WebSphere Enterprise Service Bus, Versão 6.2.0 Sistemas Operacionais: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Parâmetros manageprofiles

Utilize os seguintes parâmetros com o comando manageprofiles para WebSphere ESB.

O arquivo de comando manageprofiles está localizado no diretório install_root/bin. O arquivo de comando é um script chamado manageprofiles para plataformas i5/OS, manageprofiles.sh para plataformas Linux® e UNIX®, ou manageprofiles.bat para plataformas Windows®.

Antes de começar a utilizar o comando manageprofiles, certifique-se de que você entende todos os pré-requisitos para criar e aumentar os perfis. Para obter informações adicionais sobre pré-requisitos, consulte Pré-requisitos para criação ou aumento dos perfis. Para obter informações adicionais sobre como criar e aumentar perfis, consulte Criando Perfis Utilizando o Comando manageprofiles e Aumentando Perfis Utilizando o Comando manageprofiles.

Atenção: Ao criar um perfil do WebSphere ESB, utilize somente os parâmetros documentados no centro de informações para o WebSphere ESB.
Nota: Todos os parâmetros fazem distinção entre maiúsculas e minúsculas.

A seguintes opções estão disponíveis para o comando manageprofiles:

-adminUserName adminUser_ID
Especifica o ID do usuário que é utilizado para segurança administrativa. Para aumentar um perfil existente que possui a segurança administrativa ativada, este parâmetro é necessário.
-adminPassword adminPassword
Especifica a senha para o ID do usuário da segurança administrativa especificado com o parâmetro -adminUserName. Para aumentar um perfil existente que possui a segurança administrativa ativada, este parâmetro é necessário.
-augment
Utilize o parâmetro augment para fazer as alterações em um perfil existente com um modelo de aumento. O parâmetro de aumento faz com que o comando manageprofiles atualize ou aumente o perfil identificado no parâmetro -profileName utilizando o modelo no parâmetro -templatePath. Os modelos de aprimoramento que você pode utilizar são determinados por quais produtos IBM® e versões estão instalados em seu ambiente.
Nota: Não modifique manualmente os arquivos localizados no diretório install_dir/profileTemplates. Por exemplo, se você estiver alterando as portas durante a criação do perfil, utilize o Profile Management Tool ou os argumentos -startingPort ou -portsFile no comando manageprofiles em vez de modificar o arquivo no diretório de modelo do perfil.
Especifique o caminho de arquivo completo para -templatePath. Por exemplo:
manageprofiles(.bat)(.sh) -augment -profileName
profile_name
 -templatePath fully_qualified_template_path
-backupProfile
Desempenha um backup de sistema de arquivos de uma pasta de perfil e o metadados de perfil a partir do arquivo de registro do perfil.

Este parâmetro não é suportado com o WebSphere ESB.

-backupFile backupFile_name
Faz backup do arquivo de registro de perfil para o arquivo especificado. Você deve fornecer um caminho de arquivo completo para backupFile_name.
-cbeServerName
O nome do servidor no qual o Common Base Event Browser do WebSphere ESB está configurado para execução.
-ceiBufferPool4k
Especifica o nome do conjunto de buffers de 4 K para Common Event Infrastructure. Esse conjunto de buffer deve estar ativo antes que os scripts DDL de banco de dados possa ser executado.
Nota: Reprovado na 6.2 para todos os bancos de dados, exceto DB2 para z/OS.
-ceiBufferPool8k
Especifica o nome do conjunto de buffers de 8 K para Common Event Infrastructure. Esse conjunto de buffer deve estar ativo antes que os scripts DDL de banco de dados possa ser executado.
Nota: Reprovado na 6.2 para todos os bancos de dados, exceto DB2 para z/OS.
-ceiBufferPool16k
Especifica o nome do conjunto de buffers de 16 K para Common Event Infrastructure. Esse conjunto de buffer deve estar ativo antes que os scripts DDL de banco de dados possa ser executado.
Nota: Reprovado na 6.2 para todos os bancos de dados, exceto DB2 para z/OS.
-ceiDbInstallDir
O diretório no qual o banco de dados está instalado para o Common Event Infrastructure. Este parâmetro será necessário apenas se você especificou true para o parâmetro dbDelayConfig.
-ceiDbName
O nome do banco de dados de eventos do Common Event Infrastructure a ser criado. Para bancos de dados DB2, Derby, Informix e Microsoft® SQL Server, o valor padrão é event se não for especificado. Para bancos de dados DB2 iSeries (i5/OS) Native, o valor padrão é *LOCAL, se não especificado. Para bancos de dados DB2 iSeries (i5/OS) Toolbox, o valor padrão é *SYSBAS, se não especificado.

Para bancos de dados Oracle, o SID (System Identifier) Oracle já deve ter sido criado e disponibilizado para o comando do serviço de eventos criar as tabelas e preencher as tabelas com dados. Quando não especificado, o valor padrão é orcl.

