Portal de Publicacao-Manual de Utilizacao

PORTAL DE PUBLICAO
Manual de Utilizao (v. 3.1)

FTP e HP OO Portal Simples
quinta-feira, 12 de maro de 2015
ndice
1. Portal de Publicao .................................................................................................. 4
1.1. Objetivos ........................................................................................................... 4
1.2. Caractersticas .................................................................................................. 4
1.3. Arquitetura da Soluo...................................................................................... 5
1.3.1. FTP do Portal de Publicao .................................................................... 6
1.3.2. Portal Simples Interface do Usurio ......................................................... 9
2. Processo de Publicao de uma Aplicao ............................................................. 12
2.1. Acesso ao FTP de publicao......................................................................... 12
2.1.1. Configurao do acesso ao FTP ............................................................ 13
2.1.2. Cuidados com a publicao de artefatos Windows................................. 16
2.2. Transferncia de arquivos para o FTP ............................................................ 17
2.3. Acesso interface web do Portal de Publicao ............................................. 19
2.4. Execuo do fluxo Portal Simples................................................................. 20
2.4.1. Imediata ................................................................................................. 22
2.4.2. Agendada............................................................................................... 25
2.5. Resultados da Publicao ............................................................................... 30
2.6. Funcionamento da Publicao de DLLs (Windows) ........................................ 31
2.6.1. Objetivos ................................................................................................ 31
2.6.2. Caractersticas ....................................................................................... 31
2.6.3. Processo de Publicao de DLL............................................................. 32
3. Processo de Execuo de Scripts em Banco de Dados .......................................... 37
3.1. Acesso ao FTP de publicao......................................................................... 37
3.2. Transferncia de arquivos para o FTP ............................................................ 37
3.3. Acesso interface web do Portal de Publicao ............................................. 38
3.4. Execuo do fluxo Executa Scripts BD ......................................................... 38
3.4.1. Execuo Imediata ................................................................................. 39
3.4.2. Agendada............................................................................................... 43
3.5. Resultados da Publicao ............................................................................... 48
4. Apndice ................................................................................................................. 49
4.1. Procedimentos para a implantao da automao do deploy de aplicaes no
SERPRO .................................................................................................................. 49
4.2. Sobre a abertura de mudanas para o deploy/publicao............................... 50
4.3. Tratamento de Erros ....................................................................................... 50
4.3.1. Erros no acesso e transferncia de arquivos ao FTP do Portal de
Publicao ........................................................................................................... 51
4.3.2. Erros na execuo do fluxoPortal Simples ........................................... 51
4.3.3. Erros na execuo do fluxo Executa Scripts BD .................................. 52
4.3.4. Erros na log de execuo da Publicao................................................ 53
4.4. Sobre a abertura de incidentes quando a publicao impactar na disponibilidade
e performance do ambiente/servio de cliente. ......................................................... 54
Folha-2
Folha-3
1. Portal de Publicao
O Portal de Publicao uma soluo desenvolvida para facilitar e padronizar o
desenvolvimento de aplicaes desenvolvidas pelo SERPRO.
Foi desenvolvida em parceria com a empresa HP, conforme requisitos das diferentes
reas responsveis pelo processo de publicao definidos atravs de projeto bsico,
como parte integrante do projeto SIGPB.
O Portal de Publicao composto pelos seguintes mdulos:
Publicao de aplicaes (Portal Simples)
Execuo de Scripts de Banco de Dados (Executa Scripts BD)
1.1. Objetivos
Os principais objetivos do Portal de Publicao so:
Padronizao do fluxo de publicao nos 3 Centros de Dados da SUPCD
Centralizao da publicao entre plataformas (Linux e Windows)
Centralizao da execuo de scripts de banco de dados (Oracle, MSSQL,
MySQL, PostgreSQL)
Integrao dos processos de publicao de aplicao, de publicao de
componentes e de execuo de scripts de banco de dados para facilitar o controle
de alteraes na aplicao.
Integrao com o repositrio de autenticao corporativo do SERPRO
Controle de acesso s publicaes definido pelo gestor no LDAP
Implementao utilizando o menor nmero de softwares
Menor dependncia de processos manuais das equipes de suporte e conseqente
aumento da autonomia do desenvolvedor no processo de publicao
1.2. Caractersticas
Dentre as caractersticas mais importantes do portal de Publicao podemos destacar:
Integridade - Publicao de aplicaes baseada em sincronismo de pastas
(espelhamento)
Autonomia - Execuo de publicaes imediatas ou agendadas controladas

conforme definio da estratgia da equipe de desenvolvimento
Versatilidade - Execuo de scripts administrativos criados pela equipe de suporte

(pr e ps sincronismo) adaptada s caractersticas de cada tecnologia e s
peculiaridades de cada aplicao ou SGBD.
Rastreabilidade - Envio de recibo via e-mail e disponibilizao de logs no FTP,

contendo o resultado das publicaes de aplicaes incluindo a lista de arquivos
Folha-4
atualizados, permitindo maior controle e registro histrico das alteraes nas

aplicaes.
1.3. Arquitetura da Soluo

O Portal de Publicao possui dois componentes principais: o FTP seguro e a interface
web de execuo do fluxo de publicao (ferramenta HP Operations Orchestration).
O desenvolvedor interage com cada um desses componentes para realizar a publicao
dos objetos da aplicao e/ou a execuo de scripts de banco de dados. Em ambos os
componentes, a autenticao feita utilizando-se as credenciais do LDAP corporativo
(SERPRO-RLSL). No servidor de LDAP as permisses do usurio so checadas nos
grupos de publicadores de cada aplicao
O acesso ao FTP do Portal de Publicao feito atravs de cliente FTP (FileZilla) e nele
so depositados os objetos da aplicao.
Depois de depositar os objetos da aplicao ou scripts de banco de dados, o
desenvolvedor acessa a interface web do Portal de Publicao (HP OO) atravs de um
navegador suportado (Firefox ou IE) e executa ou agenda a publicao desses objetos ou
a execuo dos scripts de banco de dados para os servidores de destino nas diversas
ZDMs do SERPRO.
Folha-5
1.3.1. FTP do Portal de Publicao

O FTP do Portal de Publicao um dos componentes utilizados para realizar as
modificaes nas aplicaes desenvolvidas pelo SERPRO. Trata-se do repositrio onde
so depositados os componentes de uma aplicao tais como cdigo-fonte, scripts de
bancos de dados, scripts da aplicao e bibliotecas.
1.3.1.1. Principais Caractersticas:

Validao do acesso as pastas do FTP das aplicaes por usurio (Utilizando a
configurao do LDAP);
Padronizao da estrutura de publicao de aplicaes de diferentes plataformas e
tecnologias.
Repositrio nico para cdigo-fonte, scripts de bancos de dados, scripts e
bibliotecas de cada aplicao.
Contingncia do FTP garantida atravs do recurso de alta disponibilidade da
tecnologia VMotion (VMware)
Replicao das configuraes e arquivos das pastas das aplicaes do FTP entre
os sites (BSA, SPO e RJO).
O FTP do Portal de Publicao do SIGPB foi desenvolvido com o objetivo de facilitar o

upload e controle dos arquivos e atualizaes das aplicaes/servios (ADCAT)
hospedadas nos servidores administrados pela SUPCD. O FTP seguro integrado com o
LDAP do Serpro, permitir que somente os usurios autorizados para publicao
consigam acessar o diretrio de cada aplicao e consigam realizar as atualizaes
necessrias para posterior publicao/distribuio para os diferentes servidores de
destinos que hospedam a aplicao.
1.3.1.2. Estrutura do FTP
A estrutura bsica de pastas de uma aplicao no servidor FTP exibida conforme
a figura abaixo:
Folha-6
Cada aplicativo bsico consiste em 4 pastas no servidor FTP:

