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: 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.
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.
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.
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.
- Conecte-se ao sistema.
- Inicie uma sessão Qshell utilizando o comando STRQSH.
- Navegue para o diretório app_server_root/bin para o servidor de aplicativos.
- 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
- 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:
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
- 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
- -profileName profile_name
- 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:
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:
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
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.