Manual Agora NG Instadm v6.3 PT - Draft (Alsoft) - v3

AGORA-NG
Manual de Instalao AgoraNG

Guia de Instalao de verses 6.3
[6.3] | [Novembro de 2012]

2

Copyright 2012 Portugal Telecom Inovao. Todos os direitos so reservados. Este manual no
pode ser total ou parcialmente copiado, fotocopiado, reproduzido, traduzido ou convertido em formato
eletrnico, sem prvia autorizao escrita da PT Inovao, S.A.

[Agora-NG] uma marca registada da Portugal Telecom Inovao.

Portugal Telecom Inovao
Rua Eng. Jos Ferreira Pinto Basto
3810-106 Aveiro Portugal
http://www.ptinovacao.pt
Tel: +351 234 403 200
Fax: +351 234 424 723

ndice de Contedos

3
ndice de Contedos

1 Pr-requisitos .................................................................................................................... 7
1.1 Data Communication Network ............................................................................................ 7
1.2 Instalao do java e jboss ................................................................................................... 9
1.2.1 Instalao por YUM ........................................................................................................... 10
1.2.2 Instalao por RPM ........................................................................................................... 10
1.3 Oracle 11g ......................................................................................................................... 11
1.3.1 Instncia Oracle ................................................................................................................ 11
1.4 Apache .............................................................................................................................. 13
2 Instalao ......................................................................................................................... 16
2.1 Pacotes de instalao ....................................................................................................... 16
2.1.1 Assure Pack ...................................................................................................................... 17
2.1.2 Provision Pack ................................................................................................................... 18
2.1.3 Northbound Alarms Interface (opcional) ........................................................................... 19
2.1.4 Northbound Inventory Interface (opcional) ........................................................................ 19
2.1.5 Northbound GPON Interface (opcional) ............................................................................ 19
2.1.6 Northbound DSL Interface (opcional)................................................................................ 19
2.2 Procedimentos de instalao ............................................................................................ 20
2.2.1 Instalao por YUM ........................................................................................................... 20
2.2.2 Instalao por RPM ........................................................................................................... 20
2.2.3 Instalao manual ............................................................................................................. 20
2.2.4 Configurar sudo ................................................................................................................. 22
2.3 Licena .............................................................................................................................. 23
2.4 Actualizao dos schemas BD .......................................................................................... 23
2.5 Actualizao dos procedimentos PL-SQL ........................................................................ 25
3 Upgrade ............................................................................................................................ 26
3.1 Instalar RPMs .................................................................................................................... 26
3.2 Actualizar configuraes ................................................................................................... 26
4 Administrao ................................................................................................................. 28
4.1 Configuraes ................................................................................................................... 28
4.1.1 Alarm Monitor .................................................................................................................... 29
4.1.2 Network Gateway .............................................................................................................. 29
4.1.3 Reports .............................................................................................................................. 29
4.1.4 QoS Collector .................................................................................................................... 30
4.1.5 Provision Pack ................................................................................................................... 30
4.1.6 Northbound Alarms Interface (opcional) ........................................................................... 30
4.1.7 Northbound Inventory Interface (opcional) ........................................................................ 30
4.1.8 Northbound GPON Interface (opcional) ............................................................................ 31

4
ndice de Contedos

4.1.9 Northbound DSL Interface (opcional)................................................................................ 31
4.1.10 Servio de controlo............................................................................................................ 31
4.2 Customizao .................................................................................................................... 31
4.3 Lanar o servico de controlo de mdulos ......................................................................... 32
4.4 Lanamento da aplicao ................................................................................................. 33
5 Redundncia geogrfica ................................................................................................ 34
5.1 Instalao do Corosync e Pacemaker .............................................................................. 34
5.2 Configurao do Corosync ................................................................................................ 34
5.2.1 Chave de autenticao ..................................................................................................... 34
5.2.2 Ficheiro de configurao ................................................................................................... 34
5.2.3 Configurar a firewall para permitir a comunicao do Corosync ...................................... 35
5.3 Arranque do Corosync ...................................................................................................... 36
5.3.1 Verificar que existe comunicao no cluster ..................................................................... 36
5.4 Configurao do Pacemaker ............................................................................................. 36
5.4.1 Desactivar o STONITH ..................................................................................................... 36
5.4.2 Mudar quorum policy ......................................................................................................... 36
5.4.3 Desactivar auto-failback .................................................................................................... 36
5.5 Adicionar recursos............................................................................................................. 37
5.5.1 Adicionar um recurso qualquer ......................................................................................... 37
5.5.2 Adicionar um endereo IP ................................................................................................. 38
5.6 Configurar relaes entre recursos ................................................................................... 38
5.6.1 Fazer depender um servio da existncia de outro .......................................................... 38
5.6.2 Forar ordem de arranque dos servios ........................................................................... 38
5.7 Configurar localizao de recursos e re-localizao manual de recursos ........................ 38
5.7.1 Localizao de recursos ................................................................................................... 38
5.7.2 Re-localizao manual de recursos .................................................................................. 39
6 FAQ ................................................................................................................................... 40
6.1 O mdulo Job Scheduler no se encontra disponvel ...................................................... 40
7 Referncias ...................................................................................................................... 41

ndice de Figuras

5
ndice de Figuras

Fig. 1: Data Communication Network ..................................................................................................... 7

ndice de Tabelas

6
ndice de Tabelas

Tabela 1: Portos usados por mdulo (User firewall) ............................................................................... 7
Tabela 2: Portos utilizados para clustering (NE firewall) ........................................................................ 8
Tabela 3: Portos utilizados para clustering (User firewall) ...................................................................... 8
Tabela 4: Mdulos que compem o AGORA-NG AssurePack ............................................................. 17
Tabela 5: Tabela de ficheiros de configurao ..................................................................................... 29
Tabela 6:Tabela de recursos ................................................................................................................ 37

01

7
Pr-requisitos

1 Pr-requisitos
1.1 Data Communication Network
A rede de comunicaes de gesto ter uma estrutura semelhante apresentada na figura.
AGORA-NG
User network
Firewall
NE Firewall

Fig. 1: Data Communication Network
Os portos que devero estar abertos nas duas firewall so apresentados nas tabelas seguintes.

Mdulo Portos TCP
Portal
(offset 600)
1698, 1699, 4473,
5044-5046, 8609,
8680, 8683, 8690,
8692, 8693, 5057,
6045, 6055
assurepack
(jboss offset 800)
1898, 1899, 4673,
5244-5246, 8809,
8880, 8883, 8890,
8892, 8893, 5257,
6245, 6255
Apache Web server 8080, 8081
Tabela 1: Portos usados por mdulo (User firewall)

8
Pr-requisitos

Mdulo Portos
SNMP UDP 161, 162
FTP, SSH, Telnet,
HTTP, HTTPS,
SFTP
TCP 21, 22, 23, 80,
443,115
Sistema de nomes
para uso futuro
TCP 137
Tabela 2: Portos utilizados para clustering (NE firewall)

