Manual de Atualização de Versão

Transcrição

1 Este documento fornece as orientações necessárias para efetuar a atualização da versão da Plataforma Citsmart. Versão /03/2014

2 Visão Resumida Data Criação 05/03/2014 Versão Documento 2.0 Projeto Responsáveis Revisores Citsmart - Plataforma Inteligente de Governança Corporativa Rosana Silva Godinho (Documentadora) Cleison Ferreira (Gerente de Soluções) Aprovador 1 de 13

3 Histórico de Revisão Data Versão Descrição Autor 14/03/ Criação do Documento. Rosana Silva Godinho 12/04/ Atualização do Documento. Rosana Silva Godinho 06/05/ Inserção dos procedimentos de segurança e alteração de Layout do Documento. 09/05/ Atualização das informações de Processo de Atualização de Versão. 05/06/ Atualização das informações de Processo de Atualização de Versão. 12/07/ Atualização da capa e do Layout do Documento. Rosana Silva Godinho Rosana Silva Godinho Rosana Silva Godinho Patricie Medova 16/08/ Atualização da capa do Documento. Rosana Silva Godinho 21/11/ Atualização das informações do Documento. 17/02/ Modificação das informações sobre backup do banco de dados e arquivos do site. 21/02/ Inserção de informações sobre Rollback. 05/03/ Inserção de informações sobre a atualização de versão da aplicação utilizando JBoss AS Rosana Silva Godinho Michel Andrade Rosana Silva Godinho Rosana Silva Godinho 2 de 13

4 Sumário 1. INTRODUÇÃO Propósito PRÉ-REQUISITOS Backup das Visões Backup da Aplicação Backup do Servidor PROCESSO DE ATUALIZAÇÃO DE VERSÃO Validação da Atualização de 13

5 1. INTRODUÇÃO 1.1. Propósito Fornecer orientações para efetuar a atualização da versão da Plataforma Citsmart de forma correta. 2. PRÉ-REQUISITOS Para realizar o processo de atualização do Citsmart deve realizar os procedimentos de segurança que são: Backup das Visões; Backup da Aplicação; Backup do Servidor Backup das Visões Realize o Backup das Visões, através da Plataforma Citsmart, conforme os passos descritos abaixo: 1. No menu principal, posicione o mouse nas opções Sistema, Visões e clique na opção Manutenção de Visões; 4 de 13

6 2. Será exibida tela de Visão; 3. Clique no botão Exportar Visões XML ; 5 de 13

7 4. Será exibida uma janela para seleção das visões a serem exportadas; 5. Selecione todas as visões, marcando a opção Marcar todos e clique no botão Exportar Arquivo(s). 6. Será exibida uma janela para realização da exportação (download) do arquivo de visões; 7. Realize o download do arquivo de visões; 8. O arquivo será salvo no local de download padrão no computador. 6 de 13

8 2.2. Backup da Aplicação Caso utilize o Servidor de Aplicação JBoss GA, realize o backup da aplicação conforme os passos descritos abaixo: 1. Entre na pasta de deploy do JBoss (usr/local/jboss/server/default/deploy); 2. Copie os projetos citsmart_***.war e cithelp_***.war para um local seguro. Caso utilize o Servidor de Aplicação JBoss AS 7.1.1, realize o backup da aplicação conforme os passos descritos abaixo: 1. Entre na pasta deployments do JBoss (usr/local/jboss-as Final/standalone/deployments); 2. Copie os projetos citsmart_***.war e cithelp_***.war para um local seguro Backup do Servidor É recomendado realizar o backup da base de dados do Citsmart e utilizar a prática de snapshot da máquina virtual para acelerar o processo de rollback, pois é uma prática segura e disponível em todas as plataformas de virtualização disponíveis no mercado. Caso tenha alguma dúvida para realizar o backup da base de dados, entre em contato com a equipe de suporte do Citsmart. 7 de 13

