Comando restoreConfig

Utilize o comando restoreConfig para restaurar a configuração de seu nó depois de fazer backup da configuração utilizando o comando backupConfig.

Configurações suportadas Configurações suportadas:

Este artigo trata da migração da configuração de perfil. Para migrar seus aplicativos para a versão mais recente, use o Kit de Ferramentas de Migração do WebSphere Application Server. Para obter mais informações, consulte o Kit de ferramentas de migração no WASdev.

sptcfg

O comando restoreConfig é um utilitário simples para restaurar a configuração de seu nó depois de fazer backup utilizando o comando backupConfig. Por padrão, todos os servidores do nó param antes da restauração da configuração, de forma que uma sincronização do nó não ocorre durante a restauração. Se o diretório da configuração já existir, ele será renomeado antes da restauração ocorrer. Para obter informações sobre onde executar este comando, consulte Utilizando as ferramentas de linha de comandos.

Se fizer alterações diretamente nos arquivos de aplicativos, no diretório app_server_root/installedApps, um processo conhecido como "implementação a quente", mas que não faz as mesmas alterações nos arquivos de aplicativos no diretório app_server_root/config; tais alterações poderão ser sobrescritas se utilizar o comando restoreConfig.

[Linux][IBM i][z/OS]O comando backupConfig não salva permissões de arquivos ou informações sobre propriedade. O comando restoreConfig utiliza a umask atual e o ID do usuário efetivo (EUID) para definir as permissões e a propriedade ao restaurar um arquivo. Se for necessário que os arquivos restaurados tenham permissões e propriedades originais, use o comando tar (disponível em todos os sistemas UNIX ou Linux) para fazer backup e restaurar a configuração.

[AIX][z/OS]Se você estiver utilizando um diretório lógico para app_server_root/config, o comando restoreConfig não funcionará.

[IBM i]O comando restoreConfig executa no perfil de usuário QEJBSVR para garantir que esse perfil de usuário seja o proprietário dos diretórios e arquivos criados. O sistema configura a autoridade *PUBLIC para os diretórios criados para *EXCLUDE. Quaisquer autoridades privadas preexistentes nos diretórios e arquivos do diretório de configuração serão perdidas. Use o script Qshell (grtwasaut) de autoridade de concessão do WebSphere Application Server ou o comando CHGAUT CL para configurar quaisquer autoridades perdidas.
Nota: O perfil do usuário QEJBSVR deve ter, pelo menos, a autoridade *X para cada diretório no caminho que contenha o backup_file e a autoridade *R no backup_file.
[IBM i]O comando restoreConfig configura o proprietário da estrutura de diretórios e seu conteúdo para o perfil do usuário QEJBSVR, mas não restaura autoridades privadas. Se você estiver usando uma instância do IBM® HTTP Server ou do Lotus Domino HTTP Server com o servidor de aplicativos no mesmo sistema ou partição, e o arquivo plugin-cfg.xml de seu servidor de aplicativos residir na estrutura de diretório profile_root/config, use as seguintes instruções para conceder as autoridades privadas necessárias para o perfil de usuário do IBM HTTP Server ou do Lotus Domino HTTP Server.
Nota: Se você não estiver usando um IBM HTTP Server ou Lotus Domino HTTP Server no mesmo sistema do perfil que foi restaurado, não execute estas etapas. Além disso, não execute estas etapas se o arquivo plugin-cfg.xml não residir na estrutura de diretórios config do perfil.
  1. Conecte-se ao sistema.
  2. Inicie uma sessão Qshell utilizando o comando STRQSH.
  3. Navegue para o diretório app_server_root/bin para o servidor de aplicativos.
  4. Utilize o comando grtwasaut Qshell a seguir para conceder a autoridade execute (x) a cada diretório do caminho que contém o arquivo plugin-cfg.xml, iniciando com o diretório config:
    grtwasaut -profileName profile_name -object path -dtaaut x -user user
    em que profile_name é o nome da configuração de perfil que foi restaurada, path é o caminho de diretório a ser modificado de acordo com o diretório raiz do perfil e user é QTMHHTTP (para o IBM HTTP Server) ou QNOTES (para o Lotus Domino HTTP Server).
    Por exemplo, execute os seguintes comandos se usar o IBM HTTP Server para a plataforma iSeries e o arquivo plugin-cfg.xml para seu perfil myprofile residir no diretório profile_root/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance:
    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
    Use o seguinte exemplo se estiver usando o IBM HTTP Server para a plataforma iSeries e o arquivo plugin-cfg.xml para seu perfil myprofile residir no diretório profile_root/config/cells:
    grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP 
    grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
  5. Utilize o seguinte comando grtwasaut para conceder a autoridade read,execute (rx) para o arquivo plugin-cfg.xml:
    grtwasaut -profileName profile_name -object path/plugin-cfg.xml -dtaaut x -user user
    em que profile_name é o nome da configuração de perfil que foi restaurada, path é o caminho de diretório a ser modificado de acordo com o diretório raiz do perfil e user é QTMHHTTP (para IBM HTTP Server) ou QNOTES (para Lotus Domino HTTP Server).
    Por exemplo, digite o seguinte comando se usar o IBM HTTP Server para a plataforma iSeries e o arquivo plugin-cfg.xml para seu perfil myprofile residir no diretório profile_root/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance:
    grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile
    /servers/myHTTPinstance/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
    Use o seguinte exemplo se estiver usando o IBM HTTP Server para a plataforma iSeries e o arquivo plugin-cfg.xml para seu perfil myprofile residir no diretório profile_root/config/cells:
    grtwasaut -profileName myprofile -object config/cells/plugin-cfg.xml -dtaaut rx -user QTMHHTTP

