CONFIGURAES

CONFIGURAES->AVANADO->ATUALIZAO DO SISTEMA

O SankhyaW pode ser atualizado atravs do Web Package Manager, verso web do SankhyaW Gerenciador de Pacotes. O Web Package Manager, doravante WPM, disponibiliza uma interface para download e controle de pacotes (.pkgs) arquivos de atualizaes, j baixados, bem como a execuo dos mesmos. No sendo necessrio, e nem devido, parar o JBoss, pois o WPM tambm uma aplicao web que roda no mesmo JBoss do SankhyaW. Todo o processo de atualizao do SankhyaW ser feito pela tela do WPM.

GERENCIADOR E PACOTE DE ATUALIZAO

O WPM no distribudo junto com o SankhyaW, primeiramente deve ser instalado pelo Gerenciador de Pacotes. Para isso, o usurio deve acessar o endereo eletrnico e realizar o download do arquivo sankhyaw-atualizador-web-[verso].pkg.

CONFIGURAES

Esse arquivo corresponde a um pacote de atualizao para o SankhyaW, que deve ser alocado dentro da pasta pkg do Gerenciador de Pacotes do SankhyaW.

CONFIGURAES

Sendo assim, o usurio deve utilizar o Gerenciador de Pacotes para executar este pacote de atualizao, fazendo assim, com que o WPM passe a fazer parte do SankhyaW. No h a necessidade de parar o servidor de aplicao (JBoss). Para realizar a atualizao, abra o Gerenciador de Pacotes. Selecione a opo [1] Instalao/atualizao expressa do Sistema. Em seguida, selecione a opo que corresponde ao pacote sankhyaw-atualizador-web-[verso].pkg.

Por final, informe em qual Servidor de Aplicao que ser executado o pacote de atualizado do WPM. O sistema ir solicitar que o usurio realize as configuraes de conexo com o Banco de Dados. Caso esse servidor j esteja configurado, o sistema ir solicitar ao usurio que o mesmo confirme essa configurao.

CONFIGURAES

ATUALIZAO DO SISTEMA

O SankhyaW pode ser atualizado atravs do Gerenciador de Pacotes. O Web Package Managerdownload e controle de pacotes (.pkgs) arquivos de atualizaes, j baixados, bem como a execuo dos mesmos. No sendo necessrio, e nem devido, parar o JBoss, pois o WPM tambm uma aplicao web que roda no mesmo JBoss do SankhyaW. Todo o processo de atualizao do SankhyaW ser feito pela tela do WPM. Para acess-lo atravs do menu do SankhyaW, o usurio deve seguir o seguinte caminho: Configuraes->Avanado->Atualizao do Sistema.atravs do endereo http://localhost:8080/wpm Ateno: Uma vez acessada esta tela, no possvel retornar ao SankhyaW caso o usurio no queira realmente executar uma atualizao.o sistema apresentar ao usurio a opo de retornar ao SankhyaW. O WPM no distribudo junto com o SankhyaW, ele instalado pelo Gerenciador de Pacotes. Existe um arquivo especfico com exteno .pkghttp://downloads.sankhya.com.br. O WPM possui um login prprio, com apenas o campo Senha, sem a necessidade de um usurio. Por padro, a senha para o primeiro acesso

Assim que o usurio realizar o primeiro acesso, padro seja realizada. Nesta tela, o usurio dever informar novamente a cadastrar uma nova senha, informandocampo Confirma senha.

CONFIGURAES

O SankhyaW pode ser atualizado atravs do Web Package Manager, verso web do SankhyaW Web Package Manager, doravante WPM, disponibiliza uma interface para

download e controle de pacotes (.pkgs) arquivos de atualizaes, j baixados, bem como a execuo dos mesmos. No sendo necessrio, e nem devido, parar o JBoss, pois o WPM tambm uma aplicao web

oss do SankhyaW. Todo o processo de atualizao do SankhyaW ser feito pela tela

lo atravs do menu do SankhyaW, o usurio deve seguir o seguinte caminho: >Atualizao do Sistema. Tambm possvel acessar diret

http://localhost:8080/wpm.