-ceiDbNodeName
O nome do nó DB2 (deve ter 8 caracteres ou menos) para o Common Event Infrastructure. Este nó já deve estar catalogado e configurado para comunicação com o servidor DB2. Esse parâmetro deve estar configurado se a estação de trabalho atual estiver configurada como um cliente DB2 e o parâmetro dbDelayConfig definido para true.
Nota: Reprovado na 6.2 para todos os bancos de dados, exceto o cliente DB2.
-ceiDbUser
Nota: Reprovado na versão 6.2 para todos os bancos de dados, exceto o Microsoft SQL Server.
Especifica o ID de usuário para utilização com o banco de dados de eventos do Common Event Infrastructure.
Para bancos de dados DB2, o valor padrão é db2inst1 se não for especificado. Para bancos de dados DB2 para z/OS, ele especifica o ID do usuário que possui privilégios para criar e eliminar os bancos de dados. Este parâmetro é obrigatório.
For i5/OS operating system Para bancos de dados iSeries (i5/OS), ele especifica o ID do usuário que possui privilégios para criar e eliminar os bancos de dados. Este parâmetro é obrigatório.
Para bancos de dados Derby, é o ID de usuário utilizado pela origem de dados para autenticação do banco de dados Derby. Este parâmetro será opcional quando a segurança do domínio do WebSphere estiver desativada e será necessário quando a segurança do domínio do WebSphere estiver ativada.
Para bancos de dados Informix, ele especifica o ID do usuário do esquema do banco de dados Informix que possuirá as tabelas do banco de dados do serviço de eventos. A origem de dados do WebSphere utiliza este ID de usuário para autenticar a conexão do banco de dados Informix. Este parâmetro é obrigatório.
Para bancos de dados Oracle, ele especifica o ID do usuário do esquema Oracle que possuirá as tabelas Oracle do serviço de eventos. O ID do usuário será criado durante a criação do banco de dados e a origem de dados do WebSphere utiliza este ID de usuário para autenticar a conexão do banco de dados Oracle. Quando não especificado, o valor padrão é ceiuser.
Para bancos de dados Microsoft SQL Server, ele especifica o ID do usuário do SQL Server que possuirá as tabelas do serviço de eventos. Quando não especificado, o valor padrão é ceiuser.
-dbCeiUserId
Para bancos de dados Oracle, especifica o ID do usuário do CEI.
-dbUserId
Especifica o ID de usuário para utilização com o banco de dados de eventos do Common Event Infrastructure.
Para bancos de dados DB2, o valor padrão é db2inst1 se não for especificado. Para bancos de dados DB2 para z/OS, ele especifica o ID do usuário que possui privilégios para criar e eliminar os bancos de dados. Este parâmetro é obrigatório.
For i5/OS operating system Para bancos de dados iSeries (i5/OS), ele especifica o ID do usuário que possui privilégios para criar e eliminar os bancos de dados. Este parâmetro é obrigatório.
Para bancos de dados Derby, é o ID de usuário utilizado pela origem de dados para autenticação do banco de dados Derby. Este parâmetro será opcional quando a segurança do domínio do WebSphere estiver desativada e será necessário quando a segurança do domínio do WebSphere estiver ativada.
Para bancos de dados Informix, ele especifica o ID do usuário do esquema do banco de dados Informix que possuirá as tabelas do banco de dados do serviço de eventos. A origem de dados do WebSphere utiliza este ID de usuário para autenticar a conexão do banco de dados Informix. Este parâmetro é obrigatório.
Para bancos de dados Oracle, ele especifica o ID do usuário do esquema Oracle que possuirá as tabelas Oracle do serviço de eventos. O ID do usuário será criado durante a criação do banco de dados e a origem de dados do WebSphere utiliza este ID de usuário para autenticar a conexão do banco de dados Oracle. Quando não especificado, o valor padrão é ceiuser.
Para bancos de dados Microsoft SQL Server, ele especifica o ID do usuário do SQL Server que possuirá as tabelas do serviço de eventos. Quando não especificado, o valor padrão é ceiuser.
-ceiDiskSizeInMB
O tamanho do banco de dados em MB a ser criado para o banco de dados de eventos do Common Event Infrastructure. O valor mais baixo que pode ser configurado é 10 MB. Para DB2 para z/OS, o valor padrão é 100 MB, se não especificado.
Nota: Reprovado na 6.2 para todos os bancos de dados, exceto DB2 para z/OS.
-ceiInstancePrefix
Para bancos de dados Informix, Oracle e Microsoft SQL Server, o comando utiliza o nome da instância de banco de dados de eventos do Common Event Infrastructure para agrupar os arquivos de banco de dados em um diretório com nomes exclusivos. Quando não especificado, o valor padrão é ceiinst1.
Nota: Reprovado na versão 6.2 para todos os bancos de dados, exceto Informix, Oracle, Microsoft SQL Server.
-dbLocation
O diretório do ORACLE_HOME. Este parâmetro será necessário quando o parâmetro dbDelayConfig estiver configurado como true.
-ceiOverrideDataSource
Quando este parâmetro for configurado como true, o comando remove qualquer origem de dados de serviço do Common Event Infrastructure existente no escopo especificado antes da criação de uma nova origem de dados. Quando este parâmetro é configurado como false, o comando não cria uma origem de dados de serviço de evento no escopo especificado se outra origem de dados de serviço de evento for localizada no mesmo escopo. O valor padrão é false se não for especificado.
-ceiSaUser
O ID do Microsoft SQL Server que possui privilégios para criar tabelas, dispositivos e caches para o Common Event Infrastructure. Este parâmetro será necessário se o parâmetro dbDelayConfig estiver configurado como true.
Nota: Reprovado na versão 6.2 para todos os bancos de dados, exceto o Microsoft SQL Server.
-ceiSaPassword
A senha para o ID do Microsoft SQL Server que possui privilégios para criar tabelas, dispositivos e caches para o Common Event Infrastructure. Este parâmetro é necessário se você especificar um valor para o parâmetro ceiSaUser, a menos que o ID de usuário sa não tenha uma senha.
Nota: Reprovado na versão 6.2 para todos os bancos de dados, exceto o Microsoft SQL Server.
-cellName cell_name
Especifica o nome da célula do perfil para o Common Event Infrastructure. Utilize um nome de célula exclusivo para cada perfil. Este parâmetro é apenas para criação de perfil. Não forneça este parâmetro ao aprimorar um perfil existente.
O valor padrão para este parâmetro é baseado em uma combinação do nome do host abreviado, a Célula constante e um número inicial, por exemplo:
if (DMgr)
	shortHostNameCellCellNumber
