Comando update

O comando update é o programa Update Installer para Software WebSphere. O Assistente do Update Installer também é conhecido como o Assistente de Instalação de Atualização, o programa instalador de atualização e o programa updateInstaller.

O programa instalador de atualização instala e desinstala correções temporárias, fix packs e pacotes de atualização para atualizar o software WebSphere.

Importante: Em todo este tópico, determinados caminhos de diretório são mostrados apenas no formato Linux e UNIX para simplicidade. Os caminhos equivalentes do Windows são idênticos, exceto pela direção das barras.

Visão geral

O comando update chama o programa instalador de atualização para instalar e desinstalar o serviço para atualizar o software WebSphere. Este tópico descreve o comando do instalador de atualização e seus parâmetros de linha de comandos.

As descrições a seguir contêm informações de referência sobre o comando.

Consulte Instalando Pacotes de Manutenção e Desinstalando Pacotes de Manutenção para obter informações sobre como utilizar o comando.

Importante: Para obter informações sobre problemas conhecidos, consulte o tópico Comando update - Problemas Conhecidos e Soluções Alternativas no centro de informações do WebSphere Application Server Network Deployment, versão 6.0.
Tarefas relacionadas

Opções de Comandos

A tabela a seguir lista comandos para instalar e desinstalar correções temporárias.

Comandos para Instalar Correções Temporárias

Emita um dos comandos a seguir para instalar utilizando a interface gráfica:
Tabela 1. Comandos do Instalador de Atualização para Instalação com a Interface Gráfica
Exemplo de comando Tipo de instalação Descrição
update Modo de Interface Gráfica Inicializa o campo de correção temporária com o nome da correção temporária que possui o date stamp e time stamp mais recentes.

Aceite todos os valores padrão para instalar a correção temporária com o time stamp mais recente.

update -W prereqsfailedpanelInstallWizardBean.active= "false" Modo de interface gráfica que ignora a verificação de pré-requisitos Inicializa o campo de correção temporária com o nome da correção temporária que possui o date stamp e time stamp mais recentes. Ignora a verificação de pré-requisitos.
update -options "responsefiles\file_name" Modo de interface gráfica com um arquivo de opções Substitui todos os valores da interface gráfica por valores especificados no arquivo de resposta.

Se você omitir qualquer valor, o pacote de manutenção padrão será o que possui o date stamp e o time stamp mais recentes. O software padrão é o software instalado no diretório pai.

update -W maintenance.package="C:\Arquivos de progamas\IBM\WebSphere\ProcServer \updateinstaller\maintenance\PQ20029.pak" Modo de Interface Gráfica Substitui o nome do pacote de manutenção a ser aplicado.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" Modo de Interface Gráfica Substitui o local do software WebSphere a ser atualizado.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W maintenance.package="C:\Arquivos de progamas\IBM\WebSphere\ProcServer \updateinstaller\maintenance \PQ20029.pak" Modo de Interface Gráfica Substitui o local do software WebSphere para atualizar e o nome do pacote de manutenção a ser aplicado.
Emita um dos seguintes comandos para instalar com a interface silenciosa:
Tabela 2. Comandos do Instalador de Atualização para Instalação em Modo Silencioso
Exemplo de comando Tipo de instalação Descrição
update -silent Modo silencioso Instala a correção temporária com o time stamp mais recente para atualizar o software instalado no diretório-pai.
update -silent -W prereqsfailedpanelInstallWizardBean.active= "false" Modo silencioso que ignora a verificação de pré-requisitos Instala a correção temporária com o time stamp mais recente para atualizar o software instalado no diretório-pai. Ignora a verificação de pré-requisitos.
update -W maintenance.package="C:\Arquivos de progamas\IBM\WebSphere\ProcServer\updateinstaller \maintenance\PQ20029.pak" -silent Modo silencioso Por padrão, o assistente instala a correção temporária com o date stamp e time stamp mais recentes.

Utilize a substituição de pacote para instalar outro pacote de manutenção. Não é necessário um arquivo de resposta. O software padrão é o software instalado no diretório pai.

update -silent -options "responsefiles\file_name" Modo silencioso com um arquivo de opções Substitui todos os valores padrão por valores que você especificou no arquivo de resposta.

