[AIX Solaris HP-UX Linux Windows][IBM i]

Comando manageprofiles

Utilize o comando manageprofiles para criar, excluir, aumentar, fazer backup e restaurar perfis, os quis definem ambientes de tempo de execução. Utilizar perfis em vez de várias instalações do produto economiza espaço em disco e simplifica a atualização do produto, visto que um único conjunto de arquivos do produto principal é mantido.

[AIX Solaris HP-UX Linux Windows]O comando manageprofiles e sua interface gráfica com o usuário, o Profile Management Tool, são as únicas maneiras de criar ambientes de tempo de execução.

O arquivos de comandos está localizado no diretório app_server_root/bin. O arquivos de comandos é um script denominado manageprofiles.

Nota: A criação de um perfil executando o manageprofiles.sh diretamente não é suportada no z/OS.
Lembre-se: Se você usar esse comando com o modelo de perfil gerenciado, os servidores de aplicativos não serão criados. Entretanto, as portas ainda serão utilizadas se você for associar um nó.
Importante: O comportamento padrão para manageprofiles é criar arquivos com permissões de 755, ignorando o umask em todo o sistema. Se você desejar modificar essas permissões, use o comando chmod cada vez que você passar o perfil de um usuário para outro.

Sintaxe

O comando manageprofiles é utilizado para desempenhar as seguintes tarefas:
  • criar um perfil (-create)
  • excluir um perfil (-delete)
  • aumentar um perfil (-augment)
  • desfazer o aumento de um perfil (-unaugment)
  • reduzir todos os perfis que foram aumentados com um modelo de aumento específico (-unaugmentAll)
  • excluir todos os perfis (-deleteAll)
  • listar todos os perfis (-listProfiles)
  • listar aumentos para um perfil (-listAugments)
  • obter o nome de um perfil (-getName)
  • obter o caminho de um perfil (-getPath)
  • validar um registro de perfil (-validateRegistry)
  • validar e atualizar um registro de perfil (-validateAndUpdateRegistry)
  • obter o nome do perfil padrão (-getDefaultName)
  • fazer backup de um perfil (-backupProfile)
  • restaurar um perfil (-restoreProfile)
  • executar as tarefas do comando manageprofiles contidas em um arquivo de resposta (-response)
Para obter ajuda detalhada, incluindo os parâmetros obrigatórios para cada uma das tarefas realizadas com o comando manageprofiles, utilize o parâmetro -help. O exemplo a seguir utiliza o parâmetro help com o comando manageprofiles -augment em sistemas operacionais Windows:
app_server_root\bin\manageprofiles.bat -augment -help

Dependendo da operação que você deseja executar com o comando manageprofiles, será necessário fornecer um ou mais dos seguintes parâmetros. A ferramenta de linha de comandos valida se os parâmetros obrigatórios foram fornecidos e se os valores digitados para esses parâmetros são válidos. Certifique-se de digitar o nome dos parâmetros com a capitalização correta, pois a ferramenta de linha de comandos não valida a capitalização do nome do parâmetro. Podem ocorrer resultados incorretos quando a capitalização do parâmetro não for digitada corretamente.

  • -adminPassword adminPassword
  • -adminUserName adminUser_ID
  • -applyPerfTuningSetting standard | peak | development
  • -appServerNodeName application_server_node_name
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name (Parâmetro Opcional)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword password
  • -dmgrAdminUserName user_name
  • -dmgrHost dmgr_host_name (Parâmetro Opcional)
  • -dmgrPort dmgr_port_number
  • -dmgrProfilePath dmgr_profile_path
  • -enableAdminSecurity true | false
  • [Linux]-enableService true | false
  • -federateLater true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName host_name
  • -ignoreStack (Parâmetro Opcional)
  • -importPersonalCertKS keystore_path
  • -importPersonalCertKSAlias keystore_alias
  • -importPersonalCertKSPassword keystore_password
  • -importPersonalCertKSType keystore_type
  • -importSigningCertKS keystore_path
  • -importSigningCertKSAlias keystore_alias
  • -importSigningCertKSPassword keystore_password
  • -importSigningCertKSType keystore_type
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword keystore_password
  • -listAugments
  • -listProfiles
  • -nodeDefaultPorts
  • -nodeName node_name
  • -nodePortsFile node_ports_file_path
  • -nodeProfilePathnode_profile_path
  • -omitAction feature1 feature2... featureN (Parâmetro Opcional)
  • -personalCertDN distinguished_name
  • -personalCertValidityPeriod validity_period (Parâmetro Opcional)
  • -portsFile file_path (Parâmetro Opcional)
  • -profileName profile_name
  • -profilePath profile_root
  • -response response_file
  • -restoreProfile
  • -securityLevel security_level
  • -serverName server_name
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • [Linux]-serviceUserName service_user_ID
  • -setDefaultName
  • -signingCertDN distinguished_name
  • -signingCertValidityPeriod validity_period (Parâmetro Opcional)
  • -startingPort starting_port | -portsFile ports_file_path | -defaultPorts
  • -supportedProtocols supported_protocols
  • -templatePath template_path
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -webServerHostnamewebserver_host_name
  • -webServerInstallPath webserver_installpath_name
  • -webServerName webserver_name
  • -webServerOS webserver_operating_system
  • -webServerPluginPath webserver_plugin_path
  • -webServerPort webserver_port
  • -webServerType webserver_type
  • [Windows]-winserviceAccountType specifieduser | localsystem
  • [Windows]-winserviceCheck true | false
  • [Windows]-winservicePassword winservice_password
  • [Windows]-winserviceStartupType manual | automatic | disabled
  • [Windows]-winserviceUserName winservice_user_ID
O exemplo a seguir utiliza o comando manageprofiles -create em sistemas operacionais, como AIX ou Linux:
app_server_root/bin/manageprofiles.sh -create 
   -profileName profile_name 
   -profilePath profile_root 
   -templatePath template_path 

Parameters

As opções a seguir estão disponíveis para o comando manageprofiles:

-adminPassword adminPassword
Especifique a senha do ID do usuário de segurança administrativa especificado com o parâmetro -adminUserName.
-adminUserName adminUser_ID
Especifique o ID do usuário utilizado para segurança administrativa.
-applyPerfTuningSetting option
Especifica a configuração do ajuste de desempenho que corresponde mais estreitamente ao tipo de ambiente no qual o servidor de aplicativos será executado.

Este parâmetro é válido apenas para o modelo de perfil padrão.

padrão
As configurações standard são as definições de configuração padrão prontas para uso, otimizadas para uso de propósito geral.
peak
As configurações de desempenho de pico são otimizadas para um ambiente de produção no qual as mudanças no aplicativo são raras e o desempenho de tempo de execução ideal é importante.
desenvolvimento
As configurações de desenvolvimento são otimizadas para um ambiente de desenvolvimento no qual atualizações de aplicativo frequentes são executadas e existe um mínimo de recursos do sistema.
Importante: Não use as configurações de desenvolvimento para servidores de produção.

Se você não especificar uma opção com o parâmetro -applyPerfTuningSetting, o valor padrão será standard.

Se você especificar os parâmetros -isDeveloperServer e -applyPerfTuningSetting, dependendo da opção selecionada para -applyPerfTuningSetting, -applyPerfTuningSetting poderá substituir -isDeveloperServer.

-appServerNodeName application_server_node_name
Especifica o nome do nó do servidor de aplicativos que você está federando na célula. Especifique esse parâmetro ao criar a parte do gerenciador de implementação da célula e ao criar a parte do servidor de aplicativos da célula.
-augment
Utilize o parâmetro augment para fazer as mudanças em um perfil existente com um modelo de aumento. O parâmetro augment 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 aumento que você pode utilizar são determinados pelos produtos IBM® e versões que estão instalados em seu ambiente.
Importante: Os modelos que são incluídos com o produto WebSphere Application Server Network Deployment podem ser usados somente para criar perfis e não para aumentar os perfis existentes porque somente os modelos de criação são enviados com o produto.

Além disso, não modifique manualmente os arquivos que estão localizados no diretório install_dir/ profileTemplates. Se você estiver alterando as portas durante a criação de perfil, por exemplo, use os argumentos -startingPort ou -portsFile no comando manageprofiles em vez de modificar o arquivo no diretório de modelo de perfil.

[AIX Solaris HP-UX Linux Windows]Especifique o caminho de arquivo completo para -templatePath. Exemplo:
 manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath template_path