app: contm uma cpia de toda a aplicao (pginas, css, imagens etc)
que sero utilizados como base para o espelhamento nos servidores de
destino. Somente os arquivos modificados (data ou tamanho) sero
transferidos ao destino durante a execuo da publicao
bd: contm uma pasta default utilizada somente como repositrio para a
execuo manual de scripts de banco (via RdS ou RdM); e uma pasta para
cada banco de dados utilizada pela execuo automtica de scripts de
banco de dados. Cada uma dessas pastas possuem os seguintes
subdiretrios:
o demandas: onde so depositados os scripts para bancos de dados

para execuo automatizada.
o resultados: onde so obtidos os resultados dos scripts executados

nos bancos de dados atravs do processo automatizado de
execuo de scripts de banco de dados.
dll: a existncia dessa pasta opcional. Algumas aplicaes Windows que

fazem uso de bibliotecas de vnculo dinmico (DLL) podem possuir essa
pasta para fazer a publicao de arquivos desse tipo como parte da
publicao da aplicao. A implementao da publicao automtica de
DLL depende de processo prvio conforme descrito no item 4.1. Dentro de
cada pasta dll existem trs subpastas:
o regsvr: deve conter os arquivos DLL que sero registrados nos

servidores de destino atravs do comando regsvr32.exe.
o regasm: deve conter os arquivos DLL do tipo biblioteca Assembly

do .NET que sero registrados nos servidores de destino atravs do
comando regasm.exe.
Folha-7
o complus: deve conter pastas contendo os arquivos DLL do tipo

COMPLUS que sero registrados nos servidores de destino atravs
do mdulo Component Services do Windows. Cada pasta
representar um continer tipo Server Application dentro do
Complus onde as dlls sero registradas
OBS: Maiores informaes sobre essa funcionalidade esto

descritos na seo 2.6.
logs: onde so obtidos os registros de sada dos roteiros dos processos de

automao do Portal. O resultado do processo de publicao ser colocado
nessa pasta aps a execuo da publicao nos formatos:
o <nome da aplicao>_ddmmaaaahhmmss.zip (para aplicao)
o DLL_<nome da aplicao>_ddmmaaaahhmmss.zip (para DLLs)
o bdlog_<nome da aplicao>_ddmmaaaahhmmss.zip (para scripts

de banco de dados)
Onde:
<nome da aplicao> o nome que identifica a aplicao no

FTP
ddmmaaaahhmmss um identificador do processo de

publicao representado pela data e hora da publicao.
Dentro de cada um desses arquivos compactados estaro os

arquivos contendo o registro de sada da execuo dos processos
de publicao. Para os arquivos referentes a publicao de
Folha-8
aplicao e DLLs o arquivo compactado conter um arquivo de

registro para cada servidor de destino utilizado pela aplicao.
Aps o envio dos arquivos atualizados para a pasta da aplicao no FTP, o usurio
dever utilizar a ferramenta HP OO para a execuo da publicao.
Observao: As pastas das aplicaes, as permisses, os pr-scripts e ps-scripts, a

lista dos servidores de destino e o fluxo de publicao para a aplicao (ADCAT) devero
ser previamente configurados pela equipe responsvel pelo suporte da aplicao na
SUPCD.
1.3.2. Portal Simples Interface do Usurio

A interface do Portal Simples foi desenvolvida para facilitar a distribuio/publicao de
objetos dos servios (ADCAT) do SERPRO. Essa interface permitir aos usurios
responsveis pela publicao, selecionar as suas aplicaes e executar os fluxos de
publicao de arquivos ou de execuo de scripts de banco de dados nos servidores de
destino.
1.3.2.1. Principais Caractersticas:

Validao do acesso as aplicaes por usurio (Utilizando a configurao do
LDAP);
Configurao do RSYNC independente da criao do fluxo no HP Operations
Orchestration (OO);
Execuo de deploy das aplicaes em paralelo nos servidores envolvidos;
Envio de Email para o usurio executor com os resultados da execuo da
publicao (logs).
Os fluxos de publicao e execuo de scripts foram desenvolvidos com o objetivo de

propiciar a execuo de forma simples do deploy das aplicaes do SERPRO. Os fluxos
sero executado a partir da console web do HP OO Central e no ser necessria a
instalao de nenhum software nas estaes dos usurios.
O acesso aos fluxos ser pela ferramenta HP OO Central, que permite a execuo dos
fluxos para o deploy das aplicaes para os diferentes servidores configurados que
hospedam a aplicao.
Nos itens a seguir, sero descritos detalhes sobre os fluxos na ferramenta OO Central.
1.3.2.2. Fluxo Portal Simples para publicao de aplicaes

O fluxo de publicao de aplicaes denominado Portal Simples possui a funcionalidade
de transferir o contedo disponibilizado no servidor de FTP do Portal de Publicao para
os servidores da aplicao selecionada. O fluxo interage com o usurio para solicitar
Folha-9
informaes sobre a aplicao que deve ser publicada, bem como sobre opes de
notificao, da execuo e da programao da publicao.
I - Tela do Fluxo Portal Simples

O fluxo Portal Simples permite as seguintes opes:
Publicao imediata ou agendada: permite escolher entre realizar o deploy
da aplicao imediatamente ou mediante agendamento conforme
convenincia do publicador. Se optar pela publicao agendada, ser
solicitado o dia e hora desejados para que a publicao ocorra. Devido a
uma regra de negcio do Portal de Publicao, no possvel agendar
uma publicao para um horrio menor que 30 minutos aps a execuo
do fluxo.
Envio das notificaes somente para o publicador ou para todos do grupo:
permite escolher entre enviar as notificaes de incio do processo de
publicao e de resultado do processo de publicao somente para o
usurio que est executando o fluxo, ou para todas as pessoas que fazem
parte do grupo de publicao da aplicao selecionada. Os membros do
grupo da aplicao esto definidos conforme cadastramento realizado pelo
gestor da aplicao no servio de diretrio corporativo (SERPRO-RLSL)
Publicao adicional das DLLs (somente aplicaes Windows): quando
selecionada esta opo permite que as bibliotecas dinmicas (DLL),
alteradas nos subdiretrios de cada tipo (regsvr32, regasm ou complus) da
pasta dlls da aplicao no FTP do Portal de Publicao, sejam
transferidas para os servidores da aplicao e registradas nesses
servidores.
1.3.2.3. Fluxo Executa Scripts BD para automao da

execuo de scripts em bancos de dados
O fluxo para a automao da execuo de scripts em bancos de dados denominado
Executa Scripts BD permite que os desenvolvedores possam executar scripts nos
bancos de dados das aplicaes de forma autnoma. O fluxo interage com o usurio
Folha-10
solicitando informaes sobre o banco de dados de destino, bem como sobre opes de
notificao, da execuo e da programao da execuo dos scripts de banco de dados.
II - Fluxo Executa Scripts BD

O fluxo Executa Scripts BD permite as seguintes opes:
Execuo imediata ou agendada: permite escolher entre executar os scripts
de banco de dados imediatamente ou mediante agendamento conforme
convenincia do desenvolvedor. Se optar pela execuo agendada, ser
solicitado o dia e hora desejados para que a execuo ocorra. Devido a
uma regra de negcio do Portal de Publicao, no possvel agendar
uma execuo para um horrio menor que 30 minutos aps a execuo do
fluxo.
Envio das notificaes somente para o publicador ou para todos do grupo:
permite escolher entre enviar as notificaes de incio do processo de
execuo e de resultado do processo de execuo somente para o usurio
que est executando o fluxo, ou para todas as pessoas que fazem parte do
grupo de publicao da aplicao selecionada. Os membros do grupo da
aplicao esto definidos conforme cadastramento realizado pelo gestor da
aplicao no servio de diretrio corporativo (SERPRO-RLSL)
Folha-11
2. Processo de Publicao de uma Aplicao

O processo para a atualizao de uma aplicao consiste na execuo das seguintes
atividades:
Acessar o FTP do Portal de Publicao
Transferir o contedo das alteraes na aplicao para o FTP
Acessar a interface web do portal de Publicao
Executar o fluxo de publicao Portal Simples
Verificar o resultado da publicao
2.1. Acesso ao FTP de publicao

