O manual a seguir contém as instruções para a instalação do Sankhya OM para Banco de Dados Oracle e SQL Server em Ambiente Windows.
Download de Arquivos para a Aplicação do Sankhya OM
Procedimento para Banco de Dados Oracle
Configuração para Banco de Dados Oracle
Configuração para Banco de Dados SQL Server
Instalação do pacote Sankhya OM
Configuração de memória do Wildfly
Inicialização automática do Wildfly Produção (Serviço do Windows)
Conexão da aplicação Sankhya OM
Introdução
O papel do Sankhya OM 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 Sankhya OM 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.
Referente aos diretórios padrões utilizados, recomendamos que siga os descritos neste manual para agilizar futuras buscas por arquivos a fim de realizar manutenções 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. Já em ambiente Windows o Gerenciador de Pacotes será instalado no diretório "C:\Arquivos de Programas\SankhyaOM" Gerenciador de Pacotes e o servidor de aplicações será colocado em "C:\Arquivos de Programas\Sankhya\[JBOSS]".
O JBoss é um servidor de aplicações baseado na plataforma JEE e portável tanto para Windows quanto para Linux. Usualmente, este será disponibilizado sob o formato Zip e sua instalação irá se resumir apenas na descompactação do arquivo, tanto para Linux quanto para Windows.
No Sankhya OM todo o processo de atualização é realizado por meio do Sankhya OM Gerenciador de Pacotes, além da descompactação é necessário um registro do servidor.
O Sankhya OM ficará sob propriedade do usuário mgeweb, desta forma, a atualização e manipulação do sistema não dependerá da disponibilização da senha do root que é usuário com privilégios de administrador do sistema operacional. Logo, o servidor de aplicações e o Sankhya OM Gerenciador de Pacotes deverão estar na home mgeweb.
Download de Arquivos para a Aplicação do Sankhya OM
Download do Wildfly: http://downloads.sankhya.com.br/repositorio/wildfly
Para baixar a última versão disponível do download do JDK8, Gerenciador de Pacotes, e download do pacote com "Sankhyaom_x.xx.xxxxx.pkg" acesse o link: http://downloads.sankhya.com.br/
Nota: O download do arquivo JDK8 deverá estar de acordo com a versão do Sistema Operacional.
Procedimento para Banco de Dados Oracle
Para a instalação, deve-se conectar no Banco de Dados Oracle via sqlplus;
Para verificação do parâmetro opens_cursors insira o comando:
SQL> show parameter open_cursors
NAME TYPE VALUE
----------------------------------- ----------- ------------------------------
open_cursors integer 300
Ajustar parâmetros do Oracle:
SQL> alter system set open_cursors=2000;
System altered.
SQL> exit
Observação: Caso este retorne o valor <2000, efetue o procedimento de Ajustar parâmetros do Oracle, sendo este :
[oracle@oracletestes ~]$ sqlplus "/as sysdba"
1 - Adição da variável JAVA_HOME
Para a execução desta, deve-se clicar no botão direito do mouse do seu computador e em seguida, e selecionar as opções de acordo com a ordem exibida a seguir:
Propriedades > Configurações Avançadas do Sistema > Variáveis de ambiente;
Posteriormente, na aba "Variáveis do sistema", clique na opção "Novo" .
Veja o exemplo quando o Windows possui 64bits:
Observação: A versão do Java irá variar conforme a instalação, como por exemplo, jdk1.8.0_xxx C:Program Files\Java\jdk1.8.0_152
Windows 32 bits:
2 - Instalação do Gerenciador de Pacotes
Para esta etapa, primeiramente execute a descompactação do arquivo pkg-man_windows_x_xxx.zip localizado na pasta c:\sankhya
Execute a instalação do gerenciador de pacotes;
Quando a instalação for finalizada, clique na opção "Avançar" e instale este na pasta c:\sankhya;
Aguarde a cópia dos arquivos e a sua finalização;
3 - Instalação do Wildfly teste e treina
Execute a descompactação do arquivo Wildfly_10.0.0_Sankhya_mod_XXXX.zip em c:\sankhya, e a pasta wildfly_producao será criada;
Duplique a pasta wildfly_producao mude os nomes para wildfly_teste e wildfly_treina.
4 - Execução do Gerenciador de Pacotes
Selecione o botão "Iniciar" do windows e entre em "Todos os Programas\Sankhya OM Gerenciador de Pacotes" e clique em "Gerenciador de Pacotes";
Em seguida, cole as DLL na pasta C:\windows\SysWOW64
Configuração do Wildfly
Para este, faz-se necessário realizar o procedimento abaixo para as bases de Produção, Teste e Treina.
No início da instalação, tem-se a tela:
Para este, digite a opção 4;
Em seguida digite o servidor de aplicações, sendo este wildfly_producao;
O diretório de instalação neste exemplo será C:\sankhya\wildfly_producao.
Configuração para Banco de Dados Oracle
Para realizar as etapas no seu Banco de Dados Oracle, será necessário executar o procedimento descrito abaixo para Bases de Produção, teste e treina.
Para o início das configurações, tem-se as opções abaixo:
Para esta, digite o número 2 referente à opção "Selecionar Servidor";
Em seguida, será exibida as opções para a seleção do Servidor de Aplicações, tem-se estas:
- [1] wildfly_produção;
- [2] wildfly_teste;
- [3] wildfly_treina
- [4] Retonar ao menu anterior.
Digite a opção 1;
Para o servidor selecionado, será exibido as opções:
e para estas você deverá digitar a opção 1;
Posteriormente, teremos as opções:
- [1] Oracle;
- [2] Ms SQL Server (Driver JTDS);
- [3] Ms SQL Server (Driver Ms);
- [4] Para saber mais sobre JTDS e Ms.
Selecione o Banco de Dados correspondente à opção [1] Oracle;
Digite o IP do servidor correspondente. Para este, observe o exemplo:
192.168.0.148
Ou digite o localhost caso o servidor de aplicação estiver junto ao servidor de Banco de Dados.
Depois, digite o número da porta;
Pra o nome do serviço digite XE, neste as letras sempre deverão ser maiúsculas.
Em seguida insira o usuário do Banco de Dados. O usuário SANKHYA poderá ser digito com letras maiúsculas ou minúsculas.
Digite a senha, e para a pergunta que será exibida em seguida digite S.
Nota: Caso ocorra um erro no teste de conexão, faça a revisão das suas configurações.
Configuração para Banco de Dados SQL Server
Para bases de Produção, teste e treina, o procedimento abaixo deverá ser realizado.
No início das configurações você terá as opções:
- [1] Instalação/atualização expressa do Sistema;
- [2] Selecionar Servidor;
- [3] Listar Servidores registrados;
- [4] Registrar Servidor;
- [5] sair.
Digite o número 2, correspondente à opção Selecionar Servidor;
Selecione o Servidor de Aplicação 1.
Em seguida, para as configurações para o servidor wildfly_producao teremos:
Insira o número 1;
Depois escolha um Banco de Dados;
Para este digite 2 ou 3;
Observação: A opção 2 utilizará drivers do Java, destacamos que esta deverá ser uma preferência de uso. Na opção 3, será utilizado os drivers da microsoft.
Posteriormente digite o IP do servidor do Banco de Dados. Vejamos o exemplo para a sua inserção:
192.168.0.148
ou localhost, caso o servidor de aplicação esteja junto ao servidor do Banco de Dados.
Digite o número da porta e o Nome da Instância.
Nota: A instância do SQL Server deverá ser informada apenas se esta estiver nomeada.
Em seguida, digite o nome da base do Banco de Dados do SQL Server. Para tal, temos por exemplo:
SANKHYA_PROD
Faça a inserção do usuário SANKHYA, este poderá conter letras maiúsculas ou minúsculas.
Depois de digitar a senha, responda a pergunta a ser exibida com a letra S.
Observação: Caso ocorra erro no teste de conexão, execute a revisão das configurações.
Instalação do pacote Sankhya OM
O procedimento abaixo será necessário para as bases de Produção, teste e treina.
Para o inicio do procedimento de instalação, teremos as opções:
- [1] Instalação/atualização expressa do Sistema;
- [2] Selecionar servidor;
- [3] Listar servidores registrados;
- [4] Registrar servidor;
- [5] Sair.
Digite 1 referente à Instalação/Atualização Expressa do Sistema, digite S para realizar a atualização deste;
Para os servidores registrados, será disponibilizado as opções:
- [1] wildfly_producao;
- [2] wildfly_teste;
- [3] wildfly_treina;
- [4] Retornar ao menu anterior.
Digite a opção 1 para o servidor de aplicação;
Em seguida, insira a opção 1 para o Pacote de Atualização;
Depois você verá que o Gerenciador exibirá mensagens o informando que o processo de atualização foi inicializado.
Nota: Caso ocorra algum erro na instalação do pacote, efetue a verificação nos logs do Gerenciador de pacotes C:\Sankhya\sankhyaOM_gerenciador_de_pacotes\log\package-manager.log.
Configuração da Porta Wildfly
Será necessário realizar o procedimento abaixo para as bases de Produção, teste e treina.
Das opções a serem disponibilizadas acima, digite a opção 2;
Referente à Seleção do Servidor de Aplicações, tem-se:
Para tal, digite opção 1.
Logo, teremos:
Importante: Não utilize a porta 8080.
Por padrão Sankhya, pode-se utilizar as portas:
- Porta 8180 para Base Produção;
- Porta 8280 para Base Teste;
- Porta 8380 para Base Treina.
Configuração de memória do Wildfly
Primeiramente, deve-se selecionar o servidor, para tal ação, digite 2 para a seleção da opção a que refere-se este número;
Em seguida, você deve selecionar um Servidor de Aplicação, portanto digite o número 1 da opção "wildfly_producao".
Para esta etapa digite o número 7, a que refere-se à opção de Configuração de Memória;
Referente ao Ambiente de Execução desta configuração, digite o número 1, a que corresponde ao da opção Editar configurações de memória (XMX e XMS).
Em seguida, tem-se:
Referente a esta etapa, destacamos que a quantidade memória inicial e máxima do Wildfly deverão ser menores que a disponível no sistema operacional. A recomendável que considere a quantidade memória utilizada por outros processos na máquina, inclusive na sistema operacional.
Inicialização automática do Wildfly Produção (Serviço do Windows)
Esta opção fará o registro do wildfly como serviço do Windows para inicialização automática.
Para o início desta, tem-se as opções:
- [1] Instalação/atualização expressa do Sistema;
- [2] Selecionar Servidor;
- [3] Listar Servidores registrados;
- [4] Registrar Servidor;
- [5] Sair.
Para tal, digite a opção 2.
Selecione a opção 1 referente ao Servidor de Aplicação wildfly_producao;
Posteriormente, teremos:
Digite a opção 9;
Inicialização do Wildfly
Para abrir os serviços do windows, abra o executar e digite services.msc
Inicialize os serviços wildfly_producao, wildfly_teste e wildfly_treina;
Para tal ação, clique na aba "Logon";
Em seguida pesquise o administrador em "Digite o nome do objeto a ser selecionado" e clique em "Verificar nomes";
Digite a senha da conta e clique em "Aplicar".
Posteriormente, clique com o botão direito no serviço de cada base em "Iniciar";
Nota: Certifique-se de verificar se o logon estava como administrador.
Conexão da aplicação Sankhya OM
Para esta etapa você deverá abrir seu navegador, e para um melhor desempenho sugerimos o Google Chrome como navegador padrão para solução Java. deve-se então, alterar a porta configurada para seu respectivo ambiente a que deseja-se conectar. Vejamos o exemplo:
- Produção: http://ipdoservidor:8180/mge
- Teste: http://ipdoservidor:8280/mge
- Treina: http://ipdoservidor:8380/mge
Observação: Caso a aplicação WEB não seja exibida, certifique-se que o wildfly foi inicializado, caso contrário poderá ter acontecido um erro ao iniciar a aplicação e será necessário verificar o log.
Quando o login for efetuado no Sankhya OM pela primeira vez, uma licença será solicitada.
Assim, acesse o Sankhya Place por meio do sistema Sankhya ou entrando em uma página da web, e busque pela "Chave de Cliente" disponibilizada:
Em seguida, retorne na área do cliente e clique em "Administração", logo selecione a tela Administração do Servidor.
Na aba "Autorização de Acesso", campo "ID do Cliente:" copie a chave do cliente a clique em "Salvar":
Navegue pelo Sankhya OM em telas do cliente para verificar se não há erros no sistema. Como nas telas de Vendas e Compras.
No Sankhya OM, faça a alteração da senha.
Realize o acesso ao WPM por meio do endereço do Sankhya OM adicionando a extensão /wpm ao final do endereço na barra de endereço do navegador. Ao abrir este, ficará como http://endereço do skw/wpm.
Quando você acessar o wpm, este estará como o exemplo http://ipservidor:8180/wpm
Caso não seja possível executar a atualização pelo WPM, na aba "Configurações", na seção "Opções" desmarcar a opção "Utilizar Repositório Alternativo." e faça a atualização manualmente.
Faça o download do arquivo em http://downloads.sankhya.com.br/ e copie para a pasta C:\sankhya\SankhyaOM Gerenciador de Pacotes\pkgs e execute o Gerenciador de pacotes.
Posteriormente, informe o Servidor de Aplicação em que será executado o pacote de atualização do WPM. O sistema irá solicitar que o usuário realize as configurações de conexão com o Banco de Dados.
Caso esse servidor já esteja configurado, o sistema irá solicitar ao usuário que o mesmo confirme essa configuração.
Veja também:
Comentários
0 comentário
Por favor, entre para comentar.