else
	shortHostNameNodeNodeNumberCell
em que CellNumber é um número seqüencial que começa em 01 e NodeNumber é o número do nó que você utilizou para definir o nome do nó.

O valor para este parâmetro não deve conter espaços ou quaisquer caracteres que não sejam válidos, tais como os seguintes: *, ?, ", <, >, ,, /, \ e |.

-configureBSpace true | false
Configura o Business Space desenvolvido com WebSphere, que fornece uma experiência do usuário integrada para usuários do aplicativo na carteira de produtos do IBM Websphere Business Process Management. O valor padrão é verdadeiro. O Business Space é suportado com os seguintes produtos de banco de dados: Derby Embedded, Derby Network Server, DB2 Universal, DB2 Universal Runtime Client, DB2 para i5/OS, DB2 para z/OS, Oracle 9i, Oracle 10g e Oracle 11g.
Importante: Se o banco de dados comum que você utiliza para o WebSphere ESB não corresponder aos bancos de dados suportados para o Business Space, o comando manageprofiles utilizará um banco de dados Derby Embedded para a configuração do Business Space. Você não pode associar esse perfil a um ambiente de implementação posteriormente, pois o Derby Embedded não é suportado para ambientes de implementação.
Para obter informações adicionais sobre como configurar o Business Space para ambientes de implementação, consulte Configurando o Business Space nas informações relacionadas.
-create
Cria o perfil.
Especifique manageprofiles -create -templatePath fully_qualified_file_path_to_template -help para obter informações específicas sobre a criação de um perfil. Os modelos disponíveis incluem:
  • default.esbserver: para um perfil do servidor independente do WebSphere Enterprise Service Bus, que define um servidor independente.
  • dmgr.esbserver: para um perfil do gerenciador de implementação do WebSphere Enterprise Service Bus, que define um gerenciador de implementação.
  • managed.esbserver: para um perfil customizado do WebSphere Enterprise Service Bus, que, quando associado a um gerenciador de implementação, define um nó gerenciado.
-dbCommonForME
Indica se deve utilizar o banco de dados Comum para mecanismos do sistema de mensagens. Para bancos de dados DB2 para z/OS, o valor padrão é true. Para todos os outros bancos de dados, o valor padrão é false. Se este parâmetro for configurado como false, os mecanismos do sistema de mensagens utilizarão um armazém de arquivos.
-dbConnectionLocation
O local do banco de dados DB2 para z/OS.
-dbCreateNew
Indica se você criará ou reutilizará um banco de dados. Os valores válidos são true ou false.
-dbDelayConfig
Indica se você adiará a criação da tabela até depois da criação do perfil. Os valores válidos são true ou false. O parâmetro é configurado como false, por padrão.
-dbDriverType
O tipo de driver do banco de dados. Para bancos de dados Oracle, os valores válidos são ORACLE_THIN ou ORACLE_OCI. Para bancos de dados DB2, os valores válidos são 2 ou 4.
-dbHostName
O nome do host ou endereço IP do servidor do banco de dados. O valor padrão é localhost.
-dbInstance
O nome da instância do banco de dados para bancos de dados Informix.
-dbJDBCClasspath
O local dos arquivos do driver JDBC.
-dbLocation
Indica o diretório da instalação do banco de dados se você estiver utilizando bancos de dados Informix. Você poderá utilizar este parâmetro apenas se o parâmetro dbCreateNew estiver configurado como true.
-dbName
O nome do banco de dados. O valor é configurado como WPRCSDB por padrão.
-dbOutputScriptDir
O local para scripts de banco de dados exportados.
-dbPassword
A senha necessária para autenticação do banco de dados. Este parâmetro é necessário para todos os bancos de dados, exceto o Derby Embedded.
-dbSchemaName
O nome do esquema do banco de dados para os bancos de dados DB2 para iSeries, DB2 para i5/OS e DB2 para z/OS.
Nota: Esse parâmetro não é válido para ser usado com o banco de dados DB2 Universal.
-dbServerPort
O número da porta do servidor de banco de dados. Dependendo do banco de dados que você está utilizando, você pode especificar um número de porta diferente em vez do número de porta padrão.
-dbStorageGroup
O nome do grupo de armazenamento para bancos de dados DB2 z/OS.
-dbType
O tipo de banco de dados.

