Histórico da Página
...
- 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.
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:
- JBoss 4.2.3-GA e JBoss 7.1.1: http://www.jboss.org/jbossas/downloads/.JBoss EAP 6.3.0.GA (requer autenticação mesmo para a versão endereçada aos desenvolvedores): https://www.redhat.com/en/technologies/jboss-middleware/application-platform.
- Pacote JBoss 6.3.0.GA com as alterações já efetuadas: Jboss EAP 6.3.0.GA - Intellector.
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 | ||||
---|---|---|---|---|
| ||||
Bloco de código | ||||
| ||||
#!/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 | ||||
---|---|---|---|---|
| ||||
<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 language xml 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 | ||||
---|---|---|---|---|
| ||||
... <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
- Criar módulo $JBOSS_HOME\modules\system\layers\base\org\springframework\spring\main.
- Baixar os jars da lista a seguir e colocar no diretório criado no item anterior.
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
<?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 | ||||
---|---|---|---|---|
| ||||
<?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 language xml 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 language xml 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.