Uma vez acessada esta tela, no possvel retornar ao SankhyaW caso o usurio no queira realmente executar uma atualizao. Isso s ser possvel caso a atualizao seja feita, e neste moo sistema apresentar ao usurio a opo de retornar ao SankhyaW.

O WPM no distribudo junto com o SankhyaW, ele instalado pelo Gerenciador de Pacotes. Existe um .pkg, disponvel para o usurio baixar diretament

O WPM possui um login prprio, com apenas o campo Senha, sem a necessidade de um usurio. Por padro, a senha para o primeiro acesso admin.

Assim que o usurio realizar o primeiro acesso, o WPM ir apresentar uma tela para que a troca da senha padro seja realizada. Nesta tela, o usurio dever informar novamente a cadastrar uma nova senha, informando-a duas vezes, uma vez no campo Nova senha

ONFIGURAES

, verso web do SankhyaW , disponibiliza uma interface para

download e controle de pacotes (.pkgs) arquivos de atualizaes, j baixados, bem como a execuo dos mesmos. No sendo necessrio, e nem devido, parar o JBoss, pois o WPM tambm uma aplicao web

oss do SankhyaW. Todo o processo de atualizao do SankhyaW ser feito pela tela

lo atravs do menu do SankhyaW, o usurio deve seguir o seguinte caminho: Tambm possvel acessar diretamente

Uma vez acessada esta tela, no possvel retornar ao SankhyaW caso o usurio no queira Isso s ser possvel caso a atualizao seja feita, e neste momento,

O WPM no distribudo junto com o SankhyaW, ele instalado pelo Gerenciador de Pacotes. Existe um , disponvel para o usurio baixar diretamente do site de downloads

O WPM possui um login prprio, com apenas o campo Senha, sem a necessidade de um usurio. Por

o WPM ir apresentar uma tela para que a troca da senha padro seja realizada. Nesta tela, o usurio dever informar novamente a Senha atual (admin), e

Nova senha, e novamente no

CONFIGURAES

Deve-se observar que, o WPM pode ser acessado pelo endereo http://[localhost]:[porta]/wpm. O usurio pode acess-lo tambm pelo menu Configuraes/Avanado/Atualizao do Sistema. Caso o usurio logado no seja o SUP, o sistema apresentar a tela de autenticao de acesso. Por outro lado, caso o usurio logado no sistema seja o administrador SUP, a tela do WPM ser aberta sem necessidade de autenticao de acesso. O boto Recarregar aplicao fica localizado na parte superior direita da tela. Sua funcionalidade poder reinicializar o WPM sem a necessidade do usurio logar novamente. Dessa forma, por exemplo, o sistema busca e apresenta novos pacotes disponveis para download.

ABA DISPONVEIS NO REPOSITRIO

Nesta aba so apresentadas as atualizaes disponveis para que o usurio obtenha as verses mais recentes do sistema, com todas as alteraes realizadas, correes feitas, etc. Na grade so apresentadas informaes sobre as verses disponveis, as descries sobre o que se referem os pacotes (se pacote: sistema sem help ou sistema com help), a data e hora em que foram disponibilizadas, se esto compatveis com o seu sistema, e demais dados tcnicos como o nome do arquivo, qual seu tamanho, verses do banco de dados, aplicativo Java e JBoss. Para realizar a atualizao, o usurio deve solicitar a opo Baixar atualizao, que est localizada na

coluna Aes da grade, e representada pelo cone . Ao clicar nesta opo, o sistema apresenta na tela informaes sobre a ao do download como a completude da ao, o tempo decorrido, e o tempo estimado.

CONFIGURAES

Caso o usurio queira interromper o download, basta solicitar a opo Cancelar Download. Selecionada a opo Cancelar Download o sistema simplesmente retorna tela anterior, neste caso, apresentando a aba Disponveis no repositrio. Caso ocorra algum problema durante a transferncia, o sistema apresenta na tela a seguinte mensagem:

Essa mensagem apresentada quando o usurio acessa o WPM e o sistema no consegue se comunicar com o repositrio dos pacotes de atualizao, download.sankhya.com.br (indisponibilidade temporria). Caso algum fator impea o download do pacote de atualizao, o sistema lanar a mensagem abaixo. Normalmente isso ocorre quando a conexo com a internet se perde.

