restoreConfig comando

Utilizza il restoreConfig comando per ripristinare la configurazione del tuo nodo dopo averne eseguito il backup con il backupConfig comando.

Il restoreConfig comando è una semplice utility che consente di ripristinare la configurazione del nodo dopo averne eseguito il backup con il backupConfig comando. Per impostazione predefinita, tutti i server sul nodo si arrestano prima del ripristino della configurazione, in modo che durante il ripristino non avvenga la sincronizzazione dei nodi. Se la directory di configurazione esiste già, viene rinominata prima che avvenga il ripristino. Per ulteriori informazioni su dove eseguire questo comando, vedere Utilizzo degli strumenti della riga di comando.

Se si apportano modifiche direttamente ai file dell'applicazione nella directory /installedApps app_server_root, un processo noto come "distribuzione a caldo", ma non si apportano le stesse modifiche ai file dell'applicazione nella directory /config app_server_root, le modifiche potrebbero essere sovrascritte se si utilizza il restoreConfig comando.

Il backupConfig comando non salva i permessi dei file né le informazioni sulla proprietà. Il restoreConfig comando utilizza l'umask corrente e l'ID utente effettivo (EUID) per impostare i permessi e la proprietà durante il ripristino di un file. Se è necessario che i file ripristinati abbiano le autorizzazioni e la proprietà originali, utilizzare il tar comando (disponibile su tutti i sistemi UNIX o Linux® ) per eseguire il backup e ripristinare la configurazione.

Il restoreConfig comando viene eseguito con il profilo utente QEJBSVR per garantire che il profilo utente QEJBSVR sia il proprietario delle directory e dei file creati. Il sistema imposta l'autorità *PUBLIC sulle directory che sono state create su *EXCLUDE. Eventuali autorizzazioni private precedentemente presenti nelle directory e nei file nella directory di configurazione vengono perse. Utilizzare lo script Qshell dell'autorità di concessione delle sovvenzioni ( WebSphere Application Servergrtwasaut) o il CHGAUT CL comando per impostare eventuali autorità private che sono state perse.
Nota: il profilo utente QEJBSVR deve disporre almeno dell'autorità *X per ciascuna directory nel percorso contenente il file di backup e dell'autorità *R per il file di backup.
Il restoreConfig comando imposta il proprietario della struttura della directory e dei suoi contenuti sul profilo utente QEJBSVR, ma non ripristina le autorizzazioni private. Se si utilizza un'istanza IBM® HTTP Server o Lotus Domino HTTP Server con il server dell'applicazione sullo stesso sistema o partizione e il plugin-cfg.xml file per il server dell'applicazione risiede nella struttura della /config directory profile_root, utilizzare le seguenti istruzioni per concedere le autorizzazioni private necessarie al profilo utente per IBM HTTP Server o Lotus Domino HTTP Server.
Nota: se non si utilizza un IBM HTTP Server o Lotus Domino HTTP Server sullo stesso sistema del profilo ripristinato, non completare questi passaggi. Inoltre, non completare questi passaggi se il file plugin-cfg.xml non si trova nella directoryconfigstruttura delle directory per il profilo.
  1. Accedi al sistema.
  2. Avvia una sessione Qshell utilizzando il STRQSH comando.
  3. Passare alla directory /bin app_server_root del server dell'applicazione.
  4. Utilizzare il seguente comando grtwasaut Qshell per concedere l'autorità di esecuzione (x) a ciascuna directory nel percorso contenente il plugin-cfg.xml file, a partire dalla config directory:
    grtwasaut -profileName profile_name -object path -dtaaut x -user user
    dove profile_name è il nome della configurazione del profilo che è stata ripristinata, path è il percorso della directory da modificare rispetto alla directory principale del profilo e user è QTMHHTTP (per IBM HTTP Server ) o QNOTES (per Lotus Domino HTTP Server ).
    Ad esempio, esegui i seguenti comandi se utilizzi l' IBM HTTP Server per la piattaforma iSeries e il plugin-cfg.xml file per il tuo profilo myprofile risiede nella directory /config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance profile_root :
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
    servers/myHTTPinstance -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
    servers -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile 
    -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP
    grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
    Utilizza il seguente esempio se stai utilizzando IBM HTTP Server per la piattaforma iSeries e il plugin-cfg.xml file per il tuo profilo myprofile risiede nella directory /config/cells profile_root :
    grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP 
    grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
  5. Utilizzare il seguente grtwasaut comando per concedere l'autorizzazione di lettura ed esecuzione (rx) al plugin-cfg.xml file:
    grtwasaut -profileName profile_name -object path/plugin-cfg.xml -dtaaut x -user user
    dove profile_name è il nome della configurazione del profilo che è stata ripristinata, path è il percorso della directory da modificare rispetto alla directory principale del profilo e user è QTMHHTTP (per IBM HTTP Server ) o QNOTES (per Lotus Domino HTTP Server ).
    Ad esempio, immettere il comando seguente se si utilizza IBM HTTP Server per la piattaforma iSeries e il plugin-cfg.xml file per il profilo myprofile risiede nella directory /config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance profile_root :
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile
    /servers/myHTTPinstance/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
    Utilizza il seguente esempio se stai utilizzando IBM HTTP Server per la piattaforma iSeries e il plugin-cfg.xml file per il tuo profilo myprofile risiede nella directory /config/cells profile_root :
    grtwasaut -profileName myprofile -object config/cells/plugin-cfg.xml -dtaaut rx -user QTMHHTTP

