Argumentos de Linha de Comandos do IBM Installation Manager

Utilize essa tabela de referências para aprender mais sobre os argumentos de linha de comandos do Installation Manager.

Argumento Descrição
-accessRights Define se o Installation Manager funciona no modo administrador ou não-administrador. Para o modo não-administrador, utilize o argumento —accessRights com o parâmetro nonAdmin: -accessRights nonAdmin Para o modo administrador, utilize —accessRights com o parâmetro admin: -accessRights admin.
Se —accessRights não for utilizado, o valor-padrão é definido com base nas permissões de usuário atuais.
Nota:
Para usuários do Microsoft Windows XP que são membros do grupo de Administrador, o valor-padrão é sempre -accessRights admin. Para esses usuários executarem no modo não-administrador, passe o argumento -accessRights nonAdmin explicitamente.

O Installation Manager relata um erro quando o usuário não tem permissões de sistema apropriadas.

Atenção: Não altere este argumento ao instalar, modificar, atualizar, retroceder ou desinstalar a mesma instância do Installation Manager. Por exemplo, User1 instala Installation Manager no diretório C:\user1\InstallationManager com direitos de acesso de administrador. Quando executar um comando para modificar o Installation Manager no diretório C:\user1\InstallationManager, User1 não deve utilizar o argumento -accessRights nonAdmin.

Para obter informações sobre como instalar como um administrador ou não-administrador, consulte Instalando como um Administrador ou Não-Administrador.

-dataLocation <agentDataLocation> Especifica o local do diretório para o diretório de dados do Installation Manager. Este local armazena informações sobre pacotes instalados. Configure este local ao instalar o Installation Manager.
Atenção: Não altere este argumento após o Installation Manager ser instalado. Alterar este argumento pode danificar os dados de instalação. Esse dano pode impedi-lo de modificar, atualizar, retroceder ou desinstalar pacotes instalados.

Para obter informações sobre os tipos de arquivos e informações armazenadas no local de dados do agente, consulte Local de Dados do Agente.

-encryptString stringToEncrypt Criptografa a cadeia inserida. Use -encryptString com-passwordKey para aumentar a segurança da criptografia.

Na interface com o usuário, o seguinte comando abre a janela Utilitário de Criptografia de Cadeia: IBMIM -encryptString password em que password é a cadeia que está criptografada. Na janela Utilitário de Criptografia de Cadeia, o campo Cadeia a ser criptografada contém a cadeia a criptografar. O campo Versão criptografada da cadeia contém o valor criptografado para copiar no arquivo de resposta. No Utilitário de Criptografia de Cadeia, você pode alterar o campo Cadeia a ser criptografada, e então clicar em OK para gerar uma nova cadeia criptografada.

Na interface da linha de comandos, o seguinte comando retorna a cadeia criptografada na linha de comandos:IBMIM -silent -noSplash -encryptString password em que password é a cadeia que está criptografada.

Quando você registra um arquivo de resposta, as cadeias criptografas para senhas são criadas e armazenadas no arquivo de resposta. value contém a cadeia criptografada.

Um exemplo de uma cadeia criptografada a partir de um arquivo de resposta para IBM Rational ClearCase:
<profile installLocation='C:Program Files\IBM\RationalSDLC' id="IBM Rational SDLC'>
<data key='user.CC_ServerProcessPassword,com.ibm.rational.clearcase.nt_i386' value='1ML/Coqkg33e5616BcUnYg=='
</profile>

Após gravar o arquivo de resposta, utilize -encryptString para gerar e colar diferentes cadeias criptografadas dentro do arquivo de resposta. Por exemplo, você registra um arquivo de resposta. Você tem cinco computadores para instalar um produto IBM utilizando o arquivo de resposta. Cada um dos cinco computadores requer um valor de senha diferente para uma chave de dados no arquivo de resposta. Antes de executar a instalação em um dos computadores, gere a cadeia criptografada para a senha a ser utilizada no computador. Copie a cadeia criptografada no arquivo de resposta. Inicie a instalação silenciosa com o arquivo de resposta atualizado.