Outra falha de conexo possvel como Banco de Dados SQL ou Oracle:

CONFIGURAES

Esta mensagem apresentada quando o usurio digita um usurio, ou senha, invlidos na configurao da conexo com o banco de dados SQL. Essa configurao, dentro do WPM, est localizada na aba Configuraes, boto Editar dados de conexo.

O mesmo ocorre quando o tipo do banco de dados Oracle, e for digitado usurio, ou senha ou ambos invlidos, ser apresentada a mensagem acima. Quando o usurio solicita o download de um pacote de atualizao que j tenha sido baixado anteriormente, ou seja, o pacote encontra-se disponvel na aba Disponvel localmente, na aba Disponveis no repositrio, o sistema apresentar a seguinte mensagem de aviso.

Com a transferncia concluda, o sistema oferece ao usurio duas opes: Instalar verso recebida e Atualizar depois.

Caso o usurio solicite a opo Atualizar depois, o sistema informar que o pacote de atualizao que foi transferido para a mquina local se encontra na aba Disponveis localmente e no se faz necessrio realizar novamente o download desta atualizao. Ver-se- sobre esta aba logo em seguida.

CONFIGURAES

Por outro lado, caso o usurio solicite a opo Instalar verso recebida, dois avisos sero apresentados. De forma extremamente recomendvel, solicitado ao usurio que faa backup da base de dados e em seguida informa que o sistema ficar indisponvel durante todo o processo de atualizao.

Juntamente aos avisos, tambm so fornecidas duas opes para o usurio: Prosseguir e Atualizar Depois. Semelhante a tela anterior, a opo Atualizar depois interrompe o processo de atualizao e retorna aba Disponveis localmente.

Contudo, selecionando a opo Prosseguir, dada continuidade no processo de atualizao, e o sistema apresenta na tela as informaes tcnicas referente a este processo. Na parte inferior da tela, est contida uma barra que ilustra a porcentagem de completude da atualizao. A esquerda desta barra tem-se a opo Rolar texto automaticamente, e logo direita, Cancelar Instalao.

CONFIGURAES

Caso o usurio solicite a opo Cancelar Instalao, esta faz com que o processo de atualizao seja abortado. Este procedimento pode danificar a instalao, j que o processo de atualizao/instalao no retorna o sistema ao estado anterior, sendo necessrio executar um pacote de atualizao com verso anterior atual. Antes de cancelar a instalao, ou paus-la, o sistema apresenta uma mensagem com essas informaes e questiona se realmente deseja faz-lo.

Se ocorrer algum erro na instalao/atualizao a tela Erro ao executar script se apresentar, nela so listados termos tcnicos relacionados ao erro. O usurio nesse caso ter a sua disposio trs opes: Tentar novamente, Ignorar e prosseguir e Cancelar atualizao.

CONFIGURAES

Seguindo normalmente a instalao/atualizao, ao finaliz-la o sistema reiniciado para fazer com que as alteraes sejam aplicadas. Possivelmente, pode surgir uma mensagem na parte superior da tela informando que a conexo foi perdida, logo em seguida, o sistema reinicializado. Com o procedimento finalizado com sucesso, o sistema ainda apresenta ao usurio duas opes: Executar diagnstico e Ir para o SankhyaW.

Selecionando a opo Ir para o SankhyaW, o usurio redirecionado para a tela de login do SankhyaW. No entanto, solicitando a opo Executar diagnstico o sistema redireciona o usurio para a aba Diagnstico do sistema. Esta aba ser explicada logo mais adiante neste help. Com as informaes apresentadas, pode-se explanar de modo resumido e objetivo o exato comportamento desta funcionalidade, possibilitando ao usurio um fcil entendimento do novo procedimento de atualizao do SankhyaW. Esta rotina promover facilidades que mantero os sistemas em total alinhamento ao seu ciclo de vida, ponderando as atualizaes, fazendo com que o sistema fique livre de bugs e erros.

ABA DISPONVEIS LOCALMENTE

