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.
- Criar o arquivo de resposta.
- 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):
- Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager. Por exemplo:
-
cd
C:\Program Files\IBM\Installation Manager\eclipse
- Para outras plataformas: cd
/opt/IBM/InstallationManager/eclipse
- 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.
- 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 .
- 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.
- 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.
- Altere diretórios para diretório temporário.
- 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:
- Descompacte o arquivo ZIP do Installation Manager e, em seguida, vá para o diretório InstallerImage_plataforma.
- 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:
- Vá para o diretório InstallerImage_plataforma no local em que descompactou o arquivo ZIP
do Installation Manager.
- Abra o arquivo install.ini, removendo as seguintes linhas: -input e @osgi.install.area/install.xml
- Digite o seguinte comando: install -record <caminho
e nome do arquivo de resposta> -skipInstall <Local_de_dados_do_agente>, por exemplo:
install -record
- 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:
-
installc
--launcher.ini silent-install.ini -log <caminho e nome do arquivo de log> .
Por exemplo: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml
- install --launcher.ini silent-install.ini
-log <caminho e nome do arquivo de log>. Por exemplo, install --launcher.ini
silent-install.ini -log /root/mylogs/mylogfile.xml
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:
-
IBMIMc.exe
--launcher.ini silent-install.ini -input <caminho e nome do arquivo de resposta>
-log <caminho e nome do arquivo de log>. Por exemplo: IBMIMc.exe --launcher.ini
silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
- IBMIM --launcher.ini silent-install.ini -input <caminho
e nome do arquivo de resposta> -log <caminho e nome do arquivo de log>. Por exemplo:
IBMIM --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml
-log /root/mylog/silent_install_log.xml
Para instalar produtos silenciosamente utilizando o instalador do Installation
Manager, no diretório eclipse, digite o seguinte comando:
-
installc.exe
--launcher.ini silent-install.ini -input <caminho e nome do arquivo de resposta>
-log <caminho e nome do arquivo de log>. Por exemplo: installc --launcher.ini
silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
- install.exe --launcher.ini silent-install.ini
-input <caminho e nome do arquivo de resposta> -log <caminho e nome do arquivo de log>.
Por exemplo: IBMIM --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml
-log /root/mylog/silent_install_log.xml
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:
- Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager.
- Digite e execute o seguinte comando, substituindo os seus próprios locais
para o arquivo de resposta e, opcionalmente, o arquivo de log:
-
IBMIMc.exe
--launcher.ini silent-install.ini -installAll -log <caminho e nome do arquivo de log>
- IBMIM --launcher.ini silent-install.ini -installAll
-log <caminho e nome do 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:
- Em uma linha de comandos, altere para o subdiretório eclipse no diretório em que deseja instalar o Installation Manager.
- Digite e execute o seguinte comando, substituindo os seus próprios locais
para o arquivo de resposta e, opcionalmente, o arquivo de log:
-
IBMIMc.exe
--launcher.ini silent-install.ini -updateAll -log <caminho e nome do arquivo de log>
- IBMIM --launcher.ini silent-install.ini -
-updateAll -log <caminho e nome do 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:
- Os Comandos de Preferência são utilizados para configurar as preferências localizadas
no Installation Manager em Arquivo -> Preferências, como as informações do local do repositório.
- Os comandos de instalação Silenciosa são utilizados para emular o
assistente dos Pacotes de Instalação no Installation Manager.
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.