Come effettuare la migrazione dell'installazione di ADSelfService Plus da una macchina a un'altra

Description

Questo articolo descrive la procedura di migrazione dell'installazione di ADSelfService Plus da una macchina a un'altra.

Importante:

1. Prima di iniziare il processo di migrazione, aggiorna la tua installazione di ADSelfService Plus alla versione più recente dalla pagina web del Service Pack.
2. Non disinstallare ADSelfService Plus dalla vecchia macchina finché non hai verificato che la nuova installazione funziona correttamente.

Procedura di migrazione dell'installazione del tuo ADSelfService Plus

Passo 1: Identifica il database

• Vai alla cartella della configurazione - <directory di installazione>\conf. La cartella predefinita di configurazione è disponibile in C:\Program Files(x86)\ManageEngine\ADSelfService Plus\conf.
• Apri il file database_params.conf in un editor di testo e individua drivername per identificare il database che viene utilizzato da ADSelfService Plus.
• La versione del database PostgreSQL deve essere la stessa sulla macchina vecchia e sulla macchina nuova. Se il database dell'installazione esistente è meno recente del database della macchina nuova, contatta il team di assistenza di ADSelfService Plus per ulteriore assistenza.

  Identificazione della versione di PostgreSQL: La versione di PostgreSQL può essere individuata eseguendo il comando pgsql\bin>postgres.exe -V dal prompt dei comandi all'interno della cartella pgsql nella posizione in cui è installato ADSelfService Plus (di solito C:\Program Files(x86)\ManageEngine\ADSelfService Plus).

• Se il database di backend è MySQL o MS SQL, contata il team di assistenza di ADSelfService Plus per assistenza alla migrazione.

Passo 2: Effettua il backup del database di ADSelfService Plus dalla macchina vecchia

• Arresta il tuo ADSelfService Plus, in esecuzione come applicazione o come servizio.
  • Avvio → Tutti i programmi → ADSelfService Plus → Arresta ADSelfService Plus.
  • Se hai installato ADSelfService Plus come servizio di Windows, segui questa procedura: Avvio → Esegui → digita Services.msc → Arresta ManageEngine ADSelfService Plus.
• Apri il prompt dei comandi come amministratore (fai clic destro sul prompt dei comandi e seleziona "Esegui come amministratore").
• Vai alla cartella <directory di installazione>\bin (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus\bin).
• Esegui il comando backupDB.bat. Viene effettuato il backup del database.
• Viene creata una cartella chiamata backup nella directory di installazione di ADSelfService Plus (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus\Backup), che contiene il backup del database in formato di file compresso (per esempio: 081224-1547.ezip).

Passo 3 (facoltativo):

• Effettua il backup di tutti i file di patch: Copia la cartella delle patch presente nella directory di installazione di ADSelfService Plus (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus).
• Effettua il backup di tutti i file di lingua personalizzati: Vai a <directory di installazione> e copia la cartella delle risorse.
• Effettua il backup della pagina personalizzata di accesso: Vai a <directory di installazione>\webapps\adssp e copia le cartelle di html, immagini, risorse e stili.
• Effettua il backup di tutti i certificati SSL: Se hai abilitato l'opzione HTTPS per ADSelfService Plus nella vecchia macchina, vai alla cartella <directory di installazione>\conf e copia server.xml, web.xml e l'archivio delle chiavi SSL. (Per esempio: server.keystore).
• Effettua il backup della cartella MPM: Se hai abilitato la funzionalità di distribuzione dell'app per dispositivi mobili, effettua il backup della cartella MPM (Posizione predefinita: <directory di installazione>\MPM).
  Nota: Il motivo per effettuare il backup delle cartelle della macchina vecchia è che alcune cartelle possono andar perse durante il processo di migrazione. I file persi, come quelli relativi alla lingua o all'agente di accesso, devono essere ripristinati nella macchina nuova. Se non vengono ripristinati, le personalizzazioni al file di lingua o all'agente di accesso non funzioneranno nella nuova macchina.

Passo 4: Ripristina il database di ADSelfService Plus nella macchina nuova

• Installa ADSelfService Plus nella macchina nuova. La versione o il numero della build delle installazioni devono essere identici.
  Nota: Se non conosci il numero di build della tua vecchia installazione di ADSelfService Plus, contatta il nostro team di assistenza.
• Arresta ADSelfService Plus, in esecuzione come applicazione o come servizio.
• Se hai compiuto il passo 3:
  • Incolla la cartella delle patch nella directory di installazione di ADSelfService Plus (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus).
  • Incolla la cartella delle risorse nella directory di installazione di ADSelfService Plus (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus).
  • Incolla le cartelle di html e stili nella cartella <directory di installazione>\webapps\adssp.
  • Incolla i file server.xml, web.xml e l'archivio delle chiavi SSL nella cartella <directory di installazione>\conf.