9 3. PROCESSO DE ATUALIZAÇÃO DE VERSÃO Para realização da atualização da versão do Software Citsmart, proceder conforme as rotinas descritas abaixo: 1. Realize o download dos arquivos: Software Citsmart, Citsmart help e documentação atualizada, conforme os passos abaixo: a) Acesse o site, realize o login e clique na aba Downloads ; b) Os arquivos estarão disponibilizados no site do Citsmart ( c) Será exibida uma página contendo os links para download dos arquivos necessários para atualização do Software Citsmart que são: Manual de atualização; Documentação da versão; Versão do Citsmart e help atualizado (final_version.zip). d) Efetue o download de todos os arquivos citados acima; e) Será exibida uma janela para realização do download do arquivo. As documentações no formato.pdf e o arquivo de atualização (.zip); f) Realize o download do arquivo; a) O arquivo será salvo no local de download padrão no computador; b) Após conclusão do download, abra a pasta na qual o arquivo está armazenado e descompacte o mesmo. 2. Caso esteja utilizando o servidor de aplicação JBoss GA, proceda da seguinte maneira: 8 de 13

10 a) Pare o JBoss (Esta rotina é necessária devido às várias rotinas feitas no momento em que o JBoss é iniciado); b) Na pasta de deploy do JBoss (/opt/citsmart/jboss GA/server/default/deploy), copie os arquivos citsmart_***.war e help.war para um diretório de backup, caso seja necessário voltar à versão, estes arquivos serão necessários; c) Copie os arquivos (citsmart_***.war e help.war), os quais foram feitos download e descompactados para a pasta de deploy do JBoss (/opt/citsmart/jboss ga/server/default/); d) Delete as pastas tmp/ e work/ do diretório (/usr/local/jboss/server/default); e) Feito isso, inicie o JBoss; 3. Caso esteja utilizando o servidor de aplicação JBoss AS 7.1.1, proceda da seguinte maneira: a) Pare o JBoss (Esta rotina é necessária devido às várias rotinas feitas no momento em que o JBoss é iniciado); b) Na pasta deployments do JBoss (/usr/local/jboss-as Final/standalone/deployments), copie os arquivos citsmart_***.war e help.war para um diretório de backup, caso seja necessário voltar à versão, estes arquivos serão necessários; c) Copie os arquivos (citsmart_***.war e help.war), os quais foram feitos download e descompactados para a pasta deployments do JBoss (/usr/local/jboss-as final/standalone/deployments) d) Delete as pastas tmp/ do diretório (/usr/local/jboss-as Final/standalone/deployments); e) Feito isso, inicie o JBoss; 9 de 13

11 4. Realize a validação da atualização conforme tópico seguinte. ATENÇÃO: Siga corretamente esta validação, pois o sistema ficará bloqueado aos usuários até este passo tenha sido realizado Validação da Atualização É necessário que o Administrador realize a validação da atualização para que o sistema opere de forma correta. 1. Após realizar o Login no sistema, será exibida uma tela para validação da atualização; 2. Clique no botão Validar Atualização para que seja concluída a atualização; 3. Caso ocorra alguma inconsistência durante a execução de scripts automática no sistema, será exibida uma tela, onde serão indicados os scripts com inconsistência, conforme abaixo: 10 de 13

12 4. Para realizar as tratativas dos scripts com inconsistência, selecione a versão desejada no campo Baixe aqui o documento de script da versão para visualizar o script; 5. Após selecionar a versão desejada, será exibida uma janela apresentando os scripts; 11 de 13

13 6. Copie os scripts indicados e rode no banco de dados; 7. Após rodar os scripts no banco de dados, clique no botão Validar Atualização para que a atualização do sistema seja validada. Caso não tenha efetuado a validação da atualização, o sistema ficará bloqueado para os usuários até que o mesmo seja validado; 8. Feito isso, a atualização do sistema será validada com sucesso e poderá ser utilizado normalmente. Se for necessário fazer Rollback, deverá importar as visões. As visões refletem o código da versão atual, ao voltar a uma versão anterior as visões também deverão voltar. 12 de 13