No caso de se usar clustering:
Mdulo Portos TCP
Portal
(offset 600)
1700-1702, 1761,
1762, 4158, 5047,
5048, 49752, 49753
assurepack
(jboss offset 800)
1900-1902, 1961,
1962, 4358, 5247,
5248, 49952, 49953
Tabela 3: Portos utilizados para clustering (User firewall)

9
Pr-requisitos

No caso da instalao em ambiente virtualizado so necessrios

Mdulo Portos TCP
Cliente PC para
Acesso ao Oracle
VM Manager
7002, 15901, 10000
(necessrio)
Acesso ao Oracle
VM Server
22 (necessrio)
Acesso do Oracle
VM Manager ao
Oracle VM Server
8899, 123, 7002
(desnecessrio)
Acesso do Oracle
VM Manager ao
Oracle VM Server
desnecessrio
Tabela 4: Portos utilizados acesso ao Oracle VM Manager

1.2 Software de base
Antes de instalar o AGORA-NG necessrio assegurar a instalao de alguns pacotes de
software externos. Assume-se o uso do sistema operativo RHEL ou CentOS.
o JDK 1.6_0_*
o JDK 1.5_0_*
o MySQL 5.*

10
Pr-requisitos

o Apache 2.*
o Oracle 11g (any Edition)
o ProcMail
o tftp (este nos S.O. acima referidos pertence ao Xinetd)
1.2.1 Instalao do java e jboss
O java e o jboss podem ser instalados de duas formas distintas:
a) YUM este mtodo deve ser utilizado quando a mquina onde se est a instalar tem
acesso ao servidor yum da PT Inovao;
b) RPM este mtodo deve ser utilizado quando a mquina onde se est a instalar no tem
acesso ao servidor yum da PT Inovao.
Para verificar se existe conectividade com o servidor YUM da PT Inovao basta aceder ao
endereo http://yum.ptin.corppt.com/repo e confirmar que aparece uma pgina com uma listagem
de ficheiros. Em caso de sucesso seguir o passo a). Em caso de a pgina dar erro necessrio
seguir o passo b).

Para aumentar o desempenho dos application servers Jboss 5.1 com HornetQ, em Linux,
aconselha-se a instalao de:
Linux-native asynchronous I/O access library libaio

1.2.1.1 Instalao por YUM
necessrio instalar os seguintes ficheiros de configurao dos repositrios yum:
http://yum.ptin.corppt.com/repo/ext-mirror-java-sun-1.6.repo jdk6
http://yum.ptin.corppt.com/repo/ext-generic.repo JBOSS AS 5.1
hornetQ

Instalar o jdk e o jboss pela seguinte ordem para que no ocorram problemas com a verso do
jdk.

1.2.1.2 Instalao por RPM
Este modo de instalao exige que os RPMs sejam disponibilizados pela PT Inovao.

$ yum install sun-jdk-1.6.0
$ yum install jboss-jdk6-5.1.0
$ yum install jboss-hornetq2.1.2-jdk6-5.1.0

11
Pr-requisitos

Dentro da rede da PT Inovao possvel obter os ficheiros utilizando os seguintes
comandos:

Aps disponibilizao dos RPMs pode-se instalar atravs dos seguintes comandos:

1.2.2 Oracle 11g
Deve ser instalada a verso Oracle 11g apropriada, segundo o manual Oracle[1].
1.2.2.1 Instncia Oracle
*No caso de verso Oracle 11g, colocar o parmetro SEC_CASE_SENSITIVE_LOGON a
FALSE para que no seja case sensitive no logon e desativar "password expiration".
Estes pontos podem ir contra as normas do cliente, j que so relativos a segurana. Caso no
sejam implementadas ser necessrio ter em conta este aspecto nas configuraes de ligao a
instancia de BD

*Acesso a toda a rede (Network Access - Disable ACL). Este ponto tem que ser feito pelo menos
para a rede de comunicao de maquinas aplicacionais.

# Efectuar o download dos rpms substituindo o X pela verso
mais atual disponvel no repositrio. A listagem das verses
disponveis pode ser obtida acedendo pelo browser ao
endereo onde o ficheiro se encontra.
$ wget http://yum.ptin.corppt.com/repo/ext-
mirror/java/sun/1.6/x86_64/jdk-6uX-linux-amd64.rpm
generic/el5/x86_64/sun-jdk-1.6.0_X.ptin.el5.x86_64.rpm
generic/el5/x86_64/jboss-jdk6-5.1.0-X.ptin.el5.noarch.rpm
generic/el5/x86_64/jboss-hornetq2.1.2-jdk6-5.1.0-
X.ptin.el5.noarch.rpm

$ rpm -i jdk-6uX-linux-amd64.rpm
$ rpm -i sun-jdk-1.6.0_X.ptin.el5.x86_64.rpm
$ rpm -i jboss-jdk6-5.1.0-X.ptin.el5.noarch.rpm
$ rpm -i jboss-hornetq2.1.2-jdk6-5.1.0-X.ptin.el5.noarch.rpm

ALTER SYSTEM SET SEC_CASE_SENSITIVE_LOGON = FALSE SCOPE = BOTH;

ALTER PROFILE DEFAULT LIMIT FAILED_LOGIN_ATTEMPTS UNLIMITED
PASSWORD_LIFE_TIME UNLIMITED;

12
Pr-requisitos

*No caso Oracle XE atribuir GRANT EXECUTE ON <package> TO PUBLIC ou a cada user por
ns criado as seguintes packages internas:

As 3 primeiras so para os user do AgoraNG.
As 2 ultimas so para os user do SCA.
Verificar, alterar parmetros da instancia (user system da instancia):
- open_cursors = 900
- sessions = 900
- process = 600
Comando para ver: show parameter <parmetro>
Comando para alterar: alter system set <parametro> = <valor> scope = spfile;
Shutdown e startup para que os novos valores fiquem ativos.
- shutdown immediate
- startup

begin
begin
dbms_network_acl_admin.drop_acl(
acl => 'all-network-PUBLIC.xml'
);
exception
when others then null;
end;
dbms_network_acl_admin.create_acl(
acl => 'all-network-PUBLIC.xml',
description => 'Network connects for all',
principal => 'PUBLIC',
is_grant => true,
privilege => 'connect'
);
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(
principal => 'PUBLIC',
is_grant => true,
privilege => 'resolve'
);
dbms_network_acl_admin.assign_acl(
host => '*'
);
end;
/
commit;

# para o user do AgoraNG
STANDARD
UTL_FILE
UTL_TCP
# para o user do SCA
UTL_SMTP
UTL_HTTP (v4.5.0 do sca)

13
Pr-requisitos

1.2.3 Apache
necessrio modificar o ficheiro /etc/httpd/conf/httpd.conf e:
configurar o user e grupo

configurar o timeout

configurar o DocumentRoot

configurar o Listen

configurar o o mod_proxy adicionando e adaptando as seguintes linhas:

<IfModule mod_proxy.c>
ProxyRequests On
#
<Proxy *>
Order deny,allow
Deny from all
Allow from all
</Proxy>

ProxyRequests Off
ProxyPreserveHost On
ProxyReceiveBufferSize 8048
ProxyTimeout 7200

ProxyPass /JobScheduler http://hostname:8680/JobScheduler
ProxyPassReverse /JobScheduler
http://hostname:8680/JobScheduler

ProxyPass /Portal http://hostname:8680/Portal
ProxyPassReverse /Portal http://hostname:8680/Portal

ProxyPass /plrelatorios http://hostname:8380/plrelatorios

User agorang
Group jboss

Timeout 1800

DocumentRoot "/opt/ptin/agorang/share/www"
e
<Directory "/opt/ptin/agorang/share/www">

Listen 8080
Listen 8081 #Esta entrada dever constar no apache onde corre o
naProvisao

14
Pr-requisitos

ProxyPassReverse /plrelatorios
http://hostname:8380/plrelatorios

ProxyPass /servletGateway
http://hostname:8680/servletGateway
ProxyPassReverse /servletGateway
http://hostname:8680/servletGateway

ProxyPass /sca http://hostname:8680/sca
ProxyPassReverse /sca http://hostname:8680/sca

ProxyPass /alarmmanagerlaunch
http://hostname:8680/alarmmanagerlaunch
ProxyPassReverse /alarmmanagerlaunch
http://hostname:8680/alarmmanagerlaunch

ProxyPass /assurepacklaunch
http://hostname:8680/assurepacklaunch
ProxyPassReverse /assurepacklaunch
http://hostname:8680/assurepacklaunch

ProxyPass /ejap http://hostname:8630/ejap
ProxyPassReverse /ejap http://hostname:8630/ejap

ProxyPass /AlarmMgrRepSearch
http://hostname:8630/AlarmMgrRepSearch
ProxyPassReverse /AlarmMgrRepSearch
http://hostname:8630/AlarmMgrRepSearch

ProxyPass /provisionPackEla
http://hostname:8330/provisionPackEla
ProxyPassReverse /provisionPackEla
http://hostname:8330/provisionPackEla

ProxyPass /provisionPackNx64
http://hostname:8280/provisionPackNx64
ProxyPassReverse /provisionPackNx64
http://hostname:8280/provisionPackNx64

ProxyPass /provisionPackSdh
http://hostname:8230/provisionPackSdh
ProxyPassReverse /provisionPackSdh
http://hostname:8230/provisionPackSdh

ProxyPass /provisionPackAtm
http://hostname:8180/provisionPackAtm
ProxyPassReverse /provisionPackAtm
http://hostname:8180/provisionPackAtm
</IfModule>

Reiniciar o apache

15
Pr-requisitos

Verificar arranque automtico

*runlevel 2, 3, 4, 5 devem estar a on
Colocao do servio em arranque automtico
$ su - -c chkconfig httpd on

Tftp (ficheiro de configurao em /etc/xinetd.d/tftp)
este tem que ter o diretorio configurado para
/opt/ptin/agorang/data/downloads

$ su - -c "service httpd restart"

Nota: o commando pode devolver erro caso algum dos portos ja esteja
a ser usado ou o utilizador e grupo ainda no tenham sido criados
isto pode acontecer numa instalao base;

$ su - -c "chkconfig --list httpd"

02

16
Instalao

2 Instalao
2.1 Pontos para uma instalao completa
- instalar S.O. com file systems especficos ou de forma genrica, no esquecer se possvel de
incluir a maioria do soft base necessrio a nvel de S.O. (apache, mysql, tftp,.)
A nvel de S.O. se for usando file systems especficos:
/opt/ptin
/u01/app
/logs
/oradata
/oraback
/oraarch
/desempenho
Caso se opte por file system genrico criar a estrutura acima mencionada
Nos directorios /oradata, /oraback e /oraarch criar um directorio com o nome que se
pretende para a instancia (8 caracteres), SID que ira ser usado na criao
- instalar soft. base de dados Oracle, no esquecer de previamente ver os pr-requisitos da
Oracle ao nvel do S.O.
- criar instancia de base de dados (dbca) pontos de referncia
Seleccionar Custom Database
Global Database Name e SID = [AGORABD] (pode ser outro nome se quiserem 8 caracteres
no maximo)
Desactivar Configure Enterprise manager
Seleccionar Use the Same Administrative Password for All Accounts
Seleccionar Use Common Location for All Database Files e colocar /oradata
Fast Recovery Area alterar a variavel {ORACLE_BASE} por /oradata/SID
Seleccionar Enable Archiving e entrar em Edit Archive Mode Parameters
Alterar em Archive Log File Format a extenso dbf para arc
Na grelha na 1 posio colocar /oraarch/SID
Desabilitar todas as opes
Seleccionar Custom em Memory
Valores mnimos SGA=512 PGA=1024
Sizing aumentar Processes para 600 (este valor pode ser alterado aps a criao)
Character Sets
Database Character Set = WE8ISO8859P15 ISSO 8859-15 West European

17
Instalao

Default Language = Portuguese
Default Territory = Portugal ou Brazil
Alterar o tamanho dos Redo Log Groups de 51200K para 102400K
Aps a criao da instancia alterar parmetros como referido em 1.2.2.1
- instalar RPMs base do assurepack, o rpm database pode ficar para ser instalado aps se
terem feito as primeiras configuraes globais assim como a criao dos schemas na base de
dados
- instalar rpm database, concluir os schemas
- colocar os restantes produtos (AlarmMonitor, naProvisao, .)
2.2 Pacotes de instalao
2.2.1 Assure Pack
O AGORA-NG Assure Pack composto por um conjunto de mdulos cuja instalao depende do
cenrio desejado.

Pacote Tipo Descrio Onde instalar
agorang-ap-lib RPM
Pacote base de qualquer
outro pacote do sistema.
Inclui scripts de
arranque/paragem
Todas as mquinas
agorang-ap-client RPM JBoss app com frontend Mquinas Frontend
agorang-ap RPM JBoss app com servios core
Mquina Backend, com
acesso BD
agorang-database RPM
Scripts de criao e
actualizao do modelo de
dados. Packages PL-SQL.
Mquina com acesso BD, com
sqlplus, preferencialmente a
mesma de agorang-ap
agorang-static-
common-repo
RPM
Contedo esttico para
disponibilizao nos GUI,
como mapas e imagens
Mquinas Frontend
agorang-
alarmMonitorGw
RPM
Mdulos de comunicao
com Alarm Monitor
Mquina com acesso BD, com
sqlplus, preferencialmente a
mesma de agorang-ap
Tabela 5: Mdulos que compem o AGORA-NG AssurePack
2.2.1.1 Network Gateway
NA (proviso)
ver.
2.3.3.1
Network gateway
Mquinas com acesso ao
equipamento

18
Instalao

agorang-naprovisao-
repository
RPM
Repositrio de aes para
Network gateway
Mquinas com NA proviso
instalado

