Installing and Upgrading MicroStrategy Office
What's new
Introduction to MicroStrategy Office
System Requirements and Compatibility
Certified and Supported Configurations
Installing and Upgrading
Product Documentation
Known and Resolved Issues and Troubleshooting
Intellectual Property Notices
MicroStrategy Readme Index

The following information is provided to help install and deploy MicroStrategy Office and MicroStrategy Web Services:

Installing MicroStrategy Office

For steps to install MicroStrategy Office along with other MicroStrategy products, see the Installing MicroStrategy on Windows chapter of the Installation and Configuration Guide. You can also install MicroStrategy Office in the following ways:

  • Stand-alone version of Office: If MicroStrategy Office is the only MicroStrategy program you are installing, use the stand-alone installation to avoid installing all MicroStrategy common files. For the stand-alone installation of MicroStrategy Office, run MicrostrategyOffice.msi or MicroStrategyOffice64.msi (for use with 64-bit Microsoft Office) in the Installations\Office folder on the installation DVD-ROM.
  • Installing Office from MicroStrategy Web: From the MicroStrategy Web Administrator page, you can designate the installation directory path to MicroStrategy Office, and also determine whether or not a link to Office installation information appears in the MicroStrategy Web interface. For steps to enable users to install MicroStrategy Office from Web, see the Deploying MicroStrategy Web and Web Universal chapter of the Installation and Configuration Guide.

Notes:

  • Windows Installer 4.5 or later is required to install all MicroStrategy Office products on a Windows platform.
  • Microsoft .NET Framework 4.0 must be installed prior to installing MicroStrategy Office.
  • If you are unable to install MicroStrategy software from the DVD-ROM format due to the lack of a DVD drive, you can download the software from the MicroStrategy download site.

If you encounter problems during the installation procedure, refer to the General Information Readme - Troubleshooting and the Troubleshooting appendix in the Installation and Configuration Guide. If you require additional assistance, refer to the issues and troubleshooting information for MicroStrategy Office or contact MicroStrategy Technical Support.

Directory structure

The table below lists folders and files of interest that are included in the default directory structure after an installation of MicroStrategy Office.

Directory Contents
\Office\ Root MicroStrategy Office directory
\Office\Images Images directory
\Office\de German language support directory
\Office\es Spanish language support directory
\Office\fr French language support directory
\Office\it Italian language support directory
\Office\ja Japanese language support directory
\Office\ko Korean language support directory
\Office\pt Portuguese language support directory
\Office\sv Swedish language support directory
\Office\zh-CHS Simplified Chinese language support directory
\Office\zh-CHT Traditional Chinese language support directory

Installing MicroStrategy Web Services

For steps to install MicroStrategy Web Services (ASP.NET or J2EE), see either the Installing MicroStrategy on Windows chapter or the Installing MicroStrategy on UNIX and Linux chapter of the Installation and Configuration Guide, depending on your environment.

Review your environment to ensure compliance with supported operating systems, application servers, web servers, Java Development Kits, Java servlet engines, and hardware and software requirements.

Notes:

  • Windows Installer 4.5 or later is required to install MicroStrategy Office products on a Windows platform.
  • Microsoft .NET Framework 4.0 must be installed prior to installing MicroStrategy Web Services.
  • If you are unable to install MicroStrategy software from the DVD-ROM format due to a lack of a DVD drive, you can download the software from the MicroStrategy download site.

If you encounter problems during the installation procedure, refer to Troubleshooting and the Troubleshooting appendix in the Installation and Configuration Guide. If you require additional assistance, refer to the issues and troubleshooting information or contact MicroStrategy Technical Support.

Directory structure

Web Services ASP.NET: The table below lists folders and files of interest that are included in the default directory structure after an installation with no previous Web Services versions installed:

Directory Contents
\Web Services\ Root MicroStrategy Web Services directory and Interface asmx files.
\Web Services\Office\ Contains the install media to enable the web-based installation and upgrade mechanism for MicroStrategy Office.
\Web Services\swf Location of MicroStrategy and third-party flash dashboard viewer files.
\Web Services\VisFramework Location of MicroStrategy flash visualization files.
\Web Services\images\ Contains the images that are defined with relative paths in reports: attribute form images, threshold images, and so on. By default, this folder contains images used in MicroStrategy demonstration projects.

Web Services J2EE: The table below lists folders and files of interest that are included in the default directory structure after an installation with no previous Web Services versions installed:

Directory Contents
/Web Services J2EE Root folder of the application that stores the .war file to deploy MicroStrategy Web Services J2EE. In a UNIX or Linux environment, this folder does not contain spaces in its name.

Deploying Web Services J2EE on different application servers

For steps to deploy MicroStrategy Web Services J2EE on different application servers, see the Installation and Configuration Guide.

Verifying a Web Services ASP.NET deployment

To verify that Web Services is up and running, open Internet Explorer and type in the following URL:  http://hostname:port/MicroStrategyWS/MSTRWS.asmx (assuming that the Web Services installation used the default virtual directory). A web page with a list of available APIs should be displayed. Click the Service Description link. A well-formatted XML page should be displayed.

Verifying a Web Services J2EE deployment

A typical connectivity URL to Web Services J2EE is structured as follows: http://hostname:port/ContextRoot_Name/services/Servlet_Name. ContextRoot_Name is typically selected during deployment of the war file. On the other hand the Servlet_Name can be customized by modifying the web.xml file. It is however advisable to keep the default values for these variables. 

To verify that Web Services is up and running, open Internet Explorer and type in the following URL: http://hostname:port/MicroStrategyWS/services/MSTRWSJ. A connection test web page with a link to supported APIs should be displayed. Click on the link Service Description. A well-formatted XML page should be displayed.

Upgrading MicroStrategy Office and MicroStrategy Web Services

Customers who want to use the MicroStrategy features introduced in this release and customers who need fixes made in this release for MicroStrategy products should upgrade:

  • All pre-9.0.0 MicroStrategy products must be uninstalled prior to upgrading to MicroStrategy Analytics Enterprise. After this is complete, you can install the Analytics Enterprise version of MicroStrategy products.
  • MicroStrategy 9.0.x products can be upgraded directly to MicroStrategy Analytics Enterprise.
  • MicroStrategy Office 32-bit must be uninstalled prior to installing MicroStrategy Office 64-bit.

To perform a centralized upgrade of MicroStrategy Office, you can upgrade MicroStrategy Web Services to the new version. Then, upon connecting to MicroStrategy Office, users are prompted with instructions to download and install the new version of MicroStrategy Office.

Before upgrading, refer to the Upgrade Guide for important information about preparing for the upgrade, the order in which to upgrade products, and tasks to perform after upgrading.

Uninstalling MicroStrategy Office and MicroStrategy Web Services

For details about uninstalling MicroStrategy Office or MicroStrategy Web Services, see the Adding or Removing MicroStrategy Components chapter of the Installation and Configuration Guide.

Undeploying Web Services J2EE: Before undeploying MicroStrategy Web Services J2EE, make sure to back up the projectsources.xml and any threshold image folders you may have. Once MicroStrategy Web Services J2EE has been redeployed, copy those files back before restarting your application server.

 

 

 

About MicroStrategy, Inc.