Na aba Disponveis localmente esto alocados os pacotes de atualizao que, por algum motivo, foram baixados (realizou-se o download), porm no foram instalados/atualizados. Sendo assim, eles foram dispostos na prpria mquina do usurio, no sendo necessrio baix-los novamente do servidor do SankhyaW. Semelhante a aba Disponveis no repositrio, nesta tambm se encontram as informaes referentes ao pacote, como a descrio, verso, etc. importante observar a informao contida na coluna Compatvel. Em alguns casos, o pacote de atualizao que foi baixado, e est contido na prpria mquina do usurio, pode ser de verso inferior a atual SankhyaW. Em ambas as abas Disponveis no repositrio e Disponveis localmente, na coluna

CONFIGURAES

Compatvel o cone representa que o pacote de atualizao de verso superior ao atual sistema do usurio, e compatvel.

J o cone indica ao usurio que o pacote de atualizao no possui compatibilidade com o seu sistema. Para informaes sobre a incompatibilidade, basta o usurio posicionar o cursor do mouse sobre

este cone. Mesmo com este cone, o pacote instalado. Quando apresentado o cone , o pacote de atualizao totalmente incompatvel. Quando ocorre este ltimo cone, o pacote no pode ser instalado.

Nesta aba est a disposio do usurio, posicionada acima da grade no canto direito, a opo Deletar todos arquivos de atualizao. Com esta opo, o usurio pode apagar da grade, todos os arquivos que foram baixados do servidor e, por determinado fato, armazenados na mquina local. Diferentemente da aba Disponveis no repositrio, na coluna Aes desta grade, esto contidas duas

opes: Instalar verso e Deletar arquivo de atualizao.

Com a opo Deletar arquivo de atualizao , o usurio apaga de sua unidade de armazenamento, o

pacote de atualizao que foi baixado do servidor. A opo Instalar Verso faz com que o sistema siga os mesmos procedimentos descritos anteriormente na aba Disponveis no repositrio. Resumindo, ir avisar ao usurio que faa o backup da base de dados e informa que o sistema ficar indisponvel durante tudo processo de atualizao, fornecendo a opo de Prosseguir ou Atualizar depois. Na sequncia, apresenta na tela todas as informaes tcnicas da instalao/atualizao, possibilitando cancelar. Ao final, o sistema reiniciado e so apresentadas duas opes ao usurio: Executar diagnstico e Ir para o SankhyaW.

ABA PACOTES DE IDIOMAS

No WPM existe a possibilidade de configurar o sistema de forma que possa visualiz-lo em outros idiomas. Para isso foi criada a Aba Pacotes de Idiomas onde o usurio poder baixar e incrementar o sistema com o idioma selecionado. Aps o login no WPM, com o sistema j atualizado e instalado com a verso do pacote desejado, o usurio ir Aba Pacotes de idiomas:

CONFIGURAES

Nesta Aba aparecero todos os pacotes dos idiomas disponveis para utilizao. O usurio ter que baixar um de cada vez. Aes:

Se o usurio clicar no cone abrir a tela com os seguintes dizeres: "Este processo far com que o pacote do idioma selecionado seja disponibilizado para utilizao no sistema. No haver reinicializao ou atualizao. Aps efetuado este procedimento, poder configurar o usurio para o idioma selecionado atravs do menu Configuraes Controle de Acesso Usurios, campo Idioma." Ao clicar em Ok o sistema inicializa o download:

Depois de efetuado o download do pacote de traduo o sistema efetua a instalao:

CONFIGURAES

Depois, caso no ocorra nenhum problema o sistema trar a mensagem informando que corretamente e est pronto para ser utilizado:

Este processo far o download do pacote de idioma selecionado e copiar os arquivos contidos no mesmo para a pasta de arquivos de internacionalizao. O sistema no ser atualizado e nem reinicializado. Nota: O cadastro do usurio dever estar configurado para logar com as configuraes realizadas referentes ao idioma. No exemplo da imagem abaixo dever ser alterado para Ingls (Estados Unidos).

CONFIGURAES

ABA DIAGNSTICO DO SISTEMA

O objetivo da aba Diagnstico do sistema permitir detectar possveis problemas na estrutura do Banco de Dados e Dicionrio de Dados. Inconsistncias essas que podem ser causas com a criao de novos campos e tabelas ao longo do ciclo de vida do sistema.