-exportInstallData <InstallDataFile> Exporta os dados da instalação para o arquivo especificado em um formato de arquivo .zip.
É possível usar este argumento para gerar um arquivo .zip que contém dados para análise de problema.
  • Windows: IBMIMc.exe --launcher.ini silent-install.ini -exportInstallData <installDataFile>
  • Linux e UNIX: IBMIM --launcher.ini silent-install.ini -exportInstallData <installDataFile>
em que <installDataFile> é o nome do arquivo gerado que contém os dados exportados.
-help Exibe uma breve descrição dos argumentos da linha de comandos doInstallation Manager.
-ignoreRepositoryDigest Direciona o Installation Manager a ignorar o arquivo de compilação do repositório, repository.xml, quando acessar repositórios.
-input <responseFile> Especifica um arquivo de resposta XML como a entrada para o Installation Manager ou o instalador do Installation Manager. O arquivo de resposta contém comandos que o Installation Manager ou o instalador do Installation Manager executa.

Não é possível usar -input com -installAll ou -updateAll

Você pode utilizar um caminho de arquivo ou uma URL para o valor <responsefile>. Esses exemplos mostram os caminhos de arquivo e as cadeias URL:
  • Caminho de arquivo:
    • Windows: -input C:\response_files\myresponsefile.xml
    • Linux e UNIX: -input /response_files/myresponsefile.xml
  • URL: -input http://server/response_files/myresponsefile.xml
Lembre-se: Você pode registrar um arquivo de resposta, editar um arquivo de resposta de amostra ou criar manualmente um arquivo de resposta.
-keyring <file> [-password <password>] Quando especificado, faz com que o Eclipse crie o arquivo do conjunto de chaves se um arquivo do conjunto de chaves não existir. O argumento -password <password> é opcional. Se a senha não estiver especificada, o Eclipse utiliza uma senha padrão. Você pode fornecer uma criptografia avançada especificando uma senha para abrir o arquivo do conjunto de chaves.

O conteúdo do arquivo do conjunto de chaves é criptografado. É necessário ter permissões de gravação para o arquivo do conjunto de chaves.

O Installation Manager utiliza a infraestrutura do Eclipse para salvar credenciais em um arquivo do conjunto de chaves. Para obter informações adicionais sobre os arquivos do conjunto de chaves, consulte o Eclipse workbench user's guide disponível em http://www.eclipse.org.

--launcher.ini <.ini file>
Exemplos
  • --launcher.ini silent-install.ini
  • --launcher.ini silent-uninstall.ini
  • --launcher.ini user-silent-install.ini
  • --launcher.ini user-silent-uninstall.ini
Especifica o local do arquivo .ini do produto a ser utilizado. Quando esse argumento não estiver especificado, o Installation Manager verifica um arquivo no mesmo diretório como o ativador que tem o mesmo nome e a extensão ".ini". Por exemplo, se installc.exe for o ativador, o Installation Manager verifica installc.ini.

O arquivo silent-install.ini contém os parâmetros de inicialização para instalação silenciosa. O arquivo silent-install.ini está localizado no mesmo diretório que o arquivo installc.exe e deve estar presente.

O arquivo user-silent-install.ini é utilizado para uma instalação não-administrador.

O arquivo user-silent-uninstall.ini é usado para um procedimento de desinstalação não-administrador.

Importante: A versão dos arquivos silent-install.ini e user-silent-install.ini fornecidos nos arquivos de instalação do Installation Manager utiliza o argumento de linha de comandos -input. Para usar -installAll ou -updateAll com esses arquivos .ini, é necessário remover duas linhas: a linha -input e a linha que aponta para o arquivo de resposta. Um exemplo das duas linhas para remover:
-input
@osgi.install.area\install.xml
Se -input e as linhas do arquivo de resposta não forem removidas, os argumentos de linha de comandos -installAll e -updateAll não funcionarão.

Os arquivos .ini no diretório de instalação do Installation Manager não utilizam o argumento de linha de comandos -input .

Um exemplo de um arquivo silent-install.ini dos arquivos de instalação para Installation Manager:
-accessRights
admin
-vm
jre_5.0.2.sr8a_20080811b\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-input
@osgi.install.area\install.xml
-vmargs
-Xquickstart
-Xgcpolicy: gencon
Um exemplo de um arquivo silent-install.ini do diretório de instalação Installation Manager:
-accessRights
admin
-vm
C:\Program Files\IBM\Installation
Manager\eclipse\jre_5.0.2.sr8a_20080811b\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-vmargs
-Xquickstart
-Xgcpolicy: gencon

