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: 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.
sptcfgO 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]](../images/linux.gif)
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.
Se você estiver utilizando um diretório lógico para
app_server_root/config,
o comando restoreConfig não funcionará.
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.
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.Local
Emita o comando a partir do diretório profile_root/bin.
Sintaxe
A sintaxe de comandos é a seguinte:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh backup_file [options]
![[Windows]](../images/windows.gif)
restoreConfig.bat backup_file [options]
![[IBM i]](../images/iseries.gif)
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
Os padrões de local para o diretório
app_server_root/config.
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]](../images/dist.gif)
-profileName profile_name![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Define o perfil do processo do Servidor de Aplicativos em uma instalação com vários perfisA 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
É possível utilizar o comando restoreConfig
para recuperar um servidor de aplicativos se ele falhar. Execute as
seguintes etapas:O exemplo a seguir demonstra a sintaxe correta:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip
![[IBM i]](../images/iseries.gif)
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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[IBM i]](../images/iseries.gif)
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.
Tópico de Referência