Manual de Instalação e Atualização SankhyaW

MANUAL DE INSTALAÇÃO E
ATUALIZAÇÃO SANKHYAW
SANKHYA GESTÃO DE NEGÓCIOS
SANKHYA Business Partners

Copyright © 2006 SANKHYA Tecnologia em Sistemas Ltda.
Todos os direitos reservados.
Proibida a reprodução parcial ou total por qualquer meio, seja este eletrônico, mecânico, de fotocópia, de gravação, ou outros, sem prévia autorização, por
escrito da SANKHYA Gestão de Negócios.
-2-
Introdução..................................................................................................................................................6
Pré-Requisitos.............................................................................................................................................6
Sobre os diretórios padrões...........................................................................................................................6
Instalação do servidor de aplicações...........................................................................................................7
SankhyaW em Ambiente Linux....................................................................................................................7
Implantação e Atualização do Sistema SankhyaW em Ambiente Linux................................................................7
Figura 1.......................................................................................................................................................7
Figura 2.......................................................................................................................................................8
Instalação do JDK........................................................................................................................................8
Figura 3.......................................................................................................................................................8
Figura 4.......................................................................................................................................................8
Variáveis de Ambiente..................................................................................................................................8
Figura 5.......................................................................................................................................................9
Figura 6.......................................................................................................................................................9
Figura 7.......................................................................................................................................................9
Instalação do SankhyaW Gerenciador de Pacotes............................................................................................9
Figura 8.......................................................................................................................................................9
Figura 9.....................................................................................................................................................10
SankhyaW em Ambiente Windows.............................................................................................................10
Instalação do JDK em Ambiente Windows.....................................................................................................10
Figura 10...................................................................................................................................................10
Figura 11...................................................................................................................................................11
Figura 12...................................................................................................................................................12
Figura 13...................................................................................................................................................12
Figura 14...................................................................................................................................................13
Figura 15...................................................................................................................................................13
Figura 16...................................................................................................................................................14
Figura 17...................................................................................................................................................14
Figura 18...................................................................................................................................................15
Configuração das Variáveis de ambiente em Windows.....................................................................................16
Figura 19...................................................................................................................................................16
Figura 20...................................................................................................................................................17
Configuração da variável de ambiente JAVA_HOME.........................................................................................17
Figura 21...................................................................................................................................................17
Figura 22...................................................................................................................................................18
Instalação do SankhyaW Gerenciador de Pacotes (Windows)....................................................................18
Figura 23...................................................................................................................................................18
Figura 24...................................................................................................................................................19
Figura 25...................................................................................................................................................20
Figura 26...................................................................................................................................................21
Figura 27...................................................................................................................................................22
Utilização do Gerenciador de Pacotes........................................................................................................22
Os diretórios do SankhyaW Gerenciador de Pacotes........................................................................................23
Figura 28 - Menu Principal do SankhyaW Gerenciador de Pacotes.............................................................23
[1] Instalação/atualização Expressa do Sistema.............................................................................................24
Figura 29 - Diretório onde são colocados os pacotes a serem executados pelo..........................................24
Gerenciador de Pacotes (Windows)...........................................................................................................24
Figura 30 -Diretório onde são colocados os pacotes a serem executados pelo Gerenciador de Pacotes
(Linux)......................................................................................................................................................24
Figura 31...................................................................................................................................................25
opção de execução automática dos scripts.....................................................................................................25
Figura 32...................................................................................................................................................26
-4-
Instalação do Servidor de aplicações............................................................................................................26

Instalando o servidor de aplicações manualmente.......................................................26
Instalando o servidor de aplicações através de um pacote...........................................27
Figura 33...................................................................................................................................................27
Procedimento em servidores instalados e registrados..................................................27
Figura 34 - Seleção do Servidor de Aplicações...........................................................................................28
Inicialização/Interrupção do Servidor de Aplicações.....................................................28
Figura 35...................................................................................................................................................29
Figura 35...................................................................................................................................................30
Figura 36...................................................................................................................................................30
Figura 37 – lista de processos...................................................................................................................31
Configuração da conexão com o banco de dados.........................................................31
Figura 39...................................................................................................................................................31
Figura 40 - Inserindo as informações de conexão para um banco Oracle...................................................32
Figura 41 - Inserindo as informações de conexão para um banco MS SQL Sever.......................................33
A execução dos scripts............................................................................................33
Figura 42 - Execução de scripts automática e sem solicitação de confirmação...........................................34
Figura 43...................................................................................................................................................34
Erros comuns na execução dos scripts.......................................................................35
Figura 44...................................................................................................................................................35
A importação do Dicionário de Dados........................................................................36
Figura 45...................................................................................................................................................36
O processo de instalação/atualização dos arquivos binários..........................................37
Figura 46...................................................................................................................................................37
Erros durante a atualização dos arquivos binários.......................................................37
Considerações finais sobre a opção de Instalação/Atualização Expressa.........................37
[2] Selecionar Servidor...............................................................................................................................38
Figura 47...................................................................................................................................................38
Figura 45...................................................................................................................................................38
Figura 46...................................................................................................................................................39
Figura 47...................................................................................................................................................40
Figura 48...................................................................................................................................................40
Figura 49...................................................................................................................................................41
Figura 50 - Inserindo as informações de conexão para um banco Oracle...................................................41
Figura 51 - Inserindo as informações de conexão para um banco MS SQL Sever.......................................42
Figura 52...................................................................................................................................................43
Figura 53.....................................................................................................................................................43
-5-
INTRODUÇÃO
O SankhyaW é uma aplicação ERP Java Web, portanto o ambiente de execução deve ter todos
os requisitos necessários para uma aplicação deste padrão.
Resumidamente a aplicação é constituída por arquivos binários, resultado da compilação dos

arquivos fontes, acondicionados dentro de um servidor de aplicações e alimentados por uma
base de dados, seja o SGBD Oracle ou MS SQL Server.
O servidor de aplicações utilizado é o JBoss, que por sua vez é um servidor de aplicações de
código fonte aberto, baseado na plataforma JEE, portanto é portável tanto a Windows quanto
a Linux.
O papel do SankhyaW Gerenciador de Pacotes é efetuar o deploy (distribuição dos arquivos

binários) no JBoss e executar scripts no banco de dados ao qual esse JBoss está vinculado.
Intrínseco a esse deploy está um arquivo que contém as informações de conexão com o banco,
esse mesmo arquivo é utilizado pelo Gerenciador de Pacotes. O SankhyaW Gerenciador
de Pacotes também possui diversas opções como, por exemplo, editar os dados desse
arquivo que contém as informações de conexão com o banco.
PRÉ-REQUISITOS
Para realizar o processo que será descrito neste manual é necessário possuir:
 Instalador do JDK (Java Developer Kit) (www.sun.com);

 Instalador do Gerenciador de Pacotes (Fornecido pela Sankhya);
 Pacote de Instalação do Sistema (Também fornecido pela Sankhya)
 Dados para configuração do Banco de dados.
Se houver um JDK instalado na máquina verificar a compatibilidade da versão do mesmo com

a versão do JDK utilizada pelo SankhyaW.
Se for necessário baixar, além das verificações de versão supracitadas, a JDK adequada para o
sistema operacional (Linux ou Windows) e para a arquitetura do computador (32 ou 64 bits).
SOBRE OS DIRETÓRIOS PADRÕES
É extremamente recomendável seguir os padrões de diretórios segundo este manual,

isso agilizará futuras buscas por arquivos, a fim de dar manutenção e/ou fazer
verificações diversas.
Em ambiente Linux todos os arquivos são colocados no home do usuário mgeweb e sob
propriedade do mesmo, dessa forma a atualização e manipulação do sistema não dependerá
da disponibilização da senha do root, que é um usuário com privilégios de administrador do
sistema operacional.
Em ambiente Windows o Gerenciador de Pacotes será instalado no diretório C:\Arquivos

de Programas\SankhyaW Gerenciador de Pacotes e o servidor de aplicações será
colocado em C:\Arquivos de Programas\Sankhya\[JBOSS].
-7-
É relevante deixar claro essa questão, vale ressaltar também que tudo isto será detalhado no
decorrer deste manual.
INSTALAÇÃO DO SERVIDOR DE APLICAÇÕES
O JBoss é um servidor de aplicações baseado na plataforma JEE e portável tanto para

Windows quanto para Linux.
Disponibilizado normalmente sob formato Zip sua instalação resume-se apenas na

descompactação do arquivo, tanto para Linux quanto para Windows.
Como no SankhyaW todo o processo de atualização é feito através do SankhyaW

Gerenciador de Pacotes, além da descompactação é necessário um registro do
servidor.
O registro é a forma de vincular um servidor de aplicações às tarefas do ‘Gerenciador de

Pacotes’, veja mais detalhes em “[ 4 ] Registrar Servidores”.
No processo de instalação do SankhyaW, a instação do JBoss é feita através da

descompactação manual do arquivo ou do ‘Gerenciador de Pacotes’ através da execução de
um pacote de instalação que contenha o JBoss. De fato, em ambos os casos o arquivo é o
mesmo, porém, neste último o ‘Gerenciador’ faz a descompactação de forma interativa
solicitando o caminho onde o servidor será descompactado e um nome para o registro desse
servidor. Este processo será mostrado no tópico intitulado “Instalando o servidor de
aplicações através de um pacote”.
No processo de descompactação manual, após descompactar, será preciso registrar o servidor

conforme mostrado em “[ 4 ] Registrar Servidores”.
Uma vez descompactado e registrado, o JBoss precisará ter um JDK a seu alcance. Para isso,
será necessário instalar um JDK e criar uma variável de ambiente que aponte para este JDK.
Os procedimentos da instalação do JDK e configuração das variáveis de ambiente estão
detalhados a seguir sob os respectivos títulos “Instalação do JDK” e “Variáveis de
Ambiente”.
SANKHYAW EM AMBIENTE LINUX
IMPLANTAÇÃO E ATUALIZAÇÃO DO SISTEMA SANKHYAW EM AMBIENTE LINUX
Primeiramente, uma questão que deve estar clara é que, por padrão, o SankhyaW fica sob
propriedade do usuário mgeweb, dessa forma a atualização e manipulação do sistema não
dependerá da disponibilização da senha do root que é um usuário com privilégios de
administrador do sistema operacional.
Em suma, o servidor de aplicações e o SankhyaW Gerenciador de Pacotes devem estar

na home do usuário mgeweb. A seguir estarão os detalhes de instalação do servidor de
aplicações, neste exemplo, o servidor utilizado foi o JBOSS:
Figura 1
-8-
pwd – mostra o caminho do diretório corrente.

Estamos no home do usuário mgeweb, conforme hierarquia padrão:
/home/mgeweb
Figura 2
ls -l – lista arquivos de forma detalhada do diretório corrente.
Note que neste diretório já estão o JDK, o SankhyaW Gerenciador de Pacotes e o Pacote de
Atualização e que todos os arquivos estão sob propriedade do usuário mgeweb.
INSTALAÇÃO DO JDK
Conforme mostra a Figura 2, a instalação do JDK requer que o arquivo de instalação esteja
com permissão de execução.
O usuário pode setar um arquivo como executável através do comando:
chmod +x nome_do_arquivo
Seguindo o processo, executaremos a instalação do JDK, conforme a figura abaixo:
Figura 3
Leia atentamente a licença de uso do JDK.
Figura 4
Ao final dos termos da lincença, conforme a Figura 4, caso o usuário concorde, deverá digitar
yes e apertar a tecla Enter.
VARIÁVEIS DE AMBIENTE
Feita a instalação do JDK, deve-se criar a variável de ambiente JAVA_HOME apontando para
o diretório de instalação do JDK. Na distribuição utilizada neste exemplo, e em algumas
-9-
outras, bastará incluir no arquivo /home/mgeweb/.bash_profile a variável seguida de seu

valor, conforme as figuras abaixo:
Neste exemplo foi utilizado o editor de texto vi, mas a edição pode ser feita com o editor de
preferência do usuário.
Abrindo o arquivo .bash_profile do usuário mgeweb:
Figura 5
Inserindo a variável e o valor:
Figura 6
Salvar o arquivo. As alterações no .bash_profile só serão válidas à partir do próximo logon.

Logue novamente.
Após a instalação do JBoss, seja através de um pacote ou da instalação manual, será
necessário editar novamente o .bash_profile e setar a variável JBOSS_HOME com o diretório
que foi instalado o JBoss.
Neste exemplo foi utilizado o JBoss 4.2.2, assim nossa variável ficaria no .bash_profile da
seguinte forma:
Figura 7
INSTALAÇÃO DO SANKHYAW GERENCIADOR DE PACOTES
O SankhyaW Gerenciador de Pacotes, é disponibilizado em um arquivo compactado no

formato .tar.gz e pode ser descompactado através do tar, seguido dos parâmetros x
(extract), z (filter the archive through gzip), v (verbosely list files processed), f (file).
Vale ressaltar que a descompactação deve ser feita em /home/mgeweb
Figura 8
O usuário deverá verificar sempre se a versão do Gerenciador de Pacotes é a mais atual e se

necessário entre em contato com os responsáveis.
Feita a extração do SankhyaW Gerenciador de Pacotes, todos os arquivos estarão dentro

da pasta /home/mgeweb/sankhyaW_gerenciador_de_pacotes. O Gerenciador de
Pacotes é inicializado através da execução do arquivo sankhyaw-package-manager dentro
da pasta bin. Conforme figura 9:
- 10 -
Figura 9
Utiliza-se o comando pwd para mostrar o diretório corrente, estamos em

/home/mgeweb/sankhyaW_gerenciador_de_pacotes/bin
Utiliza-se ls para listar os arquivos do diretório corrente, note que o arquivo sankhyaw-
package-manager já possui permissão de execução portanto para iniciá-lo, bastará executar
conforme a ultima linha da figura 9.
SANKHYAW EM AMBIENTE WINDOWS
O SankhyaW é uma aplicação ERP Java Web, portanto o ambiente de execução deve ter
todos os requisitos necessários para uma aplicação Java. Temos então um servidor de
aplicações que apontará para um SDK (Standard Developer Kit) Java.
INSTALAÇÃO DO JDK EM AMBIENTE WINDOWS
Figura 10
- 11 -
Na figura 10 apresenta o instalador do SankhyaW Gerenciador de Pacotes e do JDK.
O primeiro a ser instalado é o JDK, é necessário verificar se a versão é compatível com o

SankhyaW e se há compatibilidade com o sistema operacional Linux ou Windows, bem como
compatibilidade com a arquitetura da máquina (32 ou 64 bits). Ou seja, o JDK a ser baixado e
instalado deve estar de acordo com esses três requisitos, assim sendo, clicar no executável
para iniciar a instalação do JDK.
Figura 11
Aguardar enquanto o Instalador do JDK prepara a instalação, como mostra a Figura 11.
- 12 -
Figura 12
Leia o contrato de licença cuidadosamente e clique em “Accept”, como mostra a Figura 12.
Figura 13
- 13 -
Selecionar as ferramentas desejadas e clicar em Next, como mostra a Figura 13.
Figura 14
Aguardar enquanto o JDK é instalado no computador, como mostra a Figura 14.
Figura 15
Se o computador já possuir o JRE instalado, clicar em “No” (não), caso contrário continuar a
instalação.
- 14 -
Figura 16
Selecionar as opções desejadas e clicar em Next, como mostra a Figura 16.
Figura 17
- 15 -
Aguardar enquanto o JRE é instalado no computador, como mostra a Figura 17.
Figura 18
Caso desejar, registrar o JDK ou clique em Finish para concluir a instalação.
- 16 -
CONFIGURAÇÃO DAS VARIÁVEIS DE AMBIENTE EM WINDOWS

Para inserir variáveis de ambiente no Windows, clicar com o botão direito sobre a ícone
“Meu Computador” e em “Propriedades”, conforme Figura 19.
Figura 19
Clicar na aba “Avançado” e em seguida em “Variáveis de ambiente”.
A janela intitulada “Variáveis de ambiente”, conforme Figura 20, permite a criação e edição
de variáveis de ambiente.
As variáveis para o SankhyaW devem ser criadas como “Variáveis do sistema”.
- 17 -
Figura 20
CONFIGURAÇÃO DA VARIÁVEL DE AMBIENTE JAVA_HOME
Após a instalação do JDK será necessário incluir uma variável de ambiente apontando para o
mesmo, essa variável deverá possuir o nome JAVA_HOME.
No sistema operacional, na janela intitulada “Variáveis de ambiente”, clicar em “Nova”, em

seguida digitar o nome da variável JAVA_HOME. Em “Valor da variável” colocar o caminho
da instalação do JDK, conforme Figura 21.
Figura 21
Será necessário também colocar na variável “path” o caminho da pasta bin da JDK, para isso
utilizar a variável JAVA_HOME, na Figura 21 ela possui o valor “c:\Arquivos de
programas\Java\jdk1.6.0_06”. Assim, o valor a ser inserido na “path” seria
- 18 -
%JAVA_HOME%\bin que seria o mesmo que inserir o caminho “c:\Arquivos de

programas\Java\jdk1.6.0_06\bin”, conforme mostra a Figura 22.
Manter os outros valores que estão na “path” e colocar “;” (ponto e vírgula) para separar o
valor inserido.
Figura 22
INSTALAÇÃO DO SANKHYAW GERENCIADOR DE PACOTES (WINDOWS)
De acordo com a Figura 10, o usuário deverá dar dois cliques no Instalador do
Gerenciador de Pacotes e siguir os passos abaixo para instalar o mesmo:
Figura 23
- 19 -
A Figura 23 mostra a tela inicial da instalação, clicar em “Avançar” para continuar.
Figura 24
A instalação padrão é feita no diretório sugerido “C:\Arquivos de programas\SankhyaW

Gerenciador de Pacotes” como mostra a Figura 24.
- 20 -
Figura 25
Selecionar a pasta do “Menu Iniciar” onde deve ser criado os atalhos do Gerenciador de
Pacotes, depois clicar em “Avançar” como mostra a Figura 25.
- 21 -
Figura 26
Aguardar enquanto o Gerenciador de Pacotes é instalado no computador como mostra a

Figura 26.
- 22 -
Figura 27
Quando a instalação for concluída, clicar em “Terminar” conforme a Figura 27.
UTILIZAÇÃO DO GERENCIADOR DE PACOTES
O sistema WGE (ou SANKHYAW) possui um Gerenciador de Pacotes que facilita a instalação
e atualização do sistema.
O SankhyaW Gerenciador de Pacotes é uma ferramenta de execução em modo texto, o

que facilita o uso em ambientes sem modo gráfico.
As atualizações do sistema serão fornecidas em arquivos com a extensão .pkg que contém
todos os arquivos necessários na instalação ou atualização do sistema como, binários, scripts
de atualização do banco de dados, dicionário de dados e no caso de uma primeira
instalação pode conter também um servidor de aplicações. Assim, pela execução de um
simples pacote, todo o processo desde a instalação do JBoss até a atualização do banco,
poderá ser feita de forma direta e automática.
A utilização do Gerenciador de Pacotes é igual para o Windows e Linux, mudando apenas o

diretório onde se encontra a pasta do Gerenciador de Pacotes.
- 23 -
OS DIRETÓRIOS DO SANKHYAW GERENCIADOR DE PACOTES
A partir do diretório principal do SankhyaW Gerenciador de Pacotes são encontrados

alguns outros diretórios como o bin, onde está o arquivo para a inicialização do Gerenciador.
No Linux é o sankhyaw-package-manager e no Windows o sankhyaw-package-
manager.exe, esses dois arquivos são responsáveis pela execução do sankhyaw-package-
manager.jar. Quando há qualquer mudança ou nova versão do Gerenciador, bastará trocar
esse sankhyaw-package-manager.jar.
A versão atual é a 1.14, se o usuário tiver uma versão anterior bastará substituir o .jar pelo o
que está disponível no endereço: www.sankhya.com.br/java/sankhyaw-package-manager.jar
O diretório backup é usado pelo gerenciador para armazenar os arquivos binários da

versão anterior, no ato de uma atualização os arquivos são compactados e colocados neste
diretório.
No diretório conf ficam arquivos de configurações do Gerenciador, tais como informações de

servidores registrados. Registro de servidor é a opção [4] Registrar Servidor, localizada do
menu principal do Gerenciador de Pacotes, e será detalhada mais adiante.
O diretório pkgs é onde devem ser colocados os pacotes de atualização, os arquivos com
extensão pkg, para evitar alguns possíveis transtornos é recomendado que se remova o
pacote desse diretório tão logo seja executado.
O SankhyaW Gerenciador de Pacotes possui um próprio JRE para sua execução, o mesmo
se encontra na pasta de mesmo nome: jre.
O diretório .install4j possui os arquivos de instalação do SankhyaW Gerenciador de

Pacotes e por fim no diretório lib possui arquivos Java (.jar) que são algumas bibliotecas
necessárias para o funcionamento do Gerenciador.
Figura 28 - Menu Principal do SankhyaW Gerenciador de Pacotes
- 24 -
[1] INSTALAÇÃO/ATUALIZAÇÃO EXPRESSA DO SISTEMA
O opção de Instalação/Atualização Expressa consiste na execução de um pacote de

atualização, sendo assim, o pacote a ser executado deve ser colocado na pasta /pkgs do
SankhyaW Gerenciador de Pacotes, conforme Figuras 29 e 30.
Coloque o pacote dentro do diretório pkgs, que por padrão estão nos diretórios:
Linux: /home/mgeweb/sankhyaW_gerenciador_de_pacotes/pkgs
Windows: C:\Arquivos de programas\SankhyaW Gerenciador de Pacotes\pkgs
Figura 29 - Diretório onde são colocados os pacotes a serem executados pelo

Gerenciador de Pacotes (Windows)
Figura 30 -Diretório onde são colocados os pacotes a serem executados pelo

Gerenciador de Pacotes (Linux).
O sistema lista os pacotes que estão dentro da pasta pkgs citada anteriormente, ordenando
por data. Escolha o pacote a ser executado.
- 25 -
Figura 31
OPÇÃO DE EXECUÇÃO AUTOMÁTICA DOS SCRIPTS
No processo de Instalação/Atualização Expressa do Sistema, logo após a escolha do

pacote, será exibido o Conteúdo do Pacote, conforme Figura 32. Caso o mesmo possua
arquivos de atualização de banco de dados, será exibida uma mensagem de alerta:
“Foram encontradas no pacote atualizações de Banco de Dados e/ou Dicionário de

Da
dos.
É extremamente recomendável que você tenha feito um BACKUP antes de
prosseguir.
Deseja prosseguir?”
Neste ponto se o usuário desejar cancelar o processo de Instalação/Atualização Expressa

do Sistema, bastará teclar a letra “N”, caso contrário teclará “S”
- 26 -
Figura 32
A opção, “Executar AUTOMATICAMENTE os scripts de banco de dados, sem solicitar

confirmacao de execucao?”, mostrada na Figura 32, permite visualizar as opções de cada
script, bem como confirmar ou não a execução do script em questão.
A execução desses scripts é realizada após a escolha do servidor, essa execução está
detalhada na seção intitulada “A execução de scripts”.
INSTALAÇÃO DO SERVIDOR DE APLICAÇÕES
No caso de uma instação nova será necessário instalar um servidor de aplicações, isso poderá
ser feito de duas formas:
Instalando o servidor de aplicações manualmente
A instalação manual de um servidor possui apenas dois passos: descompactação do arquivo do

servidor de aplicações e registro do mesmo.
Descompactar nos diretórios padrões:

Linux: /home/mgeweb
Windows: C:\Arquivos de programas\Sankhya
Uma vez descompactado bastará registrar o JBoss, conforme mostrado mais adiante através
da opção 4 do Menu principal, intitulada: [4] Registrar Servidor
- 27 -
Instalando o servidor de aplicações através de um pacote
Se o pacote que está sendo executado possuir um JBoss, o processo de descompactação e

registro do servidor de aplicações será feito seqüencialmente pelo Gerenciador, conforme
Figura 32, sendo solicitado uma path (caminho) para a instalação desse Jboss. Por padrão,
como foi citado, esse diretório será:
Linux: /home/mgeweb
Windows: C:\Arquivos de programas\Sankhya
Digitar um nome para o servidor de aplicações, como mostra também a Figura 33, que será
usado futuramente em algumas funcionalidades do sistema.
Figura 33
Para completar a instalação do servidor de aplicações informar a quantidade de memória que

deseja reservar para a Máquina Virtual Java. O mínimo requerido pelo sistema é 512MB.
Procedimento em servidores instalados e registrados
A instalação do servidor de aplicações é necessária apenas na instalação.
Se o sistema detectar a existência de pelo menos um servidor registrado, ele não solicitará
informações de registro para um novo JBoss, solicitará apenas o nome ou a confirmação do
servidor sugerido entre “[]”. Selecione o “Servidor de Aplicações” que deseja atualizar,
caso seja o informado entre as chaves “[]” teclar “Enter”, se não, digitar o nome do servidor
desejado.
- 28 -
Figura 34 - Seleção do Servidor de Aplicações.
Inicialização/Interrupção do Servidor de Aplicações
Faz-se conveniente esclarecer aqui como colocar o JBoss rodando e como parar as atividades
do mesmo, mas, vale ressaltar que estes são processos de pós configuração e deploy do
SankhyaW. Portanto, apenas após ter preenchido o JBoss através da execução do “Pacote de
Instalação/Atualização” e de ter configurado o JDK para que o JBoss funcione, é que será
necessário, de fato, colocá-lo em atividade.
Nota: entende-se por “deploy” o ato de descarregar os arquivos no servidor de aplicações,

respeitando os devidos locais de cada arquivo.
Em Windows o processo de inicialização do JBoss pode ser feito através da execução do

arquivo ‘run.bat’ que encontrasse dentro da pasta ‘bin’. A janela deve permanecer aberta,
conforme mostra a figura 35. Se o usuário desejar derrubar a aplicação ou reinicializá-la,
deverá fechar e abrir a janela, novamente.
Todas as informações exibidas nessa janela são também enviadas para os arquivos de log
dentro da pasta “…server/default/log/”.
- 29 -
Figura 35
O JBoss também pode ser inicializado como ‘Serviço do Windows’. Tal recurso torna-se
vantajoso em ambientes que trabalham com “Remote Desktop Services” (Terminal
Services), pois uma sessão de TS pode inicializar uma instância do JBoss e a mesma não
poderá ser derrubada por outros usuários e/ou sessões. Como serviço todos os usuários teriam
possibilidade de ‘visualizar’, ‘inicializar’, ‘parar’ ou ‘reinicializar’ o servidor.
A configuração da atividade do Jboss, como serviço, pode ser feita de forma simples pelo
‘Gerenciador de Pacotes’.
A partir do ‘Menu Principal’ do ‘Gerenciador de Pacotes’, o usuário poderá selecionar a opção 2
(Selecionar Servidor), selecionar o servidor (registrado) e escolher a opção [7] ‘Instalar
JBoss como servico do Windows’, com o nome JBoss Aplication Server, conforme ilustra a
figura 36.
A opção 8 ‘Exclui’ o serviço criado.
- 30 -
Figura 35
Em Linux o servidor de aplicações pode ser inicializado através do arquivo

“jboss_init_redhat.sh” que encontrasse na pasta ‘bin’ do JBoss, é necessário passar o
parâmetro “start” e também verificar a ‘permissão de execução dos arquivos’, como
mostra a figura 37.
Figura 36
O JBoss pode ser parado através do comando “kill -9 [nro_processo_JDK]”, para ver o
número do processo use o comando “ls | grep java” conforme mostra a figura 38.
A opção ‘grep’ é utilizada nesse caso para filtrar os processos.
- 31 -
Figura 37 – lista de processos
Configuração da conexão com o banco de dados
Para a execução de scripts de banco de dados, o SankhyaW Gerenciador de Pacotes

buscará dentro do JBoss as informações de conexão com o banco.
Essas informações podem ser inseridas ou editadas através da opção 2 que está detalhada
adiante, como [2] Selecionar Servidor.
Figura 39
Caso o servidor já possua o arquivo de configurações com o banco de dados, será exibida as
configurações encontrada no arquivo, conforme Figura 39. Se o usuário desejar editar essas
configurações deverá teclar a letra “S” e “Enter”, senão deverá apertar “N”. Na execução de
um pacote que contenha atualização para o banco e não exista o arquivo que guarda essas
informações, o Gerenciador solicitará os dados para criação do arquivo, conforme mostram as
Figura 40 e 41. Nessa situação tem-se que digitar a opção referente ao tipo do banco de
dados.
Em seguida se o SGBD for Oracle:
Digitar o IP do servidor de Banco de Dados;

Digitar o número da porta;
Digitar o nome do serviço;
Digitar o nome de usuário do Banco de Dados;
Para finalizar, digitar a senha do Banco de Dados (não aparecerá caracteres na tela)
- 32 -
Figura 40 - Inserindo as informações de conexão para um banco Oracle
Se o sistema de Gerenciamento de banco for MS SQL Server:

Digitar a instância;
Digitar o nome do banco de dados;
Digitar o usuário do banco de dados selecionado;
Para finalizar, digitar a senha do Banco de Dados (não aparecerão caracteres na tela)
- 33 -
Figura 41 - Inserindo as informações de conexão para um banco MS SQL Sever
Após inserir as informações, será exibida uma opção de teste de conexão através do qual
pode-se verificar se as informações estão corretas. Em caso de problemas com a conexão,
antes de repetir esse procedimento certificar-se que as informações estão corretas e foram
inseridas corretamente e/ou verificar se há comunicação com o servidor de banco de dados
dando um ping no IP.
A execução dos scripts
Se anteriormente, após selecionar um pacote a ser executado, o usuário tiver digitado “S”
para a opção “Executar AUTOMATICAMENTE os scripts de banco de dados, sem
solicitar confirmacao de execucao?”, os scripts serão executados de forma seqüencial e
sem interrupções conforme Figura 42.
- 34 -
Figura 42 - Execução de scripts automática e sem solicitação de confirmação
Se o usuário tiver optado pela confirmação individual dos scripts, ou seja, em “Executar
AUTOMATICAMENTE os scripts de banco de dados, sem solicitar confirmacao de
execucao?”, tiver escolhido “N”, será solicitado uma confirmação para cada script a ser
executado, conforme mostra Figura 43.
Figura 43
O menu mostrado na Figura 43 será exibido a cada script e através dele o usuário poderá
visualizar o script corrente através da opção 3 ou mesmo visualizar as informações do
cabeçalho do script através da opção 4.
A opção 5 roda o script corrente e desabilita esse menu para os próximos scripts.
Para executar o script e ver essas mesmas opções para o próximo script, utilizar a opção 1. É
possível também não executar e passar para o próximo script através da opção 2.
- 35 -
Erros comuns na execução dos scripts
Figura 44
Durante a execução de scripts podem ocorrer alguns erros, os mais comuns são intrínsecos a
problemas ou divergências entre o banco e os scripts. A Figura 33, mostra um exemplo, no
qual após a execução do script 146, o script de número 1 não pôde ser rodado e fazendo
com que seja escolhida uma dentre as 4 opções exibidas.
As opções dadas na Figura 44 são:

[1] Tentar novamente - nessa opção o script será rodado novamente.
[2] Continuar – Ignora o script corrente e passa para o próximo.
[3] Visualizar script – mostra o script que o Gerenciador está tentando executar, essa opção
é útil para auxiliar na detecção do problema.
[4] Abortar – Aborta todo o processo de Instalação/Atualização Expressa, dando “roll back”
nas operações efetuadas até aqui.
No exemplo da Figura 44, o problema é a criação de uma Foreing Key. Nessa situação essa
Constraint não pôde ser criada porque o script em questão referencia uma coluna que não é
Primary Key da tabela estrangeira. Deverão ser feitas as devidas verificações a fim de definir
se é a criação proposta pelo script que está errada ou se o problema é a ausência de uma
Primary Key na tabela estrangeira.
O SankhyaW Gerenciador de Pacotes faz verificações antes de executar a criação de um

objeto (PK, coluna, etc..). Antes de criar uma Primary Key, por exemplo, ele busca pelo
nome do “Objeto” que será criado. Porém, caso o objeto a ser criado exista com um nome
diferente, será exibida a mensagem de erro. Quando esse tipo de erro ocorre, torna-se
necessário averiguar qual o nome e a estrutura correta do objeto que está sendo criado, bem
como, se necessário, notificar as devidas pessoas com as causas do erro e/ou com sugestões.
Toda mensagem de erro deve ser analisada. Utilizar as informações fornecidas em “Detalhes
do erro” e a opção [3] Visualizar script, conforme mostrado na Figura 44.
- 36 -
A importação do Dicionário de Dados
Um dicionário de dados (do inglês data dictionary) é uma coleção de metadados que contêm
definições e representações de elementos de dados. As tabelas do dicionário de dados
guardam informações sobre as tabelas do sistema, tais informações são importadas da base
modelo do SankhyaW para um arquivo .xml que é incluído no .pkg , e assim, exportada
através do Gerenciador de Pacotes para a base que está sendo atualizada.
A mesagem “Scripts de Dicionário de Dados executados com sucesso!” indicará que a

atualização do dicionário de dados foi bem sucedidada.
Figura 45
- 37 -
O processo de instalação/atualização dos arquivos binários
Os arquivos binários é o resultado da compilação do código fonte do sistema, antes de efetuar

a atualização desses arquivos o Gerenciador buscará e efetuará, caso exista, o backup da
versão existente no servidor de aplicações. Veja Figura 46 abaixo:
Figura 46
A mensagem “Instalação dos binários realizada com sucesso!” indicará que a atualização
dos arquivos binários foi bem sucedida.
Erros durante a atualização dos arquivos binários
O erro mais comum na atualização dos arquivos binários do SankhyaW, são erro por conta de
permissão de acesso aos diretórios do SankhyaW Gerenciador de Pacotes e do JBoss.
Considerações finais sobre a opção de Instalação/Atualização Expressa
Os passos listados anteriormente são condicionados ao conteúdo do pacote de

Atualização/Instalação. Todas as possíveis situações do processo de Atualização/Instalação
Expressa foram retratadas.
Uma observação extremamente relevante é que cada pacote gerado é muito subjetivo.
Um pacote de atualização não servirá para uma nova instalação e principalmente, UM
PACOTE DESTINADO A UMA (NOVA) INSTALAÇÃO NÃO DEVE SER UTILIZADO EM
BASES QUE JÁ POSSUAM O SANKHYAW INSTALADO. DEVE-SE USAR UM PKG APENAS
PARA O PROPÓSITO QUE O MESMO FOI SOLICITADO.
Uma vez que um .pkg foi utilizado, deve ser removido do diretório pkgs do Gerenciador de
Pacotes para evitar que o mesmo seja executado novamente.
A mensagem “Instalação/atualização expressa concluída!” indicará que todo o processo

de Instalação/Atualização Expressa foi concluído com sucesso.
- 38 -
[2] SELECIONAR SERVIDOR
O SankhyaW Gerenciador de Pacotes oferece alguns recursos de interação com o servidor

de aplicações. Tais funcionalidades estão disponíveis através da opção [2] do menu principal
conforme Figura 47.
Figura 47
Imediata a escolha desta opção, será exibido todos os servidores que estejão registrados. O
usuário deverá digitar o nome do servidor da sua preferência ou caso o nome do servidor
esteja sugerido entrar em “[ ]” teclar Enter. Veja Figura 47:
Figura 45
- 39 -
A Figura 45 mostra as opções para o servidor que foi selecionado, as quais são detalhadas a
seguir:
[1] Iniciar Servidor – O propósito dessa opção é inicializar o servidor de aplicações. (Esta
funcionalidade ainda encontra-se em teste).
[2] Parar Servidor – O propósito dessa opção é matar os processos do servidor de

aplicações. (Esta funcionalidade ainda encontra-se em teste).
[3] Configurar Ambiente de Execução – ao selecionar essa opção será disponibilizado um

conjunto de opções para configuração do ambiente de execução conforme mostra a Figura
45.
Figura 46
Como mostra a Figura 46, tem-se como opções do “Ambiente de Execução” do servidor de
aplicações:
[1] Path da Máquina virtual Java – Permite alterar a VM utilizada que está sendo utilizada
pelo servidor de aplicações. O processo de configuração das variáveis de ambiente substitui
esta opção.
[2] Memória – Esta opção seta quantidade de memória que será usada pelo servidor de
aplicações.
[3] Voltar – retorna ao menu anterior como mostra a Figura 47.
- 40 -
Figura 47
De volta ao menu de opções, para o servidor escolhido, terminada a explanação sobre a

opção três (Configurar Ambiente de execução), temos então a opção 4:
[4] Configurar Banco de Dados – esta opção exibe um conjunto de recursos intrínsecos as
configurações de banco do servidor de aplicações. Ao optar por ela, serão exibidas as
configurações atuais, conforme a metade superior da Figura 48, bem como um conjunto de
opções.
Figura 48
Conforme mostra a Figura 48, temos então as seguintes opções:
[1] Editar configurações – esta opção permite redirecionar o banco para o qual a aplicação
do SankhyaW está apontando, a edição dessas configurações são feitas conforme os passos a
seguir:
- 41 -
1) O primeiro passo é a seleção do SGBD. Veja a Figura 49.
Figura 49
2) Em seguida se o SGBD for Oracle:

Digitar o nome do serviço;
Digitar o nome de usuário do Banco de Dados;
Para finalizar, digitar a senha do Banco de Dados (não aparecerão caracteres na tela)
Figura 50 - Inserindo as informações de conexão para um banco Oracle
- 42 -
Se o sistema de Gerenciamento de banco for MS SQL Server:

Digitar a instância;
Digitar o nome do banco de dados;
Digitar o usuário do banco de dados selecionado;
Para finalizar, digitar a senha do Banco de Dados (não aparecerá caracteres na tela)
Figura 51 - Inserindo as informações de conexão para um banco MS SQL Sever
[7] Instalar JBoss como serviço Windows (opção 2 >> 7) - Disponível apenas para
Windows. Permite criar um serviço do Windows para ‘Inicilizar’, ‘Parar’ ou ‘Reinicializar’ o
‘Servidor de Aplicações’. Este serviço pode ser desinstalado através da opção 8 deste mesmo
menu.
[8] Desinstalar JBoss como serviço do Windows (opção 2 >> 8) - Opção habilitada
somente para Windows. Retira dos serviços Windows o JBoss Service Wrapper.
- 43 -
________________________________________________________
[3] Listar Servidores registrados
Esta opção lista os servidores que foram registrados, conforme Figura 52.
Figura 52
_________________________________________________________________
[ 4 ] Registrar Servidores
Existem várias rotinas do SankhyaW Gerenciador de Pacote que efetuam tarefas ligadas ao
servidor de aplições no qual o SankhyaW está rodando. Para facilitar, o processo é feito
utilizando o nome do servidor, dessa forma, o nome será associado a path do servidor.
Para registrar servidores selecione a opção ”[4] Registrar Servidor” do menu principal,
conforme é mostrado na Figura 53.
Figura 53
- 44 -
Na seqüência serão solicitados o nome e a path do servidor.

A mensagem “Servidor registrado com sucesso!” indicará que o processo do registro foi
concluído com sucesso.
Por último, no menu principal, a “[5]Sair” finaliza aplicação fechando a janela da aplicação do
Windows ou voltando ao prompt de comando caso o ambiente seja Linux.
- 45 -

Manual de Instalação e Atualização SankhyaW

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual de Instalação e Atualização SankhyaW

Enviado por

Direitos autorais:

Formatos disponíveis

MANUAL DE INSTALAÇÃO E

SANKHYA GESTÃO DE NEGÓCIOS

SANKHYA Business Partners

Instalação do Servidor de aplicações............................................................................................................26

Resumidamente a aplicação é constituída por arquivos binários, resultado da compilação dos

O papel do SankhyaW Gerenciador de Pacotes é efetuar o deploy (distribuição dos arquivos

 Instalador do JDK (Java Developer Kit) (www.sun.com);

Se houver um JDK instalado na máquina verificar a compatibilidade da versão do mesmo com

SOBRE OS DIRETÓRIOS PADRÕES

É extremamente recomendável seguir os padrões de diretórios segundo este manual,

Em ambiente Windows o Gerenciador de Pacotes será instalado no diretório C:\Arquivos

INSTALAÇÃO DO SERVIDOR DE APLICAÇÕES

O JBoss é um servidor de aplicações baseado na plataforma JEE e portável tanto para

Disponibilizado normalmente sob formato Zip sua instalação resume-se apenas na

Como no SankhyaW todo o processo de atualização é feito através do SankhyaW

O registro é a forma de vincular um servidor de aplicações às tarefas do ‘Gerenciador de

No processo de instalação do SankhyaW, a instação do JBoss é feita através da

No processo de descompactação manual, após descompactar, será preciso registrar o servidor

SANKHYAW EM AMBIENTE LINUX

IMPLANTAÇÃO E ATUALIZAÇÃO DO SISTEMA SANKHYAW EM AMBIENTE LINUX

Em suma, o servidor de aplicações e o SankhyaW Gerenciador de Pacotes devem estar

pwd – mostra o caminho do diretório corrente.

ls -l – lista arquivos de forma detalhada do diretório corrente.

Seguindo o processo, executaremos a instalação do JDK, conforme a figura abaixo:

Leia atentamente a licença de uso do JDK.

outras, bastará incluir no arquivo /home/mgeweb/.bash_profile a variável seguida de seu

Abrindo o arquivo .bash_profile do usuário mgeweb:

Inserindo a variável e o valor:

Salvar o arquivo. As alterações no .bash_profile só serão válidas à partir do próximo logon.

INSTALAÇÃO DO SANKHYAW GERENCIADOR DE PACOTES

O SankhyaW Gerenciador de Pacotes, é disponibilizado em um arquivo compactado no

O usuário deverá verificar sempre se a versão do Gerenciador de Pacotes é a mais atual e se

Feita a extração do SankhyaW Gerenciador de Pacotes, todos os arquivos estarão dentro

Utiliza-se o comando pwd para mostrar o diretório corrente, estamos em

SANKHYAW EM AMBIENTE WINDOWS

INSTALAÇÃO DO JDK EM AMBIENTE WINDOWS

Na figura 10 apresenta o instalador do SankhyaW Gerenciador de Pacotes e do JDK.

O primeiro a ser instalado é o JDK, é necessário verificar se a versão é compatível com o

Selecionar as ferramentas desejadas e clicar em Next, como mostra a Figura 13.

Aguardar enquanto o JDK é instalado no computador, como mostra a Figura 14.

Selecionar as opções desejadas e clicar em Next, como mostra a Figura 16.

Aguardar enquanto o JRE é instalado no computador, como mostra a Figura 17.

Caso desejar, registrar o JDK ou clique em Finish para concluir a instalação.

CONFIGURAÇÃO DAS VARIÁVEIS DE AMBIENTE EM WINDOWS

Clicar na aba “Avançado” e em seguida em “Variáveis de ambiente”.

CONFIGURAÇÃO DA VARIÁVEL DE AMBIENTE JAVA_HOME

No sistema operacional, na janela intitulada “Variáveis de ambiente”, clicar em “Nova”, em

%JAVA_HOME%\bin que seria o mesmo que inserir o caminho “c:\Arquivos de

INSTALAÇÃO DO SANKHYAW GERENCIADOR DE PACOTES (WINDOWS)

A Figura 23 mostra a tela inicial da instalação, clicar em “Avançar” para continuar.

A instalação padrão é feita no diretório sugerido “C:\Arquivos de programas\SankhyaW

Aguardar enquanto o Gerenciador de Pacotes é instalado no computador como mostra a

Quando a instalação for concluída, clicar em “Terminar” conforme a Figura 27.

UTILIZAÇÃO DO GERENCIADOR DE PACOTES

O SankhyaW Gerenciador de Pacotes é uma ferramenta de execução em modo texto, o

A utilização do Gerenciador de Pacotes é igual para o Windows e Linux, mudando apenas o

OS DIRETÓRIOS DO SANKHYAW GERENCIADOR DE PACOTES

A partir do diretório principal do SankhyaW Gerenciador de Pacotes são encontrados

O diretório backup é usado pelo gerenciador para armazenar os arquivos binários da

No diretório conf ficam arquivos de configurações do Gerenciador, tais como informações de

O diretório .install4j possui os arquivos de instalação do SankhyaW Gerenciador de

Figura 28 - Menu Principal do SankhyaW Gerenciador de Pacotes

[1] INSTALAÇÃO/ATUALIZAÇÃO EXPRESSA DO SISTEMA

O opção de Instalação/Atualização Expressa consiste na execução de um pacote de