Você poderá especificar um caminho relativo para o parâmetro -templatePath se os modelos de perfil forem relativos ao diretório app_server_root/profileTemplates. Caso contrário, especifique o caminho completo do modelo. Exemplo:
 manageprofiles -augment -profileName profile_name -templatePath template_path

Consulte também o parâmetro -unaugment.

-backupFile backupFile_name
Faz backup do arquivo de log de perfis no arquivo especificado. Você deve fornecer um caminho de arquivo completo para o backupFile_name.
-backupProfile
Executa um backup do sistema de arquivo de uma pasta de perfil e dos metadados de perfil do arquivo de registro de perfil. Todos os servidores que utilizam o perfil do qual você deseja fazer o backup devem primeiramente ser parados antes de chamar o comando manageprofiles com a opção -backupProfile. O parâmetro -backupProfile deve ser utilizado com os parâmetros -backupFile e -profileName, por exemplo:
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

Ao fazer backup de um perfil utilizando a opção -backupProfile, primeiro você deve parar o servidor e os processos em execução para o perfil do qual você deseja fazer backup.

-cellName cell_name (Parâmetro Opcional)
Especifica o nome da célula do perfil. Utilize um nome de célula exclusivo para cada perfil.
Evitar Problemas Evitar Problemas: Use um nome exclusivo mesmo se planejar federar o perfil customizado ou perfil independente a uma célula do gerenciador de implementação. A federação requer nomes de células exclusivos antes que ele possa tornar o nó parte da célula do gerenciador de implementação. Um nome de célula deve ser exclusivo em qualquer circunstância em que o produto esteja em execução na mesma máquina física ou cluster de máquinas, como um sysplex. Além disso, um nome de célula deve ser exclusivo em qualquer circunstância em que a conectividade de rede entre entidades seja requerida entre as células ou de um cliente que deve se comunicar com cada uma das células. Os nomes de célula também deverão ser exclusivos se seus espaços de nomes estiverem associados. Caso contrário, você pode encontrar sintomas, como um erro javax.naming.NameNotFoundException, nesse caso, crie células denominadas exclusivamente.gotcha

Este é um parâmetro opcional. Se você omitir o parâmetro, um nome de célula padrão é designado.

[AIX Solaris HP-UX Linux Windows]O valor padrão para esse parâmetro tem como base uma combinação do nome abreviado do host, a célula constante e um número final:
  • Perfil do servidor de aplicativos: Nenhum
  • Perfil customizado: Nenhum
  • Perfil de gerenciamento com o servidor do gerenciador de implementação: shortHostNameCellCellNumber
  • Perfil de gerenciamento com o servidor do gerenciador de tarefa: shortHostNameJobMgrCellCellNumber
  • Perfil de gerenciamento com o servidor do agente administrativo: shortHostNameAACellCellNumber
  • Perfil da célula, parte do servidor de aplicativos: shortHostNameCellCellNumber
  • Perfil da célula, parte do gerenciador de implementação: shortHostNameCellCellNumber
  • Perfil de proxy seguro: Nenhum
em que CellNumber é um número sequencial que começa em 01.
[IBM i]Os nomes de célula padrão são:
  • modelo dmgr: profilenameNetwork
  • modelo padrão: shorthostname_profilename
  • modelo gerenciado: shorthostname_profilename
  • modelo cell: O mesmo que o exemplo de dmgr anterior para os dois perfis criados.

O valor deste parâmetro não deve conter espaços nem caracteres inválidos como a seguir: *, ?, ", <, >,,, /, \, |, e assim por diante.

-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:
  • cell - Célula do gerenciador de implementação (dmgr e default)
  • management - Gerenciamento. Utilize em conjunto com o parâmetro -serverType para indicar o tipo de perfil de gerenciamento.
  • secureproxy- Proxy seguro
  • default - Servidor de aplicativos
  • managed - Customizado
-debug
Ativa a função de depuração do utilitário Ant, que o comando manageprofiles utiliza.
-personalCertValidityPeriod validity_period (Parâmetro Opcional)
Um parâmetro opcional que especifica a quantidade de tempo em anos que o certificado pessoal padrão é válido. Se você não especificar esse parâmetro com o parâmetro -personalCertDN, o certificado pessoal padrão será válido por um ano.
-defaultPorts
Designa os valores de porta base ou padrão para o perfil.

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

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto gerado automaticamente de portas recomendadas 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.

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

[AIX Solaris HP-UX Linux Windows]A exclusão de um perfil não exclui o diretório do perfil. Por exemplo, suponha que você crie um perfil no diretório /usr/WebSphere/AppServer/profiles/managedProfile. O diretório permanecerá após você excluir o perfil.

[AIX Solaris HP-UX Linux Windows]É possível excluir ou manter 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.

[IBM i]O diretório de perfil é excluído quando você exclui o perfil, de forma que possa recriar o perfil sem precisar excluir manualmente o diretório.

Se você excluir um perfil que tem modelos de aumento registrados para ele no registro de perfil, as ações para desfazer aumento serão executadas automaticamente.

Evitar Problemas Evitar Problemas: Se estiver excluindo um nó antigo que foi migrado, encerre o novo gerenciador de implementação migrado antes de excluir o nó antigo. Isso garantirá que o novo nó migrado não seja acidentalmente removido da nova célula migrada.gotcha
-deleteAll
Exclui todos os perfis registrados.

[AIX Solaris HP-UX Linux Windows]A exclusão de um perfil não exclui o diretório do perfil. Por exemplo, suponha que você crie um perfil no diretório /usr/WebSphere/AppServer/profiles/managedProfile. O diretório permanecerá após você excluir o perfil.

[AIX Solaris HP-UX Linux Windows]É possível excluir ou manter 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.

[IBM i]O diretório do perfil é excluído quando você exclui o perfil, de forma que quando recriar o perfil, você não tenha informações desatualizadas para gerenciar.

Se você excluir um perfil que tem modelos de aumento registrados para ele no registro de perfil, as ações para desfazer aumento serão executadas automaticamente.

-dmgrAdminPassword password
Se você estiver associando um nó, especifique um nome de usuário válido para um gerenciador de implementação se a segurança administrativa estiver ativada no gerenciador de implementação. Utilize esse parâmetro com o parâmetro -dmgrAdminUserName e o parâmetro -federateLater.
-dmgrAdminUserName user_name
Se você estiver associando um nó, especifique uma senha válida para um gerenciador de implementação se a segurança administrativa estiver ativada no gerenciador de implementação. Utilize esse parâmetro com o parâmetro -dmgrAdminPassword e o parâmetro -federateLater.
-dmgrHost dmgr_host_name (Parâmetro Opcional)
Identifica a máquina onde o gerenciador de implementação está em execução. Especifique esse parâmetro e o parâmetro dmgrPort para federar um perfil customizado à medida que ele é criado.

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

A especificação desse parâmetro opcional direciona o comando manageprofiles para tentar associar o nó customizado à célula do gerenciador de implementação ao criar o perfil customizado com o parâmetro -templatePath gerenciado. O parâmetro -dmgrHost é ignorado ao criar um perfil do gerenciador de implementação ou um perfil do Application Server.

Se você federar um nó personalizado quando o gerenciador de implementação não estiver em execução ou não estiver disponível, devido à segurança estar ativada ou por outras razões, o indicador da instalação nos logs será INSTCONFFAIL para indicar uma falha completa. O perfil customizado resultante não pode ser utilizado. Você deve mover o diretório do perfil personalizado para fora do repositório de perfis (o diretório raiz da instalação de perfis) antes de criar outro perfil personalizado com o mesmo nome de perfil.

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

O valor padrão para este parâmetro é localhost. O valor deste parâmetro deve ser um nome do host formado corretamente e não deve conter espaços nem caracteres inválidos como a seguir: *, ?, ", <, >,,, /, \, |, e assim por diante. 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 esse parâmetro e o parâmetro dmgrHost para federar um perfil customizado à medida que ele é criado. 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 (Java™ Management Extensions) padrão, não poderá associar ao comando manageprofiles. Utilize, então, o comando addNode.

O valor padrão para este parâmetro é 8879. A porta indicada deve 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.

-dmgrProfilePath dmgr_profile_path
Especifica o caminho do perfil para a porção gerenciador de implementação da célula. Especifique esse parâmetro ao criar a porção servidor de aplicativos da célula.
-enableAdminSecurity true | false
Ativa a segurança administrativa. Os valores válidos incluem true ou false. O valor-padrão é false.
Quando enableAdminSecurity estiver configurado como true, você também deverá especificar os parâmetros -adminUserName e -adminPassword juntamente com os valores desses parâmetros.