Configure um dos seguintes valores para o tipo do produto de banco de dados que você está utilizando com o WebSphere ESB.

  • DERBY_EMBEDDED para um banco de dados Derby Embedded
  • DERBY_NETWORKSERVER para um banco de dados Derby Network Server
  • DB2_UNIVERSAL para um banco de dados DB2 Universal
  • DB2UDBOS390_V8_1 para um banco de dados DB2 para z/OS v8
  • DB2UDBOS390_V9_1 para um banco de dados DB2 para z/OS v9
  • DB2UDBISERIES_NATIVE para um banco de dados DB2 UDB para iSeries ou DB2 para i5/OS utilizando um driver Native
  • DB2UDBISERIES_TOOLBOX para um banco de dados DB2 UDB para iSeries ou DB2 para i5/OS utilizando um driver Toolbox
  • INFORMIX para um banco de dados Informix Dynamic Server
  • MSSQLSERVER_EMBEDDED para um banco de dados Microsoft SQL Server utilizando um driver Embedded
  • MSSQLSERVER_DATADIRECT para um banco de dados Microsoft SQL Server utilizando um driver DataDirect
  • MSSQLSERVER_MICROSOFT para um banco de dados do Microsoft SQL Server usando um driver Microsoft
    Nota: O suporte para o Driver JDBC do Microsoft SQL, versão 1.2 driver do Microsoft SQL Server (Microsoft) foi incluído no WebSphere Process Server, versão 6.2.0.1.
  • ORACLE9I para um banco de dados Oracle 9i
  • ORACLE10G para um banco de dados Oracle 10g ou Oracle 11g
-debug
Ativa a função de depuração do utilitário Apache Ant, que o comando manageprofiles utiliza.
-defaultPorts
Designa os valores de portas base ou padrão para o perfil.

Não utilize este parâmetro ao utilizar o parâmetro -startingPort ou -portsFile.

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto de portas recomendadas gerado automaticamente se você não especificar o parâmetro -startingPort, o parâmetro -defaultPorts ou o parâmetro -portsFile. Os valores de porta recomendados podem ser diferentes dos valores de porta padrão com base na disponibilidade das portas padrão.

Nota: Não utilize este parâmetro se você estiver utilizando o modelo de perfil gerenciado.
-delete
Exclui o perfil.

Excluir um perfil não exclui o diretório do perfil. Por exemplo, se você criar um perfil no diretório /usr/WebSphere/ESB/profiles/managedProfile ou em plataformas i5/OS, no diretório QIBM/UserData/WebSphere/ESB/profiles/managedProfile, o diretório permanecerá após a exclusão do perfil.

Você pode excluir ou deixar o diretório. Entretanto, o diretório profile_root/logs contém informações sobre a desinstalação do perfil. Por exemplo, você pode reter o arquivo _nodeuninst.log para determinar a causa de qualquer problema durante o procedimento de desinstalação.

Se você excluir um perfil que possui modelos de aprimoramento registrados para ele no registro de perfis, então as ações de cancelamento do aprimoramento são realizadas automaticamente.

-deleteAll
Exclui todos os perfis registrados.

Excluir um perfil não exclui o diretório do perfil. Por exemplo, suponha que você crie um perfil no diretório /usr/WebSphere/ESB/profiles/managedProfile ou em plataformas i5/OS, no diretório QIBM/UserData/WebSphere/ESB/profiles/managedProfile. O diretório permanece após você excluir o perfil.

Você pode excluir ou deixar o diretório. Entretanto, o diretório profile_root/logs contém informações sobre a desinstalação do perfil. Por exemplo, você pode reter o arquivo _nodeuninst.log para determinar a causa de qualquer problema durante o procedimento de desinstalação.

Se você excluir um perfil que possui modelos de aprimoramento registrados para ele no registro de perfis, então as ações de cancelamento do aprimoramento são realizadas automaticamente.

-dmgrHost dmgr_host_name
Identifica a estação de trabalho em que o gerenciador de implementação está executando. Especifique este parâmetro e o parâmetro dmgrPort para associar um perfil customizado conforme ele é criado ou aprimorado. Este parâmetro está disponível com os modelo de perfil managed.esbserver.

O nome do host pode ser o nome longo ou curto de DNS ou o endereço IP da estação de trabalho do gerenciador de implementação.

A especificação desse parâmetro opcional instrui o comando manageprofiles para tentar associar o nó customizado na célula do gerenciador de implementação ao criar o perfil customizado. Este parâmetro será ignorado durante a criação de um perfil do gerenciador de implementação ou de um perfil do servidor independente.

