Manual de Atualizao
(C) Senior Sistemas Corporativos Ltda. Reviso 2 Maro 2009 Responsveis: Andr D. Nascimento Douglas F. Klaumann
INSTALAO SAPIENS
NDICE ANALTICO
1 2 3 INTRODUO ................................................................................................................................................. 3 GERAIS ............................................................................................................................................................. 4 ATUALIZANDO O SAPIENS .......................................................................................................................... 5 3.1 INICIANDO A ATUALIZAO DO AMBIENTE SERVIDOR/MONOUSURIO ................................................................... 5 3.1.1 ATUALIZAO DE 2 E/OU 3 NVEIS..................................................................................................11 3.1.2 ATUALIZAO DE 4 NVEL.................................................................................................................15 3.1.3 ATUALIZAO DE LETRAS..................................................................................................................17 3.2 ATUALIZAO EM AMBIENTE ESTAO................................................................................................20 4 CRIANDO AS CHAVES DO SAPIENS NO REGEDIT .................................................................................22
INSTALAO SAPIENS
1 INTRODUO
Este manual tem por objetivo auxiliar o usurio na atualizao do Sistema Sapiens nos ambientes: Servidor/Monousurio e Estao, descrevendo um passo-a-passo completo de todas as opes disponibilizadas pelo Instalador/Atualizador. Antes de iniciar a atualizao do Sapiens, necessrio efetuar os seguintes procedimentos de segurana: baixar arquivos os arquivos referente de a atualizao verso da que rea de FTP, no atualizar. caminho: Ex.:
Sugerimos tambm que seja verificado o espao em disco no Servidor de Aplicao, assim como o espao nas Tablespaces ou Databases do Banco de Dados. Aps essas verificaes, pode ser dado inicio a atualizao do Sistema.
INSTALAO SAPIENS
2 GERAIS
obrigatrio que a verso da Base de Dados esteja igual a verso do TBS. Caso contrrio, no ser possvel acessar o sistema, assim como no ser possvel proceder com a atualizao. Para identificar a verso do TBS, preciso acessar o CBDS, conectar na Base de Dados e ir ao menu Ajuda/Sobre a Base. Para conferir a verso na Base de Dados, (ainda conectado ao CBDS) preciso ir ao menu Ferramentas/Editor SQL, na rea de texto inferior, digitar o comando SELECT VERCON, VERINO, VERBAS, VERBUI FROM R999VER. O resultado apresentado ser a verso na Base de Dados. Antes de iniciar a atualizao do Sapiens, preciso verificar se h usurios conectados ao sistema. Para garantir a integridade das informaes da base de dados e evitar problemas na atualizao, nenhum usurio poder estar conectado no momento da atualizao. A vizualizao dos usurios conectados pode ser feita atravs do SGU, acessando o mesmo atravs de um atalho, acrescido do parmetro -v. Os caminhos do Sapiens no registry do Servidor so criados no momento da instalao, e eles apontam para o diretrio onde esto salvos os arquivos utilizados pelo Sistema (Ex.: executveis, bpls, modelos de relatrios, layouts de importao/exportao, etc...). A atualizao do Sapiens feita respeitando esses caminhos definidos no registry da mquina. Como o processo de atualizao pode ser feito a partir que qualquer mquina (seja servidor ou estao), preciso que seja configurado os caminhos no registry da mquina onde ser disparado o processo de atualizao. Detalhes sobre esse processo pode ser verificado no item 4 CRIANDO AS CHAVES DO SAPIENS NO REGEDIT. As verses do Sapiens so subdivididas em 4 nveis, e so denominadas da seguinte forma:
1 Nvel: Verso de gerao. 2 Nvel: Verso Inovao da Rotina. 3 Nvel: Verso Inovao do Software. 4 Nvel: Verso Construo.
INSTALAO SAPIENS
3 ATUALIZANDO O SAPIENS
A Atualizao do Sapiens dividida em dois momentos: a atualizao do Ambiente Servidor/Monousurio e a atualizao do Ambiente Estao. A atualizao do ambiente Servidor/Monousurio feito a partir do aplicativo Atualiza.exe que encontra-se na pasta <driver>:\Senior do servidor de Aplicao. Essa forma de atualizao pode ser feita a partir da mquina servidor/monousurio ou a partir de uma estao, mas obrigatriamente deve ser feito a partir de uma mquina com Sistema Operacional da famlia Windows. A atualizao do ambiente Estao feita no primeiro acesso da estao ao sistema aps a atualizao do ambiente Servidor. Atualizaes de 4 nvel podem ocorrer de duas maneiras: com alterao de TBS e sem alterao de TBS. Alteraes de TBS costumam ocorrer quando h mudanas na numerao no 4 nvel, e alteraes de letras quando o 4 nvel no sofre alterao. Mas isso no uma regra, pode ocorrer da numerao do 4 nvel ser alterada, mas a verso do TBS permanecer a mesma. Atualizaes de 3 nvel so chamadas de Converso, e no ocorrem com tanta frequencia como as atualizaes de 4 nvel, mas quando ocorrem obrigatriamente h mudanas na verso do TBS. Atualizaes de 3 nvel acontecem quando h inovaes no sistema, e essas alteraes causam maior impacto entre as verses inferiores e a nova verso. Uma converso requer maior ateno por parte do cliente, e aconselhamos que seja sempre feita primeiramente em um ambiente com base para testes, e que os processos sejam todos validados nesse ambiente. Aps feitas todas as verificaes necessrias, a converso do ambiente oficial estar habilitada. Atualizaes de 2 nvel tambm so denominadas Converso. Ocorrem somente quando h inovaes de tecnologia e tambm obrigatriamente causam mudanas de TBS. Antes de efetuar uma converso desse tipo deve-se tambm efetuar os mesmos procedimentos efetuados em uma converso de 3 nvel.
INSTALAO SAPIENS
Deve-se sempre selecionar a opo CD ou arquivos copiados da Internet. A segunda opo utilizada somente em situaes espacficas. Aps selecionada a opo, ser apresentada uma tela solicitando o caminho onde esto os arquivos de atualizao. Esses arquivos so aqueles baixados da rea de FTP2 conforme descrito no Item 1 desse manual.
Os arquivos de atualizao encontram-se compactados. Durante o processo de atualizao, alguns desses arquivos so descompactados para a pasta temporria do usurio conectado na mquina (C:\DOCUME~1\nome_usurio\CONFIG~1\Temp). Sero descompactados somente os arquivos utilizados naquele momento pelo atualizador.
Logo aps descompactar os arquivos necessrios, o Atualizador copia os arquivos descompactados para as devidas pastas onde so utilizadas as bibliotecas de tecnologia.
INSTALAO SAPIENS
Atualizados os arquivos do Atualizador, apresentado ao usurio um Assistente de Instalao para que seja ento dado inicio a atualizao da base de dados do Sapiens e do executvel.
INSTALAO SAPIENS
Nesse ponto o Atualizador solicita que seja informado qual o nvel de atualizao a ser selecionado. Para atualizaes de 2 e 3 nvel, selecionar sempre a opo Sapiens 5.2.7 -> 5.3.1 (3 Nvel), j para as atualizaes de 4 nvel e atualizaes de letras, selecionar a opo Sapiens 5.3.1 (4 Nvel). No ocorrer erros no processo de atualizao caso seja selecionada uma opo diferente do nvel correto de atualizao.
Selecionado o nvel da atualizao que ser efetuada, o Assitente de Atualizao solicita que seja informado novamente o caminho onde esto salvos os arquivos de atualizao. Esses arquivos so aqueles baixados da rea de FTP2 conforme descrito no Item 1 desse manual.
INSTALAO SAPIENS
Aps selecionar o caminho onde encontram-se os arquivos de atualizao do Sapiens, apresentada ao usurio, uma tela contendo algumas opes adicionais, possibilitando ao usurio efetuar cpias de segurana dos arquivos do ambiente que estar sendo atualizado. Mas esse backup refere-se aos arquivos utilizados pelo Sapiens e no um backup da base de dados. Na primeira opo, o Assistente de Atualizao no efetua nenhum procedimento extra e continua com a atualizao normal, verificando a situao do contrato de manuteno do cliente.
Ao selecionar a segunda opo, o Assistente de Atualizao cria abaixo do diretrio <driver:>\Senior uma pasta chamada Backup. Dentro dessa pasta feita uma cpia dos arquivos que esto dentro pasta Senior, e uma cpia dos arquivos que esto dentro da pasta Sapiens. As sub-pastas que esto dentro da pasta Sapiens no so copiadas, somente os arquivos so salvos. Aps efetuar a cpia, o Assistente de Atualizao prossegue com a atualizao do sistema.
Ao optar pela terceira opo, o Assistente de Atualizao solicita ao usurio para que informe o nome da pasta onde ser duplicada a pasta Sapiens.
INSTALAO SAPIENS
Aps informado o caminho, copiado todo o contedo da pasta Sapiens original para a pasta informada. Aps efetuar a cpia, o Assistente de Atualizao prossegue com a atualizao do sistema.
Aconselhamos que seja feito um backup completo da pasta <driver:>\Senior do servidor de aplicao antes de iniciar o processo de atualizao. Tendo o backup completo da pasta <driver:>\Senior, no h necessidade de efetuar o backup sugerido pelo Assistente de Atualizao (conforme ltimas 3 telas acima). Sendo assim, pode-se optar pela opo Desejo atualizar a verso existente, e prosseguir diretamente com o processo de atualizao. O Assistente de Instalao continua o processo, atualizando os arquivos que fazem a verificao de licena o software e contrato de manuteno do cliente.
Aps verificar as questes contratuais e certificar-se que o cliente est apto a atualizar o sistema, o Assistente de Instalao solicita a informao do arquivo .cfg para verificar se h necessidade de atualizao do TBS, nesse momento efetuada a conexo com o usurio de banco a ser atualizado.
10
INSTALAO SAPIENS
Independente do nvel da verso a ser atualizado, a seqncia de telas apresentada acima ser sempre a mesma. A partir desse ponto, telas diferentes sero exibidas ao usurio, dependendo do nvel que est sendo atualizado.
Na seqncia, o assistente de instalao apresenta uma nova tela (conforme abaixo), solicitando as seguintes informaes: caminho do arquivo CFG; caminho do arquivo conversor; caminho onde ser gerado o log de converso.
O usurio dever informar somente o caminho do arquivo CFG, pois os caminhos do conversor e do log de converso sero preenchidos automaticamente pelo Assistente de Instalao. Nessa tela h tambm uma informao opcional, onde possibilita a gerao de um outro log de converso. Esse log armazena todas as operaes efetuadas pelo conversor e indica quais ocasionaram erros (caso ocorram). O usurio poder selecionar o diretrio onde o arquivo ser salvo e tambm o seu nome.
11
INSTALAO SAPIENS
Com a conexo do banco j efetuada, o Assistente de Atualizao informa que tabelas da base de dados sero convertidas para a nova verso. Solicita a confirmao do usurio para que seja dado inicio ao processo. Caso seja optado por No converter, o processo cancelado e o Asistente de Atualizao abortado.
Antes de iniciar efetivamente a converso da base de dados, o Assitente de Atualizao faz uma consistncia de base para verificar se a estrutura dos objetos no banco esto de acordo com o TBS informado no CFG. Essa consistncia de base tambm deve ser feita manualmente pelo CBDS antes de iniciar todo o processo de converso, afim de identificar possveis divergncias. Isso necessrio pois, caso existam diferenas entre o TBS e a base de dados, mais fcil corrig-las antes de ser dado inicio a converso. A consistncia de base pelo CBDS um dos processos de segurana descrito no item 1 INTRODUO desse manual, pgina 3. O Assistente de Atualizao apresenta uma tela ao usurio informando que uma consistncia de base ser executada. Nessa tela existem duas opes em check-box, que devem sempre ser setadas: (i) uma delas informa que os objetos no presentes no TBS sero excluidos, (ii) a outra indica que os comandos efetuados sero apresentados em tela. Caso no tenha nenhuma alterao a ser efetuada, nenhum comando ser apresentado.
12
INSTALAO SAPIENS
Nessa mesma tela tambm informado o caminho onde ser descompactado o TBS que ser utilizado para a consistncia e converso. O caminho j vem preenchido por padro, na pasta temporria do usurio logado na mquina. Esse caminho no precisa ser alterado.
Aps a confirmao da consistncia de base, solicitado ao usurio se deseja fazer um backup da base de dados. Pode ser optado por no fazer o backup, pois o mesmo j dever ter sido efetuado, a partir de uma ferramenta do prprio banco, antes de iniciar o processo de converso.
Caso a consistncia de base seja efetuada com sucesso, apresentada a mensagem abaixo indicando que a base de dados est consistente com o TBS, e que converso foi habilitada. Caso ocorra alguma mensagem de erro ou gerado algum log durante o processo, o(s) mesmo(s) dever(o) ser analisado(s), e dever(o) ser tomada(s) a(s) devida(s) providncia(s) para a correo ou contorno. Caso exista alguma dvida ou dificuldade no procedimento a ser efetuado, deve-se entrar em contato com a equipe de Atendimento, solicitando por suporte em atualizao/converso.
13
INSTALAO SAPIENS
A converso da base de dados inicializada. Nesse processo so comparado os objetos do TBS atual com os objetos do TBS futuro. feito uma espcie de merge entre o TBS futuro e a base de dados, ou seja, os objetos de usurio da base de dados so transferidos para o TBS futuro, e os novos objetos padres do sistema so inseridos na base de dados. Para isso feito um processo de alterao de tabelas.
Caso a converso da base seja efetuada com sucesso, apresentada a mensagem abaixo. Caso ocorra alguma mensagem de erro ou gerado algum log durante o processo, o(s) mesmo(s) dever(o) ser analisado(s), e dever(o) ser tomada(s) a(s) devida(s) providncia(s) para a correo ou contorno. Caso exista alguma dvida ou dificuldade no procedimento a ser efetuado, deve-se entrar em contato com a equipe de Atendimento, solicitando por suporte em atualizao/converso.
14
INSTALAO SAPIENS
Quando o assistente de instalao identifica a necessidade de uma atualizao de 4 nvel, ele apresenta uma tela ao usurio solicitando a confirmao do arquivo CFG a ser utilizado na atualizao. Nesse momento efetuada a conexo com o banco de dados. Nessa tela h tambm uma informao opcional, onde possibilita a gerao de um outro log de atualizao. Esse log armazena todas as operaes efetuadas pelo atualizador e indica quais ocasionaram erros (caso ocorram). O usurio poder selecionar o diretrio onde o arquivo ser salvo e tambm o seu nome.
A consistncia da base de dados inicializada. Nesse processo so comparados os objetos do TBS atual com os objetos do TBS futuro. feito uma espcie de merge entre o TBS futuro e a base de dados, ou seja, os objetos de usurio da base de dados so transferidos para o TBS futuro, e os novos objetos padres do sistema so inseridos na base de dados. Para isso feito um processo de alterao de tabelas. O Assistente de Atualizao apresenta uma tela ao usurio informando que uma consistncia de base ser executada. Nessa tela existem duas opes em check-box, que devem sempre ser setadas: (i) uma delas informa que os objetos no presentes no TBS sero excluidos, (ii) a outra indica que os comandos efetuados sero apresentados em tela. Caso no tenha nenhuma alterao a ser efetuada, nenhum comando ser apresentado.
15
INSTALAO SAPIENS
Nessa mesma tela tambm informado o caminho onde ser descompactado o TBS que ser utilizado para a consistncia e atualizao. O caminho j vem preenchido por padro, na pasta temporria do usurio logado na mquina. Esse caminho no precisa ser alterado.
Aps a confirmao da consistncia de base, solicitado ao usurio se deseja fazer um backup da base de dados. Pode ser optado por no fazer o backup, pois o mesmo j dever ter sido efetuado, a partir de uma ferramenta do prprio banco, antes de iniciar o processo de atualizao.
Em atualizaes de 4 nvel sempre havero alteraes a serem feitas na base de dados, por isso ser apresentada uma tela listando as operaes a serem efetuadas. Todos os comandos devero estar setados, e o processo confirmado para que as alteraes tenham efeito na base de dados.
16
INSTALAO SAPIENS
apresentada uma tela informando do inicio das alteraes na base de dados e solicitado a confirmao do usurio.
Caso todas as alteraes na base de dados sejam executadas com sucesso, apresentada ao usurio uma mensagem informado que a atualizao foi efetuada com sucesso.
Nas sees anteriores foram demonstradas as seqncias de telas apresentadas em atualizaes de 2, 3 e 4 nveis. Esses tipos de atualizao apresentam telas diferentes aos usurios, pois tambm efetuam processos diferentes, mas h processos que so comuns entre todos os nveis de atualizao. Um desses processos ocorre ao inicializar a atualizao/converso, e j foi demonstrado no Item 3.1 desse manual. Outro processo que tambm comum em qualquer atualizao, a execuo do AutoCorrect e atualizao do executvel do Sapiens, bibliotecas de arquivo (.bpl), modelos de relatrios e ferramentas de apoio. Esse ltimo processo alm de ser executado em todas as atualizaes, tambm o processo completo da atualizao de letras. Em outras palavras, em uma atualizao onde no h alteraes de TBS, o Assistente de Atualizao executar a seqncia de telas que segue abaixo. (C) Senior Sistemas Corporativos Ltda.
17
INSTALAO SAPIENS
Executando o AutoCorrect. Nesse processo o Assistnte de Atualizao dispara a execuo de uma rotina que inicializa, corrige ou transfere informaes na base de dados. Em resumo, ela alimenta campos com valores padres, no permitindo que os mesmos fiquem com valores incorretos ou nulos.
Execuo do autocorrect.
Copiando os arquivos da pasta temporria do usurio para a pasta onde est instalado o Sapiens. O caminho para onde os arquivos so salvos buscado do regedit da mquina, e esse caminho criado no momento da instalao do Sapiens. Por isso interessante que a instalao seja feita por padro no diretrio Senior (ex: <driver>:\Senior).
18
INSTALAO SAPIENS
Aps copiar todos os arquivos atualizados para a pasta onde o Sapiens est instalado, o Assistnte de Instalao cria os atalhos para acesso aos aplicativos.
Criando atalhos.
O ltimo processo executado pelo Assitnte de Atualizao efetuar a atualizao dos modelos de relatrios.
Aps a atualizao dos modelos de relatrios o Assistnte de Atualizao finaliza o processo de atualizao exibindo as mensagens abaixo.
19
INSTALAO SAPIENS
As estaes Sapiens so atualizadas automaticamente no primeiro acesso ao Sapiens aps a atualizao do servidor. Como a base de dados j estar atualizada, esse processo somente copiar, do servidor para a estao, todo os arquivos necessrios para a execuo do Sapiens na estao. Para que isso ocorra corretamente e a estao seja atualizada com sucesso, preciso que algumas configuraes estejam previamente definidas. A auto-atualizao da estao feita verificando as parametrizaes definidas no atalho do Sapiens e a data dos arquivos relacionados no arquivo Estacao.ini. No atalho do Sapiens na estao necessrio que o caminho busque o arquivo Iniciar.exe que est no servidor, o arquivo Estacao.ini que est na estao, e o arquivo cfg que tambm est no servidor, sendo que esse ltimo opcional. Ao final, a configurao ser semelhante a essa:
\\servidor\Senior\Iniciar.exe -e:C:\Senior\Sapiens\Estacao.ini Sap52 -p:\\servidor\Senior\Sapiens\Sapiens.cfg
O arquivo Estacao.ini um arquivo texto comum, que possui algumas chaves definindo caminhos e arquivos. A atualizao da estao feita lendo os caminhos definidos em suas chave, e copiando para a estao os arquivos relacionados. Abaixo segue uma tela demonstrando o contedo do arquivo Estacao.ini.
20
INSTALAO SAPIENS
No h um procedimento para a atualizao da estao. Para que isso acontea, necessrio apenas que, na estao, seja inicializado o Sapiens pelo atalho que j estar configurado. A partir das configuraes do arquivo Estacao.ini so copiados os arquivos necessrios para a estao, conforme a tela abaixo:
Atualizando a estao.
Aps copiar todos os arquivos, o Sapiens comea a inicializao, carregando definies e abrindo a conexo com o banco de dados. (C) Senior Sistemas Corporativos Ltda.
21
INSTALAO SAPIENS
Na tela seguinte h duas opes: uma para efetuar a instalao e outra para efetuar a atualizao. Para que todos os caminhos sejam recriados corretamente, deve-se optar por Instalar novos produtos. Esse processo elimina os caminhos existentes e cria novos caminhos. Executando somente a atualizao, os caminhos j existentes so mantidos, somente sendo atualizados.
22
INSTALAO SAPIENS
Instalando a Tecnologia.
Na tela seguinte, possvel selecionar quais registros sero criados. Para que seja mantido compatibilidade com verses anteriores, o Assitnte de Instalao de Tecnologia disponibiliza as opes de criao de registro para todas as verses do Sapiens. Mas no necessrio recriar as chaves de todas as verses. Recomendamos recriar as chaves para as ltimas (4) quatro verses.
23
INSTALAO SAPIENS
Na tela seguinte informado o caminho base para a criao dos registros. O caminho dever apontar para a a pasta Senior onde esto os arquivos referentes ao Sapiens. Caso se deseja criar os registros apontando para o servidor, dever ser feito conforme o exemplo da tela. Caso o usurio queira recriar os caminhos locais, dever informar o caminho do formato <driver>:\Senior (Ex.: C:\Senior).
Aps a finalizao do processo, o Assistnte de Instalao de Tecnologia finaliza o processo apresentando uma mensagem ao usurio.
IMPORTANTE: Caso o aplicativo Tecnologia for necessrio para apontar uma instalao no Servidor, o aplicativo deve ser executado no prprio Servidor, apontando para o diretrio da instalao que se deseja atualizar.
24