Se você executar um comando que utiliza o argumento -input e o arquivo .ini que você utiliza também contém o argumento -input, o arquivo de resposta que o argumento -input no comando especifica é utilizado. O arquivo de resposta que o argumento -input no arquivo .ini especifica é ignorado. Um exemplo de um comando que utilizar o argumento -input: ./install --launcher.ini silent-install.ini -input <caminho e nome do arquivo de entrada>

--launcher.suppressErrors Suprime o diálogo de erro da Java virtual machine (JVM).
-log (Opcional) Especifica um arquivo de log que registra o resultado da instalação silenciosa. O arquivo de log é um arquivo XML.

Quando sua instalação silenciosa está concluída, o arquivo de log contém o elemento-raiz do <result> </result>. Quando ocorrem erros durante a instalação, o arquivo de log de instalação silenciosa conterá elementos e mensagens de erro:

Não utilize -log quando gravar um arquivo de resposta.

-mode wizard Executa o assistente de instalação com o arquivo de resposta especificado. Você deve usar -input ao usar -mode wizard.
-nosplash Suprime a tela inicial.
-passwordKey

Abre uma janela para o usuário inserir uma chave da senha. A chave de senha é usada para criptografar ou decriptografar campos que necessitam de criptografia.

O uso de -passwordKey sem especificar <passwordKey> é suportado para o modo GUI apenas. Para instalações silenciosas, é necessário usar -passwordKey <passwordKey>.
-passwordKey <passwordKey> Usa <passwordKey> para criptografar e decriptografar senhas.
-record <responseFile> Especifica o local do arquivo de resposta.
-showProgress Exibe uma barra de progresso no console.
-ShowVerboseProgress Exibe texto de progresso no console. Por exemplo, o texto Reinicializar a máquina para concluir a instalação. é exibido quando a reinicialização do computador for necessária.
-silent
  • -silent -installAll
  • -silent -updateAll
Especifica que o instalador do Installation Manager ou o Installation Manager executa em modo silencioso.

Use -silent -installAll para instalar silenciosamente todos os pacotes disponíveis.

Use -silent -updateAll para atualizar silenciosamente todos os pacotes instalados.

Você não pode usar -input com -installAll e -updateAll. Com -installAll, os recursos padrão para um pacote são instalados. Para especificar quais recursos estão instalados, você deve usar -input <responseFile>. O arquivo de resposta contém as informações sobre quais recursos serão instalados.
Nota: Quando você registra um arquivo de resposta, é possível selecionar os recursos para instalação.
-skipInstall <agentDataLocation> Grava um arquivo de resposta sem instalar o produto IBM. O valor agentDataLocation especifica o local do diretório para as pastas de instalação e arquivos. Embora o produto IBM não esteja instalado, os arquivos e pastas que são necessários para instalação são criados e armazenados no diretório especificado. O diretório deve ser gravável.

Verifique se os caminhos de arquivo no argumento existem. O Installation Manager não cria diretórios para arquivos de resposta.

Atenção: Não especifique um diretório agentDataLocation existente para o novo valor de local agentDataLocation. Consulte o Local de Dados do Agente para os locais padrões do diretório agentDataLocation.
Importante: Quando você grava um arquivo de resposta usando o argumento -skipInstall, é necessário manter o diretório, pastas e arquivos que são criados. Mantendo o diretório agentDataLocation, você pode modificar a instalação posteriormente. Quando você grava um novo arquivo de resposta para modificar a instalação, especifique o mesmo diretório para agentDataLocation.

Utilize um valor agentDataLocation diferente para cada versão de produto IBM que você instala.

É necessário primeiro gravar uma instalação de um produto IBM usando -skipInstall antes de gravar uma atualização.

-version Imprime a versão do aplicativo e depois sai.
-vm Especifica o ativador Java. No modo silencioso, sempre utilize java.exe no Windows, e java no Linux e UNIX.

Feedback