Instalando Silenciosamente

Você pode instalar o pacote do produto Rational Performance Tester, executando o Installation Manager no modo de instalação silenciosa. Quando você executa o Installation Manager no modo silencioso, a interface com o usuário não fica disponível; em vez disso, o Installation Manager utiliza um arquivo de resposta para informar os comandos que são necessários para instalar o pacote do produto. Também é possível instalar silenciosamente o Installation Manager utilizando o instalador do Installation Manager. Em seguida, é possível utilizar o instalador para instalar silenciosamente pacotes de produto.

Executar o Installation Manager no modo silencioso é útil porque permite a utilização de um processo em lote para instalar, atualizar, modificar e desinstalar pacotes de produtos por meio de scripts.

Observe que você deve instalar o Installation Manager para que possa instalar silenciosamente o pacote Rational Performance Tester. Consulte Gerenciando o IBM Installation Manager para obter detalhes sobre a instalação do Installation Manager.

Existem duas principais tarefas necessárias para a instalação silenciosa:

Nota:
Para efetuar a instalação silenciosa do Data Collection Infrastructure com o Rational Performance Tester, um arquivo de resposta adicional deve ser criado.
  1. Criar o arquivo de resposta.
  2. Executar o Installation Manager no modo de instalação silenciosa.

Criando um Arquivo de Resposta com o Installation Manager

É possível criar um arquivo de resposta gravando suas ações durante a instalação de um pacote de produto Rational Performance Tester utilizando o Installation Manager ou o instalador do Installation Manager. Quando você grava um arquivo de resposta, todas as seleções feitas na GUI do Installation Manager são armazenadas em um arquivo XML. Quando executado no modo silencioso, o Installation Manager usa o arquivo de resposta em XML para localizar o repositório que contém o pacote, selecionar os recursos para a instalação, e assim por diante.

Para registrar um arquivo de resposta para instalação (ou desinstalação):

  1. Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager. Por exemplo:
  2. Em uma linha de comandos, digite o seguinte comando para iniciar o Installation Manager, substituindo o próprio nome do arquivo e local do arquivo de resposta e, opcionalmente, o arquivo de log:
    Nota:
    Certifique-se de que os caminhos de arquivo que você digitou existam; o Installation Manager não criará diretórios para o arquivos de resposta e o arquivo de log.
  3. Siga as instruções no assistente Instalar Pacotes para fazer suas opções de instalação. Para obter detalhes, consulte Instalando o Rational Performance Tester Utilizando a GUI do Installation Manager .
  4. Clique em Concluir, em seguida, feche o Installation Manager.

Um arquivo XML é criado e reside no local especificado no comando.

Criando o Arquivo de Resposta do Data Collection Infrastructure

O seguinte arquivo de texto UTF-8 (rpt_dci.rsp) deve ser inserido no diretório temporário do sistema operacional para incluir o Data Collection Infrastructure durante uma instalação silenciosa:

-V VAccessAll=true
-V VAccessLocal=false
-V VAccessCustom=false
-V VHosts=" "
Nota:
VHosts deve ser uma lista de sistemas host válidos separados por vírgulas.
  1. Determine o diretório temporário utilizado por seu sistema operacional ou perfil de login. Por exemplo, no Windows, em uma linha de comandos, digite set. A lista de variáveis set será exibida. Procure o valor designado para tmp. Este é o diretório temporário em que a rotina de instalação silenciosa procurará o arquivo de resposta rpt_dci.rsp.
  2. Altere diretórios para diretório temporário.
  3. Crie um arquivo de texto UTF-8 denominado rpt_dci.rsp que contém os argumentos anteriormente listados.

Gravando um Arquivo de Resposta com o Instalador do Installation Manager

É possível utilizar o instalador do Installation Manager para gravar a instalação do Installation Manager e de outros produtos.

Para gravar a instalação do Installation Manager, siga estas etapas:

  1. Descompacte o arquivo ZIP do Installation Manager e, em seguida, vá para o diretório InstallerImage_plataforma.
  2. Para iniciar a gravação, digite install -record <caminho e nome do arquivo de resposta> -skipInstall <Local_de_dados_do_agente> -vmargs -Dcom.ibm.cic.agent.hidden=false

Gravando uma Instalação de Produto com o Instalador