Se você associar um nó customizado quando o gerenciador de implementação não estiver em execução, o indicador de instalação nos logs será INSTCONFFAILED para indicar uma falha completa. O perfil customizado resultante não pode ser utilizado. Você deve mover o diretório do perfil customizado para fora do repositório de perfis (o diretório raiz da instalação do perfil) antes de criar um outro perfil customizado com o mesmo nome de perfil.

Se você tiver ativado a segurança ou alterado o tipo de conector JMX padrão, você não poderá associar com o comando manageprofiles. Utilize, então, o comando addNode.

O valor padrão para este parâmetro é localhost. O valor para este parâmetro deve ser um nome do host formato apropriadamente e não deve conter espaços ou caracteres inválidos, como os seguintes: *, ?, ", <, >, , , /, \ e |. Uma conexão com o gerenciador de implementação também deve estar disponível em conjunto com o parâmetro dmgrPort.

-dmgrPort dmgr_port_number
Identifica a porta SOAP do gerenciador de implementação. Especifique este parâmetro e o parâmetro dmgrHost para associar um perfil customizado conforme ele é criado ou aprimorado. O gerenciador de implementação deve estar em execução e acessível.

Se você tiver ativado a segurança ou alterado o tipo de conector JMX padrão, não poderá associar com o comando manageprofiles. Utilize, então, o comando addNode.

O valor padrão para este parâmetro é 8879. A porta que você indicar deverá ser um inteiro positivo e uma conexão com o gerenciador de implementação deve estar disponível em conjunto com o parâmetro dmgrHost.

-enableAdminSecurity true | false
Ativa a segurança administrativa. Os valores válidos incluem true ou false. O valor padrão é false. Se você estiver criando perfis para um ambiente de implementação, você deve configurar esse parâmetro para true. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
Quando enableAdminSecurity é configurado para true, você também deve especificar os parâmetros -adminUserName e -adminPassword juntamente com os valores desses parâmetros. Se as amostras foram instaladas durante a instalação do servidor de aplicativos, você também deverá especificar o parâmetro -samplesPassword ao criar um perfil para o qual a segurança administrativa está ativada. Se o parâmetro -samplesPassword não for especificado quando a segurança administrativa for ativada, o perfil será criado com êxito, mas quando você tentar executar as amostras, exceções e falhas serão colocadas no log de saída do sistema do servidor.
For Linux operating system -enableService true | false
Ativa a criação de um serviço Linux. Os valores válidos incluem true ou false. O valor padrão para este parâmetro é false. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.

Quando o comando manageprofiles é executado com a opção -enableService configurada como true, o serviço Linux é criado com o perfil quando o comando é executado pelo usuário root. Quando um usuário não-root executa o comando manageprofiles, o perfil é criado, mas o serviço Linux não é criado. O serviço Linux não é criado porque o usuário não-root não possui permissão suficiente para configurar o serviço. Um resultado INSTCONPARTIALSUCCESS é exibido no final da criação do perfil e o log de criação do perfil install_root/logs/manageprofiles/profile_name_create.log contém uma mensagem indicando que o usuário atual não possui permissão suficiente para configurar o serviço do Linux.

-federateLater true | false
Indica se o perfil gerenciado será associado durante a criação do perfil ou se você irá federá-lo posteriormente utilizando o comando addNode. Se você estiver criando um perfil do WebSphere ESB, não forneça um valor; utilize o padrão de true.
-federateLaterWESB true | false
Indica se o perfil gerenciado será associado posteriormente utilizando o modelo managed.wesbserver. Os valores válidos são true ou false. Se os parâmetros dmgrHost, dmgrPort, dmgrAdminUserName e dmgrAdminPassword não estiverem configurados, o valor padrão para este parâmetro será true.
-fileStoreForME true | false
Se configurado como true, o armazém de dados do armazenamento de arquivos será utilizado para os mecanismos do sistema de mensagens. O valor padrão para este parâmetro é false.
Nota: Os parâmetros -dbCommonForME e -fileStoreForME não podem ser configurados como true. Isto causa um erro de validação.
-getDefaultName
Retorna o nome do perfil padrão.
-getName
Obtém o nome para um perfil registrado em um determinado parâmetro -profilePath.
-getPath
Obtém o local do sistema de arquivos para um perfil de um nome fornecido. Necessita do parâmetro –profileName.
-help
Exibe a sintaxe do comando.
-hostName host_name
Especifica o nome do host onde o perfil está sendo criado. Não forneça este parâmetro ao aprimorar um perfil existente. Esse deve corresponder ao nome do host especificado durante a instalação do produto inicial. O valor padrão desse parâmetro é o formato longo do sistema de nomes de domínio. Este parâmetro é necessário apenas para a criação do perfil. O valor para este parâmetro deve ser um nome do host do IPv6 válido e não deve conter espaços ou caracteres inválidos, como os seguintes: *, ?, ", <, >, ,, /, \ e |.
-ignoreStack
Um parâmetro opcional que é utilizado com o parâmetro -templatePath para reduzir um perfil específico que foi aprimorado.
Nota: Utilizar perfis não-aprimorados (parâmetro -unaugment) não é suportado para WebSphere ESB.
-isDefault
Especifica se o perfil identificado pelo parâmetro -profileName deve ser o perfil padrão uma vez que ele está registrado. Ao emitir comandos que tratam do perfil padrão, não é necessário utilizar o atributo -profileName do comando.
-isDeveloperServer
Especifica se o servidor é destinado apenas para propósitos de desenvolvimento. Este parâmetro é útil ao criar perfis para o teste de aplicativos em um servidor que não seja de produção antes de implementar os aplicativos em seus servidores de aplicativos de produção. Este parâmetro é válido apenas para a criação de perfis no WebSphere ESB.
Se -isDeveloperServer estiver configurado ao criar um perfil do WebSphere ESB, será instalado um repositório de arquivo do VMM pré-configurado.
-listProfiles
Lista todos os perfis definidos.
-ndtopology
Indica se você deseja utilizar o caminho do ambiente de implementação para a criação do perfil. Os valores válidos são true ou false.
-nodeName node_name
Especifica o nome do nó para o nó criado com o novo perfil. Não forneça este parâmetro ao aprimorar um perfil existente. Use um valor exclusivo dentro da célula ou na estação de trabalho. Cada perfil que compartilha o mesmo conjunto de binários do produto deve possuir um nome do nó exclusivo. Este parâmetro é necessário para a criação do perfil apenas com os modelos default.wbiserver, dmgr.wbiserver e managed.wbiserver.
For Linux operating systemFor UNIX operating systemFor Windows operating system O valor padrão para este parâmetro tem como base o nome curto do host, tipo do perfil e um número à direita, por exemplo:
if (DMgr)
	shortHostNameCellManagerNodeNumber
