Skip to main content

Migrare dalla 20.04.xx alla 24.08 o 26.04

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

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

    Lo script previsto è:
    register_exchange_module.php
    loLo script va messocopiato nellain ../plugins/script/ eed lanciatoeseguito via webweb, ad esempio https://miocrm.ch/plugins/script/register_exchange_module.php.

    Operazione critica
    Rimuovere il file register_exchange_module.php

    ATTENZIONE: rimuovere dalla cartella ilimmediatamente filedopo nonl'esecuzione. appenaLo eseguito,

    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.

      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 stato correttamente promosso a modulomodulo, bastaaprire andare nellala gestione moduli nellamoduli, sezione personalizzatiPersonalizzati, e verificare diache vereExchange ilConnector pluginsia presente.

      Verifica
      Se Exchange Connector compare correttamente dichiarato.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.

        Attenzione alle vecchie

        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 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:

        verificare
          versione ExchangeExchange, selezionata; Mail Server;Server, credenziali degliutenti, utenti;cartelle cartelle;e sincronizzazione nei due sensi.

          7. Verifica finale

          La migrazione è conclusa quando:

          quando
            il Exchange Connectormodulo compare correttamente nel Module Manager;Manager, la versione del modulo è quella prevista; gliprevista, utenti risultano collegati; lee cartelle sono corrette;corretti lee mappature sono quelle desiderate; uni 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.sincronizzazione nei due sensi hanno esito positivo.

            Back to top