Se você omitir qualquer valor do arquivo de resposta, o pacote de manutenção padrão será o pacote que possui o date stamp e o time stamp mais recentes. O software padrão é o software instalado no diretório pai.

update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -silent Modo silencioso Atualiza o software WebSphere especificado no comando com o pacote de manutenção que possui o date stamp e o time stamp mais recentes. A instalação silenciosa não se refere a um arquivo de resposta.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W maintenance.package="C:\Arquivos de progamas\IBM\WebSphere\ProcServer\updateinstaller \maintenance\PQ20029.pak" -silent Modo silencioso Atualiza o software WebSphere especificado no comando com o pacote de manutenção especificado no comando. A instalação silenciosa não se refere a um arquivo de resposta.

Comandos para Desinstalar Correções Temporárias

Emita um dos seguintes comandos para desinstalar com a interface gráfica:
Tabela 3. Comandos do Instalador de Atualização para Desinstalação com a Interface Gráfica
Exemplo de comando Tipo de instalação Descrição
update -W update.type="uninstall" Modo de Interface Gráfica Inicializa o campo de correção temporária com o nome da correção temporária que foi instalada mais recentemente.

Aceite todos os valores padrão para desinstalar a correção temporária com o date stamp e time stamp mais recentes.

update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W update.type="uninstall" Modo de Interface Gráfica Substitui a interface gráfica pelo local do software WebSphere a ser atualizado. A correção temporária padrão a ser desinstalada é aquela instalada mais recentemente para esse software.
update -W backup.package="PQ20029.pak" -W update.type="uninstall" Modo de Interface Gráfica Substitui o campo de correção temporária pelo nome do pacote de manutenção a ser desinstalado.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W backup.package="PQ20029.pak" -W update.type="uninstall" Modo de Interface Gráfica Substitui o local do software WebSphere a ser atualizado e o nome do pacote de manutenção a ser desinstalado.
update -options "responsefiles\file_name" Modo de interface gráfica com um arquivo de opções Substitui todos os valores padrão por valores que você especificou no arquivo de resposta.

Se você omitir qualquer valor do arquivo de resposta, o pacote de manutenção padrão será o pacote instalado com o date stamp e o time stamp mais recentes. O software padrão é o software instalado no diretório pai.

Emita um dos seguintes comandos para desinstalar com a interface silenciosa:
Tabela 4. Comandos do Instalador de Atualização para Desinstalar no Modo Silencioso
Exemplo de comando Tipo de instalação Descrição
update -W update.type="uninstall" -silent Modo silencioso Desinstala a correção temporária com o date stamp e time stamp mais recentes para atualizar o software instalado no diretório-pai.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W update.type="uninstall" -silent Modo silencioso Substitui o local padrão do software WebSphere a ser atualizado. A correção temporária padrão a ser desinstalada é aquela instalada mais recentemente para esse software.
update -W backup.package="PQ20029.pak" -W update.type="uninstall" -silent Modo silencioso Substitui o campo de correção temporária pelo nome do pacote de manutenção a ser desinstalado.
update -W product.location="C:\Arquivos de progamas\IBM\WebSphere\ProcServer" -W backup.package="PQ20029.pak" -W update.type="uninstall" Modo silencioso Substitui o local do software WebSphere a ser atualizado e o nome do pacote de manutenção a ser desinstalado.
update -silent -options "responsefiles\file_name" Modo silencioso com um arquivo de opções Substitui todos os valores padrão por valores que você especificou no arquivo de resposta.

Se você omitir qualquer valor do arquivo de resposta, o pacote de manutenção padrão será o pacote instalado com o date stamp e o time stamp mais recentes. O software padrão é o software instalado no diretório pai.

Instalando Várias Correções Temporárias

Utilize um script para emitir mais de um comando. Cada comando identifica um pacote de manutenção a ser instalado. Por exemplo, digite o seguinte comando em uma única linha:
update -W maintenance.package="C:\Program Files\IBM\WebSphere\ProcServer\
updateinstaller\maintenance\PQ20028.pak" -silent update
-W maintenance.package="C:\Arquivos de Programas\IBM\WebSphere\ProcServer\
updateinstaller\maintenance\PQ20029.pak" -silent

Automatizando Operações de Manutenção

