CONTEXTUALIZAÇÃO

A partir da Release 12.1.2312, expedida oficialmente pelo time de Engenharia Agro em 08/Dezembro/23 pela Central de Downloads TOTVS (artefato: 12.1.2312_INSTALLER_MULTICULTIVO_WIN e 12.1.2312_INSTALLER_MULTICULTIVO_LNX), o produto TOTVS Agro Multicultivo passou por ações de evolução tecnológica e arquitetural, destacando-se principalmente:

• Atualização da plataforma Java 6 para Java 17;
• Substituição do servidor de aplicação JBoss 6 por WildFly 28;

PREMISSAS

REQUISITOS (HARDWARE E SOFTWARE)

Desta forma, o produto TOTVS Agro Multicultivo também passou por revisões de requisitos de hardware e software para uso recomendado:

INSTALADOR/ATUALIZADOR

A partir da Release 12.1.2312, um novo ferramental para instalação/atualização do produto TOTVS Agro Multicultivo foi liberado. Desta forma, deve-se utilizá-lo para ter acesso às versões modernizadas (12.1.2312 ou superior).

CÓPIA DE PIMSMC_CLIENT DA INSTALAÇÃO JBOSS

É válido copiar o arquivo services_client.xml da pasta pimsmc_client da estrutura do JBoss (12.1.2305 ou anterior) para a pasta pimsmc_client da estrutura do WildFly (12.1.2312 ou superior), substituindo o arquivo atual, a fim de reutilizar as configurações específicas de cliente da instalação anterior. Porém, nesse caso, faz-se necessária a atualização dos nomes de serviço (JNDI) de e-mail e mensageria no arquivo services_client.xml recém-copiado, substituindo as ocorrências de nome no formato antigo pelo formato novo, conforme relacionado na tabela abaixo:

INICIALIZAÇÃO DO SERVIÇO

Após a instalação do produto TOTVS Agro Multicultivo, é necessário executar o arquivo de inicialização do serviço correspondente, de acordo com o sistema operacional, conforme abaixo:

Plataforma Windows:

A partir do subdiretório "wildfly\bin\service", no diretório em que foi instalado o produto TOTVS Agro Multicultivo,  execute os seguintes comandos:

C:\TOTVS-Agro\Multicultivo\wildfly\bin\service>service-<nome_instância>.bat install

C:\TOTVS-Agro\Multicultivo\wildfly\bin\service>service-<nome_instância>.bat start

Plataforma Unix/Linux:

A partir do subdiretório "wildfly/bin", no diretório em que foi instalado o produto TOTVS Agro Multicultivo, execute o seguinte comando:

/usr/local/totvs-agro/multicultivo/wildfly/bin$ wildfly-init-<nome_instância>.sh start

HABILITAÇÃO DE HTTPS/CERTIFICADO SSL

As configurações de certificado SSL para habilitação de HTTPS, e as demais configurações do serviço, estão centralizadas no arquivo standalone-full-ha.xml:

C:\TOTVS-Agro\Multicultivo\wildfly\<nome_instância>\configuration\standalone-full-ha.xml

O arquivo standalone-full-ha.xml, após a instalação do TOTVS Agro Multicultivo, estará com o subsistema Elytron configurado para uma "key-store" com nome pimsmcKeyStore, referente ao arquivo de certificado do tipo JKS com nome server.keystore e senha totvs@123, conforme trecho de XML abaixo:

<subsystem xmlns="urn:wildfly:elytron:17.0" final-providers="combined-providers" disallowed-providers="OracleUcrypto">
    <tls>
        <key-stores>
            <key-store name="pimsmcKeyStore">
                <credential-reference clear-text="totvs@123"/>
                <implementation type="JKS"/>
                <file path="server.keystore" relative-to="jboss.server.config.dir"/>
            </key-store>
        </key-stores>
        <key-managers>
            <key-manager name="pimsmcKeyManager" key-store="pimsmcKeyStore">
                <credential-reference clear-text="totvs@123"/>
            </key-manager>
        </key-managers>
        <server-ssl-contexts>
            <server-ssl-context name="pimsmcSSLContext" protocols="TLSv1.2" key-manager="pimsmcKeyManager"/>
        </server-ssl-contexts>
    </tls>
</subsystem>

A configuração <file path="server.keystore" relative-to="jboss.server.config.dir"/> define que o arquivo server.keystore deverá estar localizado no diretório configuration da instância:

C:\TOTVS-Agro\Multicultivo\wildfly\<nome_instância>\configuration\server.keystore

Geração de Certificado Temporário (homologação)

A geração e importação de certificado Java Keystore pode ser realizada através do utilitário keytool que acompanha a distribuição do JDK. Após instalação do TOTVS Agro Multicultivo, poderá ser localizado no seguinte diretório:

C:\TOTVS-Agro\Multicultivo\jdk\bin\keytool.exe

A geração do certificado server.keystore, com senha totvs@123, para atender a configuração default no subsistema Elytron citada na sessão anterior, pode ser efetuada da seguinte forma:

keytool.exe -genkeypair -keyalg RSA -alias pimsmc -keystore server.keystore -keypass totvs@123 -storepass totvs@123 -validity 365 -keysize 2048 -dname "cn=Totvs,ou=Agro,c=Assis,s=SP,c=BR"

Importação de Certificado Válido