Você não pode utilizar o parâmetro -enableAdminSecurity para ativar a segurança administrativa para um perfil customizado. A fim de que a segurança seja ativada para um perfil customizado, é necessário associar o perfil customizado a um gerenciador de implementação. A segurança administrativa ativada para o gerenciador de implementação é necessária para ativar a segurança do perfil customizado associado.

[Linux]-enableService true | false
[Linux]Ativa a criação de um serviço Linux. Os valores válidos incluem true ou false. O valor padrão desse parâmetro é false.

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

-federateLater true | false
Indica se o perfil gerenciado será federado durante a criação do perfil ou isso ocorrerá posteriormente utilizando-se o comando addNode. Se os parâmetros dmgrHost, dmgrPort, dmgrAdminUserName e dmgrAdminPassword não tiverem valores, o valor padrão desse parâmetro será true. Os valores válidos incluem true ou false.
-getDefaultName
Retorna o nome do perfil padrão.
-getPath
Obtém o local do sistema de arquivos para um perfil de um nome fornecido. Requer o parâmetro –profileName.
-getName
Obtém o nome de um perfil registrado em um parâmetro -profilePath determinado.
-help
Exibe a sintaxe do comando.
-hostName host_name
Especifica o nome do host onde o perfil está sendo criado. 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. O valor para este parâmetro deve ser um nome do host IPv6 válido e não deve conter espaços ou nenhum caractere que não seja válido, como os seguintes: *, ?, ", <, >, ,, /, \, | e assim por diante.
-ignoreStack (Parâmetro Opcional)
Um parâmetro opcional que é utilizado com o parâmetro -templatePath para reduzir um perfil específico que tenha sido aumentado. Consulte o parâmetro -unaugment.
-importPersonalCertKS keystore_path
Especifica o caminho para o arquivo de armazenamento de chaves que você utiliza para importar um certificado pessoal ao criar o perfil. O certificado pessoal é o certificado pessoal padrão do servidor.
Boas Práticas Boas Práticas: Ao importar um certificado pessoal como padrão, importe o certificado raiz que assinou o certificado pessoal. Caso contrário, o comando manageprofiles inclui a chave pública do certificado pessoal no arquivo trust.p12 e cria um certificado de assinatura raiz.bprac
O parâmetro -importPersonalCertKS é mutuamente exclusivo com o parâmetro -personalCertDN. Se você não criar ou importar especificamente um certificado pessoal, será criado um por padrão.

Quando você especifica qualquer um dos parâmetros que comece com -importPersonal, deve especificar todos.

-importPersonalCertKSAlias keystore_alias
Especifica o alias do certificado que está no arquivo de armazenamento de chaves que você especifica no parâmetro -importPersonalCertKS. O certificado é incluído no arquivo de armazenamento de chaves padrão do servidor e é utilizado como o certificado pessoal padrão do servidor.

Quando você especifica qualquer um dos parâmetros que comece com -importPersonal, deve especificar todos.

-importPersonalCertKSPassword keystore_password
Especifica a senha do arquivo de armazenamento de chaves que você especifica no parâmetro -importPersonalCertKS.

Quando você especifica qualquer um dos parâmetros que comece com -importPersonal, deve especificar todos.

-importPersonalCertKSType keystore_type
Especifica o tipo do arquivo de armazenamento de chaves que você especifica no parâmetro -importPersonalCertKS. Os valores podem ser JCEKS, CMSKS, PKCS12, PKCS11 e JKS. No entanto, esta lista pode ser alterada com base no provedor no arquivo java.security.

Quando você especifica qualquer um dos parâmetros que comece com -importPersonal, deve especificar todos.

-importSigningCertKS keystore_path
Especifica o caminho para o arquivo de armazenamento de chaves que você utiliza para importar um certificado raiz ao criar o perfil. O certificado raiz é o certificado que você utiliza como o certificado raiz padrão do servidor. O parâmetro -importSigningCertKS é mutuamente exclusivo com o parâmetro -signingCertDN. Se você não criar ou importar especificamente um certificado de assinatura raiz, será criado um por padrão.

Quando você especifica qualquer um dos parâmetros que comece com -importSigning, deve especificar todos.

-importSigningCertKSAlias keystore_alias
Especifica o alias do certificado que está no arquivo de armazenamento de chaves que você especifica no parâmetro -importSigningCertKS. O certificado é incluído no armazenamento de chaves raiz padrão do servidor e é utilizado como o certificado raiz padrão do servidor.

Quando você especifica qualquer um dos parâmetros que comece com -importSigning, deve especificar todos.

-importSigningCertKSPassword keystore_password
Especifica a senha do arquivo de armazenamento de chaves que você especifica no parâmetro -importSigningCertKS.

Quando você especifica qualquer um dos parâmetros que comece com -importSigning, deve especificar todos.

-importSigningCertKSType keystore_path
Especifica o tipo do arquivo de armazenamento de chaves que você especifica no parâmetro -importSigningCertKS. Os valores válidos podem ser JCEKS, CMSKS, PKCS12, PKCS11 e JKS. No entanto, esta lista pode ser alterada com base no provedor no arquivo java.security.

Quando você especifica qualquer um dos parâmetros que comece com -importSigning, deve especificar todos.

-isDefault
Especifica que o perfil identificado pelo parâmetro -profileName que o acompanha deve ser o perfil padrão quando ele estiver registrado. Ao emitir comandos que são endereçados ao perfil padrão, não é necessário utilizar o atributo -profileName do comando.
-isDeveloperServer
Especifica que o servidor destina-se somente para propósitos de desenvolvimento. Esse parâmetro é útil ao criar perfis para testar aplicativos em um servidor de não produção antes de implementar os aplicativos em seus servidores de aplicativos de produção.

Este parâmetro é válido somente para o modelo do perfil padrão.

Se você especificar os parâmetros -isDeveloperServer e -applyPerfTuningSetting, dependendo da opção selecionada para -applyPerfTuningSetting, -applyPerfTuningSetting poderá substituir -isDeveloperServer.

-keyStorePassword keystore_password
Especifica a senha a ser utilizada em todos os arquivos de armazenamento de chaves criados durante a criação do perfil. Os arquivos de armazenamento de chaves são criados para o certificado pessoal padrão e o certificado de assinatura raiz.
-listAugments
Lista os aumentos registrados em um perfil que está no registro de perfil. Você deve especificar o parâmetro -profileName com o parâmetro -listAugments.
-listProfiles
Lista os perfis que estão no registro de perfil.
-nodeDefaultPorts
Define um conjunto de portas ao criar um perfil em conjunto com um modelo de célula. Se você especificar esta opção, você não poderá especificar as opções -nodePortsFile ou nodeStartingPort ao mesmo tempo.
-nodeName node_name
Especifica o nome do nó para o nó criado com o novo perfil. Utilize um valor exclusivo na célula ou na máquina. Cada perfil que compartilha o mesmo conjunto de binários do produto deve possuir um nome do nó exclusivo.
[AIX Solaris HP-UX Linux Windows]O valor padrão desse parâmetro tem como base o nome abreviado do host, o tipo do perfil e um número final:
  • Perfil do servidor de aplicativos: shortHostNameNodeNodeNumber
  • Perfil customizado: shortHostNameNodeNodeNumber
  • Perfil de gerenciamento com o servidor do gerenciador de implementação: shortHostNameCellManagerNodeNumber
  • Perfil de gerenciamento com o servidor do gerenciador de tarefa: shortHostNameJobMgrNodeNumber
  • Perfil de gerenciamento com o servidor do agente administrativo: shortHostNameAANodeNodeNumber
  • Perfil da célula, parte do servidor de aplicativos: shortHostNameNodeNodeNumber
  • Perfil da célula, parte do gerenciador de implementação: shortHostNameCellManagerNodeNumber
  • Perfil de proxy seguro: shortHostNameNodeNodeNumber
em que NodeNumber é um número sequencial que começa em 01.
[IBM i]Existem os seguintes nomes de nó padrão:
  • modelo management para o gerenciador de implementação, agente administrativo ou gerenciador de tarefa: profilenameManager
  • modelo padrão: shorthostname_profilename
  • modelo gerenciado: shorthostname_profilename
  • cell: Consulte os exemplos anteriores de modelos management e default e aplique conforme apropriado aos dois perfis criados.
  • secureproxy template: shorthostname_profilename