Ubicazione

Esegui il comando dalla directory /bin profile_root.

Sintassi

La sintassi del comando è la seguente:

restoreConfig backup_file [options]
dove backup_file specifica il file da ripristinare. Se non ne specifichi uno, il comando non verrà eseguito.

Parametri

Per il restoreConfig comando sono disponibili le seguenti opzioni:

-help
Stampa una dichiarazione di utilizzo
-location nome_directory
Specifica la directory in cui viene ripristinato il file di backup
La posizione predefinita è la directory /config profile_root.
-logfile nome_file
Specifica la posizione del file di log in cui vengono scritte le informazioni di tracciamento

Per impostazione predefinita, il file di log è denominato restoreConfig.log e viene creato nella logs directory.

-nostop
Indica al restoreConfig comando di non arrestare i server prima di ripristinare la configurazione
-password password
Specifica la password per l'autenticazione se la sicurezza è abilitata nel server
-profileName nome_profilo
Definisce il profilo del processo Application Server in un'installazione con più profili

L'opzione -profileName non è necessaria per l'esecuzione in un ambiente a profilo singolo. L'impostazione predefinita per questa opzione è il profilo predefinito.

-quiet
Sopprime le informazioni sullo stato di avanzamento che il restoreConfig comando stampa in modalità normale
-replacelog
Sostituisce il file di log invece di aggiungere dati al log corrente
-trace
Genera informazioni di tracciamento nel file di log a scopo di debug
-username nome_utente
Specifica il nome utente per l'autenticazione se la sicurezza è abilitata nel server; funziona allo stesso modo dell'opzione -user
-user nome_utente
Specifica il nome utente per l'autenticazione se la sicurezza è abilitata nel server; funziona allo stesso modo dell'opzione -username
-?
Stampa una dichiarazione di utilizzo

Uso

Il seguente esempio mostra la sintassi corretta:

restoreConfig WebSphereConfig_2006-04-22.zip

L'esempio seguente ripristina il file specificato nella /tmp directory e non arresta alcun server prima di avviare il ripristino:

restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
L'esempio seguente ripristina la configurazione memorizzata in /home/mydir/myprofileBackup.zip alla configurazione per il profilo myprofile:
restoreConfig /home/mydir/myprofileBackup.zip -profileName myprofile

Tenere presente che se si ripristina la configurazione in una directory diversa da quella di cui è stato eseguito il backup quando è stato eseguito il backupConfig comando, potrebbe essere necessario aggiornare manualmente alcuni dei percorsi nella directory di configurazione.