MicroStrategy ONE

Enable Password Authentication on the MicroStrategy Telemetry Cache

  • Windows
  • Linux

Platform Analytics utilizes the Telemetry Cache (i.e. Redis) to improve the Telemetry Store (formerly called Platform Analytics Consumer) processing performance. For best performance, the Telemetry Store and the Telemetry Cache should be installed on the same machine to reduce the risk of network latency. By default, these two components are installed together when using the MicroStrategy Installation Wizard. In addition to enhanced processing performance, you can improve Platform Analytics data security by enabling password authentication to the Telemetry Cache.

Multiple services were renamed in the MicroStrategy 2019 release. Because this guide requires modifying the underlying files, it uses the original service name.

To enable password authentication, you need:

  • One environment with MicroStrategy and Platform Analytics fully installed and configured. For more information, see Installing Platform Analytics.
  • Access to the machine (Linux or Windows) where Platform Analytics was installed and configured.
  1. Open Windows Services, locate MicroStrategy Platform Analytics Consumer, MicroStrategy Usher Metadata Producer, and MicroStrategy In-Memory Cache. Right-click each service and select Stop.
  2. Open the Telemetry Cache installation path, located in C:\Program Files (x86)\Common Files\MicroStrategy\Redis, and open the redis.conf file.
  3. In the Configuration Security section, un-comment the following line:
    Copy
    # requirepass foobared
  4. In the same line, replace foobared with your designated password. Authentication is now enabled.
    Copy
    requirepass [password]
  5. Save the file.
  6. Open Windows Services and start MicroStrategy In-Memory Cache.
  7. In the Platform Analytics directory, located in C:\Program Files (x86)\MicroStrategy\Platform Analytics\, open the bin folder.
  8. Run the following script:
    Copy
    C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin>platform-analytics-encryptor.bat
  9. Enter your new password to generate an encrypted password.
  10. Record the encrypted password.
  11. In the Platform Analytics directory, open the conf folder.
  12. Edit the PAConsumerConfig.yaml file and update the redisPassword: field with the encrypted password.

    One space is needed after redisPassword:

    For example:

    redisPassword: c5eoCdW023nqmME9Nl2ZBntw5MdvBZEOQLd9zD6xVWSx3UjE,EnrazzMgibZDpHD
  13. Save the file.
  14. Open Windows Services, start MicroStrategy Platform Analytics Consumer and MicroStrategy Usher Metadata Producer.

Platform Analytics utilizes the Telemetry Cache (i.e. Redis) to improve the Telemetry Store (formerly called Platform Analytics Consumer) processing performance. For best performance, the Telemetry Store and the Telemetry Cache should be installed on the same machine to reduce the risk of network latency. By default, these two components are installed together when using the MicroStrategy Installation Wizard. In addition to enhanced processing performance, you can improve Platform Analytics data security by enabling password authentication to the Telemetry Cache.

Multiple services were renamed in the MicroStrategy 2019 release. Because this guide requires modifying the underlying files, it uses the original service name.

To enable password authentication, you need:

  • One environment with MicroStrategy and Platform Analytics fully installed and configured. For more information, see Installing Platform Analytics.
  • Access to the machine (Linux or Windows) where Platform Analytics was installed and configured.
  1. Open the Telemetry Cache installation path, located at /opt/MicroStrategy/Redis/, and run:
    Copy
    ./redis.sh stop
  2. In the Platform Analytics directory, located at /opt/MicroStrategy/PlatformAnalytics, open the bin folder and run the following commands:
    Copy
    ./platform-analytics-consumer.sh stop
    ./platform-analytics-usher-lookup-producer.sh stop
  3. Return to the Telemetry Cache installation path and open the redis.conf file.
  4. In the Configuration Security section, un-comment the following line:
    Copy
    # requirepass foobared
  5. In the same line, replace foobared with your designated password. Authentication is now enabled.
    Copy
    requirepass [password]
  6. Save the file.
  7. Open the Telemetry Cache installation path and run:
    Copy
    ./redis.sh start
  8. In the Platform Analytics directory, open the bin folder.
  9. Run the following script:
    Copy
    [user@your-PA-machine bin]#./platform-analytics-encryptor.sh
  10. Enter your new password to generate an encrypted password.
  11.  Record the encrypted password.
  12.  In the Platform Analytics directory, open the conf folder.
  13.  Edit the PAConsumerConfig.yaml file and update the redisPassword: field with the encrypted password.

    One space is needed after redisPassword:

    For example:

    redisPassword: c5eoCdW023nqmME9Nl2ZBntw5MdvBZEOQLd9zD6xVWSx3UjE,EnrazzMgibZDpHD
  14.  Save the file.
  15. In the Platform Analytics directory, open the bin folder and run the following commands:
    Copy
    ./platform-analytics-consumer.sh start
    ./platform-analytics-usher-lookup-producer.sh start