2.2.1.2 Alarm Monitor
Alarm Manager
(3.8.4)
Ver
2.3.3.2
Mdulo de gesto de
alarmes
Acesso BD

2.2.1.3 SCA
SCA ( 4.5.0 ) JAR
Sistema de controlo de
Acessos
Acesso BD

2.2.1.4 Reports
agorang-reports RPM
Integrao do componente
Reports
Mquina Reports
agorang-reports-
database
RPM
Reports (componente PL-
SQL)
Mquina Reports

2.2.1.5 QoS Collector
agorang-qoscollector
agorang-qoscollector-
database
RPM
QoS Collector
Mquina para recolha de
dados de desempenho
agorang-qoscollector-
udp
RPM
QoS Collector recolha de
dados via UDP
Recolha de dados de
desempenho por protocolo
proprietrio (equipamentos
legacy)

2.2.2 Provision Pack
O AGORA-NG Provision Pack composto pelos mdulos.

19
Instalao

agorang-pce RPM
Pacote base de qualquer
outro pacote do sistema.
Inclui scripts de
arranque/paragem
Todas as mquinas
agorang-pce-database RPM JBoss app com frontend Mquinas Frontend
agorang-ppXYZ RPM JBoss app com frontend Mquinas Frontend
agorang-ppXYZ-
database
RPM JBoss app com frontend Mquinas Frontend

2.2.3 Northbound Alarms Interface (opcional)
agorang-northbound-
alarm-interface
RPM
Permite o reenvio de
alarme para sistemas
externos
Mquina onde esteja instalado
agorang-alarmMonitorGw

2.2.4 Northbound Inventory Interface (opcional)
agorang-northbound-
inventory-interface
RPM
Interface de cadastro, para
consulta por sistemas
externos
agorang-ap

2.2.5 Northbound GPON Interface (opcional)
agorang-northbound-
gpon-interface
RPM
Interface para proviso e
diagnstico GPON, por
sistemas externos
agorang-ap

2.2.6 Northbound DSL Interface (opcional)
agorang-northbound-
RPM
Interface para diagnstico Mquina onde esteja instalado

20
Instalao

dsl-interface
DSL, por sistemas
externos
agorang-ap

2.3 Procedimentos de instalao
2.3.1 Instalao por YUM
Os RPMs do AGORA-NG ainda no esto disponveis atravs do YUM da PT Inovao.
2.3.2 Instalao por RPM
Os pacotes de instalao RPM so instalados/atualizados pela ferramenta do sistema operativo

2.3.3 Instalao manual
Alguns dos mdulos apenas podem ser instalados manualmente, pelo que se apresentam as
instrues de instalao
2.3.3.1 Network Gateway
Para permitir a instalao no mdulo Network Gateway, necessrio que estejam instalados os
sequintes pacotes de software:
JBOSS AS 4.0.5 GA
JDK 1.5.0_*
MySQL 5.*

Descompactar ficheiro jboss-4.0.5.GA em /opt/jboss
Criar utilizador na

Descompactar ficheiro com contedo do naProvisao no HOME do user na

Aps instalao do MYSQL e este se encontrar activo, configurar password de root, via Sistema
Operativo:

# rpm -Uvh ...

# useradd g ptin d /home/na m s /bin/bash G jboss na

# /usr/bin/mysqladmin -u root password 'new-password'
Ou
# /usr/bin/mysqladmin -u root -h <hostname> password 'new-password'

21
Instalao

Ou, alternativamente, via MYSQL:

De seguida, criar utilizador na e atribuir privilgios. Criar ainda a base de dados
'orderprocessorProvisao' para uso no naProvisao:

Verificar arranque automtico

Finalmente, garantir que o servidor apache Web Server que se encontra instalado na mquina
possui as configuraes seguintes:

O RPM, agorang-naprovisao-repository, relativo instalao do repositrio de XSLT dever ser
instalado aps a instalao do mdulo principal.

Por fim, criar o link simblico

2.3.3.2 Alarm Monitor
Para instalar o componente Alarm Monitor, efectuar os sequintes passos

SET PASSWORD FOR '<user>'@'localhost' = PASSWORD('newpass');

# mysql --user=root password
mysql> GRANT ALL PRIVILEGES ON *.* TO 'na'@'localhost' WITH GRANT OPTION;
mysql> SET PASSWORD FOR 'na'@'localhost' = PASSWORD('na');
mysql> CREATE DATABASE orderprocessorProvisao;
mysql> quit;

Ver arranque automatico Apache

Listen 8081 #naProvisao

<VirtualHost HOSTANME:8081>
DocumentRoot /home/na
</VirtualHost>

<Directory "/home/na/repositorio/firmware">
Options Indexes FollowSymLinks
IndexOptions FancyIndexing VersionSort XHTML SuppressIcon
SuppressColumnSorting SuppressDescription SuppressHTMLPreamble
SuppressLastModified SuppressRules SuppressSize
</Directory>

# ln s /home/na/jboss-server/naProvisao /opt/jboss/jboss-4.0.5.GA/server/
naProvisao

22
Instalao

Criar user alarmmon

Abrir o zip do jboss-4.2.3.GA-jdk6 e colocar no /opt/jboss/
Copiar o pacote Alarm_Monitor para o /opt/ptin/alarmmon/
Atualizar o owner dos ficheiros em /opt/ptin/alarmmon/ (como utilizador root):

Em /opt/ptin/alarmmon/lib/ colocar/substituir os drivers JDBC ojdbc* com a verso correcta
do SQL_Client instalado na maquina
Em /opt/ptin/alarmmon/lib/ colocar/substituir a ultima versao do sca.jar do SCA instalada
Criar a estrutura de pastas para os logs e symbolic links:

Editar o .bash_profile e introduzir as entradas .var_env_jboss e .var_env_oracle.

Configurar/verificar os ficheiros de configurao associados a este mdulo, enumerados em 4.1.1

2.3.3.3 SCA
A instalao do SCA resume-se cpia de dois ficheiros para localizaes especficas

Ficheiro Destino
sca.jar ~/lib
sca.war ~/share/portal/deploy/app

2.3.4 Configurar sudo
Acrescentar a seguinte linha ao ficheiro sudoers:

# useradd -g ptin -d /opt/ptin/alarmmon -m -s /bin/bash -G jboss alarmmon

# chown -R alarmmon:ptin
# chown alarmmon:ptin .var_env_*

# mkdir /logs/ptin/alarmmon
# mkdir /logs/ptin/alarmmon/alarmmonitor
# ln -s /logs/ptin/alarmmon/alarmmonitor /opt/ptin/alarmmon/jboss-
server/alarmmonitor/log
# ln -s /opt/ptin/alarmmon/lib/sca.jar /opt/ptin/alarmmon/jboss-
server/alarmmonitor/lib/sca.jar
# ln -s /opt/ptin/alarmmon/lib/ojdbc6.jar /opt/ptin/alarmmon/jboss-
server/alarmmonitor/lib/ojdbc6.jar
# ln -s /logs/ptin/alarmmon /opt/ptin/alarmmon/logs

