Páginas filhas
  • Instalação do Servidor - Server (JBoss EAP 6.3.0.GA)

Versões comparadas

Chave

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

...

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

...

  • Red Hat Enterprise versões 56.x (TikangaSantiago) e 67.x (SantiagoMaipo) 64 bits;
  • Cent OS versões 67.x 64 bits;
  • Ubuntu Server versão 14.04 LTS 64 bits.

...

O TOTVS Intellector foi homologado nas versões JBoss 4.2.3-GA, JBoss 7.1.1 e JBoss EAP 6.3.0.GA. Você pode fazer o download do JBoss para qualquer plataforma nos seguintes sites:

 

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

...

  • Não use a variável de ambiente -Duser.dir=seu_dir, pois isso impede o TOTVS Intellector de compilar as políticas.

 

Linux

  • Por questões de segurança em ambiente Linux NÃO pode ser usado o usuário root para executar o script de "startup" do JBoss. É indicada a criação de um usuário normal para executar o script.

 

Linux

Bloco de código
language
Bloco de código
languagejava
linenumberstrue
#!/bin/bash
# exporta variaveis de ambiente necessarias
export JAVA_OPTS="-XX:+TieredCompilation -Dprogram.name=standalone.sh -Xms512M -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 -Duser.server.node=mynode -Djboss.modules.system.pkgs=org.jboss.byteman -Djboss.server.default.config=standalone-full.xml -Dfile.encoding=ISO-8859-1 -Dpersistence.configuration=$JBOSS_HOME/bin/persistence.properties"

