1. Objetivo

Este manual tem como objetivo fornecer os passos necessários para instalação e configuração do aplicativo Laboratório Offline Server. As instruções aqui apresentadas contemplarão desde a

instalação dos softwares necessários, como o SDK Java e Servidor de Aplicações JBoss 6.1.0, bem como a implantação da aplicação nestes ambientes, em plataforma Windows.

2.  Instalação da JDK

Com a versão 1.6 (64 bits) do instalador à disposição, proceda com a execução do mesmo:

No próximo passo configuraremos os diretórios de instalação:

Clicando em change, alteraremos o caminho de instalação para: C:\totvs\jdk

Após confirmar e prosseguir, será iniciado o processo de instalação:

Na sequência será solicitado o local de instalação do JRE (Java Runtime Environment). A instalação deste Runtime não é necessário para o funcionamento do CCTServer, mas recomenda-se sua instalação (caso o sistema já não tenha uma versão instalada)  pois os consoles de administração do servidor de aplicações se baseiam em Applets, que exigem um JRE.

Como caminho para o JRE, informe C:\totvs\jre.

Ao clicar em Finish encerramos a instalação. Não é necessário registrar o produto (opcional).

b.      Variáveis de Ambiente

Definir as seguintes variáveis de ambiente abaixo como sendo do sistema:

Nome da variável: JAVA_HOME

Valor da variável: C:\totvs\jdk

Inserir na variável Path: %JAVA_HOME%\bin;(restante do path)

c.      Teste da instalação

Ao acessar o terminal, o comando abaixo pode ser executado para verificar se a instalação e configuração foram realizadas com sucesso. Após a execução do comando deve ser possível visualizar as informações da versão instalada.

C:\> java –version

d.      Problemas na instalação

Caso ocorra algum problema na instalação, consultar o manual Online citado nas referências para resolução, e em segundo nível o suporte da TOTVS.

3.  Instalação do Servidor de Aplicações JBoss 6.1

Para a implantação do Laboratório Offline Server a instalação de um Servidor de Aplicações é exigida. O único servidor de aplicações homologado para a execução do Laboratório Offline atualmente é o JBoss Application Server, em sua versão 6.1.0.

 O software JBoss AS é multiplataforma, o que significa que seu instalador pode ser utilizado para diversos sistemas operacionais e plataformas (32 bits e 64 bits) que suportem a plataforma Java.

3.1. Requisitos Mínimos:

- 10 GB de espaço em disco disponíveis;

- JDK Instalada

Após obtenção do pacote, descompacte o mesmo no diretório C:\totvs para realizar a instalação.

3.2. Configurações

Após instalação do JBoss, é necessário definir a variável de ambiente JBOSS_HOME como sendo de sistema, onde seu valor é o caminho para o diretório de instalação do JBOSS. Segue exemplo:

JBOSS_HOME=C:\totvs\jboss-6.1.0-jlab

3.2.1. Configurando Instância do Laboratório

No diretório "C:\totvs\jboss-6.1.0-jlab\server" haverá um diretório com o nome da instância do laboratório, chamado "jlab". Caso não existam os arquivos run-jlab.bat, run-jlab.conf.bat e service-jlab.bat,

deve-se criar uma cópia dos arquivos run.bat, run.conf.bat e service.bat.

Esse processo é necessário para que cada instância tenha sua própria configuração de memória, IP e porta.

Estes arquivos referenciam-se uns aos outros e, portando, é necessário que sejam realizadas algumas mudanças em seus conteudos.

No arquivo run-jlab.bat alterar a linha do exemplo para referenciar o arquivo run-jlab.conf.bat:

No arquivo service-jlab.bat alterar as linhas para referenciar os arquivos run-jlab.conf.bat, run-jlab.bat e service-jlab.bat:

Ainda no arquivo service-jlab.bat, alterar o nome do serviço a ser instalado:

3.2.2. Ajustando Parâmetros de Memória

Para alterar a quantidade de memória disponível para a JVM (Java Virtual Machine) utilizada pelo JBoss, devemos editar o arquivo run-jlab.conf.bat, que está no

diretório bin, da instalação do JBoss. Neste arquivo, procure pela linha que contenha o seguinte conteúdo:

set "JAVA_OPTS=-Xms768M -Xmx768M -XX:MaxPermSize=256M"

Os parâmetros -Xms e -Xmx determinam, respectivamente, a quantidade inicial e a quantidade máxima de memória que pode ser utilizada pelo servidor, e devem ser

configuradas para o mesmo valor, por questão de desempenho. Neste caso do exemplo, a configuração determina 768MB de memória, que pode ser aumentado de

acordo com a necessidade e disponibilidade de recursos do servidor.

