Integrações

Páginas filhas
  • Instalação do Servidor - Server (JBoss 7.1.1)

Versões comparadas

Versão antiga 5

changes.mady.by.user Usuário desconhecido (andrea.marques)

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Usuário desconhecido (andrea.marques)

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Introdução

O TOTVS Intellector é uma solução para a gestão de processos decisórios, fornecendo uma interação fácil através de uma linguagem simples e prática. Este manual descreve passa-a-passo o processo de instalação do servidor TOTVS Intellector para o JBoss Application Server versão 7.1.1.

  • Para o manual de instalação no JBoss 4.2.3. clique aqui.
Para quem se destina o manual

O público alvo para este manual são administradores de sistemas e application servers, e que tenha bom conhecimento de JBoss e JVM.

O que é necessário para entender esse manual

Este manual assume que os administradores tem familiaridade com os conceitos de administração e deployment do JBoss, Linux ou Windows e Sun JDK.

Pré-requisitos

Como um primeiro passo, verifique e tenha certeza de qual versão do TOTVS Intellector você deseja instalar ou atualizar. Baseado na versão, você pode determinar a compatibilidade apropriada das versões de JBoss, Linux (veja as versões abaixo) ou Windows, e Java Oracle JDK.

  • Red Hat Enterprise versões 5.x (Tikanga) e 6.x (Santiago) 64 bits;
  • CentOS versões 6.x 64 bits
  • Ubuntu Server versão 12.04 LTS 64 bits
JDK 6.0

Instale a Sun JDK 6.0 apropriada para sua plataforma. As JDKs estão disponíveis no seguinte site: http://java.sun.com/javase/downloads/index.jsp

...

Não se esqueça de configurar JAVA_HOME no seu ambiente, mas, forneceremos um bootstrap para o TOTVS Intellector, onde essa variável é configurada, mas você pode querer colocá-la em outro lugar, não se esqueça dela! Embora a localização da instalação da JDK seja livre, sugerimos criar uma pasta "<drive>:\opt" no Windows ou usar o "/opt" no Unix; isso ajuda para propósitos de suporte. Instalando em sistemas Unix, tenha bastante cuidado com as permissões de escrita para owner/group para o diretório do JBoss, pois o TOTVS Intellector vai precisar "escrever"nesse diretório.

 JBoss

O TOTVS Intellector foi homologado nas versões JBoss 4.2.3-GA e JBoss 7.1.1. Você pode fazer o download do JBoss, para qualquer plataforma do seguinte site: http://www.jboss.org/jbossas/downloads/

Este é um bom lugar para tirar dúvidas e procurar dicas sobre o JBoss... http://wiki.jboss.org/

Instalando...

Após instalar a Java JDK e o JBoss nos locais apropriados, faça um pequeno teste de verificação da instalação, subindo o JBoss ($JBOSS_HOME/bin/standalone.sh ou standalone.bat no Windows); para verificar se tudo foi bem, você estará apto a abrir a url http://localhost:9990/console de administração do application server. Se a console pedir autentição, siga esse artigo para criar usuários que podem ter acesso ao container.

Evite instalar JDK e JBoss em diretórios que contenham espaços no nome, como "C:\Arquivo de Programas" do Windows. Conheça mais sobre JBoss Enterprise Application Platform.

Bootstrap para JBoss e TOTVS Intellector

Os scripts de bootstrap para o TOTVS Intellector são simples, precisando apenas de pequenas modificações no que concerne a utilização de memória e variáveis de ambientes. Sugiro usar o nome run-intellector.sh no Linux/Unix e run-intellector.bat no Windows e, deve ficar em $JBOSS_HOME/bin com permissão explícita de execução (básico para os linuxers!)

...

rem alguns snipets para o bootstrap do TOTVS Intellector
set JAVA_OPTS=-XX:+TieredCompilation -Dprogram.name=standalone.bat -Xms64M -Xmx512M -XX:MaxPermSize=256M -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv4Stack=true -Dorg.jboss.resolver.warning=true -Djboss.modules.system.pkgs=org.jboss.byteman -Djboss.server.default.config=standalone-full.xml

rem inicia o JBoss numa instancia e IP especificos
./call standalone -b YOUR_IP
Área de dados para o TOTVS Intellector

O TOTVS Intellector tem uma característica de persistir alguns dados no File System da plataforma, seja persistência em XML (JAXB), seja dos plugins de acessos, políticas e layouts de políticas. Esse local de persistência, é um diretório ou uma árvore de diretórios. Você pode verificar, que no arquivo de bootstrap, existe uma variável intellector.datadir que deve apontar para um diretório válido, onde ocorrerá a persistência e o site criará o restante dos diretórios. Veja uma árvore de diretórios criada pelo site abaixo:

...

  • Considerando intellector.datadir=/home/intellector como diretório raiz:
    1. /home/intellector/acessos - diretório de instalação dos plugins de acesso; o TOTVS Intellector cria uma pasta para cada acesso;
    2. /home/intellector/key - diretório para as licenças do TOTVS Intellector;
    3. /home/intellector/dados - diretório raiz para persistência de cadastros (usuários, perfis, plugins, auditorias, etc.)
    4. /home/intellector/dados/person - persistência de usuários cadastrados
    5. /home/intellector/dados/audit - persistência de auditoria de execução de políticas (intellector.auditpolicy=true/false)
    6. /home/intellector/dados/plugin - persistências dos dados dos plugins instalados
    7. /home/intellector/dados/layouts - persistências de todos os layouts das políticas
    8. /home/intellector/dados/policy - persistências de todos as políticas enviadas do servidor
    9. /home/intellector/politicas - onde serão mantidas as classes das políticas compiladas
    10. /home/intellector/politicas/classes
    11. /home/intellector/politicas/classes/br
    12. /home/intellector/politicas/classes/br/com
    13. /home/intellector/politicas/classes/br/com/tools
    14. /home/intellector/politicas/classes/br/com/tools/politicas
    15. /home/intellector/tarifacao - pasta para os arquivos de Tarifação
Configurações do Application Server para o TOTVS Intellector

As seguintes configurações devem ser efetuadas no Appllication Server para que o TOTVS Intellector funcione corretamente.

...

<resources>
	<resource-root path="spring-asm.jar"/>
	<resource-root path="spring-aop.jar"/>
	<resource-root path="spring-context.jar"/>
	<resource-root path="spring-core.jar"/>
	<resource-root path="spring-beans.jar"/>
	<resource-root path="spring-tx.jar"/>
	<resource-root path="spring-jms.jar"/>
	<resource-root path="spring-expression.jar"/>
	<resource-root path="spring-web.jar"/>
</resources>
Instalando uma Licença para o TOTVS Intellector

O TOTVS Intellector trabalha com 3 (três) modelos de licenciamento, Enterprise, Limited e Trial. Essas licenças estarão contidas em um único arquivo nomeado intellector.key (outro nome não será reconhecido) que deverá ser colocado no diretório ${intellector.datadir}/key. Ele poderá ser copiado para esse local a qualquer momento, não necessitando de qualquer intervenção no servidor.

  • Tipos de licenças:
    1. Enterprise - totalmente livre para execução de qualquer política sem data de expiração;
    2. Limited - determinada por um tipo específico e uma data de expiração ou não;
    3. Trial - tipos de políticas livres e com uma data de expiração.
Deployment do TOTVS Intellector no JBoss

Considerando que o item instalando o JBoss foi seguido, o próximo passo será o deployment (instalação) do pacote intellector-ear.ear em uma instância do JBoss.

...

  1. Copiar intellector-ear.ear dentro do diretório $JBOSS_HOME/standalone/deployments;
  2. Se for uma atualização de versão, simplesmente remova o intellector-ear.ear, ANTES de extrair a nova versão. É boa prática excluir as pastas log, tmp e work, situadas abaixo da instância, neste caso: $JBOSS_HOME/standalone/log, tmp, etc. Se quiser, pode guardar os logs, tmp e wor, mas você não precisará deles.
Iniciando o JBoss

Se os passos foram seguidos e tudo correu bem, então é hora de iniciar o JBoss. No diretório $JBOSS_HOME/bin, inicie o batch simplesmente digitando ./run-intellector.sh (linux/unix) ou run.bat no Windows; abaixo o início e o fim do bootstrap do JBoss:

...

11:52:24,116 INFO  [br.com.tools.intellector] (MSC service thread 1-2) -----------------------------------------------------------
11:52:24,117 INFO  [br.com.tools.intellector] (MSC service thread 1-2) --------- TOTVS Intellector configurado com sucesso... ----------
11:52:24,117 INFO  [br.com.tools.intellector] (MSC service thread 1-2) -----------------------------------------------------------
11:52:24,154 INFO  [org.jboss.web] (MSC service thread 1-2) JBAS018210: Registering web context: /Intellector
11:52:24,156 INFO  [org.jboss.as] (MSC service thread 1-2) JBAS015951: Admin console listening on http://127.0.0.1:9990
11:52:24,157 ERROR [org.jboss.as] (MSC service thread 1-2) JBAS015875: JBoss AS 7.1.1.Final "Brontes" started (with errors) in 23695ms - Started 537 of 625 services (6 services failed or missing dependencies, 80 services are passive or on-demand)
Configurações adicionais

Normalmente, ajustes adicionais, ou tuning, dependem de plataforma, número de requisições, escalabilidade, multi-ip, dentre outras; a mais comum é alterar a porta onde o container irá atender, default é a 8080. Outros casos, como HTTPS ou load balancer, envolvendo o Apache, devem ser analisadas e não fazem parte do escopo desse manual.

Configurando Pool de Conexões - JNDI
  • O pool de conexão deve ser habilitado usando a console.
Arquivo persistence.properties

Para utilização da persistência de acessos no TOTVS Intellector Server, na primeira execução antes da utilização do cache, deverá ser copiado o arquivo de configuração persistence.properties para o diretório $JBOSS_HOME/bin, como descrito abaixo.

...