Installing Software Needed for Web Services

If you plan to use the Web Customization Editor to convert a MicroStrategy task to a web service or generate a class with the stub code for a web service, you need to install and configure some additional software. You will specify the locations where you install the software as configuration settings when you configure the MicroStrategy Web Services preferences for the Web Customization Editor.

• Apache Axis2

  Apache Axis is a servlet which implements a SOAP engine. SOAP (Simple Object Access Protocol) is a protocol for exchanging information in a decentralized environment such as a Web Services environment. 

• Apache Ant

  Apache Ant is a software tool for automating software build processes. It is implemented using the Java language and requires the Java platform. 

• .NET SDK

  Web services that run in a Microsoft Internet Information Services (IIS) 6.0 virtual directory require the .NET SDK. For instructions on creating a virtual directory, refer to the product documentation provided by Microsoft Internet Information Services (IIS). 

Instructions for downloading, installing, and configuring each software product are provided below.

• Apache Axis2

  To install Apache Axis 2, do the following:

  1. Download the currently supported version of Apache Axis2. 

  2. Refer to documentation from Apache Axis to deploy the Axis Web application to Tomcat. 

  3. Deploy the software to a location that has no spaces in the fully-qualified path.

  When you configure the MicroStrategy Web Services preferences for the Web Customization Editor, you will use this location as the value of the Axis2 Location.

• Apache Ant

  To install Apache Ant, do the following:
  

  1. Download Apache Ant from the Apache Ant Project.
     
  2. Unpack the Apache Ant file to a location that has no spaces in the fully-qualified path.
     
  3. Add the ant-contrib-1.0b3.jar file to the Ant lib directory. 

  When you configure the MicroStrategy Web Services preferences for the Web Customization Editor, you will use this location as the value of the Ant root directory. 

• .NET SDK

  To install the .NET SDK, do the following:

  1. Download the .NET SDK from the MicroSoft Download Center.
     
  2. Save the SDK to a location that has no spaces in the fully-qualified path. 

When you configure the MicroStrategy Web Services preferences for the Web Customization Editor, you will use this location as the value of the Microsoft .NET SDK location.