• Copia customer-config.xml dalla cartella <directory di installazione>\conf, rinomina il file in new-customer-config.xml e posizionalo nella cartella <directory di installazione>\conf della nuova directory di installazione.
• Copia e incolla il file compresso (.ezip) che contiene il backup del database dala vecchia directory di installazione (vedi il passo 2.v) nella cartella <directory di installazione>\bin (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus\bin) della nuova directory di installazione.
• Apri il prompt dei comandi come amministratore (fai clic destro sul prompt dei comandi e seleziona "Esegui come amministratore").
• Vai alla cartella <directory di installazione>\bin (Posizione predefinita: C:\Program Files(x86)\ManageEngine\ADSelfService Plus\bin).
• Esegui il seguente comando:

  RestoreDB.bat <offline backup file> -p <password> true
  Per esempio: restoreDB.bat 081224-1547.zip -p <password> true

  La password per il file di backup del database può essere di uno di due tipi:

  1. Password predefinita: Questa è la stringa invertita del nome del file. Per il nome del file menzionato in alto, la password sarebbe "7451-422180".
  2. Password configurata dall'amministratore: Questa è la password personalizzata che è stata configurata nel portale di amministrazione prima di creare il backup del database. L'opzione di modifica della password per il backup del database in Amministrazione → Connessione → Impostazioni generali è utilizzata per questo.

  Se hai dimenticato la password del file di backup ma hai accesso alla directory di installazione di ADSelfService Plus, la password crittografata può essere ottenuta dal file customer-config.xml (<directory di installazione>\conf\customer-config.xml); per decodificarla, puoi contattare support@adselfserviceplus.com to decrypt it.

  Altrimenti, il backup non sarà utilizzabile e dovrai creare un nuovo backup.

• Avvia ADSelfService Plus.

Appendice

1. Procedura per la configurazione della disponibilità elevata durante la migrazione

• Se stai effettuando la migrazione del server ADSelfService Plus primario che è parte di una configurazione di disponibilità, segui questa procedura:
  • Accedi alla console web di ADSelfService Plus dopo aver arrestato il server primario. Verrai reindirizzato automaticamente al server di standby.
  • Disabilita la Disponibilità elevata (Vai a Amministrazione → Enterprise essentials → Disponibilità elevata) nel server di standby.
  • I server primario e di standby verranno riavviati automaticamente.
  • Effettua la migrazione dell'installazione ADSelfService Plus primaria dalla macchina vecchia alla macchina nuova.
  • Una volta completata la migrazione, abilita la Disponibilità elevata nella macchina nuova con questa procedura.
• Se stai effettuando la migrazione di un server ADSelfService Plus di standby che non è parte di una configurazione a disponibilità elevata, puoi semplicemente installare ADSelfService Plus su una macchina nuova e aggiungerlo alla configurazione di disponibilità elevata modificando la configurazione di disponibilità elevata mediante il server ADSelfService Plus primario.

2. Procedura per la configurazione del bilanciamento del carico durante la migrazione

• Se stai effettuando la migrazione del nodo ADSelfService Plus primario di una configurazione di bilanciamento del carico, segui questa procedura:
  • Effettua l'accesso a ADSelfService Plus nella macchina vecchia che agisce come nodo primario utilizzando le credenziali da amministratore.
  • Vai a Amministrazione → Enterprise essentials → Bilanciamento del carico. Nella finestra di configurazione del bilanciamento del carico, fai clic su Rimuovi per eliminare l'intera configurazione di bilanciamento del carico dalla macchina vecchia.
    Note: Il ripristino del backup non ripristinerà automaticamente la configurazione di bilanciamento del carico. Deve essere configurato manualmente. Devono essere configurati anche i nodi secondari. Durante il processo di migrazione, gli utenti non possono accedere a ADSelfService Plus.
  • ADSelfService Plus viene riavviato automaticamente.
  • Effettua la migrazione del nodo ADSelfService Plus primario dalla macchina vecchia alla macchina nuova.
  • Una volta che la migrazione è completata, puoi configurare il bilanciamento del carico nella macchina nuova seguendo questa procedura.
• Per effettuare la migrazione dei nodi ADSelfService Plus secondari che sono parte di una configurazione di bilanciamento del carico, installa ADSelfService Plus nella macchina nuova e aggiungila come nodo secondario modificando la configurazione di bilanciamento del carico attraverso il nodo primario mentre rimuovi il nodo non utilizzato.