O arquivo de certificado válido *.CER pode ser importado via o utilizado keytool, referenciado na sessão anterior, da seguinte forma:

keytool.exe -import -alias pimsmc -keystore server.keystore -trustcacerts -file C:\<caminho-completo>\<nome_arquivo>.cer

HABILITAÇÃO DE E-MAIL (SMTP)

O SMTP e conta de e-mail devem ser configurados na seção <socket-binding-group> e no subsistema (subsystem) mail, respectivamente,  no arquivo standalone-full-ha.xml. 

Configuração de SMTP

Para configurar o SMTP, deve-se adicionar o elemento XML <outbound-socket-binding> ao elemento <socket-binding-group>, conforme trecho de exemplo abaixo:

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="0">
    <!-- Configurações de socket-binding -->
    <socket-binding/> 
    <!-- Configuração de SMTP -->
    <outbound-socket-binding name="mail-smtp">
        <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
</socket-binding-group>

Atributos:

• name - o nome atribuído ao socket-binding deverá ser referenciado na configuração do subsistema mail, como pode ser observado na próxima seção abaixo. O nome "mail-smtp" é apenas uma sugestão, ele pode ser personalizado;
• host - define o endereço (host) do SMTP a ser utilizado;
• port - define o número da porta do SMTP.

Configuração de conta de e-mail (subsistema mail)

Para configurar uma conta de e-mail, deve-se adicionar um elemento <mail-session> (contendo o elemento <smpt-server>) ao subsistema (subsystem) mail, conforme exemplo abaixo:

<subsystem xmlns="urn:jboss:domain:mail:4.0">
    <mail-session name="default" debug="false" jndi-name="java:jboss/mail/Default" from="[email protected]">
        <smtp-server outbound-socket-binding-ref="mail-smtp" tls="false" username="usuario" password="senha"/>
    </mail-session>            
</subsystem>

Atributos:

• jndi-name - nome do serviço de e-mail configurado no WildFly. Valor padrão deve ser "java:jboss/mail/Default";
• from - endereço de e-mail que será utilizado no envio de e-mails;
• outbound-socket-binding-ref - referencia ao socket-binding via nome (mail-smtp) configurado na seção anterior;
• tls - (true/false) - Indica se o serviço de SMTP utiliza ou não o protocolo TLS;
• username e password - configuram o usuário e senha do serviço SMTP, respectivamente. Caso o serviço SMTP esteja sem autenticação de usuário, os atributos username e password devem ser removidos dessa configuraçao.

Configuração de e-mail via WildFly Admin Console

As configurações de e-mail descritas acima podem ser refetuadas via interface gráfica no WildFly Admin Console, da seguinte forma, conforme printscreens abaixo:

1 - Configuração de SMTP:

2 - Configuração de conta de e-mail:

ALTERAÇÃO DE PORTAS

As configurações de portas, e as demais configurações do serviço, estão centralizadas no arquivo standalone-full-ha.xml:

C:\TOTVS-Agro\Multicultivo\wildfly\<nome_instância>\configuration\standalone-full-ha.xml

O arquivo de configuração standalone-full-ha.xml contém a sessão <socket-binding-group> que define as portas de conexão da aplicação. Se, durante a instalação do TOTVS Agro Multicultivo foi informado o valor 0 para o valor "Offset de porta", a configuração dessa sessão estará da seguinte forma:

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="0">
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="iiop" interface="unsecure" port="3528"/>
    <socket-binding name="iiop-ssl" interface="unsecure" port="3529"/>
    <socket-binding name="jgroups-mping" interface="private" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
    <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
    <socket-binding name="jgroups-tcp-fd" interface="private" port="57600"/>
    <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
    <socket-binding name="jgroups-udp-fd" interface="private" port="54200"/>
    <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
    <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9993}"/>
    <socket-binding name="modcluster" multicast-address="${jboss.modcluster.multicast.address:224.0.1.105}" multicast-port="23364"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
        <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
</socket-binding-group>

O atributo port-offset indica o valor que será adicionado (somado) ao valor das portas configuradas nas subsessões <socket-binding> ao inicializar o serviço. Se o valor de port-offset estivesse definido com valor 100, e considerando a subsessão <socket-binding name="http" port="8080"/>, por exemplo, após inicialização do serviço, a porta de conexão para HTTP estaria disponível com o número 8180.

DEFINIR MODELO PADRÃO DE VALORES / IDIOMA PADRÃO

Para garantir o modelo padrão para de valores, no arquivo localizado em wildfly/bin/{instancia}.conf.bat deve estar definido a linguagem (-Duser.language) e o país (-Duser.country) destacados nas linhas 4 e 5.

set "JAVA_OPTS=%JAVA_OPTS% -Dconf_dir=%MULTICULTIVO%\desenvolvimento"
set "JAVA_OPTS=%JAVA_OPTS% -Dconf_client=%MULTICULTIVO%\desenvolvimento_client" 
set "JAVA_OPTS=%JAVA_OPTS% -Dpims.mc.estatico=%MULTICULTIVO%\pimsmcestatico" 
set "JAVA_OPTS=%JAVA_OPTS% -Duser.language=pt"
set "JAVA_OPTS=%JAVA_OPTS% -Duser.country=BR"

CENTRAL COLABORATIVA

Para sugestões e ideias de melhorias, compartilhe sua demanda por meio da Central Colaborativa TOTVS.