Comando GenPluginCfg

O comando GenPluginCfg é utilizado para gerar o arquivo de configuração do plug-in de servidor da Web do WebSphere, plugin-cfg.xml.

Para obter mais informações sobre onde executar esse comando, consulte o artigo Utilizando Ferramentas de Comando.

CUIDADO:
Gerar novamente a configuração do plug-in pode sobrescrever alterações na configuração manual que você pode querer preservar. Antes de executar esta tarefa, entenda suas implicações, conforme descrito em Implementando um Plug-in de Servidor da Web.
Evitar Problemas Evitar Problemas: A configuração de plug-in de topologia central, ou global, foi descontinuada. Use a configuração centrada no aplicativo, conforme a descrição em Implementando um Plug-in de Servidor da Web. Para qualquer configuração de topologia central existente, é possível atualizar o arquivo plugin-cfg.xml global, usando o console administrativo ou executando o comando GenPluginCfg para todos os clusters em uma célula. Entretanto, deve-se excluir o arquivo config/cells/plugin-cfg.xml antes de atualizar o arquivo plugin-cfg.xml global. Se você não excluir o arquivo config/cells/plugin-cfg.xml, somente as novas propriedades e seus valores serão incluídos no arquivo plugin-cfg.xml global. Todas as atualizações nos valores existentes da propriedade do plug-in não serão incluídas no arquivo plugin-cfg.xml global.gotcha
Nota: Como o comando GenPluginCfg é executado dentro de sua própria Java™ Virtual Machine (JVM) em vez de na JVM do WebSphere Application Server, o comando pode não conseguir acessar os outros arquivos de classe. Se você encontrar esse problema ao executar o comando GenPluginCfg, é possível então executar o script httpPluginManagement.py para gerar a configuração de plug-in centralizada em aplicativo. Esse script usa wsadmin para iniciar a geração de plug-in. Para obter informações adicionais, consulte Script httpPluginManagement.py.

Sintaxe

Para gerar novamente a configuração de plug-in, use os seguintes métodos:
  • [AIX Solaris HP-UX Linux Windows]Clique em Servidores > Tipo de Servidor > Servidores da web no console administrativo, selecione um servidor da web e, em seguida, clique em Gerar Plug-in.
  • Emita o seguinte comando:
    [AIX Solaris HP-UX Linux Windows]
    app_server_root/bin/GenPluginCfg.sh|bat
    Os dois métodos para gerar novamente a configuração de plug-in criam um arquivo plugin-cfg.xml em formato ASCII, que é o formato adequado para execução em um ambiente distribuído.
    [IBM i]
    app_server_root/bin/GenPluginCfg
    Esse método para gerar novamente a configuração de plug-in cria um arquivo plugin-cfg.xml em formato ASCII, que é o formato adequado para execução em um ambiente IBM i.
    [z/OS]
    app_server_root/bin/GenPluginCfg.sh
    Esse método para gerar novamente a configuração de plug-in cria um arquivo plugin-cfg.xml no formato UTF-8, que é o formato adequado para execução em um ambiente z/OS.

[AIX Solaris HP-UX Linux Windows][IBM i]É possível utilizar a opção -profileName para definir o perfil do processo do servidor de aplicativos em uma instalação com vários perfis. A opção -profileName não é necessária para execução em um ambiente de perfil único. O padrão para essa opção é o perfil padrão.

Quando o comando GenPluginCfg é emitido com a opção -webserver.name webservrName, o wsadmin gera um arquivo de configuração de plug-in para o servidor da Web. As configurações no arquivo de configuração gerado são baseadas na lista de aplicativos que estão implementados no servidor da Web. Quando esse comando é emitido sem a opção -webserver.name webservrName, o arquivo de configuração do plug-in é gerado com base na topologia.

Parameters

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

-config.root configroot_dir
Padrões para CONFIG_ROOT. O comando setupCmdLine é chamado para obter essa variável de ambiente.
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]Define o perfil do processo do Servidor de Aplicativos em uma instalação com vários perfis. A opção -profileName não é necessária para execução em um ambiente de perfil único. O padrão para essa opção é o perfil padrão.
-cell.name cell
Padrões para WAS_CELL. O comando setupCmdLine é chamado para obter essa variável de ambiente.
-node.name node
Padrões para WAS_NODE. O comando setupCmdLine é chamado para obter essa variável de ambiente.
-webserver.name webserver1
Requerido para criar o arquivo de configuração do plug-in para um determinado servidor da Web.
-propagate yes/no
Aplicável somente quando a opção webserver.name for especificada e o servidor da web for local ou em um nó não gerenciado remoto. Caso contrário, você deverá copiar manualmente o arquivo plugin-cfg.xml a partir de app_server_root/profiles/profile_name/config/cells/cell_name/nodes/node_name/servers/web_server_name para plugins_root/config/web_server_name no diretório de plug-ins do servidor da web remoto. O valor padrão é no.
-propagateKeyring yes/no
Aplicável apenas quando a opção webserver.name for especificada e o servidor da Web for local. O padrão é no.
-cluster.name cluster1,cluster2 | ALL
Lista opcional de clusters. Ignorada quando a opção webserver.name é especificada.
-server.name server1,server2
Lista opcional de servidores. Requerida para geração de plug-in de servidor único. Ignorada quando a opção webserver.name é especificada.
-output.file.name file_name
Definido como padrão para o arquivo configroot_dir/plugin-cfg.xml. Ignorado quando a opção webserver.name for especificada.
-destination.root root
Raiz da instalação da máquina na qual a configuração é utilizada. Ignorada quando a opção webserver.name é especificada.
-destination.operating.system windows/unix
Sistema operacional da máquina na qual a configuração é utilizada. Ignorada quando a opção webserver.name é especificada.
-force yes
Cria uma nova configuração em vez de tentar fundir com uma configuração existente quando o comando é emitido para uma geração de arquivo que inclui toda a célula.
-debug yes/no
O padrão é no.
-help
Imprime uma instrução de uso.
-?
Imprime uma instrução de uso.

Cenário de uso

Para gerar uma configuração de plug-in para todos os clusters em uma célula:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name NetworkDeploymentCell
[IBM i][z/OS]
GenPluginCfg.sh -cell.name NetworkDeploymentCell

Para gerar uma configuração de plug-in para um único servidor:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName

Para gerar um arquivo de configuração de plug-in para um servidor da Web:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName

Í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-mp&topic=rxml_genplugincfg1
Nome do arquivo: rxml_genplugincfg1.html