Migrating Notifications

Windows
Linux

MicroStrategy Collaboration has been enhanced to use a central data repository installed as part of the MicroStrategy Platform. Starting in MicroStrategy 2020 the Collaboration Server constructs the connection string to the MicroStrategy Data Repository during runtime. After performing the upgrade, Collaboration Server will only support connections to the MicroStrategy Data Repository.

After upgrading Collaboration Server, the previous data repository remains unchanged but it will not be used by the new version of Collaboration Server. Any comments stored in the previous data repository will need to be moved to the new repository to be accessible.

All data will remain in the MicroStrategy Data Repository after the data migration.

Migrating Comments to the MicroStrategy Data Repository

The Collaboration Server Administration Tool provides a way for system administrators to migrate comments from the previous data repository to the new data repository. The Collaboration Administration Page will display a warning message when it detects that a previous data repository was used by the Collaboration Server before the upgrade.

The Collaboration Server Administration Tool is a console application and will connect to the data repository using the same configuration as the Collaboration Server so no user input is required to connect. The tool will provide feedback as data is being migrated and will show a message when the migration is complete.

In order to recover collaboration messages that were stored in the previous version of the MicroStrategy Platform please follow these steps:

Click Start > Windows Administrative Tools > Services.
Stop the service MicroStrategy Collaboration/Realtime Service.
Start the service Mongo DB.
Run the Data Migration Command:
- Enter the three file locations in the following format:
  
  $ "<PATH_TO_NODE>" "<PATH_TO_ADMIN_TOOL_FILE>" "<PATH_TO_CONFIG_FILE>"
  Copy
```
"C:\Program Files\MicroStrategy\Common Files\MicroStrategy\nodejs\node.exe" "C:\Program Files\MicroStrategy\Collaboration Server\node_modules\mstr-collab-svc\admintool.js" "C:\Program Files\MicroStrategy\Collaboration Server\config.json"
```
- Use the migrate command to run the data migration:
  Copy
```
cmd> migrate
```
- Enter quit to close the Collaboration Server Administration Tool.
Stop the service Mongo DB.
Start the service MicroStrategy Collaboration/Realtime Service.

The Collaboration Admin Page will stop displaying the warning message at this point.

All data will remain in the MicroStrategy Data Repository after the data migration.

Migrating Comments to the MicroStrategy Data Repository

In order to recover collaboration messages that were stored in the previous version of the MicroStrategy Platform please follow these steps:

Stop the Collaboration service:

Copy

cd /opt/mstr/MicroStrategy/install/CollaborationServer/
./collaborationServer.sh stop

Start the previous data repository:

Copy

cd /opt/mstr/MicroStrategy/install/CollaborationServer/MongoDB/
./mongod.sh start

Run the Data Migration Command:
- Enter the three file locations in the following format:
  
  $ "<PATH_TO_NODE>" "<PATH_TO_ADMIN_TOOL_FILE>" "<PATH_TO_CONFIG_FILE>"
  Copy
```
/opt/mstr/MicroStrategy/install/NodeJS/bin/node 
/opt/mstr/MicroStrategy/install/CollaborationServer/node_modules/mstr-collab-svc/admintool.js /opt/mstr/MicroStrategy/install/CollaborationServer/config.json
```
- Use the migrate command to run the data migration:
  Copy
```
cmd> migrate
```
- Enter quit to close the Collaboration Server Administration Tool.
Stop the service Mongo DB.
Start the service MicroStrategy Collaboration/Realtime Service.

The Collaboration Admin Page will stop displaying the warning message at this point.