Para iniciar a gravação de uma instalação de produto com o instalador do Installation Manager, siga estas etapas:

  1. Vá para o diretório InstallerImage_plataforma no local em que descompactou o arquivo ZIP do Installation Manager.
  2. Abra o arquivo install.ini, removendo as seguintes linhas: -input e @osgi.install.area/install.xml
  3. Digite o seguinte comando: install -record <caminho e nome do arquivo de resposta> -skipInstall <Local_de_dados_do_agente>, por exemplo: install -record
  4. Inicie o Installation Manager e conclua o assistente para Instalar Pacotes.

Instalando e Executando o Installation Manager no Modo Silencioso

Utilize o instalador do Installation Manager para instalar o Installation Manager e, em seguida, utilize o Installation Manager para instalar pacotes de produtos no modo de instalação silenciosa a partir de uma linha de comandos.

Consulte o Web site do Installation Manager para obter documentação adicional sobre como executá-lo no modo silencioso. Por exemplo, a instalação silenciosa de um repositório que requer autenticação (ID de usuário e senha).

A seguinte tabela descreve os argumentos utilizados com o comando de instalação silenciosa:

Argumento Descrição
-vm Especifica o ativador Java. No modo silencioso, sempre utilize java.exe no Windows e java em outras plataformas.
-nosplash
Especifica que a tela inicial deve ser suprimida.
--launcher.suppressErrors
Especifica que o diálogo de erro da JVM deve ser suprimida.
-silent Especifica que o instalador do Installation Manager ou o Installation Manager devem ser executados no modo silencioso.
-input
Especifica um arquivo de resposta XML como a entrada para o instalador do Installation Manager ou o Installation Manager. Um arquivo de resposta contém comandos que o instalador ou o Installation Manager executa.
-log
(Opcional) Especifica um arquivo de log que registra o resultado da instalação silenciosa. O arquivo de log é um arquivo XML.

O instalador do Installation Manager e o Installation Manager têm um arquivo de inicialização ou .ini silent-install.ini que inclui valores padrão para os argumentos da tabela.

O instalador do Installation Manager é utilizado para instalar o Installation Manager. Siga estas etapas para instalar o Installation Manager silenciosamente.

Para instalar o Installation Manager silenciosamente, descompacte o arquivo ZIP do instalador, vá para o subdiretório eclipse e, em seguida, utilize os seguintes comandos:

Depois que o Installation Manager for instalado, será possível utilizá-lo para instalar outros produtos. Também é possível utilizar o instalador do Installation Manager para instalar os produtos.

Para executar o Installation Manager no modo silencioso, execute o seguinte comando no subdiretório eclipse:

Para instalar produtos silenciosamente utilizando o instalador do Installation Manager, no diretório eclipse, digite o seguinte comando:

Quando o instalador do Installation Manager ou o Installation Manager é executado no modo de instalação silenciosa, ele lê o arquivo de resposta e grava um arquivo de log no diretório especificado. Apesar de você precisar ter um arquivo de resposta quando executa no modo de instalação silenciosa, arquivos de log são opcionais. O resultado desta execução deve ser um status 0 para com êxito e um número diferente de zero para com falha.

Procurando e Instalando Silenciosamente Todos os Produtos Disponíveis

Você pode procurar e instalar silenciosamente atualizações para todos os produtos disponíveis.

Para procurar e instalar silenciosamente todos os produtos disponíveis:

  1. Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager.
  2. Digite e execute o seguinte comando, substituindo os seus próprios locais para o arquivo de resposta e, opcionalmente, o arquivo de log:

Todos os produtos disponíveis conhecidos do Installation Manager serão instalados.

Instalando Silenciosamente Atualizações em Todos os Produtos Atualmente Instalados

Você pode procurar e instalar silenciosamente atualizações para todos os produtos atualmente instalados.

Para procurar e instalar silenciosamente atualizações de todos os produtos disponíveis:

  1. Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager.
  2. Digite e execute o seguinte comando, substituindo os seus próprios locais para o arquivo de resposta e, opcionalmente, o arquivo de log:

Todas as atualizações dos produtos disponíveis conhecidos do Installation Manager serão instaladas.

Comandos do Arquivo de Resposta