Local

Emita o comando a partir do diretório profile_root/bin.

Sintaxe

A sintaxe de comandos é a seguinte:

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh backup_file [options]
[Windows]
restoreConfig.bat backup_file [options]
[z/OS]
restoreConfig.sh backup_file [options]
[IBM i]
restoreConfig arquivo_de_backup [options]
em que arquivo_de_backup especifica o arquivo a ser restaurado. Se você não especificar um, o comando não será executado.

Parameters

As opções a seguir estão disponíveis para o comando restoreConfig:

-help
Imprime a instrução de uso
-location nome_do_diretório
Especifica o diretório em que o arquivo de backup é restaurado
[AIX Solaris HP-UX Linux Windows][z/OS] Os padrões de local para o diretório app_server_root/config.
[IBM i]O local é padronizado para o diretório profile_root/config.
-logfile file_name
Especifica o local do arquivo de log no qual as informações são gravadas

Por padrão, o arquivo de log é chamado de restoreConfig.log e é criado no diretório logs.

-nostop
Instrui o comando restoreConfig para não parar os servidores antes de restaurar a configuração
-password senha
Especifica a senha para autenticação se a segurança estiver ativada no servidor
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName profile_name
[AIX Solaris HP-UX Linux Windows][IBM i]Define o perfil do processo do Servidor de Aplicativos em uma instalação com vários perfis

A opção -profileName não é requerida para execução em um ambiente de perfil único. O padrão para essa opção é o perfil padrão.

-quiet
Suprime as informações de progresso que o comando restoreConfig imprime no modo normal
-replacelog
Substitui o arquivo de log em vez de anexar o log atual
-trace
Gera informações de rastreio no arquivo de log para fins de depuração
-username user_name
Especifica o nome do usuário para autenticação se a segurança estiver ativada no servidor; atua como a opção -user
-user user_name
Especifica o nome do usuário para autenticação se a segurança estiver ativada no servidor; atua como a opção -username
-?
Imprime a instrução de uso

Uso

O exemplo a seguir demonstra a sintaxe correta:

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh WebSphereConfig_2006-04-22.zip
[Windows]
restoreConfig.bat WebSphereConfig_2006-04-22.zip
[z/OS]
restoreConfig.sh WebSphereConfig_2006-04-22.zip
[IBM i]
restoreConfig WebSphereConfig_2006-04-22.zip

O exemplo a seguir restaura o arquivo determinado no diretório /tmp e não pára nenhum servidor antes de iniciar a restauração:

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[Windows]
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[z/OS]
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[IBM i]
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[IBM i]O exemplo a seguir restaura a configuração armazenada em /home/mydir/myprofileBackup.zip para a configuração para o perfil myprofile:
restoreConfig /home/mydir/myprofileBackup.zip -profileName myprofile

Lembre-se de que se você restaurar a configuração para um diretório diferente do diretório do qual foi feito backup quando você executou o comando backupConfig, poderá ser necessário atualizar manualmente alguns dos caminhos no diretório de configuração.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_restoreconfig
Nome do arquivo: rxml_restoreconfig.html