else
	shortHostNameNodeNodeNumber
em que NodeNumber é um número sequencial iniciando em 01.
For i5/OS operating system Os nomes de nó padrão são os seguintes:
  • Modelo dmgr: profilenameManager
  • Modelo default: shorthostname_profilename
  • Modelo managed: shorthostname_profilename
  • cell: Consulte os exemplos de modelos dmgr e default anteriores e aplique-os conforme apropriado nos dois perfis que são criados.

O valor para este parâmetro não deve conter espaços ou caracteres inválidos, como os seguintes: *, ?, ", <, >, ,, /, \ e |, .

-omitAction feature1 feature2... featureN
Um parâmetro opcional que exclui recursos do perfil.
Cada modelo de perfil é predefinido com determinados recursos opcionais. A opção samplesInstallAndConfig está disponível apenas quando o produto é instalado com aplicativos de amostras selecionados. Os recursos opcionais a seguir podem ser utilizados com o parâmetro -omitAction para os seguintes modelos de perfis:
  • default - Servidor de aplicativos
    • deployAdminConsole
    • samplesInstallAndConfig
    • defaultAppDeployAndConfig
  • dmgr - Gerenciador de implementação
    • deployAdminConsole
-portsFile file_path
Um parâmetro opcional que especifica o caminho para um arquivo que define as configurações da porta para o novo perfil. Não forneça este parâmetro ao aprimorar um perfil existente.

Não utilize este parâmetro ao utilizar o parâmetro -startingPort ou -defaultPorts.

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto de portas recomendadas gerado automaticamente se você não especificar o parâmetro -startingPort, o parâmetro -defaultPorts ou o parâmetro -portsFile. Os valores de porta recomendados podem ser diferentes dos valores de porta padrão com base na disponibilidade das portas padrão.

-profileName profile_name
Especifica o nome do perfil. Utilize um valor exclusivo ao criar um perfil.
Cada perfil que compartilha o mesmo conjunto de binários do produto deve ter um nome exclusivo. O nome do perfil padrão tem como base o tipo de perfil e um número à direita, por exemplo:
profileType ProfileNumber
em que profileType é um valor ProcSrv, Dmgr ou Custom e ProfileNumber é um número seqüencial que cria um nome de perfil exclusivo.

O valor para este parâmetro não deve conter espaços ou caracteres inválidos, como os seguintes: *, ?, ", <, >, ,, /, \ e |. O nome do perfil que você escolhe não deve estar em uso.

-profilePath profile_root
Especifica o caminho completo para o perfil, que é referido através do centro de informações como profile_root.
Por exemplo:
-profilePath profile_root
Utilize este parâmetro ao criar apenas perfis. Não configure este parâmetro para aumentar um perfil existente.

For Windows operating system Em plataformas Windows: Se o caminho completo contiver espaços, coloque o valor entre aspas.

O valor padrão é baseado no diretório install_root, no subdiretório de perfis e no nome do arquivo.

Por exemplo, o padrão para a criação de perfil é:
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
em que WS_WSPROFILE_DEFAULT_PROFILE_HOME é definido no arquivo wasprofile.properties no diretório install_root/properties.

O valor para este parâmetro deve ser um caminho válido para o sistema de destino e não deve estar atualmente em utilização.

