SAS Servidor de Acessos Sankhya

Transcrição

1 1 / 5 1) Pré-requisitos 2) Descompactação 3) Configuração 4) Inicialização/Finalização do Servidor 5) O utilitário SASConsole 1 - Pré-requisitos O SAS é uma aplicação desenvolvida sob a plataforma Java, portanto necessita do ambiente de execução 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 disponível. A versão mínima do JRE ( Java Runtime Environment) para a correta execução do SAS é a Em casos onde o banco de dados Oracle 8i ou posterior estiver instalado, já vai existir uma instalação do JRE, se a versão for ou posterior não será necessário atualização, geralmente será a versão e deverá ser atualizada. O JRE pode ser encontrado em Nesta página existe um link com o texto Download J2SE JRE o qual o guiará ao download do JRE correto. 2 - Descompactação O arquivo de instalação do SAS é compactado no formato ZIP padrão conservando a path original dos arquivos, portanto quando descompactado será gerada a seguinte estrutura de diretórios: /sas (diretório raiz da instalação) /bin (utilitários de inicialização e parada) /conf (arquivos de configurações do SAS e banco de dados) /lib (pacotes de bibliotecas e drivers de banco de dados) /licença (pasta onde ficará o arquivo de licença) /log (pasta onde o servidor escreve os log de execução) Quando descompactado, por exemplo, na pasta \opt\sankhya será criada a pasta \opt\sankhya\sas a qual é a pasta raiz da instalação do SAS. A estrutura de diretórios do SAS deve ser respeitada, e os arquivos não devem ser removidos para outras pastas, pois assim a aplicação não conseguirá encontrálos.