3.2.3. Configurando a Instância Padrão do PIMSCS no JBoss

Um dos parâmetros esperados pela aplicação Server é a instância padrão que deve ser utilizada para consultas na base de dados do PIMSCS. Esta configuração deve

ser feita no arquivo run-jlab.conf.bat. Neste arquivo, procure a parte que é responsável pela passagem de parâmetros de memória para a JVM, como exemplo:

set "JAVA_OPTS=-server -Xms1024m -Xmx1024m -Xss1024k -Xnoclassgc -XX:MaxPermSize=256m -XX:+UseParNewGC -Duser.language=pt -Duser.country=BR -Duser.timezone=GMT-3 -Dinstancia_default=ALBER -Dversao.jboss=JB6"

O parâmetro -Dinstancia_default=INSTANCIA neste exemplo está com valor INSTANCIA, e deve ser substituído pelo nome da instância em questão.

*Um ponto de atenção é o nome da instância, que deve ser escrito em caixa alta (letras maiúsculas), pois é assim que são configurados na base de dados do PIMSCS.

3.2.4. Configuração de parâmetros adicionais de inicialização e finalização

Para passar parâmetros adicionais na inicialização:

Para passar parâmetros adicionais na finalização:

Nos exemplos acima, foram passados parâmetros para inicializar uma instância com a configuração chamada “jlab”:

-c jlab

Outro parâmetro indica que a instância deve ser executada no IP 10.11.21.24:

-b 10.11.21.24

Já na finalização, foi indicado qual o IP do servidor que deve ser parado:

--server=10.11.21.24:1099

3.3. Realizando a instalação do serviço

Para realizar a instalação do serviço, basta executar o prompt de comando (como administrador), e a partir do diretório JBOSS_HOME/bin, executar o seguinte comando:

JBOSS_HOME/bin> service-jlab.bat install

Caso deseje realizar a desinstalação, executar o comando a seguir:

JBOSS_HOME/bin> service-jlab.bat uninstall

Após realizar a instalação, o serviço deve aparecer na lista de serviços do Windows.

Configure-o para inicialização automática e reinicie o servidor, para que o serviço possa ser iniciado (isto pode ser necessário caso o usuário em execução não tenha permissão para inicialização de serviços).

4. Instalação e configuração da aplicação PIMSServer JLab

A aplicação JLab é desenvolvida em Java e deve ser implantada no servidor de aplicações JBoss 6.1.0. O arquivo da aplicação, disponibilizado para implantação, chama-se PIMSServer.ear.

Esse arquivo deverá ser copiado para a pasta deploy dentro da instância, segue exemplo: C:\totvs\jboss-6.1.0-jlab\server\jlab\deploy

4.1. Configuração do Datasource

Para que a aplicação funcione como esperado, é necessário configurar o acesso a alguns servidores de bancos de dados através de arquivos de configuração de datasource. Os arquivos em

questão estão no diretório deploy, citado acima. São eles: PIMSCS-oracle-ds.xml e PIMSLABDS-oracle-ds.xml.

Nestes arquivos devem ser informados o IP (ou nome na rede) do servidor onde está configurado o banco de dados, a porta de conexão, o nome da instância, usuário e senha de

acesso. O exemplo abaixo apresenta a configuração:

A sintaxe da propriedade URL do exemplo acima de aplica caso a conexão esteja identificada oor SID. Se a conexão estiver identificada por um nome de serviço a sintaxe deve ser:

4.1.1. Outras configurações

Caso o servidor de banco de dados esteja configurado em RAC, é necessário que o client do Oracle esteja instalado na máquina, e que seu diretório de instalação esteja referenciado nas variáveis de ambiente, como PATH, por exemplo.

Além disso, existem mudanças na maneira de se configurar o datasource. Tomemos como exemplo a seguinte entrada no tsnames.ora:

PROD.NOME.REDE =

  (DESCRIPTION =

    (LOAD_BALANCE=on)

    (FAILOVER=on)

(ADDRESS_LIST =

      (ADDRESS = (PROTOCOL = TCP)(HOST = 10.0.0.25)(PORT = 1541))

      (ADDRESS = (PROTOCOL = TCP)(HOST = 10.0.0.26)(PORT = 1541))

    (ADDRESS = (PROTOCOL = TCP)(HOST = 10.0.0.27)(PORT = 1541))

    (ADDRESS = (PROTOCOL = TCP)(HOST = 10.0.0.28)(PORT = 1541))

    )

    (CONNECT_DATA =

      (SERVER = DEDICATED)

      (SERVICE_NAME = NOME_SERVICO)

      (FAILOVER_MODE= (TYPE=select) (METHOD=basic))

    )

  )

Com isso, no datasource temos a seguinte configuração: