SAGE

Sistema Aberto de Gerenciamento de Energia

SAGE SNMP: Agente SNMP

Av. Horcio Macedo, 354 - Cidade Universitria

CEP 21941-911

Rio de Janeiro RJ

Dezembro de 2007

A informao contida neste documento de propriedade do CEPEL, tendo se originado de trabalho desenvolvido nesta
empresa para consulta e referncia dos usurios do sistema SAGE, e no poder ser reproduzida ou utilizada para
quaisquer outros fins sem autorizao prvia e expressa do CEPEL. Este documento baseia-se em informao disponvel
na data de sua publicao. Embora sejam feitos esforos para torn-lo preciso, este no se prope a cobrir todos os
detalhes ou particularidades apresentadas pelo sistema. O CEPEL no se responsabiliza por notificar os usurios deste
documento de possveis alteraes feitas posteriormente.

Contedo
INTRODUO ................................................................................. 3
ARQUITETURA ............................................................................... 5
PROCESSOS ................................................................................... 7
CONFIGURAO............................................................................. 9
INFORMAES ACESSVEIS VIA AGENTE SAGE SNMP................. 11
Lista de variveis de ambiente disponveis: .......................................... 12

i
SAGE
Sistema Aberto de Gerenciamento de Energia

- Contedo

ii
SAGE SNMP : Agente SNMP
Dezembro - 2007

Introduo

O Agente SAGE SNMP tem por objetivo tornar o SAGE gerencivel. Isto
significa que o SAGE tem capacidade de responder requisies SNMP e
informar caractersticas do desempenho e configurao de um sistema
SAGE.

3
SAGE
Sistema Aberto de Gerenciamento de Energia

- Introduo

4
SAGE SNMP : Agente SNMP
Dezembro - 2007

Arquitetura
O processo agente SNMP acessa dados diretamente da base de dados de
tempo real.
Um processo monitor coleta periodicamente algumas informaes sobre
processos do SAGE e coloca dados na base de dados de tempo real do
SAGE. O monitor no imprescindvel para o funcionamento do agente
SAGE SNMP, mas sem o monitor algumas informaes como utilizao
de CPU e consumo de memria por processos SAGE ficam
indisponveis.
A recomendao do CEPEL instanciar mais de um agente SNMP em
estao SAGE (servidor ou ihm). Um agente seria o agente SNMP j
existente no prprio sistema que poderia ser executado sem a
dependncia do SAGE. Outra instncia de agente SNMP seria o agente
SAGE SNMP que depende do sistema SAGE pois depende de acessos
base de dados de tempo real.

GERENTE
SAGE SNMP

AGENTE SNMP
MIB-SAGE

GERENTE
SNMP

MIB-X

TRANSPORTADORES

MIB-Y

1
GCD
MCAST

2
1
MONITOR

SISTEMA
OPERACIONAL

BDTR
1

COLETA DE
DADOS

ARMAZENAMENTO

REQUISIO
SNMP

CONSULTA
DE DADOS

RESPOSTA
SNMP

Figura 1 Agente SNMP SAGE

5
SAGE
Sistema Aberto de Gerenciamento de Energia

- Arquitetura

6
SAGE SNMP : Agente SNMP
Dezembro - 2007

Processos

O processo sage agente SNMP (snmpd) deve ser ativado pelo gcd ou por
scripts prprios do SAGE para tal fim, que so:
ativa sagesnmpd para ativar agente SAGE SNMP
desativa sagesnmpd para ativar agente SAGE SNMP

O processo monitor tambm configurado com scripts de ativao e

desativao seguindo mesmo padro:
ativa monitor para ativar monitor
desativa monitor para ativar monitor

O agente SAGE SNMP gera arquivo de log em $LOG/sagesnmpd.log.

O agente SAGE SNMP por configurao default executado de maneira

a estar apto a receber dados pela porta 1027.

7
SAGE
Sistema Aberto de Gerenciamento de Energia

- Processos

8
SAGE SNMP : Agente SNMP
Dezembro - 2007

Configurao

O arquivo sagesnmpd.conf contm a configurao para instanciao do

agente SAGE SNMP.
Existe uma chamada para o mdulo que permite a um agente net-snmp
responder a requisies acerca de um sistema SAGE.
A chamada obedece o seguinte formato:
dlmod sagesnmpd $LIB/net-snmp/sagesnmpd.so

onde $LIB substitudo pelo diretrio que contm bibliotecas

necessrias ao SAGE. $LIB uma varivel de ambiente no SAGE.
Os seguintes campos podem ou devem ser informados no arquivo de
configurao sagesnmpd.conf:

rwcommunity (obrigatrio)

trapsink e trapcommunity (opcional)

exec e execfix (opcional)

Uma configurao bsica a do seguinte exemplo:

trapcommunity public
trapsink itauba 162
rwcommunity public

Trapcommunity define uma palavra a ser enviada em mensagens trap