2 2 / Configuração A configuração do SAS é muito simples, basicamente iremos criar 1 variável de ambiente e editar 2 arquivos de configuração, um para o banco de dados e outro para o SAS propriamente dito. Deve ser criada uma variável de ambiente com o nome SAS_HOME cujo valor deve ser a path para o diretório de instalação do SAS, no exemplo citado acima este path seria \opt\sankhya\sas. Vale lembrar que sem esta variável devidamente nomeada e com o conteúdo correto o servidor não será inicializado. O primeiro arquivo a configurar é o do banco de dados, este está localizado na pasta conf da instalação do SAS. Nesta pasta temos 3 arquivos com a extensão.map, um para cada tipo de banco de dados compatível com o MGE/Mitra: interbase.map mssql.map oracle.map (compatível com Interbase e Firebird) (MS-SQL Server) (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 configuração deste arquivo é basicamente uma linha, a qual irá informar ao SAS como se conectar ao banco de dados. Todos os arquivos têm exemplos de como configurar esta linha de conexão. Ainda na pasta conf, outro arquivo a ser editado é o sas.cfg onde são informados os parâmetros para execução do SAS. Os parâmetros que deverão ser editados neste arquivo são: 1 - db.vendor Define o tipo de banco de dados em uso, os possíveis valores são: oracle mssql interbase Esses valores são sensitivos a caixa baixa e alta, portanto não existe um tipo Oracle ou MSSQL. 2 db.username Usuário do banco de dados.

3 3 / 5 3 db.password Senha do banco de dados. 3.1 db.password.cript *Senha do banco de dados criptografada (opcional) Todos os parâmetros devem ser definidos sem o uso de aspas, segue um exemplo: db.vendor = oracle db.username = jose db.password = masterkey db.password.cript = W-O-S--42 (apenas letras MAIÚSCULAS) Os outros parâmetros deste arquivo podem ser ignorados, no entanto não devem ser removidos. As licenças dos módulos adquiridos pelo parceiro SANKHYA são definidas no arquivo 'licenca.dat', este arquivo é gerado através do MGE-Serviço Web por usuários habilitados para tal, tipicamente o departamento financeiro ou BPs. Portanto o mesmo não faz parte da instalação padrão 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 atualização na licença do parceiro SANKHYA em decorrência da aquisição de novos módulos ou renegociação do contrato, o servidor de licenças não precisará ser reinicializado ( caso ele esteja em execução, é claro ), bastando somente copiar o novo arquivo para a pasta de licenças, assim o SAS se atualizará automaticamente. Vale lembrar que o arquivo licenca.dat não deverá ser renomeado, pois o SAS procura exatamente por este nome. * A senha criptografada é obtida através do executável "gerar_senha_licence.dat.exe", onde efetua-se a geração da licença (LICENSE.DAT - mesmo arquivo utilizado pelo MGE); o conteúdo deste arquivo gerado, é a senha criptografada. Importante: Estas são apenas as informações iniciais sobre a senha criptografada. Todos os detalhes desta configuração, podem ser visualizados no documento "MANUAL DE INSTALAÇÃO ORACLE 10G > 20º Passo - Configurar JBoss para utilizar senha criptografada no padrão do MGE", disponível no site downloads.sankhya.

4 4 / Inicialização/Finalização do Servidor Feitas as configurações o servidor já pode ser inicializado. Vá até a pasta bin da instalação do SAS, lá existem 4 arquivos utilitários para lançar e finalizar o servidor de acessos, são eles: run.bat stop.bat run.sh stop.sh (batch file win32 para inicializar o SAS) (batch file win32 para finalizar o SAS) (Shell script Linux para inicializar o SAS) (Shell script Linux para finalizar o SAS) Como a saída do SAS é redirecionada para o arquivo de log do SAS <SAS_HOME>/log/server.log a sua inicialização será silenciosa, sem nenhuma saída de tela. Logo após a inicialização, os usuários poderão logar nos sistemas normalmente. Problemas de inicialização podem ser detectados no arquivo de log. Para parar o SAS basta ir à pasta bin da instalação e executar a shell stop.sh ( Linux ) ou a batch stop.bat ( Win32 ). É importante lembrar que, todos os usuários logados nos sistemas serão cancelados quando da parada do SAS. Portanto se algum usuário estiver fazendo algo importante, este deverá ser avisado da parada para que possa salvar o seu serviço. Para constar como informação, a porta usada pelo SAS é a 10050, e não temos registros de aplicações servidoras que usam esta porta como default, portanto não deverá haver problemas com conflitos de portas. 5 - O utilitário SASConsole O SASConsole é uma aplicação GUI onde se pode monitorar o estado de execução do SAS assim como executar alguns comandos. Esta aplicação 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 aplicação é gráfica a mesma não deve ser executada no servidor, pois a maioria dos servidores não tem recursos gráficos instalados (no caso de servidores Linux), portanto o pacote sas.jar deverá ser copiado para uma máquina desktop ( Windows ou Linux com ambiente gráfico ) que tenha o JRE instalado. Esta máquina provavelmente será a máquina do responsável pelo sistema na empresa, sendo desaconselhada a disponibilidade desta aplicação para outros usuários. Para executar o SASConsole basta abrir uma tela de prompt de comando (WIN32) ou uma sessão de console (Linux) e executar o comando:

5 5 / 5 java -cp sas.jar console.sasconsole O nome da aplicação é sensitivo a caixa baixa e alta, portanto, java -cp sas.jar Console.Sasconsole não irá funcionar! A aplicação em si é muito simples. No menu 'arquivo' existem 3 opções : 1 - Conexão Abre uma caixa de texto para que o usuário 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 execução no endereço o console estará conectado a ele. 2 Usuários Logados Abrirá uma tela com uma estrutura em árvore onde serão mostradas informações sobre o servidor, detalhes da licença e usuários logados. Alguns comandos poderão ser executados em alguns elementos da árvore quando selecionados, para tanto deverá ser usado o menu de contexto ( click com o botão direito do mouse sobre o elemento ). Sempre que for executado algum comando, o botão atualizar deverá ser usado. Este botão fica na parte inferior esquerda da tela de informações. 3 Sair Fecha a aplicação.