8. Migrare i commenti a una nuova installazione del Server di collaborazione

I seguenti passaggi di migrazione si applicano solo in caso di aggiornamento di MicroStrategy 2019 a MicroStrategy 2020 e 2021.

Se si effettua l'upgrade MicroStrategy 2020 a MicroStrategy 2021, utilizzare la funzione di backup e ripristino del database, come descritto in MicroStrategy Repository.

In MicroStrategy ONE, Collaboration Server utilizza MicroStrategy Repository per archiviare i commenti degli utenti. Quando si esegue un aggiornamento in parallelo, la nuova installazione di Collaboration Server verrà configurata automaticamente su MicroStrategy Repository durante l'installazione. Dopo aver eseguito l'aggiornamento, Collaboration Server supporterà solo le connessioni a MicroStrategy Data Repository. Tutti i commenti degli utenti esistenti dovranno essere migrati nel nuovo repository per rimanere accessibili.

Il Strumento di amministrazione del Server di collaborazione consente agli amministratori di sistema di migrare i commenti dal repository di dati precedente al nuovo repository di dati. La pagina di amministrazione di Collaboration visualizza un messaggio di avvertenza quando viene rilevato che un repository di dati precedente è stato utilizzato dal Server di collaborazione prima dell'aggiornamento.

Lo strumento di amministrazione del Server di collaborazione è un'applicazione console e si connetterà al repository di dati utilizzando la stessa configurazione del Server di collaborazione, quindi non sarà necessario l'input utente per la connessione. Lo strumento fornirà feedback durante la migrazione dei dati e visualizzerà un messaggio al termine della migrazione.

Nel Server di collaborazione esistente:

Modificare mongod.cfg file con il /opt/mstr/MicroStrategy/install/CollaborationServer/MongoDB/ directory, aggiungere una nuova sezione net con bindIpAll: true. Consentirà a MongoDB di essere accessibile all'esterno del computer, in modo da poter utilizzare lo strumento di amministrazione del Server di collaborazione per connettersi a MongoDB da un altro computer.

Assicurarsi di utilizzare quattro spazi anziché una tabulazione per rientro perché mongod.cfg è in formato YAML.
Copia
```
...
processManagement:
    windowsService:
        serviceName: MSTR_mongodb
        displayName: MongoDB
security:
    authorization: enabled
net:
    bindIpAll: true
```
Riavviare il servizio Mongo DB per applicare la configurazione modificata.
Copia
```
./mongod.sh restart
```
Aprire il config.json file sotto il /opt/mstr/MicroStrategy/install/CollaborationServer/ directory, copiare l'intero dburl proprietà.

Nel nuovo computer Server di collaborazione:

Arrestare MicroStrategy Collaboration/Realtime Service.
Copia
```
./collaborationServer.sh stop
```

Aprire il config.json file sotto il /opt/mstr/MicroStrategy/install/CollaborationServer/ directory incollare il dburl riga all'inizio del contenuto. Sostituire localhost stringa in dburl con l'IP del computer del Server di collaborazione esistente. Assicurarsi che il contenuto sia in un formato JSON valido. Ecco un esempio di modificato config.json file.

Copia

{
    "dburl": "mongodb://mstr:xxxx@{IP of the existing 2019 machine}:27017/mstr_collab?authSource=admin",
    "port": 3000,
    "logging": false,
    "authorizationServerUrl": "http://localhost:8080/MicroStrategyLibrary/api",
    "dataSource": {
        "username": "mstr_collab",
        "password": "xxxxxx"
    },
    "scaling": "none",
    "secretKey": "xxxx",
    "enableConfigApi": true
}

Eseguire il comando di migrazione dei dati:
- Immetti i tre percorsi dei file nel seguente formato:
  $ "<PATH_TO_NODE>" "<PATH_TO_ADMIN_TOOL_FILE>" "<PATH_TO_CONFIG_FILE>"
  Copia
```
/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
```
- Utilizzare il comando migrate per eseguire la migrazione dei dati:
  Copia
```
cmd> migrate
```
- Invio quit per chiudere Strumento di amministrazione del Server di collaborazione.
Avviare il servizio MicroStrategy Collaboration/Realtime Service.
Copia
```
./collaborationServer.sh start
```