23
Instalao

agorang ALL=NOPASSWD:/opt/ptin/agorang/etc/init.d/agorangctrl

2.4 Licena
Garantir que a licena se encontra em conf/ap-configuration/conf.jar/xlic.lic
2.5 Actualizao dos schemas BD
Executar, no sqlplus, os ficheiros apresentados na tabela seguinte, pela ordem indicada.
As scripts seguintes so alternativas, consoante se pretenda ou no o uso de partitioning
Passo02-AppGestor-tabelasBase-ComPartitioning.sql
AMschema/Passo02-AppGestor-tabelasBase-ComPartitioning.sql
Passo02-AppGestor-tabelasBase-SemPartitioning.sql
AMschema/Passo02-AppGestor-tabelasBase-SemPartitioning.sql

Em cada passo indicado o user BD onde deve ser executado o ficheiro sql.
Invocar o utilitrio sqlplus, indicar o nome do user/password e executar o ficheiro

Ficheiro sql User BD
Passo01-system-tablespaces_users.sql
Passo01-system-tablespaces_users.sql (*) do AM
SYSTEM
Passo02a-AppGestor-tabelasBase-ComPartitioning.sql
Passo02b-AppGestor-tabelasBase-SemPartitioning.sql
AGORANGGESTOR
Passo03-AppGestor-gera_grants.sql AGORANGGESTOR
Passo03-AppGestor-grants.sql
AGORANGGESTOR

# vi /etc/sudoers

# sqlplus <agoranggestor>/<pass_agoranggestor>
# start <nome_fich>
Ou
# @ <nome_fich>

24
Instalao

(Este ficheiro foi gerado no passo anterior)
Passo04-App-gera_sinonimos.sql AGORANGGESTOR
Passo04-App-sinonimos.sql
AGORANG
Passo05-App-prePreenchidos.sql AGORANG
Passo06-PGrafGestor-tabelasBase.sql PGRAFGESTOR
Passo07-PGrafGestor-gera_grants.sql PGRAFGESTOR
Passo08-PGraf-gera_sinonimos.sql PGRAF
Passo08-PGraf-sinonimos.sql
PGRAF
Passo09-AppGestor-CriaDirectorio.sql AGORANGGESTOR
Passo02-AppGestor-schema-
integracao_agorang_ComPartitioning.sql
Passo02-AppGestor-schema-
integracao_agorang_SemPartitioning.sql
AGJ2GESTOR
Passo03-AppGestor-gera_grants.sql AGJ2GESTOR
Passo03-AppGestor-grants.sql
AGJ2GESTOR
Passo04-App-gera_sinonimos.sql AGJ2
Passo04-App-sinonimos.sql
AGJ2
Passo05-App-prepreenchidos-integracao_agorang.sql AGJ2
Passo06-App-schema-integracao_agorang.sql AGJ2
step1_SYSTEM_install_tablespaces.sql SYSTEM
step2_SYSTEM_create_users.sql SYSTEM
step3_AppGestor_gestor_schema.sql SCA_GESTOR
step4_AppGestor_insert_prePreenchidos.sql SCA_GESTOR
step5_AppGestor_cliente_schema.sql SCA_GESTOR
step6_AppGestor_job_remove_sessions SCA_GESTOR
step7_AppGestor_job_clean_log_tables.sql SCA_GESTOR
step8_AppGestor_job_sync_ldap_users.sql SCA_GESTOR
step9_AppGestor_job_update_acronyms.sql SCA_GESTOR

25
Instalao

2.6 Actualizao dos procedimentos PL-SQL
Instalar as packages PL-SQL, usando o comando:

Quando solicitado, dever introduzir o ustilizador gestor do schema, utilizador do schema (cliente)
e respectivas passwords

Quando o script tem sucesso, apresentado o resultado:

# dbtools ~/src/database/plsql

User owner (AppGestor): <agoranggestor>
Password: <pwd_agoranggestor>

User (App): <agorang>
Password: <pwd_agorang>

Compiling schema...

PL/SQL procedure successfully completed.

Checking if there is any invalid package...

no rows selected

02

26
Upgrade

3 Upgrade
3.1 Instalar RPMs
Instalar RPMs, usando o comando referido em 3.1.2
Como resultado da instalao, o sistema apresentar um output parecido a:

3.2 Actualizar configuraes
As linhas de warning (linha 3 do exemplo anterior) no ponto anterior indicam que um ficheiro de
configurao teve a sua estrutura alterada nesta verso, mas no foi sobreposto porque o anterior
j havia sido personalizado nesta plataforma.
O utilizador dever comparar o ficheiro original com o ficheiro novo (gravado como *.rpmnew) e
decidir se pretende remover o antigo, remover o novo ou fundi-los. O mesmo deve ser feito
Preparing...
########################################### [100%]
1:agorang-ap-lib warning:
/opt/ptin/agorang/conf/agorang.cfg created as
/opt/ptin/agorang/conf/agorang.cfg.rpmnew
########################################### [ 14%]
Fixing permissions
2:agorang-static-common-
r########################################### [ 29%]
3:agorang-ap-client
########################################### [ 43%]
4:agorang-alarmMonitorGW
########################################### [ 57%]
5:agorang-ap
########################################### [ 71%]
/var/tmp/rpm-tmp.89499: line 29: fg: no job control
6:agorang-database
########################################### [ 86%]
Connected to jdbc:oracle:thin:@itanium:1521:AGORANG
/opt/ptin/agorang/src/database/schemas/6.2.0/28-AS-AppGestor.sql
/opt/ptin/agorang/src/database/schemas/6.2.0/31-defines.sql
/opt/ptin/agorang/src/database/schemas/6.2.0/35-AS-ScaGestor.sql
/opt/ptin/agorang/src/database/schemas/6.2.0/39-defines.sql
Number of database schema files that should be run: 14
7:agorang-lightpad
########################################### [100%]

27
Upgrade

quando o warning for sobre a extenso rpmsave, onde o antigo foi salvaguardado com esta
extenso e o novo foi colocado em uso.

O processo de update dos RPMs indica ainda uma lista com os scripts de actualizao de base
de dados que devero ser corridos sequencial e manualmente na BD. Com o utilizador de sistema
operativo agorang, dever iniciar a ferramenta sqlplus com o utilizador de BD adequado a correr
cada script
AppGestor login/pass: agoranggestor/agorang
PGrafGestor login/pass: pgrafgestor/pgraf
SCA login/pass: sca_gestor/sca_cliente
Alarm Monitor login/pass: agj2gestor/agj2
Aceder ao diretrio schemas (cd src/database/schemas/6.2.0/) e efetuar o seguinte comando:
sqlplus agoranggestor (pass: agoranggestor)
a) Agora em SQL, atualizar a BD, executando, por ordem, cada um dos schemas indicados
quando se instalou os RPMs; por exemplo: @10_AS_AppGestor.sql
b) No final de cada execuo de schema, dever efetuar-se um comando de commit:
commit;
Por fim, necessrio recompilar as packages PL-SQL
1. No diretrio plsql (cd src/database/plsql), correr o seguinte comando: dbtools .
(login/pass AppGestor: agoranggestor; login/pass App: agorang)