O valor para este parâmetro não deve conter espaços ou nenhum caractere que não seja válido, como os seguintes: *, ?, ", <, >, ,, /, \, | e assim por diante.

-nodePortsFile node_ports_path
Especifica as portas para a parte do nó da célula que você está criando. Se você especificar essa opção, não poderá especificar as opções -nodeDefaultPorts ou -nodeStartingPort ao mesmo tempo.
-nodeProfilePath node_profile_path
Especifica o caminho do perfil para a parte do nó da célula. Especifique esse parâmetro ao criar a parte do gerenciador de implementação da célula.
-omitActionfeature1 feature2... featureN (Parâmetro Opcional)
Um parâmetro opcional que exclui recursos de perfil.
Cada modelo de perfil vem predefinido com alguns recursos opcionais. Os recursos opcionais a seguir podem ser utilizados com o parâmetro -omitAction para os seguintes modelos de perfil:
  • padrão - servidor de aplicativos
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • gerenciamento - perfil de gerenciamento para o gerenciador de implementação, agente administrativo ou gerenciador de tarefas
    • deployAdminConsole
  • célula - célula do gerenciador de implementação, que é compsota de um dmgr e um modelo de perfil padrão
    • cell_dmgr (dmgr criado durante a criação do perfil da célula)
      • deployAdminConsole
      • defaultAppDeployAndConfig
-personalCertDN distinguished_name
Especifica o nome distinto do certificado pessoal que você está criando ao criar o perfil. Especifique o nome distinto entre aspas. Este certificado pessoal padrão está localizado no arquivo de armazenamento de chaves do servidor. O parâmetro -importPersonalCertKSType é mutuamente exclusivo com o parâmetro -personalCertDN. Consulte o parâmetro -personalCertValidityPeriod e o parâmetro -keyStorePassword.
-portsFile file_path (Parâmetro Opcional)
Um parâmetro opcional que especifica o caminho para um arquivo que define as configurações da porta para o novo perfil.

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

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto gerado automaticamente de portas recomendadas 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 possuir um nome exclusivo. O nome do perfil padrão tem como base o tipo do perfil e um número final, por exemplo:
<profile_type><profile_number>
em que
  • <profile_type> é um valor como AppSrv, Dmgr, AdminAgent, JobMgr ou Custom
  • <profile_number> é um número sequencial que cria um nome de perfil exclusivo.

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

O nome do perfil escolhido não deve estar em uso.

-profilePath profile_root
Especifica o caminho completo do perfil, que é referido como profile_root.
Especifique o caminho completo para evitar uma limitação de script Ant que possa causar uma falha ao associar o perfil a uma célula. Exemplo:
-profilePath profile_root

[Windows]Se o caminho completo contiver espaços, coloque o valor entre aspas.

[AIX Solaris HP-UX Linux Windows]O valor-padrão é baseado no diretório app_server_root, no subdiretório de perfis e no nome do perfil.

[IBM i]O valor-padrão é baseado no diretório user_data_root, no subdiretório de perfis e no nome do perfil.

Por exemplo, o padrão é:
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
O elemento WS_WSPROFILE_DEFAULT_PROFILE_HOME é definido no arquivo wasprofile.properties no diretório app_server_root/properties.
Nota: O arquivo wasprofile.properties inclui as propriedades a seguir:
WS_CMT_PI_MODPERMS
Essa propriedade especifica se o pós-instalador deve modificar as permissões de quaisquer arquivos que ele cria. Os valores válidos são true ou false. Qualquer outro valor assume como padrão false. Remover essa propriedade do arquivo também faz com que ele assuma como padrão false. Quando configurado para false, quaisquer arquivos criados pelo pós-instalador tem permissão com base na definição de umask do sistema.

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

[AIX Solaris HP-UX Linux Windows]Você deve ter permissões para gravar no diretório.

[IBM i]O perfil QEJBSVR deve ter permissões para gravar no diretório.

WS_CMT_PI_LOGS
Esta propriedade especifica se e quando o pós-instalador deverá limpar seus logs para cada produto que está localizado no diretório PROFILE_HOME/logs/service/productDir. As configurações desta propriedade permitem especificar os seguintes critérios de limpeza de log:
  • É possível especificar o número de log que você deseja manter para cada produto no diretório PROFILE_HOME/logs/service/productDir. O valor especificado pode ser qualquer número inteiro entre 1 e 999. Por exemplo, se você especificar WS_CMT_PI_LOGS=5, o pós-instalador manterá os cinco logs mais recentes para cada produto.
  • É possível especificar a quantia máxima de armazenamento que os logs podem ocupar. O valor especificado pode ser qualquer número inteiro entre 1 e 999, seguido por:
    • KB, se você estiver especificando o valor em kilobytes.
    • MB, se você estiver especificando o valor em megabytes.
    • GB, se você estiver especificando o valor em gigabytes.
    Por exemplo, se você especificar WS_CMT_PI_LOGS=10MB, quando a quantia de armazenamento que os logs ocupam exceder 10 megabytes, o pós-instalador começará a excluir os logs mais antigos.
    Evitar Problemas Evitar Problemas: Como os valores especificados fazem distinção entre maiúsculas e minúsculas, as letras incluídas no valor especificado deverão ser maiúsculas.gotcha
  • É possível especificar a quantia de tempo que deseja que o pós-intalador mantenha os logs. O valor especificado pode ser qualquer número inteiro entre 1 e 999, seguido por:
    • D, se você estiver especificando o valor em dias.
    • W, se você estiver especificando um valor em semanas.
    • M, se você estiver especificando o valor em meses.
    • Y, se você estiver especificando o valor em anos.
    Por exemplo, se você especificar WS_CMT_PI_LOGS=2W, cada registro será mantido por duas semanas.
    Evitar Problemas Evitar Problemas: Como os valores especificados fazem distinção entre maiúsculas e minúsculas, as letras incluídas no valor especificado deverão ser maiúsculas.gotcha
  • É possível especificar uma data específica após a qual um log será excluído. O valor deve ser especificado usando valores numéricos, separadas por traços no formato DD-MM-YYYY. Por exemplo, se você especificar WS_CMT_PI_LOGS=12-31-2013, todos os logs serão excluídos em 31 de Dezembro de 2013.
    Evitar Problemas Evitar Problemas: Se o valor não for especificado no formato indicado, com os números separados por traços, essa configuração da propriedade será ignorada.gotcha
-response reponse_file
Acessa todas as funções da API a partir da linha de comandos utilizando o comando manageprofiles.

A interface de linha de comandos pode ser orientada por um arquivo de resposta que contém os argumentos de entrada de um determinado comando no arquivo de propriedades no formato chave e valor. Para determinar quais argumentos de entrada são necessários para os vários tipos de modelos e ações de perfis, use o comando manageprofiles com o parâmetro -help.