A maioria dos fix packs e pacotes de atualização incluem alguma manutenção para o IBM SDK, Java Technology Edition no diretório install_root/java/jre. Quando um pacote de atualização, fix pack ou correção temporária atualiza o SDK, o programa Update Installer para Software WebSphere clona o SDK no produto, iniciando um processo ISMP para copiar o SDK para o diretório install_root/updateinstaller/java/jre:
install_root   /updateinstaller
      /java
         /jre

Para utilizar um script para executar uma instalação de manutenção silenciosa, você deve ativar o programa instalador de atualização duas vezes. O primeiro comando clona apenas o SDK e não reativa automaticamente o programa instalador de atualização. O segundo comando utiliza o SDK clonado para atualizar o produto e o SDK no produto.

O Update Installer para WebSphere sempre utiliza o SDK no diretório install_root/updateinstaller se o SDK estiver presente.

Emita os seguintes comandos a partir do script:
  1. update -silent [other_options] -W relaunchwizardexecInstallWizardBean.active=false
    Por exemplo, utilize o seguinte comando para clonar o SDK em um sistema Solaris:
    /opt/IBM/WebSphere/ProcServer/updateinstaller/update \
       -silent \
       -W relaunchwizardexecInstallWizardBean.active=false \

    Identifique a correção temporária no primeiro comando se a correção temporária não for o último pacote de manutenção transferido por download. Omita os caracteres de continuação de linha do Linux e UNIX (\) ao emitir o comando em uma linha.

  2. update -silent
    O programa instalador de atualização utiliza a cópia clonada do SDK no diretório install_root/updateinstaller na próxima chamada do comando. Por exemplo, utilize o comando a seguir em um sistema Linux do WebSphere Process Server para instalar atualização utilizando o SDK clonado:
    /opt/ibm/WebSphere/ProcServer/updateinstaller/update \
       -silent -W maintenance.package=\
       "/opt/ibm/WebSphere/ProcServer/updateinstaller/maintenance/  \
       6.0-WS-WPS-ESB-LinuxIA32-RP0000002.pak" \
       -W update.type="install" \
       -W product.location="/opt/ibm/WebSphere/ProcServer"
    Omita os caracteres de continuação de linha do Linux e UNIX (\) ao emitir o comando em uma linha.

Registro em log

As seções a seguir descrevem o log que ocorre ao instalar e desinstalar o serviço.

Logs Criados ao Instalar um Serviço

Se não existir um arquivo de log de instalação, consulte o arquivo de log temporário no diretório install_root/logs/update/tmp. Se todas as validações forem transmitidas, ocorrerá a instalação.

Em seguida, o programa instalador de atualização cria o diretório install_root/logs/update/maintenance_package.install.

Dentro do diretório estão o arquivo updatelog.txt, o arquivo updatetrace.log.gz compactado e o arquivo updateconfig.log.gz compactado. O arquivo updateconfig.log.gz existe apenas quando a instalação do serviço utiliza o utilitário interno de gerenciador de configuração para executar scripts ANT.

Logs Criados ao Desinstalar um Serviço

Se não existir um arquivo de log após a desinstalação da correção temporária, consulte o arquivo de log temporário no diretório install_root/logs/update/tmp. Se todas as validações forem aprovadas, ocorrerá o procedimento de desinstalação.

Em seguida, o programa instalador de atualização cria o diretório install_root/logs/update/maintenance_package.uninstall.

Dentro do diretório estão o arquivo updatelog.txt, o arquivo updatetrace.log.gz compactado e o arquivo updateconfig.log.gz compactado. O arquivo updateconfig.log.gz existe apenas quando a remoção do serviço utiliza o utilitário interno de gerenciador de configuração para executar scripts ANT.

Indicadores de Sucesso

O arquivo de log inclui um indicador de sucesso:
INSTCONFSUCCESS
A operação atual foi bem-sucedida. Não é necessário revisar mais o arquivo de log.
INSTCONFPARTIALSUCCESS
A operação atual foi parcialmente bem-sucedida. O sistema ainda deve estar em um estado utilizável, entretanto algumas ações não-críticas falharam. Consulte o arquivo de log para determinar o que falhou e como recuperar-se do defeito, se possível.
INSTCONFFAILED
A operação atual falhou. O sistema não está mais em um estado utilizável. Consulte o arquivo de log para obter informações adicionais.

(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido em tecnologia Eclipse (http://www.eclipse.org)