manual agora ng instadm v6.3 pt - draft (alsoft)_v3

43
AGORA-NG Manual de Instalação AgoraNG Guia de Instalação de versões 6.3 [6.3] | [Novembro de 2012]

Upload: deathkx

Post on 24-Nov-2015

62 views

Category:

Documents


5 download

TRANSCRIPT

  • 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

  • Manual de Instalao AgoraNG

    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

  • Manual de Instalao AgoraNG

    ndice de Figuras

    5

    ndice de Figuras

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

  • Manual de Instalao AgoraNG

    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

  • Manual de Instalao AgoraNG 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

    $ wget http://yum.ptin.corppt.com/repo/ext-

    generic/el5/x86_64/sun-jdk-1.6.0_X.ptin.el5.x86_64.rpm

    $ wget http://yum.ptin.corppt.com/repo/ext-

    generic/el5/x86_64/jboss-jdk6-5.1.0-X.ptin.el5.noarch.rpm

    $ wget http://yum.ptin.corppt.com/repo/ext-

    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 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

    Comando para alterar: alter system set = 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(

    acl => 'all-network-PUBLIC.xml',

    principal => 'PUBLIC',

    is_grant => true,

    privilege => 'resolve'

    );

    dbms_network_acl_admin.assign_acl(

    acl => 'all-network-PUBLIC.xml',

    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:

    ProxyRequests On

    #

    Order deny,allow

    Deny from all

    Allow from all

    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

    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

    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"

  • Manual de Instalao AgoraNG 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

    Pacote Tipo Descrio Onde instalar

    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

    Pacote Tipo Descrio Onde instalar

    Alarm Manager

    (3.8.4)

    Ver 2.3.3.2

    Mdulo de gesto de alarmes

    Acesso BD

    2.2.1.3 SCA

    Pacote Tipo Descrio Onde instalar

    SCA ( 4.5.0 ) JAR Sistema de controlo de Acessos

    Acesso BD

    2.2.1.4 Reports

    Pacote Tipo Descrio Onde instalar

    agorang-reports RPM Integrao do componente Reports

    Mquina Reports

    agorang-reports-database

    RPM Integrao do componente Reports (componente PL-SQL)

    Mquina Reports

    2.2.1.5 QoS Collector

    Pacote Tipo Descrio Onde instalar

    agorang-qoscollector

    agorang-qoscollector-database

    RPM Integrao do componente QoS Collector

    Mquina para recolha de dados de desempenho

    agorang-qoscollector-udp

    RPM Integrao do componente 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

    Pacote Tipo Descrio Onde instalar

    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)

    Pacote Tipo Descrio Onde instalar

    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)

    Pacote Tipo Descrio Onde instalar

    agorang-northbound-inventory-interface

    RPM

    Interface de cadastro, para

    consulta por sistemas

    externos

    Mquina onde esteja instalado agorang-ap

    2.2.5 Northbound GPON Interface (opcional)

    Pacote Tipo Descrio Onde instalar

    agorang-northbound-gpon-interface

    RPM

    Interface para proviso e

    diagnstico GPON, por

    sistemas externos

    Mquina onde esteja instalado agorang-ap

    2.2.6 Northbound DSL Interface (opcional)

    Pacote Tipo Descrio Onde instalar

    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 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 ''@'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

    DocumentRoot /home/na

    Options Indexes FollowSymLinks

    IndexOptions FancyIndexing VersionSort XHTML SuppressIcon

    SuppressColumnSorting SuppressDescription SuppressHTMLPreamble

    SuppressLastModified SuppressRules SuppressSize

    # 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 /

    # start

    Ou

    # @

  • 24

    Instalao

    (Este ficheiro foi gerado no passo anterior)

    Passo04-App-gera_sinonimos.sql AGORANGGESTOR

    Passo04-App-sinonimos.sql (Este ficheiro foi gerado no passo anterior)

    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 (Este ficheiro foi gerado no passo anterior)

    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

    (Este ficheiro foi gerado no passo anterior) AGJ2GESTOR

    Passo04-App-gera_sinonimos.sql AGJ2

    Passo04-App-sinonimos.sql

    (Este ficheiro foi gerado no passo anterior) 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):

    Password:

    User (App):

    Password:

    Compiling schema...

    PL/SQL procedure successfully completed.

    Checking if there is any invalid package...

    no rows selected

  • Manual de Instalao AgoraNG 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/29-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/30-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/31-defines.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/32-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/33-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/34-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/35-AS-ScaGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/36-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/37-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/38-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/39-AS-AppGestor.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/39-defines.sql

    /opt/ptin/agorang/src/database/schemas/6.2.0/40-AS-AppGestor.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)

  • Manual de Instalao 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/beanLocationsConfig.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/beanLocationsConfig.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/beanLocationsConfig.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.properties

    configuraes das aces SMS/mail

    ~/jboss-server/alarmmonitor/deploy/ejap/localLibs.sar/conf/sms/smsSenderConfig.properties

    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.properties

    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 default

    O campo 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

  • Manual de Instalao AgoraNG 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

    //authkey /etc/corosync/authkey

  • 35

    Redundncia geogrfica

    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

    Redundncia geogrfica

    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

    Redundncia geogrfica

    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// 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

    Redundncia geogrfica

    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

    Redundncia geogrfica

    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

  • Manual de Instalao AgoraNG 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.

  • Manual de Instalao AgoraNG 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