Skip to main content

Migrare dalla 20.04.xx alla 24.08 o 26.04

Il passaggio dalla 20.04 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.

Annotare anche la configurazione Exchange esistente, in particolare 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 deve essere eseguito una sola volta lo script di registrazione del modulo Exchange.

Lo script previsto è:


register_exchange_module.php
lo script va messo nella ../plugins/script/ e lanciato via web miocrm.ch/plugins/script/register_exchange_module.php

ATTENZIONE: rimuovere dalla cartella il file non appena eseguito,

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.

Lo script va eseguito una sola volta. Se Exchange Connector risulta già registrato come modulo, non deve essere eseguito nuovamente.

Per verificare che il plugin sia correttamente promosso a modulo basta andare nella gestione moduli nella sezione personalizzati e verificare dia vere il plugin correttamente dichiarato.

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:

  1. aprire Impostazioni > Exchange Connector;
  2. verificare che il tipo di server sia Office365;
  3. scegliere tra Proxy vtenext e App Microsoft personalizzata;
  4. se si usa una App personalizzata, reinserire i relativi dati di configurazione;
  5. salvare;
  6. verificare il collegamento degli utenti tramite Connect;
  7. controllare le cartelle selezionate;
  8. eseguire un test di sincronizzazione.

Attenzione alle vecchie configurazioni Office365

Nel passaggio alla nuova struttura la configurazione Office365 viene portata verso la modalità Proxy vtenext. Eventuali Client ID e Client Secret precedentemente presenti non devono essere considerati automaticamente mantenuti.

Se il cliente vuole utilizzare una propria App Microsoft, riconfigurare quindi Tenant ID, Client ID e Client Secret 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 selezionata;
  • Mail Server;
  • credenziali degli utenti;
  • cartelle;
  • sincronizzazione nei due sensi.

7. Verifica finale

La migrazione è conclusa quando:

  • Exchange Connector compare correttamente nel Module Manager;
  • la versione del modulo è quella prevista;
  • gli utenti risultano collegati;
  • le cartelle sono corrette;
  • le mappature sono quelle desiderate;
  • un test da vtenext verso Exchange funziona;
  • un test da Exchange verso vtenext funziona.

Una volta completato questo passaggio, gli aggiornamenti successivi tra versioni della nuova struttura non richiedono più lo script di registrazione.

Back to top