04

28
Administrao

4 Administrao
4.1 Configuraes
Em consequncia da instalao dos pacotes, diversos ficheiros de configurao, existentes no
$HOME do utilizador agorang, devem ser verificados/configurados:
Cada ficheiro apresenta as suas instrues de configurao.
Ficheiro Descrio
~/.agorang/agorang
definio de variveis de ambiente utilizadas pelo
AGORANG
~/.agorang/oracle
definio de variveis de ambiente utilizadas
pelas ferramentas oracle
~/.agorang/tnsnames.ora
configuraes para acesso BD oracle atravs
do sqlplus
~/conf/agorang.cfg configuraes do agorangctrl
~/conf/apClientManager.properties
configuraes especficas de mdulo de acesso
ao SCA
~/conf/alarmMonitorGW/conf/jndi/beanLocatio
nsConfig.properties
configuraes de acesso a AM
~/conf/alarmMonitorGW/conf/config.properties
configuraes especificas do alarmprocessorgw e
statemachinegw
~/conf/portal-
configuration/conf.jar/properties/*.properties
Configuraes especficas do Portal
~/conf/ap-
configuration/conf.jar/jobscheduler.properties
Agendamentos
~/conf/portal-
configuration/conf.jar/conf/jndi/beanLocations
Config.properties
Configuraes para acesso Alarm Monitor
~/conf/portal-configuration/conf.jar/jnlp-ap-
system.properties
Configuraes de cliente AP
~/conf/portal-
configuration/conf.jar/conf/jndi/beanLocations
Config.properties
Configuraes de acesso a portal
~/conf/000-configuration/conf.jar/*-
jndi.properties
Configuraes de acesso a AP
~/conf/000-configuration/conf.jar/*.properties Configuraes internas de servios AP

29
Administrao

~/share/www/documentation//.html
Pginas HTML para customizao da
documentao, Avisos, etc
~/share/www/Mapas/
Imagens disponibilizadas para fundo de janelas
do Assure Pack
Tabela 6: Tabela de ficheiros de configurao

As seces seguintes apresentam os ficheiros de configurao especficos de um mdulo.
4.1.1 Alarm Monitor
Os ficheiros de configurao especficos do mdulo Alarm Monitor encontram-se no $HOME do
utilizador alarmmon
Ficheiro Descrio
~/.var_env_oracle
configuraes de
acesso oracle
~/.var_env_ptinapp
configuraes do
user alarmmon
~/jboss-servers/alarmmon/deploy/ejap/*.xml
configuraes de
datasources
~/jboss-
server/alarmmonitor/deploy/ejap/localLibs.sar/conf/rules/rulesConfig.proper
ties
configuraes das
aces SMS/mail
~/jboss-
server/alarmmonitor/deploy/ejap/localLibs.sar/conf/sms/smsSenderConfig.p
roperties
configuraes das
aces SMS
~/jboss-server/alarmmonitor/deploy/jms/jms-remote-ds.xml

4.1.2 Network Gateway
Os ficheiros de configurao especficos do mdulo Network Gateway encontram-se no $HOME
do utilizador na
Ficheiro Descrio
~/bin/naProvisao configuraes de host (HOST_IP)

4.1.3 Reports
Os ficheiros de configurao especficos do mdulo Reports encontram-se no $HOME do
utilizador agorang

30
Administrao

Ficheiro Descrio
~/conf/000-
configuration/conf.jar/reports.properties
Configuraes especficas do mdulo Reports

4.1.4 QoS Collector
Os ficheiros de configurao especficos do mdulo QoSCollector encontram-se no $HOME do
utilizador agorang
Ficheiro Descrio
~/conf/qoscollector/global/desempenho.prope
rties
configuraes globais
~/conf/qoscollector/global/qoscollector-ds.xml configuraes do datasource
~/conf/qoscollector/extractor/META-
INF/jboss-service.xml
configuraes de activao de equipamentos
a recolher

4.1.5 Provision Pack
Os ficheiros de configurao especficos do mdulo QoSCollector encontram-se no $HOME do
utilizador agorang
Ficheiro Descrio
~/conf/000-configuration/conf.jar/resources-
ppXYZ.properties
Configuraes especficas do mdulo XYZ

4.1.6 Northbound Alarms Interface (opcional)
Os ficheiros de configurao especficos do mdulo Northbound Alarms Interface encontram-se
no $HOME do utilizador agorang
Ficheiro Descrio
~/conf/northbound-
alarms/alarms2others.properties
Configuraes especficas do mdulo
Northbound Alarms Interface

4.1.7 Northbound Inventory Interface (opcional)
No existem ficheiros de configurao especficos do mdulo Northbound Inventory Interface.
No entanto, necessrio garantir a execuo do utilitrio dbtools sobre o directrio
~/share/inventoryXml/lib aps instalao deste mdulo.

31
Administrao

Dever ser adicionada uma entrada no cron para permitir a actualizao peridica dos ficheiros
XML que descrevem as entidades cadastradas. Essa entrada deve executar o script
~/bin/inventory-nb.sh

4.1.8 Northbound GPON Interface (opcional)
No existem ficheiros de configurao especficos do mdulo Northbound GPON Interface.

4.1.9 Northbound DSL Interface (opcional)
No existem ficheiros de configurao especficos do mdulo Northbound DSL Interface.

4.1.10 Servio de controlo
O servio de controlo do AGORANG configurado no ficheiro ~/conf/agorang.cfg e deve ser
replicado em todas as mquinas da plataforma.

As configuraes de um mdulo iniciam com uma linha com o formato [servicename] seguida de
mltiplas linhas de atributos/valores com o formato attribute=value.

Os atributos possveis so:

Parmetro Valor Obrigatrio (default)
host hostname ou ip onde o mdulo se encontra instalado sim
user nome do utilizador que ir iniciar o processo no (agorang)
depends lista ,separada por vrgulas, dos mdulos dos quais
depende
no
dependents lista ,separada por vrgulas, dos mdulos que dele
dependem
no

Para ativar/desativar basta comentar/descomentar as linhas de configurao ao mdulo.
4.2 Customizao
Em /opt/ptin/agorang/share/www/skins/ criar um symbolic link para a cor de fundo pretendida

# dbtools ~/src/database/plsql/inventoryXml

32
Administrao

Em ~/share/www/Mapas devem ser colocados os ficheiros de imagem que sero disponibilizados
para associao a domnios geridos.

Para /opt/ptin/agorang/conf/gui/, devero ser transferidos os icones correspondentes
customizao pretendida, de acordo com a correspondncia seguinte:
Ficheiro Uso
AppLogo100x100.png cone da aplicao, em formato 100x100
iconFavIcon16x16.ico cone da aplicao, em formato 16x16
iconMaxi170x170.png cone da aplicao, em formato 170x170
logoClient.png
Logotipo de cliente, para aparecer no cabealho do
Portal
logoFooter.png Logotipo do rodap das aplicaes Web
mainContainerBottomBackgroundImage.png
Faixa inferior da janela de seleco de aplicaes,
no Portal
ManufacturerLogo.png
Icone do canto superior esquerdo das janelas do
Assure Pack
splash.jpg
JPEG para o splash scrren da entrada da aplicao
Assure Pack e janela About

Para personalizar as cores com que feito o sublinhado dos caminhos de Working e Protection
dos circuitos MPLS, na topologia, pode recorrer-se ao ficheiro
~/share/www/config/assurePackColors.properties

4.3 Lanar o servico de controlo de mdulos
Arrancar o servio de controlo do agorang

Verificar que o agorangctrl est a correr devidamente, executando o seguinte comando

$ ln -s <cor> default
O campo <cor> substituido com a designao do directrio da cor
pretendida.

$ sudo ~/etc/init.d/agorangctrl start

33
Administrao

4.4 Lanamento da aplicao
Os scripts de controlo do AGORANG funcionam em ambientes distribudos onde os diversos
mdulos podem ser executados em mquinas distintas. Esta caraterstica permite que se verifique
o estado, pare e arranque os mdulos a partir de qualquer mquina que possua o servio
devidamente configurado.

Aps configurao possvel utilizar o comando agorang para gerir o estado dos diversos
mdulos.

$ agorang
usage: agorang [start|stop|restart|status [servicename]]

Este comando permite executar uma operao (start, stop, restart, status) sobre um mdulo
especfico ou sobre todos os mdulos caso no se especifique o parmetro servicename.
Parmetro Descrio
start Incia o mdulo especificado assim como todos os mdulos dos quais depende.
stop
Termina o mdulo especificado assim como todos os mdulos que dele
dependem.
restart
Termina o mdulo especificado e todos os mdulos que dele dependem. Ao
iniciar garante que so iniciados todos os mdulos dos quais depende e que dele
dependem.
status
Verifica se o mdulo se encontra em funcionamento. Este comando apenas
verifica se o processo ainda se encontra ativo. No efetua nenhuma validao
lgica sobre o correto funcionamento do mdulo.
Existe um mdulo especial (keeper) que responsvel por monitorizar o estado dos outros
mdulos. Quando detecta um mdulo parado, inicia-o-o. Assim, se se pretender parar um mdulo
temporariamente, convm parar o keeper, antecipadamente.

$ agorang status

05

34
Redundncia geogrfica

5 Redundncia geogrfica
O sistema de clustering assenta em dois componentes. Uma infraestrutura de criao do cluster
de mquinas propriamente dito e um sistema de gesto e alocao de recursos. O software
Corosync desempenha o primeiro papel e o software Pacemaker o segundo.
5.1 Instalao do Corosync e Pacemaker
Instalar nas mquinas que vo fazer parte do cluster o software necessrio.

5.2 Configurao do Corosync
5.2.1 Chave de autenticao
Executar o comando 'corosync-keygen' numa das mquinas para gerar uma chave de
autenticao. A chave criada em '/etc/corosync/authkey'.

Copiar o ficheiro '/etc/corosync/authkey' para as restantes mquinas.
Instalar a chave de autenticao nas restantes mquinas

5.2.2 Ficheiro de configurao
Criar o ficheiro '/etc/corosync/corosync.conf' numa das mquinas com o seguinte contedo e
copi-lo para todas as outras:
(esta configurao usa unicast)

$ yum install -y corosync pacemaker

$ corosync-keygen

$ install -D --group=0 --owner=0 --mode=0400
/<path_to_authkey>/authkey /etc/corosync/authkey

35

5.2.3 Configurar a firewall para permitir a comunicao do Corosync
O Corosync usa dois portos UDP. O porto especificada no ficheiro de configurao em mcastport
e o porto imediatamente abaixo. Neste caso so os portos 5405 e 5404. Configurar em todas as
mquinas

# disable compatibility with older versions
compatibility: none
totem {
version: 2
# Limit generated nodeids to 31-bits (positive signed integers)
clear_node_high_bit: yes
# Disable encryption
secauth: off
# How many threads to use for encryption/decryption
threads: 0
interface {
# The following values need to be set based on your environment
ringnumber: 0
# List of the cluster members IP addresses, change accordingly
member {
memberaddr: 192.168.1.1
}
member {
memberaddr: 192.168.1.2
}
# network address to bind to. If local interface is 192.168.1.0 mask
255.255.255.0 then this value is 192.168.1.0
bindnetaddr: 192.168.1.0
# the port on which to communicate
mcastport: 5405
}
# enable unicast
transport: udpu
}
amf {
mode: disabled
}
service {
# Load the Pacemaker Cluster Resource Manager
name: pacemaker
ver: 0
}
aisexec {
user: root
group: root
}
# log configuration, adjust as needed, currently logging to syslog and file, new
everyday with weekly rotation
logging {
fileline: off
to_stderr: no
to_logfile: yes
logfile: /var/log/corosync.log {
missingok
compress
notifyempty
daily
rotate 7
copytruncate
}
to_syslog: yes
syslog_facility: daemon
debug: off
timestamp: on
logger_subsys {
subsys: AMF
debug: off
tags: enter|leave|trace1|trace2|trace3|trace4|trace6
}
}

36

5.3 Arranque do Corosync
O Corosync executado como um servio. Ao arrancar o Corosync o Pacemaker arranca
automaticamente (executar em todas as mquinas):

5.3.1 Verificar que existe comunicao no cluster
Aps fazer o arranque do Corosync em todas as mquinas verificar que todos os IPs das
mquinas membro esto presentes no output do seguinte comando:

5.4 Configurao do Pacemaker
O Pacemaker o Cluster Resource Manager (CRM). Embora a configurao exista em formato
XML este nunca deve ser editado manualmente. Para configurar o Pacemaker deve usar-se o
comando 'crm'. Executando sem parametros entra-se numa sesso de configurao interactiva.
Para permitir scripting tambm possvel fazer todas as configuraes passando parametros ao
comando crm. Os comandos seguintes so efectuados apenas numa das mquinas, de
preferencia a que queremos que seja a principal, e as configuraes so automaticamente
propagadas por todas as mquinas membro do cluster utilizando a infraestrutura disponibilizada
pelo Corosync.
5.4.1 Desactivar o STONITH
Se no existir um recurso STONITH (Shoot The Other Node In The Head) disponvel e
configurado no possvel gerir recursos no cluster sem desactivar o suporte STONITH.

5.4.2 Mudar quorum policy
Diz-se que um cluster tem quorum se metade das mquinas que fazem parte do cluster mais uma
estiverem de acordo. Num cluster de duas mquinas no h quorum em caso de uma falha mas
as mquinas devem conseguir manter os servios activos. Para isso necessrio que ignorem o
facto de no terem quorum.

5.4.3 Desactivar auto-failback
Em caso de falha os recursos migram para a mquina secundria. Para evitar que os recursos
migrem imediatamente para a mquina primria assim que esta volta a ficar online necessrio

$ service corosync start

$ corosync-objctl | grep members

$ crm configure property stonith-enabled=false

$ crm configure property no-quorum-policy=ignore

37

indicar que os recursos devem preferir ficar na mquina onde esto e especificar com "quanta
fora" se querem manter na mquina onde esto.

5.5 Adicionar recursos
Os recursos que podem ser geridos so scripts nos formatos LSB e OCF. Os preferidos so OCF
pois permitem passagem de parametros. Um script OCF tem de suportar obrigatoriamente as
seguintes aces" 'start', 'stop', 'monitor' e 'meta-data' e devem suportar a aco 'validate-all'.
Para informao detalhada sobre os recursos OCF consultar http://www.linux-
ha.org/wiki/OCF_Resource_Agents
Ao instalar o Corosync e o Pacemaker vrios recursos so instalados pela package 'cluster-
agents' em '/usr/lib/ocf/resource.d/'. Dentro desta pasta cada pasta um provider de recursos que
contem os scripts que o provider fornece. Se, por exemplo, a PTIN criar um script com o nome
'recurso-ptin' que obedece s normas OCF e o quiser adicionar ao cluster este deve residir em
'/usr/lib/ocf/resource.d/ptin/recurso-ptin'
Os recursos vo estar disponveis inicialmente na mquina em que so configurados, dever ser
a primria a no ser que imediatamente se configurem preferencias dos recursos por
determinadas mquinas. Se a mquina primria falhar os recursos migram para a secundria. O
regresso dos recursos para a mquina primria deve ser feito manualmente.
5.5.1 Adicionar um recurso qualquer
Para adicionar um recurso existente ou criado por ns e colocado na pasta
/usr/lib/ocf/resource.d/<nome_do_fornecedor>/<nome_do_script> a sintaxe genrica a seguinte:

Descrio
nome nome que queremos dar ao recurso
ocf tipo de recurso (ocf ou lsb)
fornecedor fornecedor do recurso (so para ocf, os lsb devem estar na pasta '/etc/init.d/'
script nome do script de inicializao do recurso
params parametros a passar ao script de inicializao do recurso
op operaes a realizar no recurso
Tabela 7:Tabela de recursos

$ crm configure rsc_defaults resource-stickiness=100

$ crm configure primitive nome ocf:fornecedor:script params ... op
...

38

5.5.2 Adicionar um endereo IP
Adicionar um endereo IP no qual o cluster deve fornecer servios. Este endereo IP vai saltar
para a mquina secundria quando a mquina primria vai abaixo. Neste exemplo o IP
configurado 192.168.1.10 com mscara 255.255.255.0 na interface fsica 'eth0'. Este endereo
IP vai ser monitorizado de 10 em 10 segundos.

5.6 Configurar relaes entre recursos
Assumindo a existencia de dois recursos, um endereo IP com o nome 'cluster-ip' e um recurso
com o nome "servico-generico" podem configurar-se relaes entre estes recursos.
5.6.1 Fazer depender um servio da existncia de outro
Configura uma 'colocation': um recurso s pode existir onde o outro estiver activo. O valor
'INFINITY' especifica que o outro recurso tem obrigatoriamente de existir e estar activo. Se o
recurso 'servico-generico' for mudado, automaticamente ou manualmente, o servio cluster-ip
tambm vai mudar para a mesma mquina e vice-versa.

5.6.2 Forar ordem de arranque dos servios
Uns servios podem necessitar que outros sejam iniciados primeiro para iniciarem com sucesso.
Para forar uma ordem, neste caso primeiro o 'cluster-ip' e depois o 'servico-generico' executar:

5.7 Configurar localizao de recursos e re-localizao manual de
recursos
5.7.1 Localizao de recursos
Para que um recurso esteja preferencialmente numa mquina deve indicar-se ao Pacemaker em
qual mquina deve colocar o recurso e com "quanta fora":

$ crm configure primitive cluster-ip ocf:heartbeat:IPaddr params
ip="192.168.1.10" cidr_mask="24" nic="eth0" op monitor
interval="10s"

$ crm configure colocation servico-generico-com-ip INFINITY:
servico-generico cluster-ip

$ crm configure order servico-generico-depois-de-ip mandatory:
cluster-ip servico-generico

$ crm configure location prefer-node1 servico-generico 50: node1

39

Neste caso atribui-se uma fora de 50 para o servio genrico ficar na mquina cujo resultado do
comando 'uname -n' (o hostname) node1. 'prefer-node1' o nome que queremos dar
preferencia.
5.7.2 Re-localizao manual de recursos
Para mover um recurso manualmente para a mquina com o hostname 'node1':

Os servios da mesma 'colocation' migram juntos para a mquina escolhida. Este comando faz
com que o recurso prefira sempre o node1. Para eliminar esta preferencia:

Apesar do nome este comando no faz regressar o recurso 'servico-generico' para a mquina
onde estava anteriormente, apenas elimina a preferencia forada pela mquina node1, passando
a respeitar o sistema de pontos de "fora" para escolher as mquinas.

$ crm resource move servico-generico node1

$ crm resource unmove servico-generico

06

40
FAQ

6 FAQ
6.1 O mdulo Job Scheduler no se encontra disponvel
Para contemplar o suporte do modulo Job Scheduler, em situaes de upgrade, necessrio, no
SCA:
Criar o Sistema de gesto especfico, importando o ficheiro SG_AgoraNG-JobScheduler.xml
Editar o Sistema de Gesto "AgorangNMC - Login Manager", criar um PI novo, denominado
"jobScheduler", no perfil "Seleco de mdulos", com tipo de acesso de administrao.
Garantir que o utilizador tem o perfil de AgorangNMC Login Manager com acesso de
Administrador.

12

41
Referncias

7 Referncias
[1] ORACLE_11g_QuickInstallGuide.
http://www.oracle.com/pls/db111/portal.portal_db?selected=11

[2] Using JBoss Behind a Firewall. https://community.jboss.org/wiki/UsingJBossBehindAFirewall

42
Referncias

PT Inovao
Rua Eng. Jos Ferreira Pinto Basto
3810-106 Aveiro
Portugal

Tel: +351 234 403 200
Fax: +351 234 424 723

http://www.ptinovacao.pt
Todas as especificaes so passveis de alterao sem
notificao
PT INOVAO
DIRECTRIO DE ARMAZENAMENTO/NOME DO
FICHEIRO/VERSO

Manual Agora NG Instadm v6.3 PT - Draft (Alsoft) - v3

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Agora NG Instadm v6.3 PT - Draft (Alsoft) - v3

Enviado por

Direitos autorais:

Formatos disponíveis

AGORA-NG

Manual de Instalao AgoraNG

Você também pode gostar