Utilize o seguinte arquivo de resposta de exemplo para executar uma operação de criação:
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
Ao criar um arquivo de resposta, leve em conta as considerações a seguir:
  • Ao especificar valores, não especifique caracteres de aspas duplas (") no início ou final de um valor, mesmo que tal valor contenha espaços.
    Nota: Esta é uma regra diferente de quando você especifica valores em uma linha de comandos.
  • Ao especificar um valor único que contém um caractere de vírgula, tal como nomes distintos para os parâmetros personalCertDN e signingCertDN, use uma barra invertida dupla antes do caractere de vírgula. Por exemplo, aqui está como especificar o valor signingCertDN com um nome distinto:
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
       ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US 
  • Ao especificar diversos valores, separe-os com um caractere de vírgula e não use barras invertidas duplas. Por exemplo, aqui está como especificar diversos valores para o parâmetro omitAction:
    omitAction=deployAdminConsole,defaultAppDeployAndConfig 
  • Não especifique uma linha em branco em um arquivo de resposta. Isto pode causar um erro.
  • [Windows]A instrução de caminho no sistema operacional Windows pode usar barras (/) ou barras invertidas (\). Se a instrução de caminho utilizar barras invertidas, o arquivo de resposta irá requerer barras invertidas duplas para que o arquivo de resposta entenda corretamente o caminho. Aqui é apresentado um exemplo de um arquivo de resposta para a operação create que utiliza barras invertidas duplas:
    create
    templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
    Boas Práticas Boas Práticas: Use barras para reduzir a chance de erros ao alternar entre plataformas.bprac
-restoreProfile
Importante: O comando manageProfiles -restoreProfile é suportado apenas com um backup criado no mesmo nível de fixpack.
Restaura o backup de um perfil. Deve ser utilizado com o parâmetro -backupFile, por exemplo:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
Para restaurar um perfil, execute as seguintes etapas:
  1. Pare o servidor e os processos em execução para o perfil que você deseja restaurar.
  2. Exclua manualmente o diretório para o perfil do sistema de arquivo.
  3. Execute a opção -validateAndUpdateRegistry do comando manageprofiles.
  4. Restaure o perfil, utilizando a opção -restoreProfile do comando manageprofiles.
-securityLevel security_level
Especifica as configurações iniciais de nível de segurança para o servidor proxy seguro. Os valores válidos são low, medium e high. O valor padrão é high. O nível de segurança é baseado em permissões de inicialização do usuário, considerações de roteamento, opções de administração e manipulação de erros. Como opção, você pode alterar suas configurações de segurança após criar o perfil do servidor proxy seguro.
-serverName server_name
Especifica o nome do servidor. Especifique esse parâmetro somente para os modelos default e secureproxy. Se você não especificar esse parâmetro ao utilizar os modelos default ou secureproxy, o nome do servidor padrão será server1 para o perfil padrão e proxy1 para o perfil de proxy seguro.
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
Especifica o tipo de perfil de gerenciamento. Especifique DEPLOYMENT_MANAGER para um servidor do gerenciador de implementação, ADMIN_AGENT para um servidor do agente administrativo ou JOB_MANAGER para um servidor do gerenciador de tarefas. Este parâmetro será necessário quando você criar um perfil de gerenciamento.
[Linux]-serviceUserName service_user_ID
[Linux]Especifique o ID do usuário que é utilizado durante a criação do serviço do Linux de modo que o serviço do Linux seja executado utilizando esse ID de usuário. O serviço do Linux será executado sempre que o ID do usuário tiver efetuado 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
-signingCertDN distinguished_name
Especifica o nome distinto do certificado de assinatura raiz que você cria ao criar o perfil. Especifique o nome distinto entre aspas. Este certificado pessoal padrão está localizado no arquivo de armazenamento de chaves do servidor. O parâmetro -importSigningCertKS é mutuamente exclusivo com o parâmetro -signingCertDN. Se você não criar ou importar especificamente um certificado de assinatura raiz, será criado um por padrão. Consulte o parâmetro -signingCertValidityPeriod e -keyStorePassword.
-signingCertValidityPeriod validity_period (Parâmetro Opcional)
Um parâmetro opcional que especifica a quantidade de tempo em anos que o certificado de assinatura raiz é válido. Se você não especificar esse parâmetro com o parâmetro -signingCertDN, o certificado de assinatura raiz será válido por 15 anos.
-startingPort Porta_inicial
Especifica o número de porta inicial para gerar e designar todas as portas para o perfil.

[AIX Solaris HP-UX Linux Windows]Os valores de porta são designados sequencialmente a partir do valor -startingPort, omitindo essas portas que já estão em uso. O sistema reconhece e resolve as portas que estão atualmente em uso e determina as designações de porta para evitar conflitos de porta.

[IBM i]Os valores de porta são designados sequencialmente a partir do valor de -startingPort.

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

Durante a criação do perfil, o comando manageprofiles utiliza um conjunto gerado automaticamente de portas recomendadas 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.

Atenção: Não utilize esse parâmetro se você estiver utilizando o modelo de perfil gerenciado.
-supportedProtocols supported_protocols
Especifica os protocolos que são válidos para o servidor proxy seguro para pedidos de proxy. Os valores válidos são SIP, HTTP e HTTP,SIP.
-templatePath template_path
Especifica o caminho de diretório para os arquivos de modelo 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 perfil que ficam fora da raiz da instalação, se tiver algum.

[AIX Solaris HP-UX Linux Windows]Você poderá especificar um caminho relativo para o parâmetro -templatePath se os modelos de perfil forem relativos ao diretório app_server_root/profileTemplates. Caso contrário, especifique o caminho completo do modelo. O

[IBM i]O caminho do modelo padrão é app_server_root/profileTemplates/default. É possível utilizar um caminho relativo para o parâmetro -templatePath. O caminho é relativo ao diretório de trabalho atual ou ao app_server_root/profileTemplates, nesta ordem. O exemplo a seguir cria um perfil com base no padrão para um servidor de aplicativos independente:
manageprofiles -create -profileName MyProfile -startingPort 10380

Os modelos disponíveis são descritos no tópico Conceitos de Perfil.

-unaugment
O aumento é a capacidade de alterar um perfil existente com um modelo de aumento. Para reduzir um perfil que tenha sido aumentado, especifique os parâmetros -unaugment e -profileName. Se uma série de aumentos de manageprofiles foi executada e você especificar somente esses dois parâmetros para reduzir um perfil, a ação unaugment irá desfazer primeiro a última ação augment.

Para reduzir um perfil específico que tenha sido aumentado, adicionalmente especifique o parâmetro -ignoreStack com o parâmetro -templatePath. Normalmente, você não reduziria um determinado perfil em razão de precisar certificar-se de não estar violando as dependências de modelo de perfil.

[AIX Solaris HP-UX Linux Windows]Ao utilizar o parâmetro -templatePath, especifique o caminho completo de arquivo para o parâmetro.

[IBM i]Ao utilizar o parâmetro -templatePath, você pode especificar um caminho de arquivo relativo para o parâmetro.

Consulte também o parâmetro augment.

-unaugmentAll
Reduz todos os perfis que foram aumentados com um modelo de aumento específico. O parâmetro -templatePath é necessário com o parâmetro -unaugmentAll.

[AIX Solaris HP-UX Linux Windows]Ao utilizar o parâmetro -templatePath, especifique o caminho completo de arquivo para o parâmetro.

[IBM i]Ao utilizar o parâmetro -templatePath, você pode especificar um caminho de arquivo relativo para o parâmetro.

Como opção, especifique o parâmetro -unaugmentDependents com o parâmetro -unaugmentAll para reduzir todos os perfis que são pré-requisitos dos perfis que estão sendo reduzidos.

Nota: Se você usar este parâmetro quando não tiver perfis aumentados com os modelos de perfil, pode ocorrer um erro.

Consulte também o parâmetro augment.

-unaugmentDependents
Se for especificado, o parâmetro reduz todos os perfis aumentados que são pré-requisitos para os perfis que estão sendo reduzidos com o parâmetro -unaugmentAll. Se não especificado, ele não reduz os perfis aumentados que são pré-requisitos para os perfis sendo reduzidos.

Especifique o parâmetro -unaugmentDependents com o parâmetro -unaugmentAll.

-validateAndUpdateRegistry
Verifica todos os perfis listados no registro do perfil para consultar se os perfis estão presentes no sistema de arquivo. Remove todos os perfis ausentes do registro. Retorna uma lista dos perfis ausentes que foram excluídos do registro.
-validatePorts
Verifica as portas para determinar se elas não estão reservadas ou em uso. Esse parâmetro ajuda a identificar portas que não estão sendo utilizadas. Se for determinado que uma porta está em uso, a criação do perfil será interrompida e uma mensagem de erro exibida. Você pode utilizar esse parâmetro a qualquer momento na linha de comandos do create. É recomendado usar esse parâmetro com o parâmetro –portsFile.
-validateRegistry
Verifica todos os perfis listados no registro do perfil para consultar se os perfis estão presentes no sistema de arquivo. Retorna uma lista de perfis ausentes.
-webServerCheck true | false
Indica se você deseja configurar as definições do servidor da Web. Os valores válidos incluem true ou false. O valor padrão desse parâmetro é false.
-webServerHostname webserver_host_name
O nome do host do servidor. O valor padrão desse parâmetro é o nome longo do host da máquina local.
-webServerInstallPath webserver_installpath_name
O caminho da instalação do servidor da Web, local ou remoto. O valor padrão desse parâmetro depende do sistema operacional da máquina local e do valor do parâmetro webServerType. Por exemplo:
[Windows]
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 defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Linux]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[AIX]
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “?”
webServerType=APACHE: webServerInstallPath defaulted to “?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[HP-UX]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Solaris]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[IBM i]
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath defaulted to “n\a”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”
-webServerName webserver_name
O nome do servidor da Web. O valor padrão para este parâmetro é webserver1.
-webServerOS webserver_operating_system
O sistema operacional onde o servidor da Web reside. Os valores válidos incluem: windows, linux, solaris, aix, hpux, os390 e os400. Utilize esse parâmetro com o parâmetro webServerType.
-webServerPluginPath webserver_pluginpath
O caminho para os plug-ins que o servidor da Web utiliza. O valor padrão desse parâmetro é WAS_HOME/plug-ins.
-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.
-webServerType webserver_type
O tipo do servidor da Web. Os valores válidos incluem: IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE e HTTPSERVER_ZOS. Utilize esse parâmetro com o parâmetro webServerOS.
[Windows]-winserviceAccountType specifieduser | localsystem
[Windows]O tipo da conta do proprietário do serviço do Windows criado para o perfil. Os valores válidos incluem specifieduser ou localsystem. O valor localsystem executa o serviço do Windows na conta local do usuário que cria o perfil. O valor padrão para este parâmetro é localsystem.

