O módulo SNMP é uma extensão com a qual o status do Apache HTTP Server pode ser recuperado através do Simple Network Management Protocol (SNMP). SNMP é um framework de gerenciamento muito conhecido para a Internet que permite que hardware (como roteadores, bridges e modems) e software (como sistemas operacionais, camadas de rede e aplicativos) forneçam status através de uma base MIB (Management Information Base). A MIB representa uma coleção de objetos gerenciados de dispositivos remotos que são acessíveis por meio de agentes SNMP. Os gerenciadores podem consultar um agente para saber os valores dos objetos gerenciados por ele.
O IBM HTTP Server suporta as seguintes MIBs:
MIB | Descrição |
SNMPv2-MIB | MIB obrigatória para todo agente SNMP. Foi definida pelo Grupo de Trabalho do SNMPv2. |
WWW-MIB | MIB definida para o gerenciamento de Serviços WWW. É é definida dentro do grupo de trabalho da MIB SYSAPPL do IETF. |
APACHE-MIB | MIB específica para o Apache HTTP Server. |
Para poder ativar o SNMP, o Módulo SNMP tem que ser carregado através da diretiva LoadModule.
No Windows NT:
Sintaxe:LoadModule snmp_agt_module
modules/IBMModuleSNMP.dll
No unix:
Sintaxe:LoadModule snmp_agt_module libexec/mod_snmp.so
O AddModule correspondente é: AddModule mod_snmp.c
Sintaxe:SNMPenable
A ausência de SNMPenable faz com que o SNMP seja desativado.
Sintaxe:<SNMP number>...</SNMP>
Módulo:snmp_agt_module
O número define a porta da rede em que o agente SNMP atende. Número é um número de 0 a 65635; alguns números de porta (especialmente abaixo de 1024) são reservados para protocolos privados. Veja em /etc/services a lista de algumas portas definidas; a porta padrão do protocolo SNMP é a 161.
A porta 161 é uma das portas especiais da Unix. Todas as portas numeradas abaixo de 1024 são reservadas para uso do sistema, ou seja, usuários comuns (não-raiz) não podem utilizá-las, restando a eles os números de porta mais altos. Para usar a porta 161, é preciso iniciar o servidor a partir da conta raiz.
Quem não pode usar a porta 161 deve escolher qualquer outra porta livre. Usuários não-raiz terão que escolher um número de porta maior que 1023, como 8000.
Exemplo:
<SNMP 80>
SNMPcommunity public
sysContact Administrador@endereço.de.email
sysLocation your-place.your-country.your-earth.your-universe
</SNMP>
Veja também SNMPcommunity, sysDescr, sysContact e sysLocation.
Sintaxe: SNMPcommunity string
Padrão: community public
Módulo:snmp_agt_module
A comunidade é usada para definir comunidades com as quais o agente SNMP é acessível. No SNMP versão 1 e versão 2C a comunidade é usada para 'segurança'. Só comunidades válidas têm acesso às informações fornecidas pelo agente SNMP.
A comunidade conhecida mais comum é a 'public'. Muita gente a utiliza, mas ela não é necessária. Se nenhuma comunidade for fornecida, será usada a comunidade padrão. A cadeia do Nome da Comunidade pode ter no máximo 64 caracteres.
SEGURANÇA: Para que as informações do agente SNMP não fiquem disponíveis para os outros, use nomes ou palavras comuns, retirados do dicionário.
Exemplo:
SNMPcommunity public
Sintaxe: sysDescr string
Padrão:compilada em padrão que reflete os vários sinalizadores
de versão/protocolo, além de outros detalhes.
Módulo:snmp_agt_module
A diretiva sysDescr é usada para definir a descrição do sistema do host em que o agente SNMP (portanto servidor) está sendo executado e é usado para a instância do objeto sysDescr de SNMPv2-MIB (também conhecido como parte da MIB-II).
A definição diz:
"Descrição textual da entidade. Este valor deve incluir o nome completo e a identificação da versão do tipo de hardware do sistema, software do sistema operacional, e software de rede."
Exemplo:
sysDescr IHS HTTP/1.1 com SNMP
Veja também sysContact e sysLocation.
Sintaxe: sysContact string
Módulo:snmp_agt_module
A diretiva sysContact é usada para definir o endereço de contato do sistema usado para a instância do objeto sysContact de SNMPv2-MIB (também conhecido como parte da MIB-II).
A definição diz:
"Identificação textual da pessoa de contato do nó gerenciado, juntamente com informações sobre como entrar em contato com ela. Se nenhuma informação de contato é conhecida, o valor é uma cadeia de comprimento zero."
Exemplo:
sysContact Administrador@endereço.de.email
Veja também sysDescr e sysLocation.
Sintaxe:
sysLocation string
Módulo:snmp_agt_module
A diretiva sysLocation é usada para definir a localização do host em que o agente SNMP (portanto servidor) está sendo executado e é usado para a instância do objeto sysLocation da SNMPv2-MIB (também conhecida como parte da MIB-II).
A definição diz:
"A localização física do nó (ex: 'gabinete de telefones, 3º andar'). Se a localização for desconhecida, o valor será a cadeia de comprimento zero."
Exemplo:
sysLocation Andar Térreo do prédio, sala 44
Veja também sysDescr e sysContact.
Você deve ter o Módulo de Status carregado pela diretriz LoadModule para MIBs de apScoreBoardGroup.
No Windows NT:
Sintaxe:LoadModule status_module modules/ApacheModuleStatus.dll
No unix:
Sintaxe:LoadModule status_module libexec/mod_status.so
A AddModule correspondente é: AddModule mod_status.c
Sintaxe:<ExtendedStatus On>
Módulo:mod_status
A ausência de ExtendedStatus impedirá qualquer pedido bem-sucedido para dados de apScoreBoardGroup.
Sintaxe:<LocationMatch server-status>...</LocationMatch>
Módulo:mod_status
Exemplo:
<Status do servidor LocationMatch>
SetHandler server-status
</LocationMatch>