A new Modeling service has been introduced in MicroStrategy 2020 Update 2. See Configuring the Modeling Service for information about configuring the Modeling service.
See MicroStrategy Library Server Configuration Properties for more information on setting up the Modeling service configuration for the Library server.
This section describes the errors you may encounter when using the Modeling service and how to troubleshoot them.
Note: Make your configuration changes to the configuration files located under the admin folder. Do not change the files under the conf folder. All files under the conf folder are overwritten when you upgrade MicroStrategy.
Windows: <INSTALL_PATH>\MicroStrategy\ModelingService\admin
Linux: <INSTALL_PATH>/MicroStrategy/ModelingService/admin
See the following topics to enable relevant loggings, if necessary:
Error | Troubleshoot |
|---|---|
The “New Filter“ option is disabled in the File menu in Workstation | Make sure the Library server is upgraded to version MicroStrategy 2020 Update 2 or later. |
The MicroStrategy Modeling service is not configured with the correct secret key. Please set identity_token.secret_key in “modelservice.config“ to the same value as corresponding property in MicroStrategy Library. | Make sure the "modelservice.identity_token.secret_key" in the modelservice.conf file is configured correctly. It should be the same as "identityToken.secretKey" in the Library server configOverride.properties file. |
An error occurs when restoring the IdToken: | Make sure the "modelservice.identity_token.secret_key" in the modelservice.conf file is configured correctly. It should be the same as "identityToken.secretKey" in the Library server configOverride.properties file. |
An error occurs when restoring the IdToken: | Make sure the “modelservice.identity_token.secret_key“ in the modelservice.conf file is configured correctly. It should be the same as “identityToken.secretKey“ in the Library server configOverride.properties file. |
An error occurs when building Intelligence Server session: | Make sure “modelservice.truststore.path“ in the modelservice.conf file is configured correctly. |
The MicroStrategy Modeling Service is not running, or MicroStrategy Library Server cannot find it or is not configured correctly. | Check to make sure:
|
On Linux, using the command, sh ./bin/modelservice.sh stop, to stop a running Modeling service under the ModelingService root directory returns, "Modeling service is not running," in the console output. | This can be caused by accidentally deleting the RUNNING_PID file under the ModelingService root directory. To stop the Modeling service, run the following command in a terminal: # query the running process id of Modeling Service |
An error is returned in the Filter editor: SSL Configuration issue. | When an SSL validation related error is received, make sure the truststore name and truststore password are correct in the configOverride.properties filed located at <tomcat root directory>/webapps/MicroStrategyLibrary/WEB-INF/classes/config. To troubleshoot connectivity issues between the Library server and Modeling service, please enable logs on the Library server. See Logging on Library Server for Modeling Server. |
The logging functionality fails when starting the Modeling service in command line.
| This error is caused when using start.bat in command line while the Modeling service is already started from Services. Use stop.bat to exit and run start.bat again, or start from Services, to restart Model service. |
The Topology error messages are returned:
| Check to make sure:
|
Unable to connect to the service using a secure TLS channel. | The HTTPS connection between MicroStrategy Library and the Modeling service is not configured correctly. For steps on configuring HTTPS connection, please refer to Configure HTTPS Connection Between Library Server and Modeling Service. |
The TLS/SSL between the MicroStrategy Modeling service and MicroStrategy Intelligence server is not configured correctly due to the invalid trust store path: The path provided was not valid, please double-check that it exists. | The TLS/SSL connection between the Modeling service and the Intelligence server is not configured correctly. For steps on configuring TLS enabled between the Modeling service and the Intelligence server, please refer to Configure Modeling Service When Intelligence Server is TLS Enabled. |
An error occurs when opening a fact object via the Workstation Fact editor: | This is a known defect that is being investigated by the Technology team. Please use MicroStrategy Developer as a workaround. See KB484768. |