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).

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 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

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.

CENTRAL COLABORATIVA

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