Você deve ter permissões para gravar no diretório.

-response response_file
Acessa todas as funções API a partir da linha de comandos utilizando o comando manageprofiles.
A interface da linha de comandos pode ser orientada por um arquivo de respostas que contém os argumentos de entrada para um determinado comando no arquivo de propriedades no formato de chave e valor. A seguir você encontra um arquivo de respostas de exemplo para uma operação de criação:
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=install_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1, myOptionalAction2
For Windows operating system Em plataformas Windows: A declaração do caminho no sistema operacional Windows pode utilizar barras (/) ou barras invertidas (\). Se a instrução de caminho utilizar barras invertidas, então o arquivo de resposta necessita de barras invertidas duplas para o arquivo de respostas compreender corretamente o caminho. Veja a seguir um exemplo de um arquivo de respostas para uma operação de criação que utiliza as barras invertidas duplas:
create
templatePath=C:\\WebSphere\\ESB\\profileTemplates\\default

Para determinar quais argumentos de entrada são necessários para os diversos tipos de modelos de perfil e ação, utilize o comando manageprofiles com o parâmetro -help.

-restoreProfile
Restaura o backup de um perfil. Deve ser utilizado com o parâmetro -backupFile. Este parâmetro não é suportado com o WebSphere ESB.
-samplesPassword samplesPassword
Cria uma senha a ser utilizada para amostras. A senha é utilizada para restringir o acesso a amostras de aplicativos da Web instalados durante a instalação do servidor de aplicativos.
For Linux operating system -serviceUserName service_user_ID
Especifica o ID do usuário que é utilizado durante a criação do serviço Linux para que o serviço Linux seja executado sob este ID do usuário. O serviço Linux é executado sempre que o ID de usuário efetuar logon.
-setDefaultName
Configura o perfil padrão para um dos perfis existentes. Deve ser utilizado com o parâmetro -profileName, por exemplo:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-startingPort Porta_inicial
Especifica o número da porta inicial para geração e designação de todas as portas para o perfil.

Não configure este parâmetro se você estiver aumentando um perfil existente. Os valores de portas são designados sequencialmente a partir do valor -startingPort, omitindo essas portas que já estão em uso. Em todos os sistemas, exceto no i5/OS, o sistema reconhece e resolve portas que estão atualmente em uso e determina as designações de portas para evitar conflitos de portas.

Não utilize este parâmetro com os parâmetros -defaultPorts ou -portsFile.

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto de portas recomendadas gerado automaticamente se você não especificar o parâmetro -startingPort, o parâmetro -defaultPorts ou o parâmetro -portsFile. Os valores de porta recomendados podem ser diferentes dos valores de porta padrão com base na disponibilidade das portas padrão.

Nota: Não utilize este parâmetro se você estiver utilizando o modelo de perfil gerenciado.
-templatePath template_path
Especifica o caminho do diretório para os arquivos de gabarito no diretório raiz da instalação. No diretório profileTemplates estão vários diretórios que correspondem a diferentes tipos de perfis e que variam com o tipo do produto instalado. Os diretórios de perfil são os caminhos que você indica ao utilizar a opção -templatePath. Você pode especificar modelos de perfis que ficam fora da raiz da instalação, se houver algum.

Utilize caminhos absolutos. Este parâmetro deve existir como um diretório e apontar para um diretório de modelo válido.

Utilize os seguintes modelos com WebSphere ESB:
  • default.esbserver: para um perfil do servidor independente do WebSphere Enterprise Service Bus, que define um servidor independente.
  • dmgr.esbserver: para um perfil do gerenciador de implementação do WebSphere Enterprise Service Bus, que define um gerenciador de implementação.
  • managed.esbserver: para um perfil customizado do WebSphere Enterprise Service Bus, que, quando associado a um gerenciador de implementação, define um nó gerenciado.
-topologyPattern
Determina os padrões do ambiente de implementação para o gerenciador de implementação que você está criando. Os valores válidos são CondensedSync, CondensedAsync ou Reference.
-topologyRole
Indica a função que o perfil representará no ambiente de implementação quando estiver federando um perfil que foi criado. Os valores válidos são ADT para um destino de implementação, Messaging para o sistema de mensagens do host ou Support para serviços de suporte. Você pode indicar um valor ou mais de um valor, cada um separado por um espaço, por exemplo Suporte ao Sistema de Mensagens ADT ou Sistema de Mensagens ou Suporte ao ADT.
-unaugment
Nota: Utilizar perfis não-aprimorados (parâmetro -unaugment) não é suportado para WebSphere ESB.
-validateAndUpdateRegistry
Verifica todos os perfis que estão listados no registro de perfis para ver se os perfis estão presentes no sistema de arquivos. Remove quaisquer perfis ausentes do registro. Retorna uma lista dos perfis ausentes que foram excluídos do registro.
-validateRegistry
Verifica todos os perfis que estão listados no registro de perfis para ver se os perfis estão presentes no sistema de arquivos. Retorna uma lista dos perfis ausentes.
-validatePorts
Especifica que as portas devem ser validadas para garantir que elas não estejam reservadas ou em uso. Este parâmetro ajuda você a identificar portas que não estão sendo utilizadas. Se uma porta for determinada para estar em uso, a criação do perfil é parada e uma mensagem de erro é exibida. Você pode utilizar este parâmetro a qualquer momento na linha de comandos de criação. É recomendado utilizar este parâmetro com o parâmetro –portsFile.
-webServerCheck true | false
Indica se você deseja configurar definições do servidor da Web. Os valores válidos incluem true ou false. O valor padrão para este parâmetro é false. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerHostname webserver_host_name
O nome do host do servidor. O valor padrão desse parâmetro é o nome do host longo da estação de trabalho local. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerInstallPath webserver_installpath_name
O caminho de instalação do servidor da Web, local ou remoto. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
O valor padrão para esse parâmetro é dependente do sistema operacional da estação de trabalho local e do valor do parâmetro webServerType. Por exemplo:
For AIX operating system
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath definido por padrão como “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath definido por padrão como “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “?”
webServerType=APACHE: webServerInstallPath defaulted to “?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath definido por padrão como “n/a”

