Um host virtual fornece um agrupamento lógico para configurar aplicativos da web para um determinado nome de host. O host virtual padrão (default_host) é adequado para a maioria das configurações simples.
Name | Type | Default | Description |
---|---|---|---|
id | sequência | Um ID de configuração exclusivo. | |
enabled | booleano | true | Ativar este host virtual. |
allowFromEndpointRef | Lista de referências para os elementos httpEndpoint de nível superior (sequência separada por vírgula). | Especifique o identificador de um ou mais terminais HTTP para restringir o tráfego de entrada para este host virtual aos terminais especificados. |
Associe um host e uma porta a este host virtual usando a sintaxe host:port. O host especificado pode ser um endereço IP, nome do host do servidor de nomes de domínio (DNS) com um sufixo de nome de domínio, nome do host do DNS ou * para uma correspondência de curinga em todos os nomes de host. Observe que os endereços IPv6 devem ser colocados entre [].
Especifique o identificador de um ou mais terminais HTTP para restringir o tráfego de entrada para este host virtual aos terminais especificados.
Name | Type | Default | Description |
---|---|---|---|
id | sequência | Um ID de configuração exclusivo. | |
onError |
| WARN | Ação a ser tomada após uma falha para iniciar um terminal. IGNORE O servidor não emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração. WARN O servidor emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração. FAIL O servidor emitirá uma mensagem de aviso ou de erro na primeira ocorrência de erro e, em seguida, irá parar o servidor. |
enabled | booleano | true | Alternar a disponibilidade de um terminal. Quando true, este terminal será ativado pelo dispatcher para manipular solicitações de HTTP. |
host | string | localhost | Endereço IP, nome do host do servidor de nomes de domínio (DNS) com sufixo de nome de domínio ou apenas o nome do host DNS, usado por um cliente para solicitar um recurso. Use '*' para todas as interfaces de rede disponíveis. |
httpPort | int Min: -1 Max: 65535 | A porta usada para solicitações de HTTP do cliente. Use -1 para desativar esta porta. | |
httpsPort | int Min: -1 Max: 65535 | A porta usada para solicitações de HTTP do cliente protegidas com SSL (https). Use -1 para desativar esta porta. | |
httpOptionsRef | Uma referência para o elemento de nível httpOptions (sequência). | defaultHttpOptions | Opções do protocolo HTTP para o terminal. |
sslOptionsRef | Uma referência para o elemento de nível sslOptions (sequência). | Opções do protocolo SSL para o terminal. | |
tcpOptionsRef | Uma referência para o elemento de nível tcpOptions (sequência). | defaultTCPOptions | Opções do protocolo TCP para o terminal. |
accessLoggingRef | Uma referência para o elemento de nível httpAccessLogging (sequência). | Configuração de criação de log de acesso para o terminal. |
allowFromEndpoint > httpOptions
Opções do protocolo HTTP para o terminal.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | booleano | true | Ativa as conexões persistentes (keep-alive de HTTP). Se true, as conexões são mantidas ativas para reutilização por diversas solicitações e respostas sequenciais. Se false, as conexões são encerradas após a resposta ser enviada. |
maxKeepAliveRequests | int Min: -1 | 100 | Número máximo de solicitações persistentes que são permitidas em uma única conexão HTTP se conexões persistentes estão ativadas. Um valor igual a -1 significa ilimitado. |
persistTimeout | Um período de tempo com precisão de segundo | 30s | Quantidade de tempo que um soquete terá permissão para permanecer inativo entre solicitações. Esta configuração se aplica apenas se conexões persistentes são ativadas. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos. |
readTimeout | Um período de tempo com precisão de segundo | 60s | Quantidade de tempo a esperar pela conclusão de uma solicitação de leitura em um soquete após a primeira leitura ocorrer. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos. |
writeTimeout | Um período de tempo com precisão de segundo | 60s | Quantidade de tempo a esperar em um soquete para cada parte dos dados de resposta serem transmitidos. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos. |
removeServerHeader | booleano | false | Remove informações de implementação do servidor de cabeçalhos de HTTP e também desativa a página de boas-vindas do perfil padrão do Liberty. |
NoCacheCookiesControl | booleano | true | Permite que o usuário controle se a presença de um cabeçalho Set-Cookie deve ou não atualizar o cabeçalho Cache-Control com um valor que não é de cache correspondente. Esse valor também inclui o cabeçalho Expires. |
AutoDecompression | booleano | true | Especifica se o Canal HTTP automaticamente descompacta dados do corpo da solicitação de entrada. |
allowFromEndpoint > sslOptions
Opções do protocolo SSL para o terminal.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Um período de tempo com precisão de segundo | 1d | Quantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos. |
suppressHandshakeErrors | booleano | false | Desative a criação de log de erros de handshake SSL. Os erros de handshake SSL podem ocorrer durante operação normal; no entanto, essas mensagens podem ser úteis quando o SSL está se comportando inesperadamente. |
sslRef | Uma referência para o elemento de nível ssl (sequência). | O repertório de configuração de SSL padrão. O valor padrão é defaultSSLSettings. | |
sslSessionTimeout | Um período de tempo com precisão de milissegundo | 8640ms | O limite do tempo limite para uma sessão SSL que é estabelecida pelo canal SSL. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos. |
allowFromEndpoint > tcpOptions
Opções do protocolo TCP para o terminal.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Um período de tempo com precisão de milissegundo | 60s | Quantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos. |
soReuseAddr | booleano | true | Ativa a religação imediata para uma porta sem listener ativo. |
addressIncludeList | string | Uma lista separada por vírgula de endereços que têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco. | |
addressExcludeList | string | Uma lista separada por vírgula de endereços que não têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco. | |
hostNameIncludeList | string | Uma lista separada por vírgula de nomes de host que têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido. | |
hostNameExcludeList | string | Uma lista separada por vírgula de nomes de host que não têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido. |
allowFromEndpoint > accessLogging
Configuração de criação de log de acesso para o terminal.
Name | Type | Default | Description |
---|---|---|---|
enabled | booleano | true | Ativar log de acesso.. |
filePath | Caminho para um arquivo | ${server.output.dir}/logs/http_access.log | Caminho do diretório e nome do arquivo de log de acesso. As substituições de variável padrão, como ${server.output.dir}, podem ser usadas ao especificar o caminho do diretório. |
logFormat | string | %h %u %{t}W "%r" %s %b | Especifica o formato de log que é usado ao registrar informações de acesso de cliente no log. |
maxFileSize | int Min: 0 | 20 | Tamanho máximo de um arquivo de log, em megabytes, antes de ser substituído; um valor igual a 0 significa sem limite. |
maxFiles | int Min: 0 | 2 | Número máximo de arquivos de log que serão mantidos, antes que o arquivo mais antigo seja removido; um valor igual a 0 significa sem limite. |