[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
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name (Parâmetro Opcional)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -enableAdminSecurity true | false
  • [Linux]-enableService 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
  • -nodeName node_name
  • -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
  • -serverName server_name
  • -serverType ADMIN_AGENT
  • [Linux]-serviceUserName service_user_ID
  • -setDefaultName
  • -signingCertDN distinguished_name
  • -signingCertValidityPeriod validity_period (Parâmetro Opcional)
  • -startingPort starting_port | -portsFile file_path | -defaultPorts
  • -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_plug-in_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.

-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 base 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: Nomes de célula devem ser exclusivos. Se as células tiverem nomes duplicados, você poderá ter problemas com comunicações remotas entre células, como chamadas remotas de Enterprise JavaBeans.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 de gerenciamento com o servidor do agente administrativo: shortHostNameAACellCellNumber
em que CellNumber é um número sequencial que começa em 01.
[IBM i]Os nomes de célula padrão são:
  • modelo padrão: shorthostname_profilename
  • modelo gerenciado: shorthostname_profilename

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:
  • management - Gerenciamento. Utilize em conjunto com o parâmetro -serverType para indicar o tipo de perfil de gerenciamento.
  • default - Servidor de aplicativos
-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.

-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.

-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.
[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.

-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.
-nodeName node_name
Especifica o nome do nó para o nó criado com o novo perfil. Utilize um valor exclusivo 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 de gerenciamento com o servidor do agente administrativo: shortHostNameAANodeNodeNumber
em que NodeNumber é um número sequencial que começa em 01.
[IBM i]Existem os seguintes nomes de nó padrão:
  • 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.

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.

-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 agente administrativo
    • deployAdminConsole
-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 ou AdminAgent
  • <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.

[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.
-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 ADMIN_AGENT
Especifica o tipo de perfil de gerenciamento. Especifique ADMIN_AGENT para um servidor do agente administrativo. 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.
-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 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

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: 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

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: 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
Perfil de gerenciamento para um servidor do agente administrativo app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.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

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-base-dist&topic=rxml_manageprofiles
Nome do arquivo: rxml_manageprofiles.html