Se você deseja utilizar os recursos de instalação silenciosa do Installation Manager, precisará criar um arquivo de resposta que contenha todos os comandos que o Installation Manager deve executar. A maneira recomendada de fazer isso é criar um arquivo de resposta gravando as ações conforme você instala o pacote IBM Rational Performance Tester. Entretanto, você pode criar ou editar um arquivo de resposta manualmente.

Há duas categorias de comando para o arquivo de resposta:

Comandos de Preferência da Instalação Silenciosa

Enquanto você normalmente especifica preferências utilizando a janela Preferências, poderá também especificar preferências (identificadas como chaves) em um arquivo de resposta para uso durante uma instalação silenciosa.

Nota:
Você pode especificar mais de uma preferência em um arquivo de resposta.

Quando você define preferências em um arquivo de resposta, o seu código XML será semelhante ao seguinte exemplo:

<preference
	name = "a chave da preferência"
	value = "o valor da preferência a ser configurado">
</preference>

Utilize a seguinte tabela para identificar chaves e seus valores associados para preferências da instalação silenciosa:

Chave Valor Notas
com.ibm.cic.common.core.preferences.logLocation Especifica o local do arquivo de log do Installation Manager.
Importante:
Essa chave é opcional e é projetada para teste e depuração. Se você não especificar um local para o arquivo de log, a instalação silenciosa e a versão da UI do Installation Manager utilizarão o mesmo local.
com.ibm.cic.license.policy.location Especifica uma URL que define onde reside o arquivo de políticas de licença remota.
com.ibm.cic.common.core.preferences.http.proxyEnabled True ou False False é o valor padrão.
com.ibm.cic.common.core.preferences.http.proxyHost Nome do host ou endereço IP
com.ibm.cic.common.core.preferences.http.proxyPort Número da porta
com.ibm.cic.common.core.preferences.http.proxyUseSocks True ou False False é o valor padrão.
com.ibm.cic.common.core.preferences.SOCKS.proxyHost Nome do host ou endereço IP
com.ibm.cic.common.core.preferences.SOCKS.proxyPort Número da porta
com.ibm.cic.common.core.preferences.ftp.proxyEnabled True ou False False é o valor padrão.
com.ibm.cic.common.core.preferences.ftp.proxyHost Nome do host ou endereço IP
com.ibm.cic.common.core.preferences.ftp.proxyPort Número da porta
com.ibm.cic.common.core.preferences.eclipseCache c:\IBM\common (Windows)

/opt/IBM/common (Linux)

Nota:
Os caminhos acima são valores padrão para esta preferência; normalmente, os pacotes de instalação fornecem seus próprios valores para esta preferência.
Não é possível alterar esse local se você já tiver instalado um pacote.
com.ibm.cic.agent.core.pref.offering.service.repositories. areUsed True ou False Altere esta preferência para 'False' para desativá-la. Quando for 'True', todos os repositórios vinculados serão procurados quando produtos forem instalados ou atualizados.
com.ibm.cic.common.core.preferences. preserveDownloadedArtifacts True ou False Altere esta preferência para 'False' para desativá-la. Quando for True, os arquivos necessários para recuperar o pacote para uma versão anterior serão armazenados no sistema. Quando for False, esses arquivos não serão armazenados. Se esses arquivos não forem armazenados, será necessário conectar-se ao repositório ou mídia original para recuperar.

Comandos de Instalação Silenciosa

Você pode utilizar essa tabela de referência para aprender mais sobre os comandos do arquivo de resposta para uso durante uma instalação silenciosa.

Comandos do Arquivo de Resposta Descrição

Perfil (Profile)

<profile
id="o id do perfil (grupo de pacotes)"
installLocation="local de instalação do
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>
Utilize este comando para criar um grupo de pacotes (ou local da instalação). Se o grupo de pacotes especificado já existir, o comando não terá efeito. Atualmente, ao criar o perfil, a instalação silenciosa também criará dois contextos de instalação; um para o Eclipse e um para o nativo. Um perfil é um local da instalação.

É possível utilizar o elemento <data> para configurar propriedades do perfil.

A lista a seguir contém as chaves atualmente suportadas e os valores relacionados:

  • A chave eclipseLocation especifica um valor de local do Eclipse existente, como c:\myeclipse\eclipse.
  • A chave cic.selector.nl especifica as seleções de código do idioma de NL (Natural Language), como zh, ja e en.