Se o valor for specifieduser, o parâmetro winservicePassword será necessário. O parâmetro winserviceUserName é padronizado com o valor de nome de usuário do ambiente se não especificado.

[Windows]-winserviceCheck true | false
[Windows]O valor pode ser true ou false. Especifique true para criar um serviço do Windows para o processo do servidor que é criado no perfil. Especifique false para não criar o serviço do Windows. O valor padrão desse parâmetro é false.
Importante: Em um perfil customizado, não é possível criar um serviço do Windows com este parâmetro. Em vez disso, use o comando WASService para criar o serviço separadamente.
[Windows]-winservicePassword winservice_password
[Windows]Especifique a senha para o usuário especificado ou a conta local que deve ser proprietária do serviço do Windows.
[Windows]-winserviceStartupType manual | automatic | disabled
[Windows]Possíveis valores de startup_type são:
  • manual
  • automático
  • disabled

Leia o artigo no comando WASService para obter mais informações sobre serviços do Windows.

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

[Windows]-winserviceUserName winservice_user_ID
[Windows]Especifique seu ID do usuário para que o sistema operacional Windows possa verificar você como um ID capaz de criar um serviço do Windows. O ID do usuário deve pertencer ao grupo do administrador e ter os seguintes direitos de usuário avançado:
  • Existir como parte do sistema operacional
  • Efetuar logon como serviço
O valor padrão desse parâmetro é o nome do usuário atual. O valor para este parâmetro não deve conter espaços ou caracteres que não sejam válidos, tais como os seguintes: *, ?, ", <, >, ,, /, \, | e assim por diante. O usuário que você especifica deve ter as permissões corretas para criar um serviço do Windows. Você deve especificar a senha correta para o nome do usuário que escolher.
Importante: Ao criar um perfil com serviços Windows com um usuário e senha especificados e o usuário for um usuário do domínio, você deverá usar uma barra invertida dupla conforme mostrado no exemplo a seguir:
winServiceUserName=DOMAIN\\DOMAINUSER
winServicePassword=DOMAINUSERPASSWORD

Cenário de Uso

Os exemplos a seguir demonstram a sintaxe correta. Emita o comando de qualquer um dos seguintes exemplos em uma linha. Cada exemplo mostra o comando em mais de uma linha para aumentar a clareza.

  • Criando um Gerenciador de Implementação

    O exemplo a seguir utiliza o modelo de gerenciamento para criar um gerenciador de implementação chamado Dmgr001. As portas do gerenciador de implementação começam pelo número de porta 20000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType DEPLOYMENT_MANAGER
       -nodeName Dmgr001Node
       -cellName Dmgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 20000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType DEPLOYMENT_MANAGER
       -nodeName Dmgr001Node
       -cellName Dmgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 20000
    [IBM i]
    manageprofiles -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath management
       -serverType DEPLOYMENT_MANAGER
       -startingPort 20000
  • Criando um Agente Administrativo

    O exemplo a seguir utiliza o modelo management para criar um agente administrativo denominado AdminAgent001. As portas do agente administrativo começam pelo número de porta 24000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType ADMIN_AGENT
       -nodeName AdminAgent001Node
       -hostName localhost
       -isDefault
       -startingPort 24000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType ADMIN_AGENT
       -nodeName AdminAgent001Node
       -hostName localhost
       -isDefault
       -startingPort 24000
    [IBM i]
    manageprofiles -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath management
       -serverType ADMIN_AGENT
       -startingPort 24000
  • Criando um Gerenciador de Tarefa

    O exemplo a seguir utiliza o modelo management para criar um gerenciador de tarefa denominado JobMgr001. As portas do gerenciador de tarefas começam pelo número de porta 25000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/management
       -serverType JOB_MANAGER
       -nodeName JobMgr001Node
       -cellName JobMgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 25000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\management
       -serverType JOB_MANAGER
       -nodeName JobMgr001Node
       -cellName JobMgr001NodeCell
       -hostName localhost
       -isDefault
       -startingPort 25000
    [IBM i]
    manageprofiles -create 
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath management
       -serverType JOB_MANAGER
       -startingPort 25000
  • Criando um Proxy Seguro

    O exemplo a seguir utiliza o modelo secureproxy para criar um proxy seguro denominado SecureProxySrv001. As portas de proxy seguras iniciam no número da porta 26000.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/secureproxy
       -nodeName SecureProxySrv001Node
       -serverName secproxy1
       -hostName localhost
       -isDefault
       -startingPort 26000
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\secureproxy
       -nodeName SecureProxySrv001Node
       -serverName secproxy1
       -hostName localhost
       -isDefault
       -startingPort 26000
    [IBM i]
    manageprofiles -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath secureproxy
       -startingPort 26000
  • Criando um Perfil Personalizado

    O exemplo a seguir cria um perfil customizado e associa o perfil à célula do gerenciador de implementação.

    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Custom01
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/managed
       -nodeName Custom01Node
       -cellName Custom01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
    [Windows]
    c:\WebSphere\AppServer\bin manageprofiles.bat -create
       -profileName Custom01
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\managed
       -nodeName CustomNode01
       -cellName CustomNodeCell01
       -hostName myhost.mycity.mycompany.com
       -isDefault 
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
    [IBM i]
    manageprofiles -create 
       -profileName Custom01 
       -templatePath managed 
       -startingPort 22000
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
  • Criando um Perfil do Servidor de Aplicativos

    Crie um perfil de servidor de aplicativos denominado Default01 com o seguinte comando.

    [Windows]O comando também cria um serviço do Windows para o servidor de aplicativos, certificados de assinatura pessoal e raiz para o perfil e uma senha de armazenamento de chaves para os dois certificados.
    app_server_root\bin manageprofiles.bat -create 
       -profileName Default01 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault 
       -winserviceCheck true
       -winserviceAccountType specifieduser
       -winserviceUserName my_user_id
       -winservicePassword my_password
       -winserviceStartupType manual
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw
    [Linux][AIX HP-UX Solaris]
    app_server_root/bin/manageprofiles.sh -create 
       -profileName Default01
       -profilePath profile_root
       -templatePath app_server_root/profileTemplates/default
       -nodeName Default01Node
       -cellName Default01Cell
       -hostName myhost.mycity.mycompany.com
       -isDefault
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"     
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"     
       -keyStorePassword ap3n9krw
    [IBM i]
    manageprofiles -create 
       -profileName Default01 
       -templatePath default 
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"   
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"   
       -keyStorePassword ap3n9krw
  • Criando um Perfil de Célula
    A criação de um perfil de célula requer a criação do gerenciador de implementação e da porção servidor de aplicativos do perfil da célula. Os dois perfis são vinculados e alguns parâmetros devem corresponder entre os parâmetros de criação do gerenciador de implementação e a porção servidor de aplicativos do perfil da célula.
    Importante: Para o gerenciador de implementação e a parte do servidor de aplicativos do perfil de célula, você deve usar os mesmos valores para os parâmetros cellName, nodeName e appServerNodeName. Se você não especificou os nomes para esses parâmetros quando criou a parte do gerenciador de implementação do perfil da célula, deve utilizar o nome padrão que foi designado na primeira chamada da linha de comandos. O exemplo a seguir ilustra o uso de valores idênticos para esses parâmetros no gerenciador de implementação e nas partes do servidor de aplicativos do perfil de célula.
    Para Dmgr:                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    Para AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    O exemplo a seguir mostra a criação de um perfil de célula denominado Dmgr001 que tem o nome de célula Default01Cell e o nome de nó Default01Node. Para criar uma célula totalmente funcional, os parâmetros -nodeProfilePath, -cellName, -appServerNodeName e -nodeName devem corresponder entre o perfil cell_dmgr e o perfil cell_node.
    1. Crie a porção do gerenciador de implementação do perfil da célula.
      [Windows]
      app_server_root\bin\manageprofiles.bat -create
         -templatePath app_server_root\profileTemplates\cell\dmgr
         -nodeProfilePath app_server_root\profiles\AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [Linux][HP-UX][Solaris][AIX]
      app_server_root/bin/manageprofiles.sh -create 
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath app_server_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [IBM i]
      app_server_root/bin/manageprofiles -create 
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath user_data_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. Crie a porção do servidor de aplicativos do perfil da célula.
      [Windows]
      app_server_root\bin\manageprofiles.bat -create
         -templatePath app_server_root\profileTemplates\cell\default
         -dmgrProfilePath app_server_root\profiles\Dmgr001
         -portsFile app_server_root\profiles\Dmgr001\properties\portdef.props
         -nodePortsFile app_server_root\profiles\Dmgr001\properties\nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [Linux][HP-UX][Solaris][AIX]
      app_server_root/bin/manageprofiles.sh -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath app_server_root/profiles/Dmgr001
         -portsFile app_server_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile app_server_root/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
      [IBM i]
      app_server_root/bin/manageprofiles -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath user_data_root/profiles/Dmgr001
         -portsFile user_data_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile user_data_root/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node