For HP-UX operating system
webServerType=IHS: webServerInstallPath definido por padrão como “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath definido por padrão como “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath definido por padrão como “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath definido por padrão como “”
webServerType=APACHE: webServerInstallPath definido por padrão como “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath definido por padrão como “n/a”

For Linux operating system
webServerType=IHS: webServerInstallPath definido por padrão como “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath definido por padrão como “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath definido por padrão como “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath definido por padrão como “”
webServerType=APACHE: webServerInstallPath definido por padrão como “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath definido por padrão como “n/a”

For Solaris operating system
webServerType=IHS: webServerInstallPath definido por padrão como “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath definido por padrão como “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath definido por padrão como “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath definido por padrão como “”
webServerType=APACHE: webServerInstallPath definido por padrão como “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath definido por padrão como “n/a”

For Windows operating system
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “C:\”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\”
webServerType=DOMINO: webServerInstallPath definido por padrão como “”
webServerType=APACHE: webServerInstallPath definido por padrão como “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath definido por padrão como “n/a”
-webServerName webserver_name
O nome do servidor da Web. O valor padrão deste parâmetro é webserver1. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerOS webserver_operating_system
O sistema operacional no qual o servidor da Web reside. Os valores válidos são: windows, linux, solaris, aix, hpux, os390 e os400. Utilize este parâmetro com o parâmetro webServerType.
Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerPluginPath webserver_pluginpath
O caminho para os plug-ins que o servidor da Web utiliza. O valor padrão para este parâmetro é install_root/plugins. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerPort webserver_port
Indica a porta a partir da qual o servidor da Web será acessado. O valor padrão para este parâmetro é 80. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
-webServerType webserver_type
O tipo do servidor da Web. Os valores válidos são: IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE e HTTPSERVER_ZOS. Utilize este parâmetro com o parâmetro webServerOS. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
For Windows operating system -winserviceAccountType specifieduser | localsystem
O tipo da conta do proprietário do serviço Windows criado para o perfil. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
Os valores válidos são specifieduser ou localsystem. O valor localsystem executa o serviço Windows sob a conta local do usuário que cria o perfil. O valor padrão para este parâmetro é system.
For Windows operating system -winserviceCheck true | false
O valor pode ser true ou false. Especifique true para criar um serviço Windows para o processo do servidor que é criado dentro do perfil. Especifique false para não criar o serviço Windows. O valor padrão para este parâmetro é false.
Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
For Windows operating system -winservicePassword winservice_password
Especifique a senha para o usuário especificado ou a conta local que deve ser proprietária do serviço Windows. Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.
For Windows operating system -winserviceStartupType manual | automatic | disabled
Os valores possíveis para a inicialização do serviço Windows são:
  • manual
  • automática
  • desativado

O valor padrão para este parâmetro é manual.

Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.

For Windows operating system -winserviceUserName winservice_user_ID
Especifique o seu ID de usuário para que o sistema operacional Windows possa verificar você como um ID que é capaz de criar um serviço Windows. Seu ID do usuário deve pertencer ao grupo de Administradores e ter os seguintes direitos de usuário avançado:
  • Agir como Parte do Sistema Operacional
  • Efetuar logon como um serviço
O valor padrão para este parâmetro é o nome de usuário atual. O valor para este parâmetro não deve conter espaços ou caracteres inválidos, como os seguintes: *, ?, ", <, >, ,, /, \ e |. O usuário que você especificar deve ter as permissões apropriadas para criar um serviço Windows. Você deve especificar a senha correta para o nome de usuário que você escolher.
Utilize este parâmetro ao criar apenas perfis. Não forneça este parâmetro ao aprimorar um perfil existente.

reference Tópico de Referência

Termos de Uso | Feedback


Ícone de registro de data e hora Última Atualização: 01 julho 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rins_manageprofiles_parms.html
Copyright IBM Corporation 2005, 2010. Todos os Direitos Reservados.
Este Centro de Informações foi desenvolvido com tecnologia Eclipse (http://www.eclipse.org).