Nota:
Separe vários valores NL com vírgulas.

A lista a seguir contém os códigos de idioma atualmente suportados:

  • Inglês (en)
  • Francês (fr)
  • Italiano (it)
  • Chinês Simplificado (zh)
  • Russo (ru)
  • Chinês Tradicional (Taiwan) (zh_TW)
  • Chinês Tradicional (Hong Kong) (zh_HK)
  • Alemão (de)
  • Japonês (ja)
  • Polonês (pl)
  • Espanhol (es)
  • Tcheco (cs)
  • Húngaro (hu)
  • Coreano (ko)
  • Português (pt_BR)

Repositories

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>
Utilize esse comando para especificar os repositórios utilizados durante uma instalação silenciosa. Utilize um caminho de URL ou UNC para especificar repositórios remotos; utilize caminhos de diretório para especificar repositórios locais.

Install

<install>
<offering profile= "id do perfil"
features= "ids de recurso"
id= "id da oferta" version= "versão da
version"></offering>

<!--add more offerings below>
<...>

</install>
Utilize esse comando para especificar os pacotes de instalação que serão instalados.

O ID do perfil deve corresponder a um perfil existente ou um perfil criado pelo comando configurar perfil.

IDs de Recurso podem ser especificados opcionalmente por uma lista delimitada por vírgulas, como "feature1, feature2" e assim por diante. Se nenhum ID de recurso estiver especificado, todos os recursos padrão na oferta especificada serão instalados.

O número da versão não é necessário. Se nenhuma versão for especificada, o Installation Manager instalará o produto mais recente com o ID especificado e quaisquer atualizações e correções disponíveis.

Nota:
Os recursos necessários serão incluídos para instalação, mesmo que não estejam explicitamente especificados na lista delimitada por vírgulas.

<install modify="true"> or <uninstall modify="true"> (optional attribute)

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version" 
features="-"/>
</uninstall>

Utilize o atributo <install modify="true"> em comandos de instalação e desinstalação para indicar que você deseja modificar uma instalação existente. Se o atributo não for configurado para true, o valor será padronizado como false. Se a intenção da operação de modificação for apenas instalar pacotes de idioma adicionais, um hífen "-" deverá ser utilizado na lista de IDs de recursos de oferta para indicar que nenhum novo recurso está sendo incluído.

Importante:
Você deve especificar"modify=true" e uma lista do recurso hífen "-" como especificado no exemplo; do contrário, o comando install instalará os recursos padrão da oferta e o comando uninstall removerá todos os recursos.

Uninstall

<uninstall>
<offering profile= "id do perfil"
features= "ids de recurso"
id= "id da oferta" version= "versão da
version"></offering>

<!--add more offerings below>
<...>

</uninstall>
Utilize esse comando para especificar os pacotes que serão desinstalados.

O ID do perfil deve corresponder a um perfil existente ou um perfil especificado em um comando de perfil. Além disso, se nenhum ID de recurso estiver especificado, todos os recursos na oferta especificada serão desinstalados; se nenhum ID de oferta estiver especificado, todas as ofertas instaladas no perfil especificado serão desinstaladas.

Rollback

<rollback>
<offering profile= "id do perfil"
 id= "id da oferta"
version= "offering version">
</offering>

<!--incluir mais ofertas abaixo
<...>

</rollback>
Utilize esse comando para recuperar as ofertas especificadas na versão atualmente instalada no perfil especificado. Você não pode especificar recursos em um comando rollback.

InstallAll

<installALL/>
Nota:
Esse comando é equivalente a utilizar
-silent -installAll 
.
Utilize esse comando para procurar e instalar silenciosamente todos os pacotes disponíveis.

UpdateAll

<updateALL/>
Nota:
Esse comando é equivalente a utilizar
-silent -updateAll 
.
Utilize esse comando para procurar e atualizar silenciosamente todos os pacotes disponíveis.

License

<license policyFile="local do arquivo de
 location"/>

Por exemplo:

<license policyFile="c:\mylicense.opt"/> 
Utilize esse comando para gerar um arquivo de resposta que contém um comando de licença iniciando o assistente de licença depois de iniciar o Installation Manager no modo de registro.