Inicialmente, a tela apresenta a penas o boto Executar diagnstico. Assim que o usurio solicita esta opo, so apresentadas na tela duas tabelas. Na primeira, esto dispostos os itens do Banco de Dados que precisam ser corrigidos, informando o nome e o tipo do objeto. J na segunda tabela, so apresentados os detalhes de cada item da tabela superior. Ou seja, selecionando determinado registro da primeira grade, a descrio do problema e apresentada na segunda grade. Fica ento na responsabilidade do administrador do sistema, providenciar as devidas correes no Dicionrio e Banco de Dados.

CONFIGURAES

ABA CONFIGURAES

Na aba Configuraes apresentada uma srie de informaes tcnicas referentes verso do SankhyaW e conexo com o Banco de Dados. Esto dispostos tambm, no canto inferior esquerdo da tela, trs opes: Editar dados de conexo, Alterar senha e Download do log. Solicitando a opo Editar dados de conexo, apresentada para o usurio uma pequena tela onde possvel inserir as devidas configuraes que estabelecem a conexo do SankhyaW com o Banco de Dados. Importante: O sistema reinicializado quando o usurio realiza alteraes na conexo com o banco de dados. Para que as modificaes na conexo entre o SankhyaW e o Banco de Dados sejam devidamente aplicadas, o sistema necessita ser reinicializado. Banco Oracle

CONFIGURAES

Banco Oracle (Rac)

Banco MS SQL Server (Driver Ms)

Banco MS SQL Server (Driver JTDS)

CONFIGURAES

Note que prximo a alguns campos da tela Informaes da Conexo com o Banco de Dados existem informaes teis para o devido preenchimento destes campos que se apresentam ao aproximar o mouse do ponto de interrogao . importante ressaltar a necessidade da presena/acompanhamento do administrador responsvel pelas questes tcnicas do sistema. Dessa forma, com todas as devidas informaes inseridas o usurio pode solicitar a opo Salvar configuraes. Por outro lado, caso queira desistir destas configuraes basta clicar no boto Cancelar.

Alterar senha: Ao solicitar esta opo, o sistema lana a tela apresentada logo acima. De forma resumida, o usurio primeiramente digita a atual senha utilizada no campo Senha atual, e digita a nova senha duas vezes, uma vez no campo Nova senha, outra no campo Confirma senha. Nota: Quando logado com o usurio SUP, no ser necessrio digitar a senha antiga, de acesso ao WPM, no momento de fazer essa alterao. Isso previne os casos da senha ser extraviada. Essa regra apenas valida quando o WPM acessado pelo menu do sistema: Configuraes Avanado Atualizao do Sistema.

CONFIGURAES

A opo Reinicializar Sistema promove a reinicializao do servidor de aplicaes JBoss. Assim que o usurio solicita essa opo o sistema lana uma mensagem de alerta confirmando a operao que ser realizada.

