UPSC 2.

MANUAL DO USUÁRIO

Autor: Eduardo Henrique Alves da Cruz

Dúvidas: Mauricio Jochinsen

e-mail: jochinsen@nhs.com.br

Empresa: NHS Sistemas Eletronicos

e-mail: vendas@nhs.com.br
http://www.nhs.com.br

Versao: 2.00
Data: 13.01.2004 (DD.MM.YY)
CONTEÚDO

1 Introdução...........................................................................................................................................................................3
1.1 Visão Geral.................................................................................................................................................................. 3
1.2 Características..............................................................................................................................................................3
1.3 Sistema Operacional Suportado...................................................................................................................................3
1.4 Conteúdo do Pacote..................................................................................................................................................... 3
2 Instalação............................................................................................................................................................................ 4
2.1 Instalação no Hardware............................................................................................................................................... 4
2.1.1 Estrutura do cabo serial a ser montado (DB-9 macho - DB-9 fêmea).............................................................. 4
2.1.2 Estrura do cabo serial a ser montado (DB-9 macho - DB-25 fêmea).............................................................. 4
2.2 Instalação do Software.................................................................................................................................................5
3 Configuração.......................................................................................................................................................................6
4 Execução...........................................................................................................................................................................10
5 Desinstalação.................................................................................................................................................................... 11
1 Introdução

1.1 Visão Geral

Muitos sistemas de computadores usam um UPS (Uninterruptable Power System - nobreak) para proteger o
sistema de uma anomalia na rede de energia elétrica, usando para isso uma bateria. Entretanto, o UPS somente pode
prover uma limitada energia de bateria. Quando ocorre a falha de energia, o administrador do sistema tem que dar
shutdown no sistema; caso contrário, pode ser causado uma corrupção no sistema e perda de dados quando a bateria é
expirada.

O UPSC para LINUX é um utilitário de monitoramento para UPS. Ele pode detectar o status do UPS da marca
NHS através de um cabo conectado na porta serial da máquina. Quando acontece a anomalia na rede, UPSC pegará o
sinal de anomalia da rede e enviará mensagens de aviso a todos os usuários do sistema. Depois que o tempo de contagem
regressiva para shutdown chegar a zero, o UPSC executará a tarefa de shutdown; antes que isso ocorra, o UPSC poderá
executar scripts.

O UPSC também provê configurações programáveis de tempo para bateria baixa. A detecção de bateria baixa
pode garantir um completo shutdown do sistema quando a bateria do UPS estiver quase expirada.

1.2 Características

· Detecção de anomalia na rede de energia elétrica e bateria baixa;

· Transmissão de mensagens de aviso;
· Monitoração dos status da rede e da bateria através da porta serial RS232;
· Tempo de espera de shutdown programável;
· Execução de scripts antes do shutdown;
· Execução de scripts depois do shutdown;
· Três tipos de shutdown (halt, reboot e script no lugar do shutdown).

1.3 Sistema Operacional Suportado

O UPSC pode prover serviços para UPS somente para o LINUX versão 2.x que tenha uma porta serial RS232
dedicada.

1.4 Conteúdo do Pacote

n UPSC para LINUX em um diskette (formato DOS)

n Manual do Usuário para o UPSC
2 Instalação

2.1 Instalação no Hardware

Deve ser construído um cabo serial o qual será conectado no UPS e na máquina. O UPS NHS tem saída para
conector DB-9 macho, e a máquina pode ter tanto saída para conector DB-9 fêmea como para DB-25 fêmea; portanto há
duas possibilidades de cabos: um com DB-9 no lado da máquina e outro com DB-25 no lado da máquina (sempre
conector DB-9 no lado do UPS).

2.1.1 Estrutura do cabo serial a ser montado (DB-9 macho - DB-9 fêmea)

UPS NHS COMPUTADOR

(CONECTOR DB-9) (CONECTOR DB-9)

pino 1 - DCD (BATERIA) o------------------------o DCD (BATERIA) - pino 1

pino 8 - CTS (REDE) o------------------------------o CTS (REDE) - pino 8

pino 5 - GND o--------------------------------------------o GND - pino 5

2.1.2 Estrura do cabo serial a ser montado (DB-9 macho - DB-25 fêmea)

UPS NHS COMPUTADOR

(CONECTOR DB-9) (CONECTOR DB-25)

pino 1 - DCD (BATERIA) o------------------------o DCD (BATERIA) - pino 8

pino 8 - CTS (REDE) o------------------------------o CTS (REDE) - pino 5

pino 5 - GND o--------------------------------------------o GND - pino 7

2.2 Instalação do Software

Antes de instalar o UPSC, assegure que o cabo serial está devidamente instalado. Dê boot no computador e
entre no sistema como super-usuário (administrador, root). Mude o diretório atual para ‘/tmp’ e use o camando ‘cp’ para
copiar o arquivo de instalacao do diskette para o diretório ‘tmp’.

cd /tmp
mount /dev/fd0 /mnt/floppy
cp /mnt/floppy/upsc /tmp
umount /mnt/floppy

Quando o comando ‘umount’ estiver completado, o diretório ‘/tmp’ conterá o arquivo de instalação do UPSC
para o LINUX. Execute este arquivo no diretório ‘/tmp’ com o seguinte argumento:

./upsc install

O UPSC irá lhe perguntar sobre um arquivo chamado ‘rc.local’. Informe a localização exata deste se for
preciso; o arquivo ‘rc.local’ é uma script, a qual é executada depois de todas as scripts de inicialização do sistema
LINUX.

O UPSC também irá lhe perguntar sobre três diretórios. Um diretório será para instalar o UPSC e seus arquivos,
outro será para armazenar o arquivo de histórico e outro para gravar dois arquivos de status (um para a rede e outro para
a bateria).

Depois de informado os três diretórios, o UPSC irá copiar o arquivo ‘upsc’ para o diretório especificado do
UPSC e irá criar arquivos de configurações padrão neste diretório. Quando o processo de instalação estiver completo, o
menu de configuração do UPSC irá ser mostrado na tela. Siga as instruções no Capítulo 3 para alterar as configurações.
Pode-se optar por instalar o UPSC manualmente, para saber como fazer isto leio o help on-line do UPSC, digitando no
diretório /etc/ :

./upsc help | less

ou

./upsc help | more

3 Configuração
Depois da instalação completa do UPSC, você deve configurar o UPSC para monitorar o seu sistema de
energia. Entre com o comando abaixo sempre que você quiser iniciar o módulo de configuração do UPSC.

cd /etc/upsc (ou cd <seu caminho colocado para o UPSC>)

./upsc config

Selecione as opções pelas letras em conchetes para mudar cada item da configuração corrente. No módulo de
configuração há um menu principal (cujo os itens principais são descritos abaixo), um menu avançado (veja o help do
UPSC para maiores detalhes) e outro menu para mudança de mensagens. Depois de modificar as configurações,
pressione ‘s’ para salvar a nova configuração ou ‘q’ para sair da configuração; tecla ‘h’ disponibiliza o help. Informações
de algumas opções são descritas abaixo (uma melhor descricao de cada item é descrito no módulo de configuração do
UPSC, utilize o help dentro do módulo).

[A] - Porta serial conectada ao UPS: [PATH]

PATH padrao: /dev/ttyS0

PATH indica o caminho para a porta serial na qual o UPS esta' conectado ao com-
putador atraves do cabo serial.

[B] - Tempo de espera para iniciar monitoracao no UPS: [X] min

X padrao: 0

Toda vez que o UPSC e' inicializado, ele pode aguardar X minutos antes de efeti-
vamente comecar a monitorar o UPS, ou seja, o UPSC nao faz nada durante os pri-
meiros X minutos de sua execucao.

[C] - Intervalo de tempo que nao deve ocorrer nenhuma oscilacao no UPS: [X] seg

X padrao: 10

Quando ha' alguma oscilacao no UPS, ou seja, quando o sinal do pino CTS ou DCD
e' alterado, o UPSC fica inspecionando esses pinos durante X segundos para veri-
ficar se nao ocorre outra oscilacao nos sinais. Se depois de X segundos nao
ocorrer nenhuma outra oscilacao nos sinais, entao o UPSC fara' acoes necessarias
referente a esses sinais. Se, por outro lado, ocorrer alguma oscilacao nos si-
nais dentro dos X segundos, o UPSC aguarda mais X segundos inspecionando se ha'
ou nao outra oscilacao, e assim por diante.
[D] - Agendar shutdown longo baseado na anomalia da: [FONTE]

FONTE padrao: REDE ELETRICA

FONTE=REDE ELETRICA: quando o pino da rede (CTS) comecar a indicar rede anormal,
sera' programado o shutdown longo; se o pino da bateria (DCD) comecar a indicar
bateria baixa, sera' programado o shutdown curto. FONTE representa a fonte pri-
maria de energia da maquina.

Se o UPSC esta' em processo de shutdown longo e o pino da bateria (DCD) comecar

a indicar bateria baixa, sera' cancelado o processo de shutdown longo e sera'
acionado o processo de shutdown curto. Quando se estiver no shutdown longo, e o
tempo transcorrido do shutdown longo se igualar ao do tempo de programacao do
shutdown curto, o processo de shutdown deixara' de ser shutdown longo e passara'
a ser shutdown curto.