para garantir um nvel fraco de autenticao.
Trapsink define o endereo de rede a receber traps originrios do agente
SAGE SNMP.
Rwcommunity define tambm uma palavra a ser enviada em mensagens
trap para garantir um nvel fraco de autenticao.
facultativo definir ativao e desativao de processos para o agente
SAGE SNMP. Tais pontos tero OIDs associados a entradas na extTable
encontrada na MIB UCD-SNMP. Tal procedimento configurado pelas
linhas:
exec nome_referncia comando_status
execfix nome_referncia comando_executar

9
SAGE
Sistema Aberto de Gerenciamento de Energia

- Configurao

Para a linha exec define-se um comando que ser executado a cada

leitura (mensagem SNMP GET) no OID assinalado para o referido
nome_referncia. Para a linha com configurao execfix define-se um
comando a ser executado a partir de uma mensagem SNMP SET com
valor 1.
Um exemplo para o processo referente ao conversor de protocolos do
ICCP dado a seguir:
exec iccp_on /bin/ps -C iccp
execfix iccp_on /bin/csh
/home/sage/sage/bin/scripts/iccp_on.rc
exec iccp_off /bin/ps -C iccp
execfix iccp_off /bin/csh
/home/sage/sage/bin/scripts/iccp_off.rc

Neste exemplo uma leitura (SNMP GET) no oid referente a iccp_on

retorna o resultado do comando unix para status de processo (os). J
o comando definido em execfix executa a ativao/desativao do
processo.
A fim de facilitar o processo de criao do arquivo de configurao, est
disponvel um script (gensagesnmpdconf.pl) que permite criar um
arquivo de configurao $SAGE/sagesnmpd.conf. Para isto necessrio
um arquivo bsico de configurao bsico ($SAGE/snmpd_basico.conf)
que contm apenas dados sobre trapcommunity (opcional), trapsink
(opcional) e rwcommunity. Um arquivo $SAGE/processos_snmpd.conf
define os processos em linha separadas a serem configurados para ter
uma interfaces para ativao e desativao.
O prprio script de ativao do agente SAGE SNMP executa o script
para criar o arquivo sagesnmpd.conf.

10
SAGE SNMP : Agente SNMP
Dezembro - 2007

Informaes acessveis via agente SAGE SNMP

Um gerente SNMP pode acessar informaes referentes a:

ns em um sistema SAGE

processos do SAGE

comunicao em um sistema SAGE

variveis de ambiente

referncias de tempo

O documento para consulta sobre qualquer informao acessvel pelo

agente SAGE SNMP est disponvel na MIB SAGE. Este documento
descreve de uma forma geral como a MIB SAGE est organizada.
Para ns de um sistema SAGE as informaes esto disponveis em
tabela noh (tabela descrita na MIB SAGE). Esta tabela contm as
seguintes informaes:

nome

estado

descrio

endereo IP

nmero de processos

nmero de MCDs

hora da ltima ativao

memria disponvel

swap disponvel

Para processos as informaes esto disponveis em tabelas separadas

para gmcd, sac, alr etc. Para qualquer dos processos com tabela
disponvel as informaes disponibilizadas so:

estado do processo

nmero de restarts

tempo de operao do processo

consumo de memria

consumo de CPU

nmero de page faults

PID do processo
11
SAGE
Sistema Aberto de Gerenciamento de Energia

- Informaes acessveis via agente SAGE SNMP

PID do processo pai

Para informaes sobre comunicao h uma srie de dados

disponibilizados em vrias tabelas que organizam os dados referentes a
vrias entidades que constam na base de referncia do SAGE:

Tabela referente a LSC (ligaes)

Tabela referente a CXU (Conexes)

Tabela referente a ENU (enlace UTR)

Tabela referente a UTR

Tabela referente a MUL (Multiligao)

Tabela referente a ENM (enlace de multiligao)

Tabela referente a CNM (canal lgico)

Para informaes sobre variveis de ambiente, h um conjunto de

variveis de ambiente que so informadas com o comando var do SAGE.

Lista de variveis de ambiente disponveis:

SAGE

HOST

CPU

SGBD

VERSAO BASE

CONTEXTO MODO

LOG

MODELO

NOH

LOCAL

REMOTO

SAC_HOST1 SAC_HOST2

HOME
ARQS

METODO_DIFUSAO

Para referncia de tempo o agente pode buscar informaes coletadas

sobre status de NTP no sistema SAGE. Est disponibilizada uma tabela
com as seguintes informaes:

Atraso com servidor NTP

Jitter na comunicao com servidor NTP

NTP offset que a diferena entre a hora local e a hora do

servidor NTP

Outros dados

Por fim, o documento de referncia para informaes acessveis via MIB

SAGE a prpria descrio no documento SAGE-MIB.txt.

12
SAGE SNMP : Agente SNMP
Dezembro - 2007