Logs

O comando manageprofiles cria um registro para cada perfil criado.
  • [AIX Solaris HP-UX Linux Windows]Os registros estão no diretório app_server_root/logs/manageprofiles. Os arquivos são denominados neste padrão: profile_name_create.log.
  • [AIX Solaris HP-UX Linux Windows]O comando também cria um log para cada perfil que ele exclui. Os registros estão no diretório app_server_root/logs/manageprofiles. Os arquivos são denominados neste padrão: profile_name_delete.log.
  • [IBM i]Os logs estão no diretório user_data_root/profileRegistry/logs/manageprofiles. Os arquivos são denominados neste padrão: profile_name_create.log.
  • [IBM i]O comando também cria um log para cada perfil que ele exclui. Os logs estão no diretório user_data_root/profileRegistry/logs/manageprofiles. Os arquivos são denominados neste padrão: profile_name_delete.log.

Exemplo: Criando Perfis do Gerenciador de Implementação

Você pode criar um perfil do gerenciador de implementação depois de instalar os arquivos principais do produto. O gerenciador de implementação fornece uma única interface administrativa para um grupo lógico dos servidores de aplicativos em uma ou mais máquinas. Utilize o comando manageprofiles.sh -create para criar um perfil do gerenciador de implementação.

Para criar um perfil do gerenciador de implementação chamado shasti:

[AIX][HP-UX][Linux][Solaris]
manageprofiles.sh -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
[Windows]
manageprofiles.bat -create
              -profileName shasti 
              -profilePath C:\shasti\WebSphere
              -templatePath C:\IBM\WebSphere\AppServer\profileTemplates\management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetnt
              -nodeName dmgr1
[IBM i]
manageprofiles -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
O comando cria um perfil do gerenciador de implementação chamado shasti em uma célula chamada cell1 com um nome de nó dmgr1 no seguinte local:
  • [AIX][HP-UX][Linux][Solaris][IBM i]/shasti/WebSphere
  • [Windows]C:\shasti\WebSphere

Se você não especificar uma das opções de porta durante a criação do perfil, um conjunto de valores de porta recomendados será utilizado. O algoritmo de resolução de conflito de porta determina essas portas. O conjunto de portas recomendado não deve conter conflitos. Se você quiser usar as portas IBM padrão, use a opção -defaultPorts ao criar um perfil.

Exemplo: Incrementando Números de Porta Padrão a Partir de um Ponto Inicial

O comando manageprofiles pode designar números de porta com base em um valor de porta inicial. Você pode fornecer o valor de porta inicial a partir da linha de comandos, utilizando o parâmetro -startingPort. O comando designa os números de porta sequencialmente a partir do valor do número de porta inicial. Entretanto, se um valor de porta na sequência estiver em conflito com uma designação de porta existente, o próximo valor de porta disponível será utilizado

A ordem de designações das portas é arbitrária. A pressuposição de atribuições não é possível.

Por exemplo, as portas criadas com -startingPort 20002 seriam semelhantes ao exemplo a seguir:

Portas designadas para um perfil do servidor de aplicativos
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
Portas designadas para uma célula com um perfil do servidor de aplicativos federado
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028
OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
Portas designadas para uma célula com um perfil do gerenciador de implementação
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
Portas designadas para um perfil de gerenciamento com um servidor do gerenciador de implementação
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
Portas designadas para um perfil de gerenciamento com um servidor do gerenciador de tarefas
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
Portas designadas para um perfil de gerenciamento com um servidor do agente administrativo
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
Portas designadas a um perfil de proxy seguro
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006

O exemplo a seguir utiliza o parâmetro startingPort do comando manageprofiles e cria portas a partir de um valor inicial 20002, com o conteúdo mostrado no exemplo anterior:

[Windows]
manageprofiles.bat -create
               -profileName shasti 
               -profilePath G:\shasti\WebSphere 
               -templatePath G:\shasti\WebSphere\profileTemplates\default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002 
                            
