Migrare dalla 20.04.xx alla 24.08 o 26.04
Il passaggio dalla 20.04.xx alla 24.08 o alla 26.04 richiede una procedura speciale perché Exchange Connector deve essere trasformato dalla vecchia installazione in un modulo vtenext registrato.
1. Eseguire il backup
Prima di iniziare eseguire un backup completo di database e file dell'istanza vtenext e annotare utenti, cartelle e mappature personalizzate.
2. Portare l'istanza alla versione vtenext di destinazione
Aggiornare l'istanza vtenext alla versione di destinazione prevista:
- 24.08.xx
- 25.xx
- 26.xx
Utilizzare il pacchetto Exchange Connector previsto per la stessa generazione di vtenext.
3. Registrare Exchange Connector come modulo vtenext
Sulle installazioni provenienti dalla 20.04.xx deve essere eseguito una sola volta lo script di registrazione del modulo Exchange.
Lo script previsto è:register_exchange_module.php
Lo script va copiato in ../plugins/script/ ed eseguito via web, ad esempio https://miocrm.ch/plugins/script/register_exchange_module.php.
Rimuovere il file
register_exchange_module.php dalla cartella immediatamente dopo l'esecuzione. Lo script deve essere eseguito una sola volta.La sua funzione è registrare l'Exchange Connector già presente come modulo/estensione vtlib di vtenext.
Lo script:
- verifica che l'installazione Exchange precedente sia presente;
- registra Exchange Connector nel sistema dei moduli vtenext;
- non ricrea le tabelle Exchange già esistenti;
- non ricrea cron, impostazioni o campi già presenti;
- permette al modulo di comparire nel Module Manager e di essere aggiornato normalmente in futuro.
Per verificare che il plugin sia stato correttamente promosso a modulo, aprire la gestione moduli, sezione Personalizzati, e verificare che Exchange Connector sia presente.
Se Exchange Connector compare correttamente nel Module Manager, la registrazione del modulo è avvenuta.
4. Aggiornare il modulo alla versione di destinazione
Dopo la registrazione, installare/aggiornare Exchange Connector con il pacchetto ZIP previsto per la versione di destinazione.
A questo punto il connettore viene gestito come un normale modulo vtenext.
5. Se si utilizza Microsoft 365
Con Microsoft 365 / Exchange Online la nuova versione utilizza Microsoft Graph.
Dopo la migrazione:
- aprire Impostazioni > Exchange Connector;
- verificare che il tipo di server sia Office365;
- scegliere tra Proxy vtenext e App Microsoft personalizzata;
- se si usa una App personalizzata, reinserire i relativi dati di configurazione;
- salvare;
- verificare il collegamento degli utenti tramite Connect;
- controllare le cartelle selezionate;
- eseguire un test di sincronizzazione.
Nel passaggio alla nuova struttura la configurazione Office365 viene portata verso la modalità Proxy vtenext. Se il cliente vuole utilizzare una propria App Microsoft, Tenant ID, Client ID e Client Secret devono essere riconfigurati dopo la migrazione.
6. Se si utilizza Exchange Server
Per Exchange Server on-premise la migrazione strutturale del modulo è la stessa, ma il collegamento continua a utilizzare EWS.
Dopo l'aggiornamento verificare versione Exchange, Mail Server, credenziali utenti, cartelle e sincronizzazione nei due sensi.
7. Verifica finale
La migrazione è conclusa quando il modulo compare correttamente nel Module Manager, la versione è quella prevista, utenti e cartelle sono corretti e i test di sincronizzazione nei due sensi hanno esito positivo.