Utilize esta página para visualizar e configurar um canal de transporte HTTP. Esse tipo de canal de transporte manipula pedidos HTTP de um cliente remoto.
Um canal de transporte HTTP analisa os pedidos HTTP e, em seguida, localiza um canal de aplicativos apropriado para manipular o pedido e enviar uma resposta.
Para visualizar essa página do console administrativo, clique em server_name > Portas. Localize a porta para o canal HTTP cujas configurações você deseja visualizar ou configurar e clique em Visualizar Transportes Associados. Clique no nome da cadeia de transporte que inclui esse transporte HTTP e, em seguida, clique no nome do canal de transporte HTTP.
Especifica o nome do canal de transporte HTTP.
O campo de nome não pode conter nenhum dos seguintes caracteres: # \ / , : ; " * ? < > | = + & % '
Esse nome deve ser exclusivo entre todos os canais no sistema. Por exemplo, um canal de transporte HTTP e um canal de transporte TCP não podem ter o mesmo nome se residirem no mesmo sistema.
| Informações | Valor |
|---|---|
| Tipo de Dados | String |
Especifica a prioridade deste canal em relação aos outros canais nesta cadeia de transporte. Esta propriedade é utilizada apenas quando o compartilhamento de porta está ativado, e a cadeia de transporte inclui vários canais para os quais ela pode redirecionar dados. O canal na cadeia que tem o menor peso de discriminação é o primeiro canal que examina os dados de entrada e determina se ele possui esses dados.
| Informações | Valor |
|---|---|
| Tipo de Dados | Inteiro positivo |
| Padrão | 0 |
Para Usuários de Transição: Nas versões anteriores, uma exceção "Falha de discriminação" no Canal HTTP responde com um código de resposta 403. No Versão 8.5, o servidor responde com um código de resposta 500.trnsEspecifica o tempo, em segundos, em que o canal de transporte HTTP aguarda a conclusão de um pedido de leitura em um soquete depois que a primeira leitura ocorre. A leitura que está sendo aguardada poderia fazer parte do corpo do pedido de leitura, como um POST, ou parte dos cabeçalhos, se nenhum cabeçalho for lido como parte da primeira leitura que ocorre no soquete para esse pedido.
| Informações | Valor |
|---|---|
| Tipo de Dados | Número Inteiro |
| Padrão | 60 segundos |
Especifica o tempo, em segundos, em que o canal de transporte HTTP aguarda em um soquete que cada parte dos dados de resposta seja transmitida. Esse tempo limite normalmente ocorre em situações em que as gravações estão atrasando os novos pedidos. Isso pode ocorrer quando um cliente possui uma baixa taxa de dados ou a NIC (placa da interface de rede) do servidor está saturada com E/S.
Se alguns dos clientes precisarem de mais de 300 segundos para receber os dados que estão sendo gravados neles, altere o valor especificado para o parâmetro Tempo Limite de Gravação. Alguns clientes são lentos e requerem mais de 300 segundos para receber dados que estão sendo enviados para eles. Para assegurar que eles possam obter todos os seus dados, altere o valor especificado para este parâmetro para um período de tempo em segundos que seja suficiente para que todos os dados sejam recebidos. Certifique-se que, se você alterar o valor desta configuração, o novo valor ainda proteja o servidor dos clientes mal-intencionados.
| Informações | Valor |
|---|---|
| Tipo de Dados | Número Inteiro |
| Padrão | 60 segundos |
Especifica a quantidade de tempo, em segundos, que o canal de transporte HTTP permite que um soquete permaneça inativo entre pedidos.
| Informações | Valor |
|---|---|
| Tipo de Dados | Número Inteiro |
| Padrão | 30 segundos |
Quando selecionado, especifica que as conexões do canal de transporte HTTP são deixadas abertas entre os pedidos. Deixar as conexões abertas poderá salvar a configuração e reduzir os custos dos soquetes, se a carga de trabalho tiver clientes que enviam vários pedidos.
Se seus clientes enviarem apenas pedidos simples por períodos de tempo significativamente longos, provavelmente será melhor desativar esta opção e fechar as conexões imediatamente, em vez de deixar o canal de transporte HTTP configurar os tempos limites para fechar a conexão posteriormente.
O valor padrão é true, que normalmente é a configuração ideal.
Evitar Problemas: Se um valor
diferente de 0 for especificado para a propriedade número máximo de pedidos persistentes, a
configuração da propriedade Utilizar conexões persistentes (keep-alive) será ignorada.gotchaQuando selecionado, especifica que o número de pedidos persistentes por conexão não está limitado.
Quando selecionado, especifica que o número de pedidos persistentes por conexão está limitado ao número especificado para a propriedade Número Máximo de Pedidos Persistentes. Essa definição de propriedade será ignorada se a propriedade Utilizar Conexões Persistentes (keep-alive) não estiver ativada.
Altere o valor especificado para o parâmetro Número Máximo de Pedidos Persistentes, para aumentar o número de pedidos que podem fluir por uma conexão antes de seu fechamento. Quando a opção Utilizar Conexões Persistentes for ativada, o parâmetro Número Máximo de Pedidos Persistentes controlará o número de pedidos que podem fluir por uma conexão antes de seu fechamento. O valor padrão é 100. Este valor deve ser definido como um valor de forma que a maioria, senão todos os clientes, sempre tenham uma conexão aberta quando fizerem vários pedidos durante a mesma sessão. Uma definição apropriada para este parâmetro ajuda a eliminar a configuração e remoção desnecessárias de soquetes.
Para cenários de teste em que o cliente nunca fechará um soquete ou em que os soquetes são sempre servidores da Web ou proxy na frente do seu servidor de aplicativos, um valor -1 desativará o processamento, que limita o número de solicitações em uma conexão única. O tempo limite persistente ainda encerrará alguns soquetes inativos e impedirá que seu servidor seja executado sem soquetes abertos.
Especifica o número máximo de pedidos persistentes que são permitidos em uma única conexão HTTP. Será possível incluir um valor nesse campo apenas se a propriedade Máximo de Pedidos Persistentes por Conexão for selecionada.
Quando a opção Utilizar Conexões Persistentes for ativada, o parâmetro Número Máximo de Pedidos Persistentes controlará o número de pedidos que podem fluir por uma conexão antes de seu fechamento. O valor padrão é 100. Este valor deve ser definido como um valor de forma que a maioria, senão todos os clientes, sempre tenham uma conexão aberta quando fizerem vários pedidos durante a mesma sessão. Uma definição apropriada para este parâmetro ajuda a eliminar a configuração e remoção desnecessárias de soquetes.
Para cenários de teste em que o cliente nunca fechará um soquete ou em que os soquetes são sempre servidores da Web ou proxy na frente do seu servidor de aplicativos, um valor -1 desativará o processamento que limita o número de solicitações em uma conexão única. O tempo limite persistente ainda encerrará alguns soquetes inativos e impedirá que seu servidor seja executado sem soquetes abertos.
Se um valor 0 ou 1 for especificado, somente um pedido será permitido por conexão.
| Informações | Valor |
|---|---|
| Tipo de Dados | Número Inteiro |
| Padrão | 100 |
Especifica, em bytes, o tamanho máximo de um cabeçalho que pode ser incluído em um pedido HTTP.
A definição dessa propriedade com um número realístico para seus aplicativos ajuda a evitar ataques DoS (negação de serviço) que utilizam cabeçalhos grandes em um pedido HTTP como tentativa de tornar um recurso do sistema, como aplicativos que controlam pedidos HTTP, essencialmente indisponível a seus usuários planejados.
O padrão para essa propriedade é 32768 bytes.
Especifica o número máximo de cabeçalhos que podem ser incluídos em um único pedido HTTP.
A definição dessa propriedade com um número realístico para seus aplicativos ajuda a evitar ataques DoS (negação de serviço) que utilizam um grande número de cabeçalhos em um pedido HTTP como tentativa de tornar um recurso do sistema, como aplicativos que processam pedidos HTTP, essencialmente indisponível a seus usuários planejados.
O padrão para essa propriedade é 50.
Evitar Problemas: Mesmo se você não alterar o valor dessa
propriedade, quando usar essa página do console administrativo, para alterar
outras configurações de canal de transporte HTTP, o valor especificado
para essa propriedade ao salvar será salvo automaticamente
na propriedade correspondente no arquivo server.xml. Essa mudança substituirá
qualquer valor configurado anteriormente para essa propriedade no arquivo
server.xml mesmo se você não pretendia atualizar o valor atual dessa
propriedade no arquivo server.xml.gotchaQuando selecionado, especifica que o tamanho do corpo de um pedido de HTTP é limitado.
Essa propriedade pode ser utilizada para evitar ataques de negação de serviço que utilizam pedidos HTTP grandes como tentativa de tornar um recurso do sistema, como os aplicativos que processam pedidos HTTP, essencialmente indisponível a seus usuários planejados.
Especifica, em bytes, o limite de tamanho máximo para o corpo de um pedido HTTP. Se esse tamanho for excedido, o pedido não será processado.
Um valor poderá ser incluído nesse campo somente se a propriedade Limitar Tamanho de Buffer de Corpo de Pedido for selecionada.
É possível utilizar as definições nesta seção para configurar e ativar a criação de log de acesso NCSA (National Center for Supercomputing Applications), ou ainda para a criação de log de erros de HTTP. Se você estiver executando o produto no z/OS, poderá também utilizar esta seção para configurar e ativar a criação de log do FRCA (Fast Response Cache Accelerator). A ativação de qualquer um desses serviços de criação de log reduz o desempenho do servidor.
Se desejar que qualquer um dos serviços de criação de log ativados sejam iniciados quando o servidor for iniciado, clique em server_name. Em seguida, na seção Resolução de Problemas, clique em Criação de Log de Erros de HTTP, Acesso NCSA e FRCA e selecione Ativar Serviço de Criação de Log na Inicialização do Servidor. Quando essa opção estiver selecionada, qualquer erro de HTTP, serviço de criação de log de NCSA ou FRCA que for ativado será iniciado automaticamente quando o servidor for iniciado.
Evitar Problemas: Se você estiver executando o produto
no z/OS, as configurações de criação de log de erros de HTTP, acesso NCSA e FRCA
deverão ser especificadas no controlador. Essas configurações serão ignoradas se forem
especificadas no servidor ou no adjunto.gotchaPor padrão, a opção Utilizar Serviço de Criação de Log Global é selecionada para criação de log de acesso NCSA. Essa definição significa que as configurações de criação de log de acesso NCSA têm como padrão as configurações especificadas para criação de log de acesso NCSA na página Criação de Log de Erros de HTTP, Acesso NCSA e FRCA no console administrativo. Se você quiser alterar essas configurações para esse canal de transporte HTTP específico, expanda a seção Criação de Log de Acesso NCSA e selecione a opção Utilizar Criação de Log de Cadeia Específica.
Quando selecionado, um registro de pedidos do cliente de entrada que o canal de transporte HTTP trata é mantido no arquivo de log de acesso NCSA.
Especifica o caminho e o nome do diretório do arquivo de log de acesso NCSA. Substituições de variáveis padrão, como $(SERVER_LOG_ROOT), podem ser utilizadas durante a especificação do caminho do diretório.
Se você estiver executando o produto no z/OS, deverá utilizar uma
variável específica do servidor, como $(SERVER_LOG_ROOT), para evitar conflitos de nome
de arquivo de log.
Especifica o tamanho máximo, em megabytes, do arquivo de log de acesso NCSA. Quando esse tamanho é atingido, o arquivo de log de archive logfile_name é criado. No entanto, toda vez que o arquivo do registro original estoura essa arquivo archive, o arquivo é sobrescrito com a versão mais atual do arquivo de log original.
Especifica o número máximo de versões históricas do arquivo de log de acesso NCSA que são mantidas para referência futura.
Especifica em qual formato as informações de acesso do cliente aparecem no arquivo de log do NCSA. Se Comum estiver selecionado, as entradas de log conterão o recurso solicitado e algumas outras partes de informações, mas não conterão informações de referência, do agente usuário e de cookie. Se Combinado estiver selecionado, serão incluídas informações de referência, do agente usuário e de cookie.
Por padrão, a opção Utilizar Serviço de Criação de Log Global é selecionada para criação de log do FRCA. Essa configuração significa que as configurações de criação de log do FRCA são padronizadas para configurações especificadas para criação de log FRCA na página Criação de logs de erro HTTP, acesso NCSA e FRCA no console administrativo. Se você quiser alterar essas configurações para esse canal de transporte HTTP específico, expanda a seção Criação de log do FRCA e selecione a opção Utilizar Criação de Log de Cadeia Específica.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Quando selecionado, um registro de pedidos do cliente de entrada que o canal de transporte HTTP trata é mantido no arquivo de log do FRCA.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Especifica o caminho e o nome do diretório do arquivo de log do FRCA. Você deverá utilizar uma variável específica do servidor, como $(SERVER_LOG_ROOT), para evitar conflitos de nome de arquivo de log.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Especifica o tamanho máximo, em megabytes, do arquivo de log do FRCA. Quando esse tamanho é atingido, o arquivo de log de archive logfile_name é criado. No entanto, toda vez que o arquivo do registro original estoura essa arquivo archive, o arquivo é sobrescrito com a versão mais atual do arquivo de log original.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Especifica o número máximo de versões históricas do arquivo de log do FRCA que são mantidas para referência futura.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Especifica em qual formato as informações de acesso do cliente aparecem no arquivo de log do FRCA. Se Comum estiver selecionado, as entradas de log conterão o recurso solicitado e algumas outras partes de informações, mas não conterão informações de referência, do agente usuário e de cookie. Se Combinado estiver selecionado, serão incluídas informações de referência, do agente usuário e de cookie.
Esse campo será exibido somente se você estiver executando o produto no z/OS.
Por padrão, a opção Utilizar Serviço de Criação de Log Global é selecionada para criação de log de erros. Essa definição significa que as configurações de criação de log de erros têm como padrão as configurações especificadas para criação de log de erros na página Criação de Log de Erros de HTTP, Acesso NCSA e FRCA no console administrativo. Se você quiser alterar essas configurações para esse canal de transporte HTTP específico, expanda a seção Criação de Log de Erros e selecione a opção Utilizar Criação de Log de Cadeia Específica.
Quando selecionado, os erros de HTTP que ocorrem enquanto o canal HTTP processa pedidos do cliente são registrados no arquivo de log de erros de HTTP.
Indica o caminho e o nome do diretório do arquivo de log de erros de HTTP. Substituições de variáveis padrão, como $(SERVER_LOG_ROOT), podem ser utilizadas durante a especificação do caminho do diretório.
Se você estiver executando o produto no z/OS, deverá utilizar uma
variável específica do servidor, como $(SERVER_LOG_ROOT), para evitar conflitos de nome
de arquivo de log.
Indica o tamanho máximo, em megabytes, do arquivo de log de erros HTTP. Quando esse tamanho é atingido, o arquivo de log de archive logfile_name é criado. No entanto, toda vez que o arquivo do registro original estoura essa arquivo archive, esse arquivo é sobrescrito com a versão mais atual do arquivo de log original.
Especifica o número máximo de versões históricas do arquivo de log de erros de HTTP que são mantidas para referência futura.
Especifica o tipo de mensagens de erro que são incluídas no arquivo de log de erros de HTTP.