Apêndice A. Material de Referência
A.1. Argumentos de tempo de execução do servidor
O script de inicialização do servidor do aplicativo aceita argumentos e opções. Isto permite que o servidor inicialize sob configurações alternativas em relação àquelas definidas nos arquivos de configuração standalone.xml
, domain.xml
e host.xml
.
As configurações alternativas podem incluir a inicialização do servidor com um conjunto alternativo de associações de soquete ou uma configuração secundária.
A lista dos parâmetros disponíveis pode ser acessada usando a opção de ajuda -h
ou --help
durante a inicialização.
Argumentos ou Opções | Modo de Operação | Descrição |
---|---|---|
--admin-only |
Autônomo |
Define o tipo de execução do servidor como |
--admin-only |
Domínio |
Define o tipo de execução do controlador do host como |
-b=<value>, -b <value> |
Autônomo, Domínio |
Define a propriedade do sistema |
-b<interface>=<value> |
Autônomo, Domínio |
Define a propriedade do sistema |
--backup |
Domínio |
Mantém uma cópia da configuração do domínio persistente mesmo se este host não for o controlador de domínio. |
-c=<config>, -c <config> |
Autônomo |
Nome do arquivo de configuração do servidor para uso. O padrão é |
-c=<config>, -c <config> |
Domínio |
Nome do arquivo de configuração do servidor para uso. O padrão é |
--cached-dc |
Domínio |
Se o host não é o controlador de domínio e não pode contactá-lo durante a inicialização, inicialize usando uma cópia armazenada em cache localmente da configuração do domínio. |
--debug [<port>] |
Autônomo |
Ative o modo de depuração com um argumento opcional para especificar a porta. Isto funcionará apenas se o script de inicialização suportá-lo. |
-D<name>[=<value>] |
Autônomo, Domínio |
Define uma propriedade do sistema. |
--domain-config=<config> |
Domínio |
Nome do arquivo de configuração do servidor para uso. O padrão é |
-h, --help |
Autônomo, Domínio |
Exibe a mensagem de ajuda. |
--host-config=<config> |
Domínio |
Nome do arquivo de configuração do host. O padrão é |
--interprocess-hc-address=<address> |
Domínio |
Endereço através do qual o controlador do host aguarda pela comunicação do controlador de processos. |
--interprocess-hc-port=<port> |
Domínio |
Porta através da qual o controlador do host aguarda pela comunicação do controlador de processos. |
--master-address=<address> |
Domínio |
Define a propriedade do sistema |
--master-port=<port> |
Domínio |
Define a propriedade do sistema |
--read-only-server-config=<config> |
Autônomo |
Nome do arquivo de configuração do servidor para uso. Difere de |
--read-only-domain-config=<config> |
Domínio |
Nome do arquivo de configuração do domínio para uso. Difere de |
--read-only-host-config=<config> |
Domínio |
Nome do arquivo de configuração do host para uso. Difere de |
-P=<url>, -P <url>, --properties=<url> |
Autônomo, Domínio |
Carrega propriedades do sistema a partir do URL fornecido. |
--pc-address=<address> |
Domínio |
Endereço através do qual o controlador de processos aguarda pela comunicação dos processos que ele controla. |
--pc-port=<port> |
Domínio |
Porta através da qual o controlador de processos aguarda pela comunicação dos processos que ele controla. |
-S<name>[=<value>] |
Autônomo |
Define uma propriedade de segurança. |
-secmgr |
Autônomo, Domínio |
Executa o servidor com um gerenciador de segurança instalado. |
--server-config=<config> |
Autônomo |
Nome do arquivo de configuração do servidor para uso. O padrão é |
--start-mode=<mode> |
Autônomo |
Define o modo de inicialização do servidor. Esta opção não pode ser usada em conjunto com
|
-u=<value>, -u <value> |
Autônomo, Domínio |
Define a propriedade do sistema |
-v, -V, --version |
Autônomo, Domínio |
Exibe a versão do servidor do aplicativo. |
Os arquivos de configuração que são fornecidos com o JBoss EAP são configurados para manipular o comportamento das opções (por exemplo, -b
e -u
). Se você alterar seus arquivos de configuração para não usar mais a propriedade do sistema controlada pela opção, sua inserção no comando de inicialização não terá efeito algum.
A.2. Argumentos para o utilitário add-user
A tabela a seguir descreve os argumentos disponíveis para a opção add-user.sh
ou add-user.bat
, que é um utilitário para a adição de novos usuários ao arquivo de propriedades para a autenticação inicial.
Argumento da Linha de Comando | Descrição |
---|---|
-a |
Cria um usuário no realm do aplicativo. Se omitido, o padrão é criar um usuário no realm de gerenciamento. |
-dc <value> |
O diretório de configuração do domínio que conterá os arquivos de propriedades. Se omitido, o diretório padrão será |
-sc <value> |
Um diretório alternativo de configuração do servidor autônomo que conterá os arquivos de propriedades. Se omitido, o diretório padrão será |
-up, --user-properties <value> |
O nome do arquivo alternativo de propriedades do usuário. Ele pode ser um caminho absoluto ou um nome de arquivo usado em conjunto com o argumento |
-g, --group <value> |
Lista separada por vírgulas dos grupos a serem atribuídos a este usuário. |
-gp, --group-properties <value> |
O nome do arquivo alternativo de propriedades do grupo. Ele pode ser um caminho absoluto ou um nome de arquivo usado em conjunto com o argumento |
-p, --password <value> |
Senha do usuário. |
-u, --user <value> |
O nome do usuário. Nomes de usuário podem conter somente os seguintes caracteres, em qualquer quantidade e em qualquer ordem:
|
-r, --realm <value> |
Nome do realm usado para proteger as interfaces de gerenciamento. Se omitido, o padrão será |
-s, --silent |
Executa o script |
-e, --enable |
Habilita o usuário. |
-d, --disable |
Desabilita o usuário. |
-cw, --confirm-warning |
Confirma avisos automaticamente no modo interativo. |
-h, --help |
Exibe informações de uso para o script |
-ds, --display-secret |
Imprime o valor secreto em modo não interativo. |
A.3. Atributos de interface
Os nomes de atributos nesta tabela são listados conforme aparecem no modelo de gerenciamento, por exemplo, ao usar a CLI de gerenciamento. Consulte o arquivo de definição de esquema localizado em EAP_HOME/docs/schema/wildfly-config_5_0.xsd
para ver os elementos conforme aparecem no XML, pois podem existir diferenças com relação ao modelo de gerenciamento.
Elementos da Interface | Descrição |
---|---|
qualquer |
Elemento indicando que parte dos critérios de seleção para uma interface deve ser tal que atenda pelo menos um critério, mas não necessariamente todos, do conjunto aninhado. |
any-address |
Elemento vazio inidicando que os soquetes usando esta interface devem ser associados a um endereço curinga. O endereço curinga IPv6 ( |
inet-address |
Seja um endereço IP em IPv6 ou uma anotação decimal com ponto IPv4, ou um nome de host que possa ser resolvido como um endereço IP. |
link-local-address |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se um endereço associado a ele é link-local ou não. |
loopback |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se trata-se de uma interface loopback ou não. |
loopback-address |
Endereço de loopback que pode não ser configurado na interface de loopback do computador. Difere-se do tipo de endereço inet em que o valor fornecido será usado mesmo que nenhum NIC que tenha o endereço IP associado a ele possa ser encontrado. |
multicast |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se oferece suporte para multicast ou não. |
name |
O nome da interface. |
nic |
Nome de uma interface de rede (ex. eth0, eth1, lo). |
nic-match |
Expressão regular através da qual os nomes das interfaces de rede disponíveis na máquina podem ser correspondidos para encontrar uma interface aceitável. |
not |
Elemento indicando que parte dos critérios de seleção para uma interface deve ser tal que não atenda a critério algum do conjunto aninhado. |
point-to-point |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se trata-se de uma interface ponto a ponto ou não. |
public-address |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se possui um endereço publicamente roteável ou não. |
site-local-address |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se um endereço associado a ele é site-local ou não. |
subnet-match |
Um endereço IP de rede e o número de bits no prefixo de rede do endereço, escrito em notação slash (por exemplo, |
up |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se está ativo no momento. |
virtual |
Elemento vazio indicando que parte dos critérios de seleção para uma interface deve ser se trata-se de uma interface virtual ou não. |
A.4. Atributos da Associação de Soquete
Os nomes de atributos nesta tabela são listados conforme aparecem no modelo de gerenciamento, por exemplo, ao usar a CLI de gerenciamento. Consulte o arquivo de definição de esquema localizado em EAP_HOME/docs/schema/wildfly-config_5_0.xsd
para ver os elementos conforme aparecem no XML, pois podem existir diferenças com relação ao modelo de gerenciamento.
Atributos | Descrição |
---|---|
client-mappings |
Especifica os mapeamentos de clientes para esta associação de soquete. Um cliente conectando a este soquete deve usar o endereço de destino especificado no mapeamento que corresponde a sua interface de saída desejada. Isto permite que as topologias de rede avançadas que usam conversão de endereço de rede ou possuem associações em múltiplas interfaces de rede funcionem. Cada mapeamento deve ser avaliado em ordem declarada, com a primeira correspondência bem-sucedida usada para determinar o destino. |
fixed-port |
Determina se o valor de porta deve manter-se fixo mesmo se os deslocamentos numéricos forem aplicados a outros soquetes no grupo de soquetes. |
interface |
Nome da interface com a qual o soquete deve ser associado ou, para soquetes multicast, a interface na qual ele deve aguardar por comunicação. Esta deve ser uma das interfaces declaradas. Se não estiver definido, o valor do atributo |
multicast-address |
Endereço multicast através do qual o soquete deve receber tráfego muticast. Se não especificado, o soquete não será configurado para receber multicast. |
multicast-port |
A porta pela qual o soquete deve receber o tráfego multicast. Ela deve ser configurada se o |
name |
Nome do soquete. Serviços com necessidade de acessar as informações de configuração do soquete o encontrarão usando este nome. Este atributo é necessário. |
port |
Número de porta com o qual o soquete deve ser associado. Observe que este valor pode ser substituído se os servidores aplicarem um deslocamento de porta para incrementar ou diminuir todos os valores de porta. |
A.5. Associações de Soquete Padrão
As tabelas a seguir mostram as associações de soquete padrão para cada grupo de associação de soquetes.
Associação de soquetes | Porta | Descrição |
---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Usado para clusterização HTTP e balanceamento de carga. |
http |
8080 |
Porta padrão para aplicativos web implantados. |
https |
8443 |
Conexão SSL criptografada entre aplicativos web implantados e clientes. |
management-http |
9990 |
Usado para comunicação HTTP com a camada de gerenciamento. |
management-https |
9993 |
Usado para comunicação HTTPS com a camada de gerenciamento. |
txn-recovery-environment |
4712 |
Gerenciador de recuperação de transação JTA. |
txn-status-manager |
4713 |
Gerenciador de transação JTA / JTS. |
Associação de soquetes | Porta | Porta Multicast | Descrição |
---|---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Usado para clusterização HTTP e balanceamento de carga. | |
http |
8080 |
Porta padrão para aplicativos web implantados. | |
https |
8443 |
Conexão SSL criptografada entre aplicativos web implantados e clientes. | |
jgroups-mping |
45700 |
Multicast. Usado para descobrir a associação inicial em um cluster HA. | |
jgroups-tcp |
7600 |
Descoberta unicast de máquinas em clusters HA usando TCP. | |
jgroups-udp |
55200 |
45688 |
Descoberta multicast de máquinas em clusters HA usando UDP. |
management-http |
9990 |
Usado para comunicação HTTP com a camada de gerenciamento. | |
management-https |
9993 |
Usado para comunicação HTTPS com a camada de gerenciamento. | |
modcluster |
23364 |
Porta multicast para a comunicação entre o JBoss EAP e o balanceador de carga HTTP. | |
txn-recovery-environment |
4712 |
Gerenciador de recuperação de transação JTA. | |
txn-status-manager |
4713 |
Gerenciador de transação JTA / JTS. |
Associação de soquetes | Porta | Descrição |
---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Usado para clusterização HTTP e balanceamento de carga. |
http |
8080 |
Porta padrão para aplicativos web implantados. |
https |
8443 |
Conexão SSL criptografada entre aplicativos web implantados e clientes. |
iiop |
3528 |
Serviços CORBA para transações JTS e outros serviços dependentes de ORB. |
iiop-ssl |
3529 |
Serviços CORBA criptografados por SSL. |
management-http |
9990 |
Usado para comunicação HTTP com a camada de gerenciamento. |
management-https |
9993 |
Usado para comunicação HTTPS com a camada de gerenciamento. |
txn-recovery-environment |
4712 |
Gerenciador de recuperação de transação JTA. |
txn-status-manager |
4713 |
Gerenciador de transação JTA / JTS. |
Nome | Porta | Porta Multicast | Descrição |
---|---|---|---|
ajp |
8009 |
Protocolo Apache JServ. Usado para clusterização HTTP e balanceamento de carga. | |
http |
8080 |
Porta padrão para aplicativos web implantados. | |
https |
8443 |
Conexão SSL criptografada entre aplicativos web implantados e clientes. | |
iiop |
3528 |
Serviços CORBA para transações JTS e outros serviços dependentes de ORB. | |
iiop-ssl |
3529 |
Serviços CORBA criptografados por SSL. | |
jgroups-mping |
45700 |
Multicast. Usado para descobrir a associação inicial em um cluster HA. | |
jgroups-tcp |
7600 |
Descoberta unicast de máquinas em clusters HA usando TCP. | |
jgroups-udp |
55200 |
45688 |
Descoberta multicast de máquinas em clusters HA usando UDP. |
management-http |
9990 |
Usado para comunicação HTTP com a camada de gerenciamento. | |
management-https |
9993 |
Usado para comunicação HTTPS com a camada de gerenciamento. | |
modcluster |
23364 |
Porta multicast para a comunicação entre o JBoss EAP e o balanceador de carga HTTP. | |
txn-recovery-environment |
4712 |
Gerenciador de recuperação de transação JTA. | |
txn-status-manager |
4713 |
Gerenciador de transação JTA / JTS. |
Nome | Porta | Porta Multicast | Descrição |
---|---|---|---|
http |
8080 |
Porta padrão para aplicativos web implantados. | |
https |
8443 |
Conexão SSL criptografada entre aplicativos web implantados e clientes. | |
management-http |
9990 |
Usado para comunicação HTTP com a camada de gerenciamento. | |
management-https |
9993 |
Usado para comunicação HTTPS com a camada de gerenciamento. | |
mcmp-management |
8090 |
A porta da conexão do protocolo de gerenciamento de mod-cluster (MCMP) para transmissão de eventos de ciclo de vida. | |
modcluster |
23364 |
Porta multicast para a comunicação entre o JBoss EAP e o balanceador de carga HTTP. |
Revised on 2018-01-11 05:28:21 EST