importante ressaltar que, alm de reinicializar o servidor, as pastas temporrias do servidor JBoss, tmp e work, so deletadas automaticamente, porm, so recriadas novamente assim que o inicializado. No entanto, para que isso seja possvel necessrio que o SankhyW seja atualizado pelo menos uma vez com a utilizao do Gerenciador de Pacotes (nova verso no endereo http://downloads.sankhya.com.br/). Isso se deve ao fato de que, para deletar as pastas temporrias, o JBoss necessita receber os script de deleo que so configurados atravs da atualizao por essa ferramenta (Gerenciador de Pacotes). E por final, a opo Download do log possibilita ao usurio ter acesso ao arquivo que contm o log do sistema. Este arquivo til para os tcnicos do SankhyaW encontrarem as possveis causas de erros que eventualmente possam ocorrer. Aviso de compatiblidade de binrio e dicionrio de dados O sistema realiza a comparao da verso do build do sistema com a verso do build do dicionrio de dados. Ser apresentada ao usurio, em caso de divergncia, a mensagem abaixo: A verso do dicionrio de dados [VERSObBUILD] est diferente da verso necessria [VERSObBUILD], provavelmente a atualizao do sistema no foi realizada de forma correta. Entre em contato com o responsvel pela ltima atualizao do SankhyaW.

Nota: Esta tela, apenas apresentada caso a comparao da verso do build do sistema seja diferente da verso do build do dicionrio de dados. O primeiro trecho verso e build do dicionrio de dados, enquanto que o segundo trecho da mensagem ir apresentar a verso e build esperada para inicializao do sistema.

ATUALIZAO AUTOMTICA DO WPM

Como explanado neste documento, pde Pacotes como tambm o WPM. Em ambas as ferramentasdisponvel. Quando utilizado o WPM para atualizao do sistema, se existir uma verso mais atual utilizada, o WPM ir atualizar-se automaticamente garantindo assim todas as correes e melhorias da verso mais atual. Esta atualizao ocorrer aps o login do WPM. Casestejam configuradas, o sistema aps o login far a solicitao da configurao do banco de dados e posteriormente efetuar a atualizao do WPM:

CONFIGURAES

Esta tela, apenas apresentada caso a comparao da verso do build do sistema seja diferente da verso do build do dicionrio de dados. O primeiro trecho [VERSAObBUILD]verso e build do dicionrio de dados, enquanto que o segundo trecho da mensagem ir apresentar a verso e build esperada para inicializao do sistema.

Como explanado neste documento, para atualizao do SankhyaW possvel o WPM. Em ambas as ferramentas, essencial utilizar sempre a ltima verso

o o WPM para atualizao do sistema, se existir uma verso mais atual se automaticamente garantindo assim todas as correes e melhorias da

Esta atualizao ocorrer aps o login do WPM. Caso as configuraes do Banco de Dados ainda no estejam configuradas, o sistema aps o login far a solicitao da configurao do banco de dados e posteriormente efetuar a atualizao do WPM:

ONFIGURAES

Esta tela, apenas apresentada caso a comparao da verso do build do sistema seja diferente da VERSAObBUILD] ser alterado pelo valor da

verso e build do dicionrio de dados, enquanto que o segundo trecho da mensagem ir apresentar a

ara atualizao do SankhyaW possvel utilizar tanto o Gerenciador essencial utilizar sempre a ltima verso

o o WPM para atualizao do sistema, se existir uma verso mais atual deste do que a se automaticamente garantindo assim todas as correes e melhorias da

o as configuraes do Banco de Dados ainda no estejam configuradas, o sistema aps o login far a solicitao da configurao do banco de dados e

Na tela de login do WPM vir a verso Banco de Dados vir a tela:

Aps a configurao dos dados do Banco de Dados o WPM verificar se existe alguma verso mais atual disponvel para efetuar ou no a atualizao. Para o sistema identificar se existe verso mais atual o sistema verifica no site de downloads da Sankhya, no site downloads.sankhya.com.br.

CONFIGURAES

Na tela de login do WPM vir a verso em que o WPM encontra-se. Aps o login, caso no haja dados do

Aps a configurao dos dados do Banco de Dados o WPM verificar se existe alguma verso mais atual disponvel para efetuar ou no a atualizao.

te verso mais atual o sistema verifica no site de downloads da Sankhya,

ONFIGURAES

se. Aps o login, caso no haja dados do

Aps a configurao dos dados do Banco de Dados o WPM verificar se existe alguma verso mais atual

te verso mais atual o sistema verifica no site de downloads da Sankhya,

Se a verso do WPM disponvel no site de Downloads mais atual, automaticamente o sistema efetuar a atualizao do WPM:

Depois de efetuada a atualizao, o sistema emite a mensagem:

CONFIGURAES

Se a verso do WPM disponvel no site de Downloads mais atual, automaticamente o sistema efetuar a

a atualizao, o sistema emite a mensagem:

ONFIGURAES

Se a verso do WPM disponvel no site de Downloads mais atual, automaticamente o sistema efetuar a

Em seguida aps a atualizao do WPM, o sistema voltar para a tela de login com a nova verso do WPM:

CONFIGURAES

Em seguida aps a atualizao do WPM, o sistema voltar para a tela de login com a nova verso do

ONFIGURAES

Em seguida aps a atualizao do WPM, o sistema voltar para a tela de login com a nova verso do