SAS Servidor de Acessos SANKHYA

Manual de instalao 1) Pr-requisitos 2) Descompactao 3) Configurao 4) Inicializao/Finalizao do Servidor 5) O utilitrio SASConsole 1 Pr-requisitos :
O SAS uma aplicao desenvolvida sob a plataforma Java, portanto necessita do ambiente de execuo Java instalado e devidamente configurado. O SAS foi testado nas plataformas Linux e Win32, mas ser executado em qualquer plataforma que se tenha uma JRE disponvel. A verso mnima do JRE ( Java Runtime Environment) para a correta execuo do SAS a 1.4.0. Em casos onde o banco de dados Oracle 8i ou posterior estiver instalado, j vai existir uma instalao do JRE, se a verso for 1.4.0 ou posterior no ser necessrio atualizao, geralmente ser a verso 1.3.1 e dever ser atualizada. O JRE pode ser encontrado em http://java.sun.com/j2se/1.4.2/download.html Nesta pgina existe um link com o texto Download J2SE JRE o qual o guiar ao download do JRE correto.

2 Descompactao :
O arquivo de instalao do SAS compactado no formato ZIP padro conservando a path original dos arquivos, portanto quando descompactado ser gerada a seguinte estrutura de diretrios : /sas /bin /conf /lib /licenca /log ( diretrio raiz da instalao ) ( utitlitrios de inicializao e parada ) ( arquivos de configuraes do SAS e banco de dados ) ( pacotes de bibliotecas e drivers de banco de dados ) ( pasta onde ficar o arquivo de licena ) ( pasta onde o servidor escreve os log de execuo )

Quando descompactado, por exemplo, na pasta \opt\sankhya ser criada a pasta \opt\sankhya\sas a qual a pasta raiz da instalao do SAS. A estrutura de diretrios do SAS deve ser respeitada, e os arquivos no devem ser removidos para outras pastas, pois assim a aplicao no conseguir encontr-los.

3 Configurao :
A configurao do SAS muito simples, basicamente iremos criar 1 varivel de ambiente e editar 2 arquivos de configurao, um para o banco de dados e outro para o SAS propriamente dito. Deve ser criada uma varivel de ambiente com o nome SAS_HOME cujo valor deve ser a path para o diretrio de instalao do SAS, no exemplo citado acima este path seria \opt\sankhya\sas . Vale lembrar que sem esta varivel devidamente nomeada e com o contedo correto o servidor no ser inicializado. O primeiro arquivo a configurar o do banco de dados, este est localizado na pasta conf da instalao do SAS. Nesta pasta temos 3 arquivos com a extenso .MAP , um para cada tipo de banco de dados compatvel com o MGE/Mitra : interbase.map ( compatvel com Interbase e Firebird ) mssql.map ( MS-SQL Server ) oracle.map ( Oracle ) Obviamente, dever ser editado somente o arquivo do tipo de banco de dados no qual o SAS ser usado, os outros podem ser ignorados. A configurao deste arquivo basicamente uma linha, a qual ir informar ao SAS como se conectar ao banco de dados. Todos os arquivos tm exemplos de como configurar esta linha de conexo. Ainda na pasta conf ,outro arquivo a ser editado o sas.cfg onde so informados os parametros para execuo do SAS. Os parametros que devero ser editados neste arquivo so : 1 - db.vendor Define o tipo de banco de dados em uso, os possiveis valores so : oracle mssql interbase Esses valores so sensitivos a caixa baixa e alta, portanto no existe um tipo Oracle ou MSsql.

