Argumentos de Linha de Comandos do Installation Manager

Use a tabela a seguir para saber mais sobre os argumentos de linha de comandos do IBM Installation Manager.

Comandos do Installation Manager

Os argumentos de linha de comandos consistem em comandos e opções. É possível usar comandos sem especificar uma opção. A maioria dos comandos não usam um traço. Existem diversos comandos que começam com um traço, para que haja compatibilidade com versões anteriores do Installation Manager. Você deve especificar um comando ao usar uma opção. As opções começam com um traço.
Nota: Asteriscos (*) não devem ser usados na linha de comandos do Installation Manager. Quando é inserido um asterisco, o Installation Manager não pode reconhecer o argumento de linha de comandos e produz um erro.

A Tabela 1 lista Comandos e a Tabela 2 lista Opções.

Tabela 1: Comandos do Installation Manager

Comandos Descrição
encryptString
stringToEncrypt
Criptografa a cadeia inserida.

Na interface da linha de comandos, abra o diretório eclipse e insira o comando encryptString e uma sequência com a opção -nosplash para retornar uma sequência criptografada. A janela Utilitário de Criptografia de Sequência se abre e o campo Sequência a Ser Criptografada contém a sequência a ser criptografada. 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.

Use encryptString com -passwordKey para aumentar a segurança de criptografia.

Quando você registra um arquivo de resposta, as cadeias criptografas para senhas são criadas e armazenadas no arquivo de resposta. Um exemplo de uma sequência criptografada de um arquivo de resposta para o 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

Depois de gravar o arquivo de resposta, use encryptString para gerar e colar diferentes sequências criptografadas no 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
outputFileName
Exporta dados de instalação para o arquivo especificado no formato de archive (.zip) em que outputFileName é o nome do arquivo gerado que contém os dados exportados.

Na interface da linha de comandos, abra o diretório eclipse e insira o comando exportInstallData e o nome do arquivo com as opções -noSplash e -silent para exportar dados da instalação.

help, -help, -h, ?, -? 
	help command
	help all
Mostra uma breve descrição de argumentos de linha de comandos do Installation Manager.

Quando o comando help for usado com outro comando, será mostrada uma breve descrição do comando. Quando usado com a opção all, as descrições de todos os comandos serão exibidas.

Para compatibilidade com uma versão anterior, este comando pode ser usado com um traço: -help.

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 use input com os seguintes comandos:
  • installAll, -installAll
  • updateAll, -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
As credenciais devem ser armazenadas em um arquivo do conjunto de chaves e não em scripts de instalação silenciosa.
Lembre-se: Você pode registrar um arquivo de resposta, editar um arquivo de resposta de amostra ou criar manualmente um arquivo de resposta.

Para compatibilidade com versões anteriores, este comando pode ser usado com um traço: -input.

installAll
Importante: installAll foi descontinuado a partir do Installation Manager versão 1.4.4. É recomendável não usar este comando devido a vários possíveis problemas relacionados à instalação de diversos produtos ao mesmo tempo. Por exemplo:
  • A instalação falhará se os pacotes tiverem os mesmos diretórios de instalação padrão, mas os pacotes não puderem ser instalados no mesmo grupo de pacotes.
  • A instalação pode ser problemática para pacotes que requerem informações adicionais para instalação. O usuário deve fornecer dados necessários, usando a opção -properties que pode causar colisões de dados entre pacotes.
  • Não é possível controlar onde os pacotes de extensão são instalados.
  • A instalação de muitos pacotes ao mesmo tempo pode requerer uma quantidade significativa de espaço em disco e sua conclusão pode ser demorada.
Instale todos os pacotes em um repositório especificado.

Este comando instala todos os pacotes de todos os repositórios acessíveis em seus diretórios de instalação padrão. Ele pode instalar apenas pacotes selecionados por recursos de pacote padrão.

Não use installAll com os seguintes comandos:
  • input, -input
  • updateAll, -updateAll
updateAll
Atualize todos os pacotes instalados de repositórios de serviço e repositórios definidos nas preferências do Installation Manager.
Use o comando updateAll com:
  • -installFixes: Instalar correções.
  • -properties: Definir as propriedades do perfil do grupo de pacotes.
  • -repositories: Substituir a lista de repositórios no Installation Manager e especificar onde os pacotes estão localizados.
Não use updateAll com os seguintes comandos:
  • input, -input
  • installAll, -installAll
versão
Mostra a versão e a versão interna do Installation Manager.

Para compatibilidade com uma versão anterior, este comando pode ser usado com um traço: -version.

Tabela 2: Opções do Installation Manager

Opções Descrição
-acceptLicense
Inclua a opção -acceptLicense no comando quando o comando que está sendo instalado exigir que você aceite o contrato de licenciamento.
-accessRights, -aR
mode

em que mode=[admin, nonAdmin, group]

Define se o Installation Manager opera no modo de administrador, não administrador ou de grupo. Para o modo de administrador, use —accessRights com o parâmetro admin: -accessRights admin. Para o modo não administrador, use o argumento —accessRights com o parâmetro nonAdmin: -accessRights nonAdmin. Para o modo de grupo, use —accessRights com o parâmetro group: -accessRights group

Apenas uma instância de administrador do Installation Manager pode ser instalada. Para o modo não administrador, instale apenas uma instância do Installation Manager para cada usuário.

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 Professional que são membros do grupo de Administradores, o valor padrão é sempre -accessRights admin. Para estes usuários executarem no modo não administrador, asse 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, retroceder ou remover a mesma instância do Installation Manager. Por exemplo, User1 instala Installation Manager no diretório C:\user1\InstallationManager com direitos de acesso do administrador. Ao executar um comando para modificarInstallation Manager no diretório C:\user1\InstallationManager, User1 não deve usar o argumento -accessRights nonAdmin.

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

-dataLocation, -dL
dataLocation
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. O local do diretório configurado por -datalocation não deve ser um subdiretório do diretório de instalação do 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.
  • Se você especificar um local do diretório para -dataLocation que não seja o valor padrão, o local especificado deverá ser usado sempre que você usar o Installation Manager ou o instalador do Installation Manager. Para o instalador do Installation Manager, sempre que iniciar o instalador, você deve especificar o mesmo local do diretório usando a opção -dataLocation. A instância instalada do Installation Manager usa o local especificado automaticamente.
Exemplos quando o mesmo local do diretório deve ser usado para a opção -datalocation:
  • O Installation Manager não está instalado e você usa o instalador do Installation Manager. Sempre que iniciar o instalador, você deve especificar o mesmo local do diretório para -dataLocation. Se o mesmo local não for usado, diversos locais dataLocation serão criados e poderão ocorrer danos.
  • O Installation Manager é instalado usando o local do diretório especificado. Se você usar o instalador do Installation Manager, deverá especificar o mesmo local do diretório usando a opção -dataLocation.

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.

-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. É possível fornecer criptografia mais 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 usa a infraestrutura do Eclipse para salvar credenciais em um arquivo do conjunto de chaves. Para obter informações adicionais sobre arquivos do conjunto de chaves, consulte guia dos usuários do ambiente de trabalho do Eclipse.

Atenção: O arquivo --launcher.ini .ini foi descontinuado a partir do Installation Manager versão 1.4.3. É possível usar os seguintes comandos sem especificar um arquivo .ini: install,installc, userinst, userinstc, groupinst, groupinstc, uninstallc e uninstall.
--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 este argumento não é especificado, o Installation Manager verifica um arquivo no mesmo diretório que o ativador com o mesmo nome e a extensão .ini. Por exemplo, se installc for o ativador, o Installation Manager verificará 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á no mesmo diretório que o arquivo installc e deve estar presente.

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

Importante: A versão de arquivos silent-install.ini e user-silent-install.ini fornecida nos arquivos de instalação para o Installation Manager usa o argumento de linha de comandos input. Para usar installAll ou updateAll com estes arquivos .ini, você deve 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 as linhas -input e 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:

-toolId
isilentInstall
-accessRights
admin
-vm
jre_5.0.4.sr11_20091106a\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 Installation Manager:

-accessRights
admin
-vm
C:\Program Files\IBM\Installation
Manager\eclipse\jre_5.0.3.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 usa o argumento -input: ./install --launcher.ini silent-install.ini -input input_file_path_and_name

--launcher.suppressErrors
Suprime o diálogo de erro da Java™ virtual machine (JVM).
-log, -l
log_file
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 estiver concluída, o arquivo de log conterá o elemento-raiz de result/result. Quando ocorrerem 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.

Atenção: -mode wizard foi descontinuado a partir do Installation Manager versão 1.4.4.
-mode wizard
Executa o assistente de Instalação com o arquivo de resposta especificado. Você deve usar input ao usar -mode wizard.

Para a versão 1.4.4, use IBMIM input response_file -acceptlicense para iniciar o Assistente de instalação.

-nl
value
Ao incluir a opção nl e um código de idioma com um comando, o comportamento da linha de comandos será ajustado de acordo com as configurações para o idioma especificado.
A lista a seguir contém os códigos de idioma suportados no momento que podem ser listados como valores de código de idioma:
  • Árabe (ar)
  • Checo (cs)
  • Dinamarquês (da)
  • Inglês (en)
  • Francês (fr)
  • Alemão (de)
  • Grego (el)
  • Húngaro (hu)
  • Italiano (it)
  • Japonês (ja)
  • Coreano (ko)
  • Lituano (li)
  • Polonês (pl)
  • Português (pt_BR)
  • Russo (ru)
  • Chinês Simplificado (zh_CN)
  • Esloveno (sl)
  • Espanhol (es)
  • Chinês Tradicional (Taiwan) (zh_TW)
  • Turco (tr)
Nota: Alguns idiomas suportam apenas traduções parciais. Quando um idioma é parcialmente traduzido, o conteúdo que não é traduzido é definido por padrão como inglês.
-nosplash
Suprime a tela inicial.
-passwordKey, -pK
passwordKey
Usa passwordKey para criptografar e decriptografar senhas.
-record
responseFile
Gera um arquivo de resposta das ações na UI do Installation Manager, linha de comandos ou modo do console e especifica o local do arquivo de resposta.
-showProgress, -sP
Mostra uma barra de progresso no console.
-showVerboseProgress, -sVP
Mostra o texto de progresso no console. Por exemplo, o texto Reinicializar a máquina para concluir a instalação. é mostrado quando é necessária uma reinicialização do computador.
Atenção: A partir da versão 1.4.4, -silent foi descontinuado.
-silent, -s
  • -silent -installAll -nosplash --launcher.suppressErrors
  • -silent -updateAll -nosplash --launcher.suppressErrors
Especifica que o instalador do Installation Manager ou o Installation Manager executa em modo silencioso.
Com os comandos IBMIM, install, userinst e groupinst:
  • Use -silent -installAll -nosplash --launcher.suppressErrors para instalar silenciosamente todos os pacotes disponíveis.
  • Use -silent -updateAll -nosplash --launcher.suppressErrors para atualizar silenciosamente todos os pacotes instalados.

Não use o comando input com os comandos installAll e updateAll. Com installAll, os recursos padrão para um pacote são instalados. Para especificar os recursos que estão instalados, você deve usar input responseFile. O arquivo de resposta contém as informações sobre os recursos a serem instalados.
Nota: Quando você registra um arquivo de resposta, é possível selecionar os recursos para instalação.
Importante: installAll foi descontinuado a partir do Installation Manager versão 1.4.4. É recomendável não usar este comando devido a vários possíveis problemas relacionados à instalação de diversos produtos ao mesmo tempo. Para obter mais informações, consulteinstallAll.
-skipInstall, -sI
dataLocation
Grava um arquivo de resposta sem instalar o produto IBM. O valor dataLocation especifica o local do diretório para as pastas e arquivos de instalação. 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 dataLocation existente para o novo valor de local dataLocation. Consulte Local de Dados do Agente para obter locais padrão do diretório dataLocation.
Importante: Ao gravar um arquivo de resposta usando o argumento -skipInstall, você deve manter o diretório, pastas e arquivos criados. Mantendo o diretório dataLocation, é possível modificar a instalação posteriormente. Ao gravar um novo arquivo de resposta para modificar a instalação, especifique o mesmo diretório para dataLocation.

Use um valor dataLocation diferente para cada versão de um produto IBM instalado.

Primeiro você deve gravar uma instalação de um produto IBM usando -skipInstall antes de gravar uma atualização.

-vm
Especifica o ativador Java. No modo silencioso, sempre utilize java.exe no Windows, e java no Linux e UNIX.

Feedback