# remove indicativo de erros no deployment
rm -fv /opt/jboss-eap6/standalone/deployments/*.failed
# atualize com seu IP
./standalone.sh -Djboss.bind.address.management=<IP_MAQUINA> -b <IP_MAQUINA>

...

 

Bloco de código
languagehtml/xml
linenumberstrue
<jms-destinations> destinations> 
 
      ....... 
 
      <!-- Acrescentar à lista de filas que já existam as filas do Intellector -->
    <jms-queue name="intellectorQueue"> 
    <entry name="queue/intellector"/> 
    <entry name="java:jboss/exported/jms/queue/intellector"/> 
    </jms-queue> 
    <jms-topic name="intellectorTopic"> 
    <entry name="topic/intellector"/> 
    <entry name="java:jboss/exported/jms/topic/intellector"/> 
    </jms-topic> 

      ....... 



</jms-destinations> 

 

  • Adicionar duas extensões no arquivo $JBOSS_HOME/standalone/standalone-full.xml. 

    Bloco de código
    languagexml
    title$JBOSS_HOME\\standalone\\standalone-full.xml
    ...
    <extensions>
        <extension module="org.jboss.as.configadmin"/>
        <extension module="org.jboss.as.osgi"/>
        ...
    </extensions>
    
    

<extension module="org.jboss.as.configadmin"/>
<extension module="org.jboss.as.osgi"/>

 

Módulos Globais - EE Subsystem - Global Modules

Adicionar módulos globais

    • org.apache.commons.collections

    • org.apache.commons.codec
    • org.apache.commons.io

    • org.apache.commons.beanutils

    • org.apache.xerces

    • org.apache.santuario.xmlsec.xmlsec

    • org.apache.commons.lang

 

Bloco de código
languagexml
titleGlobal Modules
...
        <subsystem xmlns="urn:jboss:domain:ee:1.2">
            <global-modules>
                <module name="org.apache.commons.collections" slot="main"/>
				<module name="org.apache.commons.codec" slot="main"/>
                <module name="org.apache.commons.io" slot="main"/>
                <module name="org.apache.commons.beanutils" slot="main"/>
                <module name="org.apache.xerces" slot="main"/>
                <module name="org.apache.santuario.xmlsec" slot="main"/>
                <module name="org.apache.commons.lang" slot="main"/>
            </global-modules>
			...
        </subsystem>
...

 

Módulos a serem alterados e criados

...

Spring Framework - versão 34.0.75.RELEASE

 

Bloco de código
languagexml
title$JBOSS_HOME\\modules\\system\\layers\\base\\org\\springframework\\spring\\main\\module.xml
linenumberstrue
<?xml version="1.0" encoding="UTF-8"?>
<!--
  ~ JBoss, Home of Professional Open Source.
  ~ Copyright 2011, Red Hat, Inc., and individual contributors
  ~ as indicated by the @author tags. See the copyright.txt file in the
  ~ distribution for a full listing of individual contributors.
  ~
  ~ This is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU Lesser General Public License as
  ~ published by the Free Software Foundation; either version 2.1 of
  ~ the License, or (at your option) any later version.
  ~
  ~ This software is distributed in the hope that it will be useful,
  ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
  ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  ~ Lesser General Public License for more details.
  ~
  ~ You should have received a copy of the GNU Lesser General Public
  ~ License along with this software; if not, write to the Free
  ~ Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  ~ 02110-1301 USA, or see the FSF site: http://www.fsf.org.
  -->
<module xmlns="urn:jboss:module:1.1" name="org.springframework.spring">
    <resources>
    <resource-root path="spring-aopjms-34.0.75.RELEASE.jar"/>
    <resource-root path="spring-asmweb-34.0.75.RELEASE.jar"/>
    <resource-root path="spring-beanstx-34.0.75.RELEASE.jar"/>
	    <resource-root path="spring-context-34.0.75.RELEASE.jar"/>
	    <resource-root path="spring-coreaop-34.0.75.RELEASE.jar"/>
    <resource-root path="spring-expression-34.0.75.RELEASE.jar"/>
	    <resource-root path="spring-jmsbeans-34.0.75.RELEASE.jar"/>
	<resource-root path="spring-tx-3.0.7.RELEASE.jar"/>
	    <resource-root path="spring-webcore-34.0.75.RELEASE.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api" />
        <module name="javax.jms.api" />
        <module name="javax.annotation.api" />
        <module name="org.apache.commons.logging" />
        <module name="org.jboss.vfs" />
    </dependencies>
</module>

 

jTDS JDBC Driver -  MSSQL Server

    • Criar módulo $JBOSS_HOME\modules\system\layers\base\net\sourceforge\jtds\main.
    • Baixar o jar jtds-1.2.7jar e colocar no diretório criado no item anterior.
    • Criar o arquivo module.xml no diretório main e inserir o conteúdo abaixo:
Bloco de código
languagexml
title$JBOSS_HOME\\modules\\system\\layers\\base\\net\\sourceforge\\jtds\\main\\module.xml
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="net.sourceforge.jtds">
  <resources>
    <resource-root path="jtds-1.2.7.jar"/>
        <!-- Insert resources here -->
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

 

Simple API For CSS

    • Criar módulo $JBOSS_HOME\modules\system\layers\base\org\w3c\css\sac\main.
    • Baixar o jar sac-1.3.jar e colocar no diretório criado no item anterior.
    • Criar o arquivo module.xml no diretório main e inserir o conteúdo abaixo:

      Bloco de código
      languagexml
      title$JBOSS_HOME\\modules\\system\\layers\\base\\org\\w3c\\css\\sac\\main\\module.xml
      <?xml version="1.0" encoding="UTF-8"?>
      
      <!--
        ~ JBoss, Home of Professional Open Source.
        ~ Copyright 2011, Red Hat, Inc., and individual contributors
        ~ as indicated by the @author tags. See the copyright.txt file in the
        ~ distribution for a full listing of individual contributors.
        ~
        ~ This is free software; you can redistribute it and/or modify it
        ~ under the terms of the GNU Lesser General Public License as
        ~ published by the Free Software Foundation; either version 2.1 of
        ~ the License, or (at your option) any later version.
        ~
        ~ This software is distributed in the hope that it will be useful,
        ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
        ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
        ~ Lesser General Public License for more details.
        ~
        ~ You should have received a copy of the GNU Lesser General Public
        ~ License along with this software; if not, write to the Free
        ~ Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
        ~ 02110-1301 USA, or see the FSF site: http://www.fsf.org.
        -->
      
      <module xmlns="urn:jboss:module:1.1" name="org.w3c.css.sac">
      
          <properties>
              <property name="jboss.api" value="private"/>
          </properties>
      
          <resources>
              <resource-root path="sac-1.3.jar"/>
              <!-- Insert resources here -->
          </resources>
      
          <dependencies>
              <module name="net.sourceforge.cssparser"/>
          </dependencies>
      </module>

CXF 2.6.4

    • Remover o conteúdo do diretório $JBOSS_HOME\modules\system\layers\base\org\apache\cxf\impl\main.
    • Baixar os jars da lista a seguir e colocar no diretório criado no item anterior
    • Criar o arquivo module.xml no diretório main e inserir o conteúdo abaixo:

      Bloco de código
      languagexml
      title$JBOSS_HOME\\modules\\system\\layers\\base\\org\\apache\\cxf\\impl\\main\\module.xml
       <?xml version="1.0" encoding="UTF-8"?>
      <!--
        ~ JBoss, Home of Professional Open Source.
        ~ Copyright 2012, Red Hat, Inc., and individual contributors
        ~ as indicated by the @author tags. See the copyright.txt file in the
        ~ distribution for a full listing of individual contributors.
        ~
        ~ This is free software; you can redistribute it and/or modify it
        ~ under the terms of the GNU Lesser General Public License as
        ~ published by the Free Software Foundation; either version 2.1 of
        ~ the License, or (at your option) any later version.
        ~
        ~ This software is distributed in the hope that it will be useful,
        ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
        ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
        ~ Lesser General Public License for more details.
        ~
        ~ You should have received a copy of the GNU Lesser General Public
        ~ License along with this software; if not, write to the Free
        ~ Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
        ~ 02110-1301 USA, or see the FSF site: http://www.fsf.org.
        -->
      <module xmlns="urn:jboss:module:1.1" name="org.apache.cxf.impl">
          <properties>
              <property name="jboss.api" value="private"/>
          </properties>
          <resources>
              <resource-root path="cxf-rt-bindings-coloc-2.6.4.jar"/>
              <resource-root path="cxf-rt-bindings-object-2.6.4.jar"/>
              <resource-root path="cxf-rt-bindings-soap-2.6.4.jar"/>
              <resource-root path="cxf-rt-bindings-xml-2.6.4.jar"/>
              <resource-root path="cxf-rt-core-2.6.4.jar"/>
              <resource-root path="cxf-rt-databinding-aegis-2.6.4.jar"/>
              <resource-root path="cxf-rt-databinding-jaxb-2.6.4.jar"/>
              <resource-root path="cxf-rt-frontend-jaxws-2.6.4.jar"/>
              <resource-root path="cxf-rt-frontend-simple-2.6.4.jar"/>
              <resource-root path="cxf-rt-management-2.6.4.jar"/>
              <resource-root path="cxf-rt-transports-http-2.6.4.jar"/>
              <resource-root path="cxf-rt-transports-jms-2.6.4.jar"/>
              <resource-root path="cxf-rt-transports-local-2.6.4.jar"/>
              <resource-root path="cxf-rt-ws-addr-2.6.4.jar"/>
              <resource-root path="cxf-rt-ws-mex-2.6.4.jar"/>
              <resource-root path="cxf-rt-ws-policy-2.6.4.jar"/>
              <resource-root path="cxf-rt-ws-rm-2.6.4.jar"/>
              <resource-root path="cxf-rt-ws-security-2.6.4.jar"/>
              <resource-root path="cxf-services-sts-core-2.6.4.jar"/>
              <resource-root path="cxf-tools-common-2.6.4.jar"/>
              <resource-root path="cxf-tools-java2ws-2.6.4.jar"/>
              <resource-root path="cxf-tools-validator-2.6.4.jar"/>
              <resource-root path="cxf-tools-wsdlto-core-2.6.4.jar"/>
              <resource-root path="cxf-tools-wsdlto-databinding-jaxb-2.6.4.jar"/>
              <resource-root path="cxf-tools-wsdlto-frontend-jaxws-2.6.4.jar"/>
              <resource-root path="cxf-xjc-boolean-2.6.1.jar"/>
              <resource-root path="cxf-xjc-dv-2.6.1.jar"/>
              <resource-root path="cxf-xjc-ts-2.6.1.jar"/>
          </resources>
          <dependencies>
              <module name="asm.asm" />
              <module name="javax.api" />
              <module name="javax.annotation.api" />
              <module name="javax.jms.api" />
              <module name="javax.jws.api" />
              <module name="javax.mail.api" />
              <module name="javax.resource.api" />
              <module name="javax.servlet.api" />
              <module name="javax.wsdl4j.api" />
              <module name="javax.xml.bind.api" services="import"/>
              <module name="com.sun.xml.bind" services="import"/>
              <module name="javax.xml.soap.api" />
              <module name="javax.xml.stream.api" />
              <module name="javax.xml.ws.api" />
              <module name="org.apache.commons.lang" />
              <module name="org.apache.neethi" />
              <module name="org.apache.velocity" />
              <module name="org.apache.xml-resolver" />
              <module name="org.apache.ws.xmlschema" />
              <module name="org.apache.ws.security" />
              <module name="org.apache.santuario.xmlsec" />
              <module name="org.joda.time" />
              <module name="org.opensaml" />
              <module name="org.springframework.spring" optional="true"/> 
              <module name="org.apache.cxf" export="true"/> 
          </dependencies>
      </module>

Instalando uma Licença para o TOTVS Intellector

...

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.