FONTE=BATERIA: quando o pino da bateria (DCD) comecar a indicar bateria baixa,

sera' programado o shutdown longo; se o pino da rede (CTS) comecar a indicar re-
de anormal, sera' programado o shutdown curto. FONTE representa a fonte primaria
de energia da maquina.

Se o UPSC esta' em processo de shutdown longo e o pino da rede (CTS) comecar a

indicar rede anormal, sera' cancelado o processo de shutdown longo e sera' acio-
nado o processo de shutdown curto. Quando se estiver no shutdown longo, e o tem-
po transcorrido do shutdown longo se igualar ao do tempo de programacao do
shutdown curto, o processo de shutdown deixara' de ser shutdown longo e passara'
a ser shutdown curto.

[E] - Ir para o shutdown longo quando a [FONTE2] voltar ao estado ok: [ALT]

FONTE2 padrao: BATERIA

ALT padrao: SIM

FONTE2 e' a fonte secundaria de energia, isto e', a fonte de reserva caso a fon-
te principal falte. Se a REDE ELETRICA e' a fonte primaria de energia para a ma-
quina, entao caso esta falhe, a fonte secundaria (FONTE2) e' a BATERIA; e se a
fonte primaria for a BATERIA para a maquina, a FONTE2 e' a REDE ELETRICA.

ALT=SIM: quando o shutdown curto estiver em andamento e a FONTE2 voltar ao esta-

do ok, entao sera' cancelado o shutdown curto e sera' programado o shutdown lon-
go, ou seja, o tempo para shutdown aumentara'. Se nao existir shutdown longo,
entao apenas sera' cancelado o shutdown curto e o sistema voltara' ao seu estado
normal (sem processos de shutdown agendados).

ALT=NAO: mesmo que a FONTE2 volte ao estado ok, nao sera' cancelado o shutdown
curto, ou seja, nada mudara'.
[F] - Tempo do shutdown longo: [X] min

X padrao: 10

Shutdown longo: acionado quando a fonte principal falta. Se, por exemplo, a fon-
te principal do UPS e' a REDE ELETRICA, e esta falta (se torna anormal) entao e'
acionado o shutdown longo. Shutdown longo nao e' o processo de shutdown propria-
mente dito, e sim um agendamento do processo de shutdown, ou seja, se o UPSC en-
trar no shutdown longo, os usuarios terao no maximo X minutos para salvarem seus
arquivos antes que o shutdown seja executado. Como o proprio nome indica, o
shutdown longo deve ter um tempo para shutdown maior ou igual ao do shutdown
curto. Pode-se optar por nao existir shutdown longo.

Como se trata de apenas duas fontes do UPS (REDE e BATERIA), a inclusao de uma
fonte num tipo de shutdown (curto ou longo) exclui esta do outro tipo de
shutdown. Por exemplo: shutdown longo acionado pela anomalia da REDE implica que
o shutdown curto so' pode ser acionado pela BATERIA baixa.

[G] - Tempo do shutdown curto: [X] min

X padrao: 2

Shutdown curto: acionado quando a fonte secundaria falta. Se, por exemplo, a
fonte secundaria do UPS e' a BATERIA, e esta falta (se torna baixa) entao e' a-
cionado o shutdown curto. Shutdown curto nao e' o processo de shutdown propria-
mente dito, e sim um agendamento do processo de shutdown, ou seja, se o UPSC en-
trar no shutdown curto, os usuarios terao no maximo X minutos para salvarem seus
arquivos antes que o shutdown seja executado. Como o proprio nome indica, o
shutdown curto deve ter um tempo para shutdown menor ou igual ao do shutdown
longo. Pode-se optar por nao existir shutdown curto.

Como se trata de apenas duas fontes do UPS (REDE e BATERIA), a inclusao de uma
fonte num tipo de shutdown (curto ou longo) exclui esta do outro tipo de
shutdown. Por exemplo: shutdown longo acionado pela anomalia da REDE implica que
o shutdown curto so' pode ser acionado pela BATERIA baixa.

[I] - Mostrar mensagens de mudanca de status: [ALT]

ALT padrao: SIM

ALT=SIM: quando haver mudancas no status do UPS, sera' mostrada mensagens no

terminal, essas mensagens sao sobre os atuais estados da rede e bateria no UPS.
Tambem sera' mostrada mensagens quando o sistema entrar no shutdown longo ou
curto, ou quando for cancelado o respectivo processo de shutdown e tambem quando
for executado o shutdown.