2 db.username Usurio do banco de dados. 3 db.password Senha do banco de dados. Todos os parmetros devem ser definidos sem o uso de aspas, segue um exemplo : db.vendor = oracle db.username = jose db.password = masterkey Os outros parmetros deste arquivo podem ser ignorados, no entanto no devem ser removidos. As licenas dos mdulos adquiridos pelo parceiro SANKHYA so definidas no arquivo 'licenca.dat', este arquivo gerado atravz do MGE-Servio Web por usurios abilitados para tal, tipicamente o departamento financeiro ou BPs. Portanto o mesmo no faz parte da instalao padro do SAS. Este arquivo dever ser copiado para a pasta <SAS_HOME>/licenca onde o SAS poder fazer a leitura do mesmo. Caso haja alguma atualizao na licena do parceiro SANKHYA em decorrncia da aquisio de novos mdulos ou renegociao do contrato, o servidor de licenas no precisar ser reinicializado ( caso ele esteja em execuo, claro ), bastando somente copiar o novo arquivo para a pasta de licenas, assim o SAS se atualizar automticamente. Vale lembrar que o arquivo licenca.dat no dever ser renomeado, pois o SAS procura exatamente por este nome.

4 - Inicializao/Finalizao do Servidor :
Feitas as configuraes o servidor j pode ser inicializado. V at a pasta bin da instalao do SAS, l existem 4 arquivos utilitrios para lanar e finalizar o servidor de acessos, so eles : run.bat ( batch file win32 para inicializar o SAS ) stop.bat ( batch file win32 para finalizar o SAS ) run.sh ( Shell script Linux para inicializar o SAS ) stop.sh ( Shell script Linux para finalizar o SAS ) Como a sada do SAS redirecionada para o arquivo de log do SAS <SAS_HOME>/log/server.log a sua inicializao ser silenciosa, sem nenhuma sada de tela. Logo aps a inicializao, os usurios podero logar nos sistemas normalmente. Problemas de inicializao podem ser detectados no arquivo de log. Para parar o SAS basta ir pasta bin da instalao e executar a shell

stop.sh ( Linux ) ou a batch stop.bat ( Win32 ). importante lembrar que, todos os usurios logados nos sistemas sero cancelados quando da parada do SAS. Portanto se algum usurio estiver fazendo algo importante, este dever ser avisado da parada para que possa salvar o seu servio. Para constar como informao, a porta usada pelo SAS a 10050 , e no temos registros de aplicaes servidoras que usam esta porta como default, portanto no dever haver problemas com conflitos de portas.

5 - O utilitrio SASConsole :
O SASConsole uma aplicao GUI onde se pode monitorar o estado de execuo do SAS assim como executar alguns comandos. Esta aplicao faz parte do pacote de runtime do SAS , arquivo sas.jar, o qual pode ser encontrado na pasta de bibliotecas do SAS em <SAS_HOME>/lib . Como esta aplicao grfica a mesma no deve ser executada no servidor, pois a maioria dos servidores no tem recursos grficos instalados ( no caso de servidores Linux ) , portanto o pacote sas.jar dever ser copiado para uma mquina desktop ( Windows ou Linux com ambiente grfico ) que tenha o JRE 1.4 + instalado. Esta mquina provavelmente ser a mquina do responsvel pelo sistema na empresa, sendo desaconselhado a disponibilidade desta aplicao para outros usurios. Para executar o SASConsole basta abrir uma tela de prompt de comando (WIN32) ou uma sesso de console (Linux) e executar o comando : java -cp sas.jar console.SASConsole O nome da aplicao sensitiva a caixa baixa e alta, portanto java -cp sas.jar Console.Sasconsole no ir funcionar ! A aplicao em s muito simples. No menu 'arquivo' existem 3 opes : 1 - Conexo Abre uma caixa de texto para que o usurio entre com o IP do servidor de acessos. Informado o IP, pressione ENTER para finalizar. Se o IP estiver correto e o SAS estiver em execuo no endereo o console estar conectado ele. 2 Usurios Logados Abrir uma tela com uma estrutura em rvore onde sero mostrados informaes sobre o servidor, detalhes da licensa e usurios logados. Alguns comandos podero ser executados em alguns elementos da rvore quando selecionados, para tanto dever ser usado o menu de contexto ( click com o boto direito do mouse sobre o elemento ). Sempre que for executado algum comando, o boto atualizar dever ser usado. Este boto fica na parte inferior esquerda da tela de informaes. 3 Sair

Fecha a aplicao.