Durante o modo de registro, se você configurar opções flex por meio do assistente de gerenciamento de licença, as opções que você configurar serão gravadas em um arquivo de políticas de licença denominado "license.opt", no mesmo diretório que o arquivo de resposta gerado; o arquivo de resposta conterá um comando de licença que faz referência ao arquivo de políticas.

Wizard

<launcher -mode wizard -input 
< response file >
Utilize esse comando para iniciar o Installation Manager no modo UI. O modo UI inicia o Installation Manager no assistente de instalação ou assistente de desinstalação. Contudo, nesse caso, o arquivo de resposta pode conter apenas comandos preference e install, ou preference e uninstall; não é possível misturar comandos install e uninstall no mesmo arquivo de resposta ao executar o Installation Manager no modo UI.

Atributos Adicionais de Arquivo de Resposta

Atributo de arquivo de resposta Descrição

Limpeza

<agent-input clean="true">
</agent-input>
Por padrão, clean="false". O Installation Manager utilizará o repositório e outras preferências especificadas no arquivo de resposta, bem como as preferências existentes configuradas no Installation Manager. Se uma preferência for especificada no arquivo de resposta e no Installation Manager, a que estiver no arquivo de resposta tem precedência.

Se for configurada para clean="true", o Installation Manager utilizará o repositório e outras preferências especificadas no arquivo de resposta; as preferências existentes configuradas no Installation Manager não serão utilizadas.

Temporário

<agent-input clean="true" temporary="false">
</agent-input>
Por padrão, temporary é configurado para 'false' e o conjunto de preferências no arquivo de resposta será mantido. Quando você configurar para temporary="true", o conjunto de preferências no arquivo de resposta não será mantido.

Você pode utilizar os atributos temporary e clean juntos, por exemplo, se configurar clean para true e temporary para false, após executar a instalação silenciosa, a configuração de repositório especificada no arquivo de resposta substituirá o conjunto de preferências nas sessões anteriores utilizando o Installation Manager.

Aceitação do contrato de licença

<agent-input acceptLicense="false">
</agent-input>
Por padrão, você concorda em aceitar qualquer licença que um pacote de instalação contiver ao utilizar o Installation Manager no modo de instalação silenciosa. Se você não quiser aceitar o contrato de licença, poderá utilizar um atributo adicional no elemento <agent-input> que falha automaticamente na operação de instalação silenciosa <agent-input acceptLicense="false">. Se o pacote de instalação que você está instalando tiver um contrato de licença que deve ser aceito, a operação de instalação silenciosa falhará.

Referência: Arquivo de Resposta de Amostra

Você poderá utilizar um arquivo de resposta baseado em XML, para especificar informações predefinidas, como preferências de instalação silenciosa, locais de repositório, perfis de instalação, e assim por diante. Arquivos de resposta são benéficos para equipes e empresas que desejam instalar pacotes de instalação silenciosamente e padronizar os locais e preferências para pacotes de instalação.

Arquivo de Resposta de Amostra
<agent-input >

<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled"
value="c:/temp"/>

<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location=
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
</server>
<install>
	<offering profile= "my_profile" features= "core" id= "ies"
version= "3.2.0.20060615">
	</offering>
</install>
</agent-input>

Arquivos de Log da Instalação Silenciosa

Você pode utilizar os arquivos de log da instalação silenciosa para examinar os resultados de uma sessão de instalação silenciosa.

A funcionalidade da instalação silenciosa cria um arquivo de log baseado em XML que registra o resultado da execução da instalação silenciosa (desde que o caminho do arquivo de log seja especificado utilizando -log <your log file path>.xml). Se a sessão da instalação silenciosa for concluída com êxito, o arquivo de log conterá apenas o elemento-raiz de <result> </result>. No entanto, caso ocorram erros durante a instalação, o arquivo de log da instalação silenciosa conterá elementos de erro com mensagens como:

<result>
	<error> Não é possível localizar o perfil: id de perfil</error>
	<error> Alguns outros erros</error>
</result>

Para análise dos detalhes, você pode examinar os logs gerados na área de dados do Installation Manager. Utilizando um comando de preferência, você pode configurar opcionalmente a área de dados para o seu local preferido, conforme mostrado no tópico do arquivo de resposta.