ALT=NAO: nao sera' mostrada nenhuma mensagem de mudanca de status e de processos

de shutdown.
[J] - Intervalo de mensagens de shutdown longo: [X] seg

X padrao: 20

Quando o UPSC esta' no shutdown longo, e' mostrada mensagens de alerta sobre o
provavel shutdown a cada X segundos. Pode-se optar por nao haver essas mensa-
gens.

[K] - Intervalo de mensagens de shutdown curto: [X] seg

X padrao: 10

Quando o UPSC esta' no shutdown curto, e' mostrada mensagens de alerta sobre o
provavel shutdown a cada X segundos. Pode-se optar por nao haver essas mensa-
gens.

[R] - Reiniciar UPSC com novas configuracoes

Reinicia o UPSC com as configuracoes atuais, isto e', com as configuracoes ja'
salvas ou aquelas que foram mudadas pelo usuario no modulo de configuracao.

[S] - Salvar novas configuracoes

Salva configuracoes alteradas pelo usuario no modulo de configuracao. Opcao dis-

ponivel somente quando algum item do menu principal ou avancado for mudado; sem-
pre que algum item for mudado, este tera' um asterisco (*) no seu lado esquerdo,
indicando assim que foi mudado e que devera' ser salvo se assim for desejado.

[T] - Desligar o UPSC

Desliga o UPSC. Opcao disponivel somente quando o UPSC esta' sendo executado.

[Q] - Sair

Sai do modulo de configuracao do UPSC.

[H] - HELP

Opcao para mostrar ajuda.

Pode-se escolher uma opcao desejada (letras A, B, ...) para ver a sua ajuda, ou
digitando '?' para ver o HELP completo.

Como ha' dois menus de configuracoes para o UPSC, e em cada um deles ha' as
mesmas letras para as opcoes, entao o HELP correspondente `a alguma letra depen-
dera' de qual menu se esteje; mas a tecla '?' mostrara' o mesmo HELP completo.

Caso se deseje o HELP completo sem teclar primeiro a letra 'H' e depois a tecla
'?', pode-se teclar apenas a tecla '?' nos menus.

4 Execução
Depois de finalizado o módulo de configuração com as opções desejadas, recomenda-se que seja reinicializado
o sistema operacional. Depois de reinicializado o sistema, o UPSC entra no módulo de execução automaticamente como
um programa servidor (daemon). Pode-se parar a execução do UPSC, desinstalá-lo ou executar seu módulo de
configuração novamente.

Para parar o módulo de execução, digite no caminho do UPSC (no qual foi instalado o UPSC):

./upsc stop

Para desinstalar o UPSC, digite no caminho do UPSC:

./upsc uninstall

Para entrar no módulo de configuração, digite:

./upsc config

No módulo de execução, o UPSC fica monitorando o UPS com as configurações pre-estabelecidas (através do
módulo de configuração). Os arquivos powerstatus.ups e batterystatus.ups (que estarão no caminho de status)
representam o estado atual da rede elétrica e bateria, respectivamente. O arquivo powerstatus.ups pode apresentar OK ou
FAIL para rede Ok ou anormal, respectivamente. O arquivo batterystatus.ups pode apresentar OK ou LOW para bateria
Ok ou baixa, respectivamente; esses arquivos são mantidos apenas para consulta de algum usuário ou do root.

Também é atualizado o arquivo logfileMMAA.ups, o qual é o arquivo de histórico onde qualquer alteração no
UPS é armazenado nele, além de informações como: execução de script, programação de shutdown, início de
monitoração, etc. Note que o nome do arquivo é logfileMMAA.ups, mas MM representa o mês e AA o ano corrente em
forma decimal; este arquivo é criado a cada vez que não é encontrado, ou seja, se o calendário passou de um mês para
outro ou se o ano passou de um para outro, outro arquivo é criado para tal e o antigo é mantido no caminho corrente.
5 Desinstalação
Para executar este módulo, digite no caminho do UPSC:

./upsc uninstall

Apenas é apagado a referência para executar o UPSC no arquivo /etc/rc.d/rc.local (ou outro arquivo escolhido
na instalação) e desgravado o arquivo /etc/path.ups , o qual armazena informações sobre onde estão os arquivos do
UPSC. Os demais arquivos do UPSC não são desgravados pois pode-se desejar que os arquivos de configuração do
UPSC continuem existindo para uma futura instalação, para apagar os demais arquivos/diretórios deve-se proceder
manualmente. Pode-se desinstalar o UPSC manualmente, mas lembre-se de tirar a referência do UPSC no arquivo /
etc/rc.d/rc.local.