Prima di migrare dalla 20.04
La migrazione dalla versione 20.04 è un passaggio particolare perché cambia il modo in cui Exchange Connector è registrato e gestito da vtenext.
Nella 20.04 il connettore proviene dalla vecchia installazione dedicata. Nelle versioni 24.08 e 26.04 viene invece gestito come un normale modulo/estensione vtenext.
Percorsi di migrazione
Da una installazione 20.04 sono previsti due percorsi equivalenti dal punto di vista strutturale:
- 20.04 → 24.08;
- 20.04 → 26.04.
In entrambi i casi è necessario eseguire una volta il passaggio manuale di registrazione del modulo Exchange.
Se invece il connettore è già in versione 24.08, vedere la pagina dedicata al passaggio 24.08 → 26.04: in quel caso non è più necessaria questa procedura speciale.
Prima di iniziare
Eseguire un backup completo dell'istanza vtenext e annotare la configurazione Exchange esistente.
Controllare almeno:
- versione attuale del connettore;
- tipo di Exchange utilizzato;
- moduli sincronizzati;
- utenti che utilizzano il connettore;
- cartelle selezionate dagli utenti;
- mappature personalizzate di Contatti e Aziende;
- eventuali errori di sincronizzazione già presenti.
Perché serve lo script di registrazione
Lo script di migrazione serve a registrare l'Exchange Connector già esistente come modulo vtlib di vtenext.
Lo script non serve a reinstallare da zero il connettore: utilizza l'installazione Exchange già presente e la rende riconoscibile dal sistema come modulo aggiornabile.
Va eseguito una sola volta sull'istanza proveniente dalla vecchia installazione 20.04.
Dopo questa registrazione, Exchange Connector compare nel Module Manager e gli aggiornamenti successivi possono essere gestiti con la normale procedura del modulo.
Se si utilizza Microsoft 365
La migrazione alla nuova generazione del connettore comporta anche il passaggio da EWS a Microsoft Graph per Exchange Online.
Prima di iniziare è quindi utile decidere se utilizzare:
- Proxy vtenext;
- App Microsoft personalizzata.
Se si utilizza un'app personalizzata, tenere disponibili Tenant ID, Client ID e Client Secret.
Se si utilizza Exchange Server
Per Exchange Server on-premise la migrazione della struttura del modulo è comunque necessaria passando dalla 20.04, ma la comunicazione con Exchange continua a utilizzare EWS.