MicroStrategy ONE

Library

Deploying MicroStrategy Library

In MicroStrategy 10.9 through 11.0, MicroStrategy Library was automatically deployed in Tomcat and the MicroStrategyLibrary.war file installed in the <INSTALL_PATH>\LibraryWebMobile directory. MicroStrategy ONE gives administrators the option to not perform the Library deployment.

This section contains high level steps and considerations for performing an upgrade or migrating MicroStrategy Library to a new environment.

You must manually deploy a new Library WAR File after upgrading MicroStrategy Library.

Windows Environments

In MicroStrategy 10.9 to 11.0, MicroStrategy Library automatically deployed in Tomcat and the Library.war file installed in the <INSTALL_PATH>\LibraryWebMobile directory. In MicroStrategy 2019 - ONE, administrators can choose to not deploy Library automatically.

Perform the following steps when doing a direct upgrade of MicroStrategy Library from 10.9 - 11.0 to MicroStrategy 2019 - ONE. If your installation of Tomcat is already on a supported version, there is no need to upgrade it.

  1. Stop Tomcat before proceeding with the upgrade.
  2. Within the Tomcat directory, back up the following files:
    • webapps folder
    • server.xml
    • tomcat-users.xml
  3. Uninstall Tomcat.
  4. Install Tomcat 9.0.12 or higher.
  5. Restore all backed up files in the new Tomcat installation.

  6. Start Tomcat.

    The new Library.war file appears in C:\Program Files (x86)\Common Files\MicroStrategy\Tomcat\apache-tomcat-XXXXX\webapps.

Linux Environments

In MicroStrategy 10.9 to 11.0, the MicroStrategy installer asks the administrator to enter a path to the Tomcat folder in order to deploy the Library.war file and installs the WAR file in the <INSTALL_PATH>/LibraryWebMobile directory. In versions 2019 - ONE , administrators are no longer prompted with the Tomcat directory and can deploy the WAR file to the J2EE server of choice.

Deploying the New WAR File

Use the following steps to deploy a new WAR file for both Windows and Linux.

  1. Use the MicroStrategy installer to create a new MicroStrategy ONELibrary.war file by doing a direct upgrade or new installation.
  2. Redeploy the new Library.war file from the Library install directory to the J2EE server being used. See the supported servers in Platform Certifications.

  3. Migrate your customizations to the new environment, such as:

    • .../webapps/MicroStrategyLibrary/images/
    • .../webapps/MicroStrategyLibrary/plugins/
    • .../webapps/MicroStrategyLibrary/WEB-INF/classes/auth/
      • Customized authentication configuration, such as SAML authentication
    • .../webapps/MicroStrategyLibrary/WEB-INF/classes/config/configOverride.properties
      • Make sure MicroStrategy Library is pointing to the correct Intelligence server and Collaboration server with correct authentication setting by going to the Library Administration control panel.
    • .../webapps/MicroStrategyLibrary/WEB-INF/classes/logback.xml
    • Any other customizations including SSL configurations
  4. Verify that MicroStrategy Library functionality including collaboration, sharing, exporting, printing, and all other features are working properly. Ensure dashboards and documents are appearing.

The Collaboration server is a separate component of MicroStrategy that is upgraded independently of Library. See Upgrade MicroStrategy Collaboration for more information.