[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
               -profileName shasti 
               -profilePath app_server_root/profiles/shasti 
               -templatePath app_server_root/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002
[IBM i]
app_server_root/bin/manageprofiles -create
               -profileName shasti 
               -profilePath user_data_root/profiles/shasti 
               -templatePath app_server_root/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002

Exemplo: Criando Perfis da Célula

Para criar o perfil de célula usando o comando manageprofiles, crie o perfil de gerenciamento de célula para um servidor do gerenciador de implementação e o perfil de nó de célula usando duas chamadas de linha de comandos manageprofiles diferentes. A combinação desses dois perfis é o perfil da célula.

São utilizados dois gabaritos para criar o perfil da célula: cell_dmgr e cell_node. Os modelos são vinculados e alguns parâmetros devem corresponder entre os parâmetros de criação nessas duas chamadas. Verifique se as chamadas correspondem.

Utilizando a linha de comandos, é possível criar as duas metades da célula em qualquer ordem ou a qualquer momento. É uma boa prática criar a porção do gerenciador de implementação do perfil em primeiro lugar. Depois de criar a célula, ela conterá um gerenciador de implementação e um nó federado. A porção do gerenciador de implementação e a porção do nó estão em diretórios separados.

[AIX Solaris HP-UX Linux Windows]Para cada um dos dois perfis que você cria, pode especificar o caminho completo para o perfil resultante usando o parâmetro -profilePath. Se você não especificar o parâmetro, o valor padrão para cada caminho de perfil terá como base o diretório app_server_root, o subdiretório de perfis e o nome do perfil.

[IBM i]Para cada um dos dois perfis que você cria, pode especificar o caminho completo para o perfil resultante usando o parâmetro -profilePath. Se você não especificar o parâmetro, o valor padrão para cada caminho de perfil terá como base o diretório, o subdiretório de perfis e o nome do perfil.

Os dois gabaritos que compõem o perfil de uma célula têm dependências entre si que requerem a correspondência de alguns valores de parâmetros entre as duas chamadas de criação. Para criar uma célula totalmente funcional, os parâmetros -nodeProfilePath, -cellName, -appServerNodeName e -nodeName devem ter os mesmos valores para o perfil cell_dmgr e o perfil cell_node. No caso de portas e especialmente no caso de portas dinamicamente alocadas, a criação da segunda metade da célula deve fazer referência às portas utilizadas na primeira metade da célula. Utilize os argumentos -portsFile e -nodePortsFile com referências aos seguintes arquivos do perfil que representa a primeira metade da célula:

[Linux][HP-UX][Solaris][AIX][IBM i]
  • profile_root/properties/portdef.props
  • profile_root/properties/nodeportdef.props
[Windows]
  • profile_root\properties\portdef.props
  • profile_root\properties\nodeportdef.props
Essa abordagem assegura que as portas na segunda metade da célula sejam criadas com a correlação correta para a primeira metade da célula.

Para obter ajuda detalhada sobre a criação de um perfil de célula, use os seguintes comandos:

[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help 
[Windows]
app_server_root\bin\manageprofiles.bat -create
 -templatePath
app_server_root\profileTemplates\cell\dmgr
 -help
[IBM i]
app_server_root/bin/manageprofiles -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help 

ou em

[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
 -templatePath
app_server_root/profileTemplates/cell/default
 -help 
[Windows]
app_server_root\bin\manageprofiles.bat -create
 -templatePath 
app_server_root\profileTemplates\cell\default
 -help 
[IBM i]
app_server_root/bin/manageprofiles -create
 -templatePath 
app_server_root/profileTemplates/cell/default
 -help 

A saída do parâmetro -help especifica quais parâmetros são requeridos e quais são opcionais ao criar o perfil do gerenciador de implementação da célula e o perfil do nó da célula.

O exemplo a seguir cria um perfil de célula denominado Dmgr001 com um nome de célula igual a Default01Cell e um nome de nó igual a Default01Node.
  1. Verifique se o seguinte caminho está disponível para uso:

    O caminho deve estar disponível ao criar o gerenciador de implementação e as partes do nó da célula, à medida que subdiretórios forem incluídos em cada parte.

    • [Linux][HP-UX][Solaris][AIX][IBM i]app_server_root/profiles
    • [Windows]app_server_root\profiles
  2. Crie a porção do gerenciador de implementação do perfil da célula.
    [Linux][HP-UX][Solaris][AIX]
    app_server_root/bin/manageprofiles.sh -create 
     -templatePath 
    app_server_root/profileTemplates/cell/dmgr 
     -nodeProfilePath 
    app_server_root/profiles/AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
     -templatePath 
    app_server_root\profileTemplates\cell\dmgr 
     -nodeProfilePath 
    app_server_root\profiles\AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [IBM i]
    app_server_root/bin/manageprofiles -create 
     -templatePath 
    app_server_root/profileTemplates/cell/dmgr 
     -nodeProfilePath 
    app_server_root/profiles/AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
  3. Verifique se o perfil Dmgr001 existe como deve existir antes de criar a parte do servidor de aplicativos do perfil da célula.
  4. Crie a porção do servidor de aplicativos do perfil da célula.
    Importante: Você deve utilizar os mesmos valores para os parâmetros cellName, nodeName e appServerNodeName que você utilizou na parte do gerenciador de implementação do perfil da célula. O exemplo a seguir ilustra a utilização dos mesmos valores para os parâmetros cellName, nodeName e appServerNodeName no gerenciador de implementação e em partes do servidor de aplicativos do perfil de célula.
    Para Dmgr:                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    Para AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    Se você não especificou os nomes para esses parâmetros quando criou a parte do gerenciador de implementação do perfil da célula, deve utilizar o nome padrão que foi designado na primeira chamada da linha de comandos.
    [Linux][HP-UX][Solaris][AIX]
    app_server_root/bin/manageprofiles.sh -create 
     -templatePath 
    app_server_root/profileTemplates/cell/default 
     -dmgrProfilePath 
    app_server_root/profiles/Dmgr001 
     -portsFile 
    app_server_root/profiles/Dmgr001/properties/portdef.props 
     -nodePortsFile 
    app_server_root/profiles/Dmgr001/properties/nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [Windows]
    app_server_root\bin\manageprofiles.bat -create 
     -templatePath 
    app_server_root\profileTemplates\cell\default 
     -dmgrProfilePath 
    app_server_root\profiles\Dmgr001 
     -portsFile 
    app_server_root\profiles\Dmgr001\properties\portdef.props 
     -nodePortsFile 
    app_server_root\profiles\Dmgr001\properties\nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name
    [IBM i]
    app_server_root/bin/manageprofiles -create 
     -templatePath 
    app_server_root/profileTemplates/cell/default 
     -dmgrProfilePath 
    app_server_root/profiles/Dmgr001 
     -portsFile 
    app_server_root/profiles/Dmgr001/properties/portdef.props 
     -nodePortsFile 
    app_server_root/profiles/Dmgr001/properties/nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName federated_node_name

Após a criação do gerenciador de implementação e das partes do nó do perfil da célula, uma sincronização entre os dois servidores deverá ocorrer. Por padrão, a sincronização ocorre automaticamente entre os dois servidores no mesmo intervalo especificado. No entanto, se a sincronização estiver desativada, o intervalo for muito longo ou ocorrer algum problema que impeça a ocorrência da sincronização de uma maneira apropriada, execute o comando syncNode para sincronizar o gerenciador de implementação e o nó.

Você deve utilizar o parâmetro portsFile ou nodePortsFile e o parâmetro startingPort ou nodeStartingPort.

Se você utilizar o comando manageprofiles, poderá escolher o perfil que deseja tornar o padrão.

[AIX Solaris HP-UX Linux Windows]Se você federar um nó servidor de aplicativos como parte da criação do perfil da célula utilizando o parâmetro -appServerNodeName, o nó não possui uma configuração original. Se você utilizar o comando -removeNode em um nó que tenha sido criado durante a criação de perfil da célula, o comando indicará que o utilitário de remoção do nó não consegue remover o nó e restaurar o nó para uma configuração base. Para remover com êxito um nó que tenha sido federado como parte de uma criação de perfil de célula, utilize o comando manageprofiles para excluir o perfil para o nó. Depois que o perfil para o nó for excluído, utilize o comando -cleanupNode no Gerenciador de Implementação para remover a configuração de nó do repositório da célula. Um novo perfil pode ser criado utilizando-se a Ferramenta de Gerenciamento de Perfil ou o comando manageprofiles.

Exemplo: Utilizando Números de Porta Predefinidos

O comando manageprofiles recomenda valores de porta iniciais quando você não configura explicitamente valores de porta. Em vez disso, você pode utilizar valores de porta predefinidos.

O comando manageprofiles recomenda valores de porta quando as opções de -defaultPorts, -startingPort, ou -portsFile não são especificadas.
Tabela 1. Os locais do arquivo dos valores de porta padrão.

Essa tabela lista os locais de arquivos de valores de porta padrão por tipo de perfil.

Perfil Caminho de Arquivo
Servidor de Aplicativos app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props
Célula - parte do servidor de aplicativos app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props
Célula - parte do gerenciador de implementação app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props
Customizado app_server_root/profileTemplates/managed/actions/portsUpdate/portdef.props
Perfil de gerenciamento para um servidor do gerenciador de implementação app_server_root/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props
Perfil de gerenciamento para um servidor do agente administrativo app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
Perfil de gerenciamento para um servidor do gerenciador de tarefa app_server_root/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props
Proxy seguro app_server_root/profileTemplates/secureproxy/actions/portsUpdate/portdef.props
Para customizar os valores de porta no arquivo portdef.props antes de criar seu perfil, desempenhe as etapas a seguir. O exemplo a seguir cria um perfil padrão. Para outros tipos de perfis, você deve substituir o caminho de arquivo pelo caminho de arquivo do perfil que deseja criar.
  1. Copie o arquivo app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props do modelo de perfil padrão e coloque uma cópia do arquivo em um diretório temporário arbitrário, como:
    • [Windows]c:\temp\ports
    • [AIX HP-UX Solaris][IBM i]/temp/ports
  2. No novo arquivo, modifique as configurações de porta para especificar seus valores de porta.
  3. Crie seu perfil com o comando manageprofiles. Use os valores de porta modificados. Especifique o local de seu arquivo modificado portdef.props no parâmetro -portsFile. Especifique o parâmetro -validatePorts para garantir que as portas não estejam reservadas ou em uso. Use o seguinte exemplo como guia:
    [Windows]
    manageprofiles.bat 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile C:\temp\ports\portdef.props
       -validatePorts 
    [AIX][Linux]
    manageprofiles.sh 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props
       -validatePorts
    [IBM i]
    manageprofiles 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root 
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props
       -validatePorts
Suponhamos que o arquivo portdef.props tenha os seguintes valores:
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

Depois de executar o comando manageprofiles para criar o perfil com os valores de porta definidos pelo usuário, um resultado de sucesso ou falha será exibido.

[IBM i]Nota: Após você criar um perfil com êxito, o console imprime uma mensagem que indica sucesso e o aconselha a verificar o arquivo AboutThisProfile.txt. No entanto, um arquivo AboutThisProfile.txt não é gerado quando você cria um perfil de cliente ou um perfil de plug-ins no IBM i.

O comando manageprofiles cria uma cópia do arquivo portdefs.props atual no diretório profile_root\properties.

Utilize apenas um dos três parâmetros de valor de porta , -startingPort, -defaultPorts ou -portsFile com o comando manageprofiles. Os três parâmetros são mutuamente exclusivos.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rxml_manageprofiles
Nome do arquivo: rxml_manageprofiles.html