Antes de acessar o FTP de publicao, necessrio que o desenvolvedor j esteja com
o(s) arquivo(s) contendo as modificaes da aplicao.
importante frisar que o Portal de Publicao no realiza o controle de versionamento
das aplicaes, pois existem ferramentas prprias para esse fim. Para maiores
informaes sobre o processo de versionamento de aplicaes, consulte o sistema PSDS
(disponvel em http://psds.portalcorporativo.serpro)
O acesso do desenvolvedor realizado atravs de cliente FTP previamente configurado.
As credenciais do LDAP corporativo fornecidas pelo desenvolvedor iro definir quais
aplicaes o desenvolvedor ter acesso para realizar modificaes.
As permisses aos grupos de publicadores de cada aplicao so definidas pela Unidade
Gestora responsvel pela aplicao e solicitadas pela rea de Gesto de Mudanas da
SUPDE, conforme definido no Subprocesso Criao de Nova Publicao (disponvel em
http://sigpb.supcd.serpro/home/index.php/processo-de-publicacao)
Folha-12
2.1.1. Configurao do acesso ao FTP

O acesso ao FTP de publicao realizado necessariamente atravs de um cliente de
FTP que suporte a utilizao de criptografia na autenticao. O cliente de FTP FileZilla
(disponvel em http://filezilla-project.org) pode ser utilizado em estaes de trabalho nas
plataformas Linux e Windows e foi homologado para a utilizao com o FTP do Portal de
Publicao.
Conforme definida na topologia do Portal de Publicao, existe um servidor de FTP em

cada um dos Centros de Dados da SUPCD (Braslia, Rio de Janeiro e So Paulo).
Dependendo da localidade em que esteja hospedado o site principal da aplicao, sero
utilizadas as seguintes configuraes para conexo com o servidor de FTP:
FTP BSA:
Servidor: portalsa.supcd.bsa.serpro
Porta: 990
Protocolo: FTP
Encriptao: Requer FTP sobre TLS explcito
Folha-13
FTP SPO:
Servidor: portalsa.supcd.spo.serpro
Porta: 990
Protocolo: FTP
FTP RJO:
Servidor: portalsa.supcd.rjo.serpro
Porta: 990
Protocolo: FTP
O FTP ir solicitar as informaes do usurio e a senha de acesso:

Usuario: (LDAP User)
Senha: (LDAP Senha)
Configurar o modo de transferncia para forar o uso de FTP passivo. Para isso, acesse a
aba Configuraes de transferncia e selecione o item Passivo no contexto Modo de
transferncia.
Folha-14
Clique em OK para criar a conexo.

A seguir, configure as opes padro para acesso ao FTP do Portal de Publicao.
Configure o timeout da conexo para 120 segundos. Para alterar essa configurao,
acesse o menu Editar, opo configuraes, e insira o valor de 90 segundos em Timeout.
Para que os arquivos sejam transferidos com o mesmo tamanho da origem, necessrio
que eles sejam transferidos em modo binrio (por padro o Filezilla transfere alguns tipos
Folha-15
de arquivos como texto). Para alterar essa configurao, selecionar Binrio no contexto
Tipo de transferncia padro.
2.1.2. Cuidados com a publicao de artefatos

Windows
Os servidores de FTP do Portal de Publicao so servidores Linux utilizando a tecnologia
PROFTPD. O servidor de FTP serve como repositrio para aplicaes de todas as
plataformas produzidas pelo SERPRO, sejam elas Windows, Linux ou Unix. Essa era uma
das premissas do projeto e uma das exigncias das equipes de desenvolvimento, que
antes tinham que acessar diferentes repositrios em diferentes plataformas e utilizando
diferentes credenciais.
Porm, com a unificao das plataformas em uma nico repositrio, alguns cuidados
adicionais se tornaram necessrios.
Quando uma aplicao desenvolvida para ser hospedada em servidores Windows,

necessrio uma ateno maior por parte dos desenvolvedores com relao aos nomes
dos arquivos (artefatos de publicao).
2.1.2.1. Arquivos Homnimos

O que ocorre que por padro, os servidores Windows no fazem diferenciao entre
caracteres maisculos ou minsculos nos nomes dos arquivos. O mesmo no ocorre com
servidores Linux, como o caso do servidor de FTP da soluo.
Com isso, possvel que um desenvolvedor de uma aplicao Windows possa colocar
dois arquivos diferentes para um mesmo artefato ao realizar a transferncia para o FTP.
Por exemplo, o desenvolvedor pode fazer upload de uma arquivo chamado abc.aspx e
outro chamado ABC.aspx, independente se o contedo desses arquivos o mesmo ou se
contm verses diferentes de um mesmo artefato. Nessa condio, o que ocorrer a
seguinte situao:
Folha-16
sero listados os dois arquivos no FTP, podendo possuir data de modificao e

tamanho iguais ou no;
ao executar a publicao atravs do HP OO, um dos dois arquivos ser sempre
atualizado, pois para o sistema de sincronizao sempre um dos arquivos estar
faltando no servidor de destino.
poder haver inconsistncia na aplicao em decorrncia de verses distintas de
artefatos publicados nos servidores.
Para evitar essa situao, sugere-se que os desenvolvedores de aplicaes de plataforma

Windows padronizem a atribuio de nomes de arquivos dos artefatos (por exemplo, para
que todos os caracteres sejam minsculos), de forma a identificar de forma mais rpida
qualquer desvio na publicao de artefatos.
Em caso de identificao de arquivos homnimos, a soluo mais rpida a excluso de

um dos arquivos do servidor de FTP. Ao proceder com a sincronizao, se o sistema de
sincronizao detectar diferena no arquivo, apenas o arquivo restante atualizado nos
servidores de destino.
2.1.2.2. Codificao de caracteres

Outro problema que pode ocorrer com aplicaes de plataformas distintas do Linux com
relao codificao de caracteres. Os servidores Linux trabalham por padro com a
codificao UTF-8 para a nomenclatura dos arquivos. J os servidores Windows utilizam o
padro ISO-8859-1.
A mesma situao anterior pode ocorrer quando os arquivos utilizam caracteres especiais
como cedilha, acentos, apstrofe etc.
Ao transferir os arquivos para o servidor de FTP eles podem aparecer como corretos
dependendo da configurao no cliente de FTP, mas ao serem transferidos para os
servidores de destinos pode ocorrer uma transformao dos caracteres devido
codificao ser distinta no servidor de destino.
O cliente de FTP FileZilla permite a autodeteco da codificao de caracteres nas

configuraes de conexo com o servidor. Essa a configurao padro, mas caso seja
necessrio alterar, deve-se acessar o menu Arquivo > Gerenciador de Sites > aba Mapa
de Caracteres, e marcar a opo Forar UTF-8.
Para evitar essa situao, o ideal que os artefatos no possuam caracteres especiais no
nome.
2.2. Transferncia de arquivos para o FTP

A transferncia de arquivos para o servidor de FTP uma tarefa bastante simples.
Folha-17
Uma vez logado no servidor de FTP com o cliente FTP FileZilla, o desenvolvedor ir
identificar no painel do lado direito intitulado Endereo Remoto a estrutura de pastas
conforme descrito na seo 1.3.1.2. Ele dever navegar at o diretrio da aplicao,
selecionando a pasta de destino nesse painel. No caso de transferncia de objetos da
aplicao web, o desenvolvedor ir selecionar a pasta app. Nesse diretrio o
desenvolvedor ir encontrar uma cpia da aplicao, que ser utilizada como base para
as modificaes necessrias.
No painel do lado esquerdo intitulado Endereo local, o desenvolvedor ir navegar
dentro da estrutura de diretrios de seu sistema de arquivos da mquina local, at
encontrar o diretrio onde se encontram os objetos que sero transferidos ao servidor de
FTP.
Ainda no painel Endereo local, na caixa inferior, o desenvolvedor ir selecionar os
arquivos/diretrios que sero transferidos.
Para transferir os arquivos/diretrios, pode-se utiliza o boto direito do mouse e em
Upload, ou selecionar o item Processar fila no menu Transferir.
importante destacar que somente os arquivos modificados, sejam pela data de

modificao ou pelo contedo do arquivo, que sero transferidos para o(s) servidor(es)
de destino, pois o componente de sincronizao ir realizar uma comparao de cada
arquivo antes de realizar a transferncia.
Os arquivos que forem removidos do FTP tambm sero apagados no(s) servidor(es) de
destino quando for executado o deploy, portanto necessrio um cuidado maior no
momento de realizar a s transferncias para no causar erros na aplicao.
Para aplicaes da plataforma Windows, importante atentar para os Cuidados com a
publicao de artefatos Windows, conforme explicado na seo 2.1.2.
Folha-18
Depois de realizadas as transferncias necessrias ao servidor de FTP, o desenvolvedor

pode se desconectar do servidor.
2.3. Acesso interface web do Portal de

Publicao
Para realizar a publicao de uma aplicao, utilize um navegador compatvel (Firefox ou
Internet Explorer), introduzindo o endereo (URL) de acordo com o Centro de Dados onde
est hospedada a aplicao.
No caso das aplicaes hospedadas na SUPCD/BSA, o acesso principal ao fluxo ser a
partir do seguinte endereo no navegador Web:
HP OO/BSA:
https://oo.supcd.bsa.serpro:8443/PAS
HP OO/RJO:
https://oo.supcd.rjo.serpro:8443/PAS
HP OO/SPO:
https://oo.supcd.spo.serpro:8443/PAS
A ferramenta ir solicitar as informaes do usurio e a senha de acesso:

Usuario: (LDAP User)
Senha: (LDAP Senha)
Folha-19
2.4. Execuo do fluxo Portal Simples

Aps o login na ferramenta HP Operations Orchestration, ser apresentada a tela inicial.
Folha-20
Navegar na rvore de fluxos, em Library > SERPRO > Portal Simples > Portal Simples
Ser aberta uma nova tela com o fluxo Portal Simples. Dever ser escolhida a opo Run
All para o incio da execuo do fluxo.
Folha-21
2.4.1. Imediata
Selecione a opo de execuo da publicao desejada (Imediata ou Agendada)
Folha-22
A opo de selecionar o Site ser utilizada somente em casos excepcionais de

contingncia. Nesses casos, selecione a regional da aplicao (BSA, SPO ou RJO)
Na opo Enviar notificaes de publicao escolha a opo Para todos do Grupo para
que as notificaes (e-mail) de incio da publicao e de resultado da publicao sejam
enviados para todos os publicadores do Grupo; ou escolha a opo Somente para mim
quando desejar que as notificaes sejam enviadas apenas para seu endereo de e-mail.
Clique no boto Continue
Na prxima tela o fluxo ir solicitar a aplicao (ADCAT) desejada para a execuo do

deploy:
A lista das aplicaes depende das permisses definidas para cada usurio por aplicao
nas configuraes do LDAP. Aps a seleo clique no boto Continue
Folha-23
PASSO OPCIONAL: Caso aplicao selecionada seja

da Plataforma Windows e possuir DLLs ser exibida
uma tela com a opo de publicar ou no as novas
DLLs. Aps a seleo clique no boto Continue
Ao final da opes escolhidas ser exibida uma mensagem informativa:
Depois de validar o recebimento do e-mail de incio da publicao, dever ser selecionada

a opo continue e aps isso j pode ser efetuado a desconexo da ferramenta OO
atravs da opo Logout.
Folha-24
Depois de fechado o fluxo, o HP OO internamente estar executando o deploy da

aplicao selecionada e caso a aplicao possua vrios servidores configurados, os
deploy sero executados em paralelo. Finalizada a execuo dos deploy nos servidores
configurados, o fluxo enviar um e-mail para o usurio executor, com os resultados da
publicao (Logs).
Ao mesmo tempo, o arquivo contendo as Logs da execuo da publicao tambm sero
colocados no servidor de FTP, na pasta logs da aplicao, conforme descrito na seo
1.3.1.2.
2.4.2. Agendada
Outra opo de agendamento a opo Agendado.
Folha-25

Na prxima tela o fluxo ir solicitar a aplicao (ADCAT) desejada para a execuo do

deploy:
Folha-26
nas configuraes do LDAP.
PASSO OPCIONAL: Caso aplicao selecionada seja

da Plataforma Windows e possuir DLLs ser exibida
uma tela com a opo de publicar ou no as novas
DLLs. Aps a seleo clique no boto Continue
Depois de confirmada as selees feitas para a execuo da publicao, o fluxo vai

solicitar os dados do agendamento da execuo da publicao.
Folha-27
Selecionar o Ano e Ms
Depois de selecionado o Ano e Ms o fluxo ir solicitar o dia do ms selecionado e o

horrio da execuo, o fluxo criar uma lista dos dias do ms com seu correspondente dia
da semana (ex. Monday Thuesday)
Selecionar o dia e a hora de execuo:
Depois de selecionado os dados de agendamento, o fluxo ir solicitar a confirmao dos

dados selecionados.
Importante: O horrio de incio da execuo agendada dever ter um intervalo de no

mnimo 30 minutos aps a confirmao dos dados do agendamento selecionado.
Folha-28
Observao: No caso de selecionar um horrio para os prximos 15 minutos desde o momento da

confirmao dos dados de agendamento, o fluxo vai solicitar a mudana do horrio para no
mnimo de 30 minutos frente do horrio atual.
Depois de selecionado o horrio correto o fluxo vai solicitar a confirmao dos dados com
a seguinte tela:
Confirmado o horrio do agendamento, o fluxo enviar o agendamento para o HP OO.

Ao final da opes escolhidas ser exibida uma mensagem informativa:
Folha-29
Depois de validar o recebimento do e-mail de incio da publicao, dever ser selecionada

a opo continue e aps isso j pode ser efetuado a desconexo da ferramenta OO
atravs da opo Logout.
Depois de fechado o fluxo, o HP OO internamente estar executando o deploy da

aplicao selecionada e caso a aplicao possua vrios servidores configurados, os
deploy sero executados em paralelo. Finalizada a execuo dos deploy nos servidores
configurados, o fluxo enviar um e-mail para o usurio executor, com os resultados da
publicao (Logs).
Ao mesmo tempo, o arquivo contendo as Logs da execuo da publicao tambm sero
colocados no servidor de FTP, na pasta logs da aplicao, conforme descrito na seo
1.3.1.2.
2.5. Resultados da Publicao
Os resultados da publicao podero ser obtidos de duas formas:

Aps a execuo da publicao ser enviada uma notificao via e-mail
para o usurio publicador. Essa notificao ir conter os dados da
publicao em seu corpo e um arquivo anexo compactado contendo as
Logs de execuo das publicaes nos servidores sendo que, para cada
servidor, haver um arquivo de Log e o nome desse arquivo composto
pelo nome do servidor e o status da publicao naquele servidor (p.ex.
RJCDSRVV0001_Ok ou DFCDSRVV9999_Fail)
Aps o trmino da execuo da publicao ser depositado um arquivo no
servidor de FTP na pasta da aplicao, no subdiretrio logs. Trata-se de
um arquivo compactado contendo as Logs de execuo das publicaes
nos servidores sendo que, para cada servidor, haver um arquivo de Log e
o nome desse arquivo composto pelo nome do servidor e o status da
publicao naquele servidor (p.ex. RJCDSRVV0001_Ok ou
DFCDSRVV9999_Fail)
Folha-30
2.6. Funcionamento da Publicao de DLLs

(Windows)
2.6.1. Objetivos
Aplicaes Windows baseadas em ASP ou .NET possuem uma implementao que
permite que parte da aplicao seja colocada em bibliotecas chamadas de Dynamic Link
Library (biblioteca de vnculo dinmico) tambm chamadas de DLL. As principais
vantagens da utilizao de DLL so:
Reutilizao de cdigo
Economia de espao em disco
Melhor gerenciamento de memria, quando executados em processo separado da
aplicao
Proteo relativa das regras de negcio A DLL compilada e por isso pode
dificultar o acesso ao cdigo fonte da aplicao.
A desvantagem na utilizao da DLL que ela compilada para uma plataforma
especfica (32 bit ou 64 bit), mas isso pode ser superado re-compilando a DLL para a
plataforma desejada, desde que possua o cdigo-fonte da DLL.
Maiores informaes sobre o uso de DLL podem ser obtidos no site da Microsoft
(disponvel em http://msdn.microsoft.com/en-us/library/1ez7dh12(v=vs.100).aspx)
A automao da publicao de DLL faz parte da publicao da aplicao (pginas), pois

est diretamente ligada a aplicao, ou seja, as pginas e a DLL possuem alto grau de
interdependncia entre si.
A necessidade da publicao de DLL surgiu juntamente com a automao da publicao
de pginas justamente devido a essa interdependncia.
Essa automao visa agilizar o processo de atualizao das aplicaes sem a interveno
das equipes de suporte da SUPCD, trazendo, com isso, maior autonomia s equipes de
desenvolvimento do SERPRO.
Entre as vantagens da automao da publicao de DLL esto as mesmas vantagens
obtidas com a publicao de pginas como a padronizao no processo de atualizao
das aplicaes, a centralizao dos repositrios das aplicaes e o controle do acesso
integrado com o LDAP.
2.6.2. Caractersticas
As principais caractersticas da publicao de DLL atravs do portal de Publicao so:
Permite o registro de diferentes tipos de DLL (regsvr32, regasm e ComPlus). Para
o tipo regsvr32 somente suportado o registro de DLL 32 bit, mesmo se o servidor
de destino for de plataforma 64 bit.
Para DLL do tipo ComPlus, permite a criao de contineres, caso haja
necessidade de execuo com permisses especficas
Em todo registro de DLL a aplicao temporariamente retirada do ar para permitir
a substituio da DLL existente na memria. prefervel que as publicaes de
Folha-31
DLL sejam executadas fora do horrio de produo da aplicao, para evitar que
os usurios da aplicao recebam mensagens de erro.
Emisso de recibo com o resultado da publicao
Emisso de log de registro da DLL com o passo a passo do processo de registro
das DLLs.
O processo de registro de DLLs prev apenas a incluso ou alterao de DLLs.
No est previsto somente a remoo de DLLs nesse processo.
2.6.3. Processo de Publicao de DLL

Para a publicao de DLL, os seguintes passos devem ser executados:
1. Acessar o servidor de FTP, da mesma forma como executado no processo de
publicao de pginas (conforme descrito na seo 2.1), acessando a pasta dll
dentro da pasta da aplicao que se deseja alterar.
2. Acessar a pasta respectiva ao tipo de DLL (regsvr32, regasm ou complus)
Folha-32
3. Transferir o arquivo de DLL para o servidor de FTP. No caso de DLL do tipo

regsvr32 e regasm, as DLL devem ser depositadas na raiz do diretrio. J no caso
de DLL do tipo ComPlus, necessrio criar um subdiretrio que representar o
continer no servidor de aplicao.
Para o nome dos diretrios e das DLL necessrio observar os mesmos cuidados
para a publicao de arquivos em Windows do portal de Publicao (conforme
descrito na seo 2.1.2).
A figura abaixo mostra como os contineres sero transformados em Server

Applications no servidor de destino.
Folha-33
4. Uma vez depositadas as DLL no servidor de FTP pode-se desconectar do servidor

de FTP e executar a segunda etapa do processo de publicao que acessar a
interface web do portal de Publicao (conforme descrito na seo 2.3)
5. Acessar o fluxo Portal Simples e executar o passo a passo conforme a forma
desejada para a publicao da aplicao. Caso no haja necessidade de
publicao de pginas e somente se desejar atualizar a(s) DLL(s) da aplicao,
tambm se pode executar o fluxo de publicao normalmente, pois se no houve
mudanas nas pginas, o fluxo no ir atualizar nenhum arquivo na pasta da
aplicao.
6. No passo seguinte ao de escolher a aplicao, ser apresentada a tela abaixo.
Nesse momento, para executar a publicao de DLL, na pergunta Publica DLLs
novas?, necessrio escolher a opo Sim.
7. Executar os demais passos da publicao e aguardar o resultado da publicao.
Folha-34
O script de publicao de DLL executar os seguintes passos em cada um dos

servidores de destino:
Pra a aplicao no IIS.
Verifica cada um dos diretrios dentro do diretrio complus e compara
com os contineres de aplicao do ComPlus.
Se no for encontrada uma aplicao no ComPlus com mesmo nome do
diretrio, criada uma nova Application no ComPlus. A aplicao no
ComPlus criada com permisses padro, ou seja, as DLLs sero
instanciadas com a permisso do usurio que executa a aplicao,
geralmente o usurio padro do IIS. Caso haja a necessidade de
permisses especficas para a execuo das DLLs, necessrio realizar
uma solicitao para a equipe de suporte da SUPCD.
Caso j exista uma aplicao no ComPlus com o mesmo nome do diretrio
e existirem DLLs nesse diretrio, ento executado um shutdown na
respectiva aplicao do ComPlus.
Verifica cada um dos arquivos de DLL presentes no diretrio da aplicao
criada/parada do ComPlus no passo anterior.
Caso algum arquivo tenha sido alterado, ou seja, se o tamanho ou a data
de modificao do arquivo for alterado, realizado um shutdown na
Aplicao do ComPlus, o componente antigo desregistrado o arquivo
antigo de DLL substitudo pelo novo e o componente novo registrado.
Em caso de arquivos de DLL novos, o arquivo copiado para o servidor e o
componente registrado no ComPlus.
Ao final da verificao dos arquivos em cada diretrio, a aplicao no
ComPlus reiniciada.
Em seguida o script verifica a existncia de arquivos de DLL novos ou
modificados no diretrio regasm. Para executar o comando de registro e
desregistro de DLL via regasm, verificada qual a verso do .NET
utilizada pela aplicao web.
de modificao do arquivo for alterado, o componente antigo
desregistrado o arquivo antigo de DLL substitudo pelo novo e o
componente novo registrado.
componente registrado via regasm.
Em seguida verificada a modificao ou a criao de arquivos de DLL no
diretrio regsvr. Para executar o comando de registro e desregistro de
DLL via regsvr32, verificada a plataforma do servidor de aplicao. Caso
o servidor seja 32-bits utilizado o comando regsvr32.exe padro. Caso o
servidor da aplicao seja 64-bits utilizado o comando regsvr32.exe
presente no diretrio SysWow64, ou seja, em modo 32-bits.
de modificao do arquivo for alterado, o componente antigo
desregistrado o arquivo antigo de DLL substitudo pelo novo e o
componente novo registrado.
Folha-35

componente registrado via regsvr32.
Ao final do processo de publicao de DLL, a aplicao reiniciada no IIS.
8. Na notificao do resultado da publicao ser anexado um arquivo adicional
contendo a log de publicao da DLL. O nome desse arquivo ter o mesmo
formato da log de publicao da aplicao (conforme descrito na seo 2.5) com a
diferena de conter o prefixo DLL_ (Ex.
DLL_BSA_AP_00000_HOM_FCT_18062013112233.zip)
9. Esse mesmo arquivo ZIP tambm ser disponibilizado no servidor de FTP, na
pasta logs da aplicao.
Folha-36
3. Processo de Execuo de Scripts em

Banco de Dados
O processo para a execuo de scripts de banco de dados de uma aplicao consiste na
execuo das seguintes atividades:
Acessar o FTP do Portal de Publicao
Transferir os scripts a serem executados para o FTP
Acessar a interface web do portal de Publicao
Executar o fluxo de publicao Executa Scripts BD
Verificar o resultado da publicao
3.1. Acesso ao FTP de publicao

Siga os mesmos procedimentos descritos no item 2.1.
3.2. Transferncia de arquivos para o FTP

Siga os mesmos procedimentos descritos no item 2.2, observando apenas que a pasta
para depositar os scripts de banco de dados a denominada demandas, que encontra-
se dentro da pasta com o nome do banco de dados, no subdiretrio bd da aplicao,
conforme descrito no item 1.3.1.2.
Folha-37
3.3. Acesso interface web do Portal de

Publicao
Siga os mesmos procedimentos descritos no item 2.3.
3.4. Execuo do fluxo Executa Scripts BD

Aps o login na ferramenta HP Operations Orchestration, ser apresentada a tela inicial.
Navegar na rvore de fluxos, em Library > SERPRO > Executa Scripts BD > Executa
Scripts BD
Ser aberta uma nova tela com o fluxo Executa Scripts BD. Dever ser escolhida a opo
Run All para o incio da execuo do fluxo.
Folha-38
Sero exibidas vrias janelas solicitando informaes sobre as opes de execuo dos
scripts em banco de dados.
A partir dessas informaes definido o fluxo com que a execuo ir seguir. Uma das
opes apresentadas a de execuo imediata ou agendada. Dependendo da escolha
efetuada, o fluxo ir seguir dois caminhos distintos, conforme descritos nas sees a
seguir.
3.4.1. Execuo Imediata
Selecione a opo de execuo da publicao desejada Imediata.
Folha-39

Na prxima tela o fluxo ir solicitar a aplicao (ADCAT) que est associada ao banco de
dados para o qual se deseja a execuo dos scripts
Folha-40
Ser exibida uma tela informando um resumo da execuo dos scripts, contendo detalhes
sobre o banco de dados a ser utilizado e a lista dos scripts que sero executados. A
ordem de execuo determinada pelo nome dos scripts, sendo que a classificao
feita por ordem alfabtica crescente.
Uma das informaes apresentadas o ID da execuo. Esse ID ser utilizado
posteriormente para obter os resultados e a log de execuo dos scripts de banco de
dados.
Confira as informaes exibidas e confirme a execuo escolhendo Sim para a pergunta
exibida. Aps a seleo clique no boto Continue.
A partir desse momento os scripts sero executados no banco de dados e ao final desse
processo ser exibida uma tela informando o sucesso da operao.
Folha-41
Clique no boto Continue para finalizar o fluxo. Aps isso j pode ser efetuado a
desconexo da ferramenta OO atravs da opo Logout.
Durante a execuo dos scripts fluxo enviar um e-mail para os destinatrios escolhidos
no incio da execuo do fluxo, com o resultado da execuo dos scripts no banco de
dados.
O resultado da execuo dos scripts ser enviada para o servidor de FTP, na pasta
resultados do banco de dados da aplicao.
Um arquivo contendo a Log do processo de execuo, para fins de depurao, ser
colocado no servidor de FTP, na pasta logs da aplicao, conforme descrito na seo
1.3.1.2.
Folha-42
Possveis mensagens de erro ou de aviso durante o processo de execuo de scripts so

descritas no Apndice deste documento, na seo 4.3.3.
3.4.2. Agendada
Outra opo de agendamento a opo Agendado.

Na prxima tela o fluxo ir solicitar a aplicao (ADCAT) que est associada ao banco de
dados para o qual se deseja a execuo dos scripts
Folha-43
Ser exibida uma tela informando um resumo da execuo dos scripts, contendo detalhes
sobre o banco de dados a ser utilizado e a lista dos scripts que sero executados. A
ordem de execuo determinada pelo nome dos scripts, sendo que a classificao
feita por ordem alfabtica crescente.
Confira as informaes exibidas e confirme a execuo escolhendo Sim para a pergunta
exibida. Aps a seleo clique no boto Continue.
Folha-44
Em seguida sero solicitadas as informaes para agendamento da execuo dos scripts.

Introduza a data e hora para o incio da execuo dos scripts. Por motivos de segurana,
o agendamento precisa ser a partir de pelo menos 30 minutos da data e hora atuais.
Folha-45
Ser exbida uma tela com a data agendada, solicitando a confirmao da informao de
agendamento.
Ao final ser exibida uma mensagem contendo as informaes da execuo dos scripts e
solictando a confirmao do agendamento.
Uma das informaes apresentadas o ID da execuo. Esse ID ser utilizado
posteriormente para obter os resultados e a log de execuo dos scripts de banco de
dados.
Folha-46
Clique no boto Continue para finalizar o fluxo. Aps isso j pode ser efetuado a
desconexo da ferramenta OO atravs da opo Logout.
O HP OO internamente ir criar o agendamento e acionar a execuo dos scripts na data

e horrio agendados.
Finalizada a execuo dos scripts no banco de dados, o fluxo enviar um e-mail para os
destinatrios escolhidos no incio da execuo do fluxo, com o resultado da execuo dos
scripts no banco de dados.
O resultado da execuo dos scripts ser enviada para o servidor de FTP, na pasta
resultados do banco de dados da aplicao.
Um arquivo contendo a Log do processo de execuo, para fins de depurao, ser
colocado no servidor de FTP, na pasta logs da aplicao, conforme descrito na seo
1.3.1.2.
Folha-47
Possveis mensagens de erro ou de aviso durante o processo de execuo de scripts so

descritas no Apndice deste documento, na seo 4.3.3.
3.5. Resultados da Publicao
Aps o trmino da execuo dos scripts de banco de dados ser depositado um arquivo
compactado no servidor de FTP na pasta da aplicao, subdiretrio bd, subdiretrio com
Nome do Banco de destino, subdiretrio Resultados, conforme descrito na seo 1.3.1.2.
Para identificar o arquivo compactado correspondente execuo do fluxo, o nome do
arquivo ir conter o ID da execuo obtido no passo anterior.
Esse arquivo conter arquivos que representam o resultado da execuo dos scripts. A
quantidade de arquivos contidos nesse arquivo compactado, sua denominao e a
descrio de cada um depende da tecnologia de SGBD utilizada e das especificaes
definidas por cada equipe de suporte a banco de dados do Centro de Dados.
Folha-48
4. Apndice
4.1. Procedimentos para a implantao da
automao do deploy de aplicaes no
SERPRO
O Portal de Publicao oferece suporte a uma srie de plataforma e tecnologias mas,
considerando o dinamismo das tecnologias dos sistemas de informao necessrio
verificar se uma determinada aplicao pode ser inserida no processo de automao da
publicao de pginas, publicao de DLL (Windows) ou no processo de automao de
execuo de scripts de banco de dados.
Para o estudo da viabilidade de implantao dessas automaes, o gestor da aplicao
deve primeiramente entrar em contato com o gestor de demandas e nveis de servio
(GDNS) da DIOPE para iniciar o processo de internalizao da demanda, conforme os
trmites processuais definidos pela rea de Gesto de Demandas da DIOPE.
Internamente, o GDNS ir verificar se a tecnologia da aplicao a ser automatizada faz
parte da relao de tecnologias suportadas pelas solues de automao e far o contato
com a respectiva equipe de suporte no Centro de Dados. Essa equipe ir realizar um
estudo de viabilidade tcnica da implementao e ir definir as atividades e prazos para
essa transio e os informar ao gestor da aplicao.
Para a automao da publicao de cdigo-fonte da aplicao (pginas web,
bibliotecas, aplicaes empacotadas etc) a equipe de suporte no Centro de Dados
a de sistema operacional utilizada pela aplicao da regional onde est ou ser
hospedada a aplicao.
Para a automao da publicao de DLL (Windows) a equipe de suporte no Centro
de Dados a de sistema operacional Windows da regional onde est ou ser
hospedada a aplicao.
Para a automao da execuo de scripts de banco de dados a equipe de suporte
no Centro de Dados a da tecnologia de banco de dados utilizada pela aplicao
da regional onde est ou ser hospedada a aplicao.
Aps a definio da infraestrutura necessria para a criao do ambiente e a realizao

dos trmites processuais definidos na Norma de Recebimento e Gesto de Demandas de
Novos Servios na SUPCD,
Aps esse estudo, o GDNS ir informar ao gestor sobre a viabilidade da implantao da
automao e detalhes sobre as atividades e prazos. Com base nessas informaes o
gestor da aplicao ir criar uma Requisio de Mudanas para o processo de
implantao da automao, contendo detalhes sobre a aplicao (nome, cdigo de
servio, ambiente, plataforma, local onde est ou ser hospedada etc), qual tecnologia
utilizada, a automao a ser implantada, a equipe de suporte de Centro de Dados que
realizar a mudana e a expectativa de prazo baseada na negociao com o GDNS.
A definio sobre os usurios publicadores que podem realizar alteraes na aplicao
utilizando o Portal de Publicao baseada no documento utilizado durante o
planejamento da implantao da aplicao denominado Configurao de Hardware e
Software (CHS). O Gestor da aplicao ir demandar ao Setor de Demandas da
Folha-49
Superintendncia de Desenvolvimento (DEGAS) a criao de grupo no LDAP corporativo

contendo os usurios publicadores.
A SUPDE/DEGAS faz uso da informao do CHS para o primeiro passo para a criao do
ambiente de publicao, que a gerao de uma demanda (Requisio de Servio)
direcionada para a equipe de administrao dos servios de diretrio corporativo do
SERPRO (SERPRO-RLSL). Essa demanda deve ser feita conforme definido no Modelo
de Criao de Grupo de Publicadores no LDAP. Concomitantemente, a URC ir gerar a
requisio de mudana para a criao do ambiente nos servidores do centro de dados
conforme definido na norma supracitada.
A segunda etapa cabe equipe de suporte de Centro de Dados, que ir provisionar os
recursos necessrios de infraestrutura de servidores e software bsico para a aplicao e
para o ambiente de publicao. Nessa etapa sero criadas as estruturas de pastas do
servidor de FTP seguro que iro armazenar o cdigo da aplicao. Tambm nessa etapa
ser criada a estrutura para a replicao do cdigo da aplicao nos servidores que iro
hospedar a aplicao.
Uma vez criada a infraestrutura da publicao, a equipe de suporte do centro de dados
envia uma notificao da liberao do ambiente para todos os publicadores e interage
com a equipe de desenvolvimento para testar o funcionamento da publicao.
4.2. Sobre a abertura de mudanas para o

deploy/publicao
Para alguns sistemas, em especial aqueles de misso crtica, as publicaes no
podero ser feitas em qualquer horrio. Os horrios devero ser previamente
programados, dentro da janela de manuteno do sistema, por exemplo, para a realizao
destas publicaes que podero impactar na disponibilidade e desempenho da aplicao.
Neste caso, sugerimos que no seja preciso a abertura de uma mudana.
Haver situaes em que a publicao corrigir algum incidente e nestes casos
no podero aguardar a janela de manuteno. Nesta situao, ser necessria uma
mudana para negociar junto URC esta nova publicao. Portanto, a mudana ter de
ser aberta ANTES de a publicao ser realizada.
Sistemtica que dever ser definida: se a SUPDE que vai tratar a mudana,
apenas comunicando a SUPCD para configurao de Black-out nas ferramentas de
monitorao, a fim de evitar registro indevido de incidentes durante a sua publicao, j
que a parada/indisponibilidade/queda na performance j est programada e aprovada
junto ao cliente, etc.
4.3. Tratamento de Erros

Durante o processo de publicao da aplicao e de execuo de scripts podem surgir
mensagens de aviso ou de erro que identificam desvios no curso normal dessas
automaes. Descrevemos abaixo as mensagens de erro ou aviso mais comuns que
podem surgir, qual a possvel causa da mensagem e quais aes podero ser tomadas
para tratar esses desvios.
Folha-50
4.3.1. Erros no acesso e transferncia de arquivos ao

FTP do Portal de Publicao
Mensagem de Erro Diagnstico Tratamento
No foi possvel conectar ao Falha na conectividade com Revise as configuraes de
servidor o servidor de FTP conexo com o FTP
conforme descritos no item
2.1.1.
Erro crtico na transferncia Problemas para gravar Verifique se possui
de arquivo arquivos de/para o servidor permisso para gravar na
de FTP pasta de destino
selecionada, conforme item
1.3.1.2
timeout/failed to retrieve O tempo mximo para listar Verifique a configurao de
directory listing o diretrio foi excedido. timeout da conexo com o
Pode ser causado por servidor de FTP, conforme
alguma latncia na rede. item 2.1.1
Invalid command O commando executado Verifique as especificaes
pelo cliente FTP no de cliente FTP, conforme
suportado. item 2.1.1
4.3.2. Erros na execuo do fluxoPortal Simples

No foi possvel conectar ao Falha na conectividade com Revise as configuraes de
servidor / Tempo limite o servidor do HP Operations conexo com o HP OO,
atingido / No possvel Orchestration conforme item 2.3
exibir esta pgina / Pgina
no encontrada
Service Unavailable / Falha no servidor web do Verificar com a equipe de
Internal Server Error HP OO suporte sobre a disponibili-
dade do servidor do HP OO
A Aplicao XXXX No A configurao da estrutura Contate a equipe de suporte
possui servidores da publicao no est em de sistema operacional no
associados. Por favor conformidade. Centro de Dados respons-
contate o suporte. vel pela aplicao.
Todos os Sites encontram- O servidor de FTP do site Verifique com a equipe de
se indisponveis no FTP de est desabilitado. suporte ao SIGPB sobre a
XXX Por favor contate um disponibilidade do servidor
administrador. de FTP.
Erro na conexo com o Erro na comunicao com o Verifique com a equipe
servio de LDAP. Por favor servidor de LDAP responsvel pelo LDAP
tente mais tarde. corporativo. sobre problemas de
conectividade.
No foi encontrada Acesso ao site (regional) Verifique o endereo para
nenhuma aplicao para errado; ou acesso ao HPOO da
Folha-51
seu perfil em XXX regional onde est

hospedada a aplicao.(2.3)
Verifique se seu usurio faz
Falta de permisses.
parte do grupo de
publicadores da aplicao
Erro ao buscar as Falha na comunicao com Verifique com a equipe de
aplicaes no servidor de o servidor de FTP. suporte ao SIGPB sobre a
FTP. disponibilidade do servidor
de FTP.
O contrato no CPS no est O contrato no CPS no est Solicite ao gestor da
validado. validado. aplicao verificar a
situao do contrato CPS
da aplicao.
O contrato no CPS est O contrato no CPS est Solicite ao gestor da
desativado ou no foi desativado ou no foi aplicao verificar a
encontrado. encontrado. situao do contrato CPS
da aplicao.
Falha na consulta ao LDAP! Erro na comunicao com o Verifique com a equipe
servidor de LDAP responsvel pelo LDAP
corporativo. sobre problemas de
conectividade.
Devido a manuteno no Falha no envio de e-mails O e-mail no ser enviado,
servidor de envio de e- por problemas com o portanto o resultado da
mails, o resultado da servidor de SMTP publicao somente poder
publicao estar disponvel corporativo. ser obtido atravs das logs
somente na pasta logs do disponveis no FTP,
FTP da aplicao. conforme item 2.5
4.3.3. Erros na execuo do fluxo Executa Scripts BD

Todos os Sites encontram- O servidor de FTP do site Verifique com a equipe de
se indisponveis no FTP de est desabilitado. suporte ao SIGPB sobre a
XXX Por favor contate um disponibilidade do servidor
administrador. de FTP.
No foi encontrada Acesso ao site (regional) Verifique o endereo para
nenhuma aplicao para errado; ou acesso ao HPOO da
seu perfil em XXX regional onde est
hospedada a aplicao.(2.3)
Verifique se seu usurio faz
Falta de permisses. parte do grupo de
publicadores da aplicao
Erro ao buscar as Falha na comunicao com Verifique com a equipe de
aplicaes no servidor de o servidor de FTP. suporte ao SIGPB sobre a
FTP. disponibilidade do servidor
de FTP.
A aplicao XXX no possui Problemas na configurao Contate a equipe de suporte
Folha-52
SGBD associado. Por favor da infraestrutura para a a banco de dados do Centro

contate o suporte. automao dos scripts de Dados para sanar o erro.
A aplicao XXX no possui Problemas na configurao Contate a equipe de suporte
uma lista de servidores de da infraestrutura para a a banco de dados do Centro
Banco de Dados. Por favor automao dos scripts de Dados para sanar o erro.
contate o suporte.
No foi encontrado nenhum O fluxo verificou a Verifique se os scripts foram
script no pasta "demandas" existncia de arquivos na depositados na pasta do
da aplicao no servidor de pasta demandas do banco FTP da aplicao correta. O
FTP. de dados selecionado da nome da aplicao e do
Favor verifique e reinicie aplicao escolhida, mas banco de dados escolhido
novamente este fluxo. no encontrou nenhum fazem parte do caminho no
script. FTP. Ex: /basic/ BSA/
<nome_da_aplicao>/ db/
<nome_do_bd/ demandas
A execuo de scripts de A automao funcionou O erro pode ter sido
banco de dados da mas alguma etapa do ocasionado por algum erro
aplicao XXXXX foi processo de execuo dos nos scripts ou por falta de
executada com Erros. scripts falhou. permisses para executar o
Verifque a log de execuo script.
disponvel no FTP para
maiores detalhes.
4.3.4. Erros na log de execuo da Publicao

As mensagens de erro encontradas nos arquivos de log das diferentes automaes
realizadas pelo Portal de Publicao so geradas para auxiliar na deteco de problemas
na infraestrutura da automao e para permitir a rastreabilidade no processo de
alteraes em uma aplicao.
No caso da publicao de cdigo-fonte, a log representa a sada do comando RSYNC que
utlizado para realizar a transferncia dos arquivos do servidor de FTP para os servidores
de destino.
Para a publicao de DLL, a log a sada de um script criado especificamente para o
registro de DLL em cada servidor.
E para a execuo de scripts de banco de dados, a log tambm representa um script
criado especificamente para esse fim, com a diferena que, como cada tecnologia de
SGBD possui um script especfico para realizar a interao com o banco de dados, o
arquivo de log da pasta logs para banco de dados limita-se ao processo de transferncia
dos scripts e ao comando de executar esses scripts personalizados para cada SGBD.
Outros resultados e logs podem ser encontrados na pasta resultados do banco de dados
da aplicao no servidor de FTP.
As equipes de suporte de Centro de Dados de cada tecnologia tambm podem auxiliar na
depurao desses erros.
Folha-53
4.4. Sobre a abertura de incidentes quando a

publicao impactar na disponibilidade e
performance do ambiente/servio de cliente.
Dever ser discutida a criao de uma sistemtica sobre a abertura de incidentes
para a SUPDE analisar e tratar estes impactos oriundos da publicao realizada por eles.
Estes incidentes devero ser de alta severidade e endereados ao grupo GSDEBR que
dar o devido tratamento/encaminhamento interno.
A SUPCD ficar isenta de qualquer ao, quando se tratar de um incidente
causado por estas publicaes automticas, exceto quando se for necessrio realizar
restore da verso anterior.
No caso de desvio na publicao, o desenvolvimento poder refazer a publicao
utilizando os arquivos corretos e corrigindo o desvio.
Folha-54
Folha-55

Portal de Publicacao-Manual de Utilizacao

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Portal de Publicacao-Manual de Utilizacao

Загружено:

Авторское право:

Доступные форматы

PORTAL DE PUBLICAO

Manual de Utilizao (v. 3.1)

Autonomia - Execuo de publicaes imediatas ou agendadas controladas

Versatilidade - Execuo de scripts administrativos criados pela equipe de suporte

Rastreabilidade - Envio de recibo via e-mail e disponibilizao de logs no FTP,

atualizados, permitindo maior controle e registro histrico das alteraes nas

1.3. Arquitetura da Soluo

1.3.1. FTP do Portal de Publicao

1.3.1.1. Principais Caractersticas:

O FTP do Portal de Publicao do SIGPB foi desenvolvido com o objetivo de facilitar o

Cada aplicativo bsico consiste em 4 pastas no servidor FTP:

o demandas: onde so depositados os scripts para bancos de dados

o resultados: onde so obtidos os resultados dos scripts executados

dll: a existncia dessa pasta opcional. Algumas aplicaes Windows que

o regsvr: deve conter os arquivos DLL que sero registrados nos

o regasm: deve conter os arquivos DLL do tipo biblioteca Assembly

o complus: deve conter pastas contendo os arquivos DLL do tipo

OBS: Maiores informaes sobre essa funcionalidade esto

logs: onde so obtidos os registros de sada dos roteiros dos processos de

o <nome da aplicao>_ddmmaaaahhmmss.zip (para aplicao)

o DLL_<nome da aplicao>_ddmmaaaahhmmss.zip (para DLLs)

o bdlog_<nome da aplicao>_ddmmaaaahhmmss.zip (para scripts

<nome da aplicao> o nome que identifica a aplicao no

ddmmaaaahhmmss um identificador do processo de

Dentro de cada um desses arquivos compactados estaro os

aplicao e DLLs o arquivo compactado conter um arquivo de

Observao: As pastas das aplicaes, as permisses, os pr-scripts e ps-scripts, a

1.3.2. Portal Simples Interface do Usurio

1.3.2.1. Principais Caractersticas:

Os fluxos de publicao e execuo de scripts foram desenvolvidos com o objetivo de

1.3.2.2. Fluxo Portal Simples para publicao de aplicaes

I - Tela do Fluxo Portal Simples

1.3.2.3. Fluxo Executa Scripts BD para automao da

II - Fluxo Executa Scripts BD

2. Processo de Publicao de uma Aplicao

2.1. Acesso ao FTP de publicao

2.1.1. Configurao do acesso ao FTP

Conforme definida na topologia do Portal de Publicao, existe um servidor de FTP em

O FTP ir solicitar as informaes do usurio e a senha de acesso:

Clique em OK para criar a conexo.

2.1.2. Cuidados com a publicao de artefatos

Quando uma aplicao desenvolvida para ser hospedada em servidores Windows,

2.1.2.1. Arquivos Homnimos

sero listados os dois arquivos no FTP, podendo possuir data de modificao e

Para evitar essa situao, sugere-se que os desenvolvedores de aplicaes de plataforma

Em caso de identificao de arquivos homnimos, a soluo mais rpida a excluso de

2.1.2.2. Codificao de caracteres

O cliente de FTP FileZilla permite a autodeteco da codificao de caracteres nas

2.2. Transferncia de arquivos para o FTP

importante destacar que somente os arquivos modificados, sejam pela data de

Depois de realizadas as transferncias necessrias ao servidor de FTP, o desenvolvedor

2.3. Acesso interface web do Portal de

A ferramenta ir solicitar as informaes do usurio e a senha de acesso:

2.4. Execuo do fluxo Portal Simples

All para o incio da execuo do fluxo.

Selecione a opo de execuo da publicao desejada (Imediata ou Agendada)

A opo de selecionar o Site ser utilizada somente em casos excepcionais de

Clique no boto Continue

Na prxima tela o fluxo ir solicitar a aplicao (ADCAT) desejada para a execuo do

PASSO OPCIONAL: Caso aplicao selecionada seja

Ao final da opes escolhidas ser exibida uma mensagem informativa:

Depois de validar o recebimento do e-mail de incio da publicao, dever ser selecionada

Depois de fechado o fluxo, o HP OO internamente estar executando o deploy da