MicroStrategy ONE

Installation of Export Engine

In versions of MicroStrategy prior to 2020, the Export Engine service is installed automatically by the MicroStrategy installer when selecting to install the Intelligence Server. The service will use port 20100 by default. In MicroStrategy 2020, you now have the option to install the Export Engine service independently of the Intelligence Server.

Windows Installations

For Windows installations prior to MicroStrategy 2020, the Export Engine service will begin automatically after the Intelligence Server is started or after installation; however, if the server is restarted, the service must be started manually. Find and control this service through Windows Task Manager or Windows services panel, listed as MSTR_PDFExporter.

For Windows installations on MicroStrategy 2020 or later, select the MicroStrategy Export checkbox to install the Export Engine. This allows you to install the Export Engine on a stand-alone machine with all other features unchecked.

Linux Installations

For Linux installations prior to MicroStrategy 2020, the Export Engine Service will begin automatically after the Intelligence Server is started or after installation; however, if the server is restarted, the service must be started manually. For Linux installations on MicroStrategy 2020 or later, you can install the Export Engine Service separately from the Intelligence Server.

The script to start the PDF Exporter service can be found under the path install/Export/. The commands for executing this script are:

  • pdfexporter.sh start to start the PDF Exporter Service.
  • pdfexporter.sh stop to stop the PDF Exporter Service.
  • pdfexporter.sh restart to restart the PDF Exporter Service.
  • pdfexporter.sh status to check the status the PDF Exporter Service.

Connecting the Intelligence Server to an Export Engine on a Different Machine

You can configure the Intelligence Server to use an export engine that is installed on a different machine. You may want to do this if you are using a dedicated machine for the export engine or if you are using RHEL 6.x for your Intelligence Server, which does not support the installation of the export engine. See the Certification Dashboard for a list of supported export applications.

To connect the Intelligence Server to an export engine on a different machine, update the registry on the Intelligence Server machine. No changes need to be made on the machine that has the export engine installed.

If Services Registration (Consul) has been installed and your network settings allows for it, you can rely on Services Registration to discover and connect to the export engine by removing these entries.

  1. Open the registry.

    On Windows, open the Registry Editor.

    On Linux, navigate to the <HOME_PATH> and open the file MSIReg.reg.

  2. On Windows, navigate to the following location and update the registry key "host" to the Fully Qualified Name or IP Address of the machine where the export engine is located.

    "[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\MicroStrategy\DSS Server\PDFExporter]":

    "host"="localhost"

  3. On Linux, edit the host in MSIReg.reg:

    HKEY_LOCAL_MACHINE\SOFTWARE\MicroStrategy\DSS Server\PDFExporter

    host: localhost

  4. In the same location, update the registry key "port" to the port number that is running the export engine service.

    During installation, the default value for the service is 20100. To calculate the port number, use "dword:" and the hexidecimal value of the decimal to be used.

    For example, 00004E84 converted from hexidecimal to decimal is 20100, which gives you the full value of "dword:00004E84" as shown in the example below:

    "[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\MicroStrategy\DSS Server\PDFExporter]":

    "port"=dword:00004E84

  5. Restart the Intelligence Server.