Skip to main content

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

Attenzione
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.

    Operazione critica
    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.

      immagine.png

      Verifica
      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.

      immagine.png

      immagine.png

      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.
        Vecchie configurazioni Office365
        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.

        Back to top