Páginas filhas
  • TOTVS Agro API Hub (silencioso e gráfico)

Versões comparadas

Chave

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

...

O pacote do instalador do TOTVS Agro API Hub está disponível na Central de Download da TOTVS, o modo de instalação silencioso está disponível a partir da Release 12.1.2512.

EXECUÇÃO DO INSTALADOR EM MODO SILENCIOSO

O instalador em modo silencioso visa permitir a instalação automatizada do software sem a necessidade de interação do usuário. Isso facilita a implantação em ambientes corporativos, reduz erros humanos, agiliza o processo e garante consistência nas instalações. Além disso, o modo silencioso é ideal para integrações com scripts e ferramentas de gerenciamento de sistemas.

ESTRUTURA DE ARQUIVOS

Ao baixar e descompactar o instalador do TOTVS Agro API Hub, haverá a seguinte estrutura de arquivos.

Image Removed

/distro:

Image Removed


...

ESTRUTURA DE ARQUIVOS NO INSTALADOR

Ao baixar e descompactar o instalador do TOTVS Agro API Hub, haverá a seguinte estrutura de arquivos:

Image Added

Na pasta distro:

Image Added

  • install.bat: Utilizado para executar o instalador/atualizador em modo interativo.
  • install-silent.bat: Utilizado para executar o processo de instalação/atualização em modo silencioso.
  • totvs-agro-ta-api-hub-oracle.properties: Utilizado para configurar os parâmetros para o
  • install.bat: Utilizado para executar o instalador/atualizador em modo interativo.
  • install-silent.bat: Utilizado para executar o processo de instalação/atualização em modo silencioso.
  • totvs-agro-ta-api-hub-oracle.properties: Utilizado para configurar os parâmetros para o processo de instalação/atualização em modo silencioso.
  • log4j2.xml: Utilizado para configurar os logs do instalador. 

...

EXECUÇÃO DO INSTALADOR EM MODO SILENCIOSO

O instalador em modo silencioso visa permitir a instalação automatizada do software sem a necessidade de interação do usuário. Isso facilita a implantação em ambientes corporativos, reduz erros humanos, agiliza o processo e garante consistência nas instalações. Além disso, o modo silencioso é ideal para integrações com scripts e ferramentas de gerenciamento de sistemas.

ARQUIVO DE CONFIGURAÇÃO DA INSTALAÇÃO / ATUALIZAÇÃO (.properties)

Antes de executar o instalador em modo silencioso, é necessário que o arquivo auto-install.xml esteja corretamente preenchido, este totvs-agro-ta-api-hub-windows-oracle.properties ou totvs-agro-ta-api-hub-linux-oracle.properties, dependendo do sistema operacional utilizado,esteja corretamente preenchido. Este arquivo define os parâmetros para a instalação / atualização do TOTVS Agro Indústria API Hub.

Exemplo de arquivo utilizado no processo de instalação:

Bloco de código
languagexml
firstline1
titleArquivo auto-install.xml
linenumberstrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="bra">
    <com.izforge.izpack.panels.htmlinfo.HTMLInfoPanel id="welcome"/>
    <com.totvs.agro.installer.panels.install.InstallConfigPanel id="InstallConfigPanel">
        <Install.operation>INSTALL</Install.operation>
    </com.totvs.agro.installer.panels.install.InstallConfigPanel>
    <com.totvs.agro.installer.panels.industria.module.ModulePanel id="ModulePanel">
        <ModuleConfPanel.PI>true</ModuleConfPanel.PI>
        <ModuleConfPanel.MI>true</ModuleConfPanel.MI>
    </com.totvs.agro.installer.panels.industria.module.ModulePanel>
    <com.totvs.agro.installer.panels.industria.apps.AppsPanel id="AppsConfigPanel">
        <IndustriaConfigPanel.appCep>true</IndustriaConfigPanel.appCep>
        <IndustriaConfigPanel.appGlab>true</IndustriaConfigPanel.appGlab>
        <IndustriaConfigPanel.appPanbsc>true</IndustriaConfigPanel.appPanbsc>
        <IndustriaConfigPanel.appPanind>true</IndustriaConfigPanel.appPanind>
        <IndustriaConfigPanel.appPro>true</IndustriaConfigPanel.appPro>
        <IndustriaConfigPanel.appCel>true</IndustriaConfigPanel.appCel>
        <IndustriaConfigPanel.appFerramentaria>true</IndustriaConfigPanel.appFerramentaria>
        <IndustriaConfigPanel.appMi>true</IndustriaConfigPanel.appMi>
    </com.totvs.agro.installer.panels.industria.apps.AppsPanel>
    <com.totvs.agro.installer.panels.industria.bde.BDEPanel id="BDEPanel">
        <BDEPanelConf.Install>true</BDEPanelConf.Install>
    </com.totvs.agro.installer.panels.industria.bde.BDEPanel>
    <com.izforge.izpack.panels.target.TargetPanel id="install_dir">
        <installpath>C:\TOTVS-Agro\Industria</installpath>
    </com.izforge.izpack.panels.target.TargetPanel>
    <com.totvs.agro.installer.panels.industria.config.IndustriaConfigPanel id="industriaPanel">
        <IndustriaConfigPanel.instance>TOTVS</IndustriaConfigPanel.instance>
        <IndustriaConfigPanel.cnpj>12.345.678/0001-90</IndustriaConfigPanel.cnpj>
        <IndustriaConfigPanel.companyName>TOTVS AGRO</IndustriaConfigPanel.companyName>
        <IndustriaConfigPanel.companyShortName>TOTVS</IndustriaConfigPanel.companyShortName>
        <IndustriaConfigPanel.city>Assis</IndustriaConfigPanel.city>
        <IndustriaConfigPanel.state>SP</IndustriaConfigPanel.state>
        <IndustriaConfigPanel.bioenergiaInstalled>true</IndustriaConfigPanel.bioenergiaInstalled>
        <IndustriaConfigPanel.tableSpace>PIMS_DATA</IndustriaConfigPanel.tableSpace>
        <IndustriaConfigPanel.tableSpaceIndex>PIMS_INDX</IndustriaConfigPanel.tableSpaceIndex>
    </com.totvs.agro.installer.panels.industria.config.IndustriaConfigPanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar1ConfigPanel id="databasePanelMI">
        <DatabaseAuxiliar1.type>ORACLE</DatabaseAuxiliar1.type>
        <DatabaseConfigPanelAuxiliar1.user>DB_USER_MI</DatabaseConfigPanelAuxiliar1.user>
        <DatabaseConfigPanelAuxiliar1.password>DB_PASS_MI</DatabaseConfigPanelAuxiliar1.password>
        <DatabaseConfigPanelAuxiliar1.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanelAuxiliar1.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar1ConfigPanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar2ConfigPanel id="databasePanelPI">
        <DatabaseAuxiliar2.type>ORACLE</DatabaseAuxiliar2.type>
        <DatabaseConfigPanelAuxiliar2.user>DB_USER_PI</DatabaseConfigPanelAuxiliar2.user>
        <DatabaseConfigPanelAuxiliar2.password>DB_PASS_PI</DatabaseConfigPanelAuxiliar2.password>
        <DatabaseConfigPanelAuxiliar2.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanelAuxiliar2.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar2ConfigPanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel id="com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel_12">
        <Database.type>ORACLE</Database.type>
        <DatabaseConfigPanel.user>DB_USER_BIO</DatabaseConfigPanel.user>
        <DatabaseConfigPanel.password>DB_PASS_BIO</DatabaseConfigPanel.password>
        <DatabaseConfigPanel.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanel.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel>
    <com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel id="BioenergiaPathPanel">
        <BioenergiaPanel.pathApp>C:\TOTVS-Agro\Bioenergia\APP</BioenergiaPanel.pathApp>
    </com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel>
    <com.totvs.agro.installer.panels.licenseServer.LicenseServerConfigPanel id="licenseServerPanel">
        <LicenseServer.ip>127.0.0.1</LicenseServer.ip>
        <LicenseServer.port>5555</LicenseServer.port>
    </com.totvs.agro.installer.panels.licenseServer.LicenseServerConfigPanel>
    <com.izforge.izpack.panels.packs.PacksPanel id="sdk_pack_select">
        <pack index="0" name="totvs-mi-install" selected="true"/>
        <pack index="1" name="totvs-pi-install" selected="true"/>
        <pack index="2" name="totvs-utilitarios-install" selected="true"/>
        <pack index="3" name="tovs-mi-update" selected="true"/>
        <pack index="4" name="totvs-pi-update" selected="true"/>
        <pack index="5" name="AppsBasicos" selected="false"/>
        <pack index="6" name="Componentes" selected="false"/>
        <pack index="7" name="PreRequisitos" selected="false"/>
    </com.izforge.izpack.panels.packs.PacksPanel>
    <com.izforge.izpack.panels.install.InstallPanel id="install"/>
    <com.izforge.izpack.panels.process.ProcessPanel id="ProcessPanel_18"/>
    <com.izforge.izpack.panels.finish.FinishPanel id="finish"/>
</AutomatedInstallation>

Exemplo de arquivo utilizado no processo de atualização do MI:

Bloco de código
languagexml
firstline1
titleArquivo auto-install.xml
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="bra">
    <com.izforge.izpack.panels.htmlinfo.HTMLInfoPanel id="welcome"/>
    <com.totvs.agro.installer.panels.install.InstallConfigPanel id="InstallConfigPanel">
        <Install.operation>UPDATE</Install.operation>
    </com.totvs.agro.installer.panels.install.InstallConfigPanel>
    <com.totvs.agro.installer.panels.industria.module.ModulePanel id="ModulePanel">
        <ModuleConfPanel.PI>false</ModuleConfPanel.PI>
        <ModuleConfPanel.MI>true</ModuleConfPanel.MI>
    </com.totvs.agro.installer.panels.industria.module.ModulePanel>
    <com.totvs.agro.installer.panels.industria.apps.AppsPanel id="AppsConfigPanel">
        <IndustriaConfigPanel.appCep>false</IndustriaConfigPanel.appCep>
        <IndustriaConfigPanel.appGlab>false</IndustriaConfigPanel.appGlab>
        <IndustriaConfigPanel.appPanbsc>false</IndustriaConfigPanel.appPanbsc>
        <IndustriaConfigPanel.appPanind>false</IndustriaConfigPanel.appPanind>
        <IndustriaConfigPanel.appPro>false</IndustriaConfigPanel.appPro>
        <IndustriaConfigPanel.appCel>true</IndustriaConfigPanel.appCel>
        <IndustriaConfigPanel.appFerramentaria>true</IndustriaConfigPanel.appFerramentaria>
        <IndustriaConfigPanel.appMi>true</IndustriaConfigPanel.appMi>
    </com.totvs.agro.installer.panels.industria.apps.AppsPanel>
    <com.totvs.agro.installer.panels.industria.IndustriaPathExe.IndustriaPathExePanel id="IndustriaPathExePanel">
        <IndustriaConfigPanel.industriaPathExe>C:\TOTVS-Agro\Industria\MI\EXE</IndustriaConfigPanel.industriaPathExe>
        <INSTALL_PATH>C:\TOTVS-Agro\Industria\MI\EXE</INSTALL_PATH>
    </com.totvs.agro.installer.panels.industria.IndustriaPathExe.IndustriaPathExePanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar1ConfigPanel id="databasePanelMI">
        <DatabaseAuxiliar1.type>ORACLE</DatabaseAuxiliar1.type>
        <DatabaseConfigPanelAuxiliar1.user>DB_USER_MI</DatabaseConfigPanelAuxiliar1.user>
        <DatabaseConfigPanelAuxiliar1.password>DB_PASS_MI</DatabaseConfigPanelAuxiliar1.password>
        <DatabaseConfigPanelAuxiliar1.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanelAuxiliar1.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar1ConfigPanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel id="com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel_12">
        <Database.type>ORACLE</Database.type>
        <DatabaseConfigPanel.user>DB_USER_BIO</DatabaseConfigPanel.user>
        <DatabaseConfigPanel.password>DB_PASS_BIO</DatabaseConfigPanel.password>
        <DatabaseConfigPanel.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanel.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel>
    <com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel id="BioenergiaPathPanel">
        <BioenergiaPanel.pathApp>C:\TOTVS-Agro\Bioenergia\APP</BioenergiaPanel.pathApp>
    </com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel>
    <com.izforge.izpack.panels.install.InstallPanel id="install"/>
    <com.izforge.izpack.panels.process.ProcessPanel id="ProcessPanel_18"/>
    <com.izforge.izpack.panels.finish.FinishPanel id="finish"/>
</AutomatedInstallation>

Exemplo de arquivo utilizado no processo de atualização do PI:

Bloco de código
languagexml
firstline1
titleArquivo auto-install.xml
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="bra">
    <com.izforge.izpack.panels.htmlinfo.HTMLInfoPanel id="welcome"/>
    <com.totvs.agro.installer.panels.install.InstallConfigPanel id="InstallConfigPanel">
        <Install.operation>UPDATE</Install.operation>
    </com.totvs.agro.installer.panels.install.InstallConfigPanel>
    <com.totvs.agro.installer.panels.industria.module.ModulePanel id="ModulePanel">
        <ModuleConfPanel.PI>true</ModuleConfPanel.PI>
        <ModuleConfPanel.MI>false</ModuleConfPanel.MI>
    </com.totvs.agro.installer.panels.industria.module.ModulePanel>
    <com.totvs.agro.installer.panels.industria.apps.AppsPanel id="AppsConfigPanel">
        <IndustriaConfigPanel.appCep>true</IndustriaConfigPanel.appCep>
        <IndustriaConfigPanel.appGlab>true</IndustriaConfigPanel.appGlab>
        <IndustriaConfigPanel.appPanbsc>true</IndustriaConfigPanel.appPanbsc>
        <IndustriaConfigPanel.appPanind>true</IndustriaConfigPanel.appPanind>
        <IndustriaConfigPanel.appPro>true</IndustriaConfigPanel.appPro>
        <IndustriaConfigPanel.appCel>false</IndustriaConfigPanel.appCel>
        <IndustriaConfigPanel.appFerramentaria>false</IndustriaConfigPanel.appFerramentaria>
        <IndustriaConfigPanel.appMi>false</IndustriaConfigPanel.appMi>
    </com.totvs.agro.installer.panels.industria.apps.AppsPanel>
    <com.totvs.agro.installer.panels.industria.IndustriaPathExe.IndustriaPathExePanel id="IndustriaPathExePanel">
        <IndustriaConfigPanel.industriaPathExe>C:\TOTVS-Agro\Industria\PI\EXE</IndustriaConfigPanel.industriaPathExe>
        <INSTALL_PATH>C:\TOTVS-Agro\Industria\PI\EXE</INSTALL_PATH>
    </com.totvs.agro.installer.panels.industria.IndustriaPathExe.IndustriaPathExePanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar2ConfigPanel id="databasePanelPI">
        <DatabaseAuxiliar2.type>ORACLE</DatabaseAuxiliar2.type>
        <DatabaseConfigPanelAuxiliar2.user>DB_USER_PI</DatabaseConfigPanelAuxiliar2.user>
        <DatabaseConfigPanelAuxiliar2.password>DB_PASS_PI</DatabaseConfigPanelAuxiliar2.password>
        <DatabaseConfigPanelAuxiliar2.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanelAuxiliar2.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseAuxiliar2ConfigPanel>
    <com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel id="com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel_12">
        <Database.type>ORACLE</Database.type>
        <DatabaseConfigPanel.user>DB_USER_BIO</DatabaseConfigPanel.user>
        <DatabaseConfigPanel.password>DB_PASS_BIO</DatabaseConfigPanel.password>
        <DatabaseConfigPanel.jdbcUrl>jdbc:oracle:thin:@127.0.0.1:1521/SID</DatabaseConfigPanel.jdbcUrl>
    </com.totvs.agro.installer.panels.dataBase.DatabaseConfigPanel>
    <com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel id="BioenergiaPathPanel">
        <BioenergiaPanel.pathApp>C:\TOTVS-Agro\Bioenergia\APP</BioenergiaPanel.pathApp>
    </com.totvs.agro.installer.panels.industria.bioenergia.BioenergiaPanel>
    <com.izforge.izpack.panels.install.InstallPanel id="install"/>
    <com.izforge.izpack.panels.process.ProcessPanel id="ProcessPanel_18"/>
    <com.izforge.izpack.panels.finish.FinishPanel id="finish"/>
</AutomatedInstallation>

CONFIGURAÇÃO DE LOGS

Para realizar a configuração do nível de logs gerados pelo instalador, basta editar o arquivo log4j2.xml, configurando o nível de log desejado.

Bloco de código
languagexml
firstline1
titleArquivo log4j2.xml
linenumberstrue
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <File name="FileLogger" fileName="logs/industria.log" append="true">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n"/>
        </File>
        <File name="LiquibaseScriptsLogger" fileName="logs/liquibase-scripts.log" append="true">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n"/>
        </File>
        <Console name="ConsoleLogger" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss} %-5level %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Logger name="com.totvs.agro.installer.industria.util.LiquibaseScriptRunnerUtil" level="info" additivity="false">
            <AppenderRef ref="LiquibaseScriptsLogger"/>
        </Logger>
        <Root level="info">
            <AppenderRef ref="FileLogger"/>
            <AppenderRef ref="ConsoleLogger"/>
        </Root>
    </Loggers>
</Configuration>

EXECUTANDO A INSTALAÇÃO / ATUALIZAÇÃO

Propriedades que requerem modificação: As propriedades representadas por ${} devem ser substituídas pelos valores específicos de cada cliente. As demais propriedades, que não seguem esse formato, não devem ser alteradas.  Abaixo listaremos as propriedades e suas respectivas funcionalidades.

Propriedades do TOTVS Agro API Hub: Descrição e Características

### Variáveis de seleção de produtos
TAG: ${INSTALL_BIOENERGIA}
Descrição: Habilita a instalação do módulo Bioenergia.
Exemplo: true

TAG: ${INSTALL_INDUSTRIA_MI}
Descrição: Habilita a instalação do módulo Indústria MI.
Exemplo: false

TAG: ${INSTALL_INDUSTRIA_PI}
Descrição: Habilita a instalação do módulo Indústria PI.
Exemplo: false
Observação: Valores aceitos: true | false.

TAG: ${CAMINHO_DA_INSTALACAO}
Descrição: Caminho de instalação do Api Hub (diretório base).
Exemplo: C:\TOTVS\ApiHub
Observação: Usado para montagem de caminhos nos scripts de instalação.

### TOTVS API Hub — Rede / serviço
TAG: ${API_HUB_IP_APLICACAO}
Descrição: Endereço IP ou host onde o serviço será acessível.
Exemplo: 0.0.0.0 ou api-hub.example.local

TAG: ${API_HUB_PORT_APLICACAO}
Descrição: Porta TCP do serviço.
Exemplo: 8080

TAG: ${API_HUB_SERVICE_NAME}
Descrição: Nome do serviço (somente para windows).
Exemplo: TOTVS-Apihub

TAG: ${API_HUB_SERVICE_DESCRIPTION}
Descrição: Descrição do serviço (somente para windows).
Exemplo: Serviço TOTVS API Hub

TAG: ${API_HUB_SERVER_CONTEXT}
Descrição: Context path da aplicação (contexto do servidor).
Exemplo: /api

### TOTVS API Hub — Database (Oracle)
TAG: ${API_HUB_TIPO_CONEXAO_DATABASE}
Descrição: Tipo de conexão Oracle (por exemplo: service ou sid).
Exemplo: service
Observação: Usado para compor URL de conexão.

TAG: ${API_HUB_USER_DATABASE}
Descrição: Usuário do schema do banco do Api Hub.
Exemplo: APHUB_USER

TAG: ${API_HUB_PASSWORD_DATABASE}
Descrição: Senha do usuário do banco do Api Hub.
Exemplo: s3nh@Exemplo

TAG: ${API_HUB_IP_DATABASE}
Descrição: Host/IP do servidor Oracle do Api Hub.
Exemplo: db-oracle.example.local

TAG: ${API_HUB_PORTA_DATABASE}
Descrição: Porta do listener Oracle.
Exemplo: 1521

TAG: ${API_HUB_NAME_DATABASE}
Descrição: Service name / SID do banco Oracle.
Exemplo: ORCLPDB1

TAG: ${API_HUB_DEFAULT_INSTANCE}
Descrição: Instância padrão usada pela aplicação.
Exemplo: 1

TAG: ${API_HUB_DEFAULT_COMPANY}
Descrição: Empresa padrão usada pela aplicação.
Exemplo: 1

### Banco de dados — Bioenergia (quando habilitado)
TAG: ${BIOENERGIA_TIPO_CONEXAO_DATABASE}
Descrição: Tipo de conexão Oracle para Bioenergia.
Exemplo: service

TAG: ${BIOENERGIA_USER_DATABASE}
Descrição: Usuário do schema Bioenergia.
Exemplo: BIO_USER

TAG: ${BIOENERGIA_PASSWORD_DATABASE}
Descrição: Senha do schema Bioenergia.
Exemplo: bioSenha123

TAG: ${BIOENERGIA_IP_DATABASE}
Descrição: Host/IP do Oracle do Bioenergia.
Exemplo: db-bio.example.local

TAG: ${BIOENERGIA_PORTA_DATABASE}
Descrição: Porta do listener Oracle para Bioenergia.
Exemplo: 1521

TAG: ${BIOENERGIA_NAME_DATABASE}
Descrição: Service name / SID do banco Bioenergia.
Exemplo: BIODB

### Banco de dados — Indústria MI (quando habilitado)
TAG: ${INDUSTRIA_MI_TIPO_CONEXAO_DATABASE}
Descrição: Tipo de conexão Oracle para Industria MI.
Exemplo: service

TAG: ${INDUSTRIA_MI_USER_DATABASE}
Descrição: Usuário do schema Industria MI.
Exemplo: MI_USER

TAG: ${INDUSTRIA_MI_PASSWORD_DATABASE}
Descrição: Senha do schema Industria MI.
Exemplo: miSenha123

TAG: ${INDUSTRIA_MI_IP_DATABASE}
Descrição: Host/IP do Oracle do Industria MI.
Exemplo: db-mi.example.local

TAG: ${INDUSTRIA_MI_PORTA_DATABASE}
Descrição: Porta do listener Oracle para Industria MI.
Exemplo: 1521

TAG: ${INDUSTRIA_MI_NAME_DATABASE}
Descrição: Service name / SID do banco Industria MI.
Exemplo: MIDB

### Banco de dados — Indústria PI (quando habilitado)
TAG: ${INDUSTRIA_PI_TIPO_CONEXAO_DATABASE}
Descrição: Tipo de conexão Oracle para Industria PI.
Exemplo: service

TAG: ${INDUSTRIA_PI_USER_DATABASE}
Descrição: Usuário do schema Industria PI.
Exemplo: PI_USER

TAG: ${INDUSTRIA_PI_PASSWORD_DATABASE}
Descrição: Senha do schema Industria PI.
Exemplo: piSenha123

TAG: ${INDUSTRIA_PI_IP_DATABASE}
Descrição: Host/IP do Oracle do Industria PI.
Exemplo: db-pi.example.local

TAG: ${INDUSTRIA_PI_PORTA_DATABASE}
Descrição: Porta do listener Oracle para Industria PI.
Exemplo: 1521

TAG: ${INDUSTRIA_PI_NAME_DATABASE}
Descrição: Service name / SID do banco Industria PI.
Exemplo: PIDB

### SSL / HTTPS
TAG: ${SSL_ENABLED}
Descrição: Habilita HTTPS/SSL.
Exemplo: true

TAG: ${SSL_KEYSTORE_PATH}
Descrição: Caminho para o keystore JKS/PKCS12 contendo o certificado do servidor.
Exemplo: C:\certs\keystore.jks

TAG: ${SSL_KEYSTORE_PASSWORD}
Descrição: Senha do keystore.
Exemplo: changeme

### JVM / memória
TAG: ${MEMORY_INITIAL}
Descrição: Valor -Xms inicial da JVM.
Exemplo: 512m

TAG: ${MEMORY_MAX}
Descrição: Valor -Xmx máximo da JVM.
Exemplo: 2048m

### Credenciais da API (OAuth / cliente)
TAG: ${CREDENTIALS_CLIENT_ID}
Descrição: Client ID usado pela aplicação para autenticação.
Exemplo: ta-api-hub-client

TAG: ${CREDENTIALS_CLIENT_SECRET}
Descrição: Client Secret associado ao Client ID.
Exemplo: s3nh@Secr3t


Exemplo de arquivo com as propriedades, utilizado no processo de instalação:

  • Windows
Bloco de código
languagetext
firstline1
titleArquivo totvs-agro-ta-api-hub-windows-oracle.properties
linenumberstrue
collapsetrue
#TOTVS Agro Java Spring - Windows + Oracle

target.os=windows

bioenergia.selected=${INSTALL_BIOENERGIA}
industria.mi.selected=${INSTALL_INDUSTRIA_MI}
industria.pi.selected=${INSTALL_INDUSTRIA_PI}

iz.api.hub.path=${CAMINHO_DA_INSTALACAO}

## TOTVS Api Hub
# Network
api.hub.service.address=${API_HUB_IP_APLICACAO}
api.hub.service.port=${API_HUB_PORT_APLICACAO}
api.hub.service.name=${API_HUB_SERVICE_NAME}
api.hub.service.description=${API_HUB_SERVICE_DESCRIPTION}
api.hub.server.context=${API_HUB_SERVER_CONTEXT}

# Database
api.hub.database.dbms=oracle
api.hub.database.oracle.connection.type=${API_HUB_TIPO_CONEXAO_DATABASE}
api.hub.database.connection.dialect=org.hibernate.dialect.Oracle11cDialect
api.hub.database.user=${API_HUB_USER_DATABASE}
api.hub.database.password=${API_HUB_PASSWORD_DATABASE}
api.hub.database.host=${API_HUB_IP_DATABASE}
api.hub.database.port=${API_HUB_PORTA_DATABASE}
api.hub.database.name=${API_HUB_NAME_DATABASE}
api.hub.database.url=jdbc:oracle:thin:@//${API_HUB_IP_DATABASE}:${API_HUB_PORTA_DATABASE}/${API_HUB_NAME_DATABASE}

# Additional info
api.hub.default.instance=${API_HUB_DEFAULT_INSTANCE}
api.hub.default.company=${API_HUB_DEFAULT_COMPANY}

# Database Products
## Bioenergia - Database
bioenergia.database.dbms=oracle
bioenergia.database.oracle.connection.type=${BIOENERGIA_TIPO_CONEXAO_DATABASE}
bioenergia.database.connection.dialect=org.hibernate.dialect.Oracle11cDialect
bioenergia.database.user=${BIOENERGIA_USER_DATABASE}
bioenergia.database.password=${BIOENERGIA_PASSWORD_DATABASE}
bioenergia.database.host=${BIOENERGIA_IP_DATABASE}
bioenergia.database.port=${BIOENERGIA_PORTA_DATABASE}
bioenergia.database.name=${BIOENERGIA_NAME_DATABASE}
bioenergia.database.url=jdbc:oracle:thin:@//${BIOENERGIA_IP_DATABASE}:${BIOENERGIA_PORTA_DATABASE}/${BIOENERGIA_NAME_DATABASE}

## Industria MI - Database
industria.mi.database.dbms=oracle
industria.mi.database.oracle.connection.type=${INDUSTRIA_MI_TIPO_CONEXAO_DATABASE}
industria.mi.database.connection.dialect=org.hibernate.dialect.Oracle11gDialect
industria.mi.database.user=${INDUSTRIA_MI_USER_DATABASE}
industria.mi.database.password=${INDUSTRIA_MI_PASSWORD_DATABASE}
industria.mi.database.host=${INDUSTRIA_MI_IP_DATABASE}
industria.mi.database.port=${INDUSTRIA_MI_PORTA_DATABASE}
industria.mi.database.name=${INDUSTRIA_MI_NAME_DATABASE}
industria.mi.database.url=jdbc:oracle:thin:@//${INDUSTRIA_MI_IP_DATABASE}:${INDUSTRIA_MI_PORTA_DATABASE}/${INDUSTRIA_MI_NAME_DATABASE}

## Industria PI - Database
industria.pi.database.dbms=oracle
industria.pi.database.oracle.connection.type=${INDUSTRIA_PI_TIPO_CONEXAO_DATABASE}
industria.pi.database.connection.dialect=org.hibernate.dialect.Oracle11gDialect
industria.pi.database.user=${INDUSTRIA_PI_USER_DATABASE}
industria.pi.database.password=${INDUSTRIA_PI_PASSWORD_DATABASE}
industria.pi.database.host=${INDUSTRIA_PI_IP_DATABASE}
industria.pi.database.port=${INDUSTRIA_PI_PORTA_DATABASE}
industria.pi.database.name=${INDUSTRIA_PI_NAME_DATABASE}
industria.pi.database.url=jdbc:oracle:thin:@//${INDUSTRIA_PI_IP_DATABASE}:${INDUSTRIA_PI_PORTA_DATABASE}/${INDUSTRIA_PI_NAME_DATABASE}

# Middleware
middleware.enabled=false
middleware.ip=
middleware.port=

# SSL / HTTPS
ssl.enabled=${SSL_ENABLED}
ssl.keystore.path=${SSL_KEYSTORE_PATH}
ssl.keystore.password=${SSL_KEYSTORE_PASSWORD}

# Memory JVM
memory.initial=${MEMORY_INITIAL}
memory.max=${MEMORY_MAX}

# Credentials API
credentials.client.id=${CREDENTIALS_CLIENT_ID}
credentials.client.secret=${CREDENTIALS_CLIENT_SECRET}

##


  • Linux
Bloco de código
languagetext
firstline1
titleArquivo totvs-agro-ta-api-hub-linux-oracle.properties
linenumberstrue
collapsetrue
#TOTVS Agro Java Spring - Linux + Oracle

target.os=unix
unix.distro=RedHat

bioenergia.selected=${INSTALL_BIOENERGIA}
industria.mi.selected=${INSTALL_INDUSTRIA_MI}
industria.pi.selected=${INSTALL_INDUSTRIA_PI}

iz.api.hub.path=${CAMINHO_DA_INSTALACAO}

## TOTVS Api Hub
# Network
api.hub.service.address=${API_HUB_IP_APLICACAO}
api.hub.service.port=${API_HUB_PORT_APLICACAO}
api.hub.server.context=${API_HUB_SERVER_CONTEXT}

# Database
api.hub.database.dbms=oracle
api.hub.database.oracle.connection.type=${API_HUB_TIPO_CONEXAO_DATABASE}
api.hub.database.connection.dialect=org.hibernate.dialect.Oracle11cDialect
api.hub.database.user=${API_HUB_USER_DATABASE}
api.hub.database.password=${API_HUB_PASSWORD_DATABASE}
api.hub.database.host=${API_HUB_IP_DATABASE}
api.hub.database.port=${API_HUB_PORTA_DATABASE}
api.hub.database.name=${API_HUB_NAME_DATABASE}
api.hub.database.url=jdbc:oracle:thin:@//${API_HUB_IP_DATABASE}:${API_HUB_PORTA_DATABASE}/${API_HUB_NAME_DATABASE}

# Additional info
api.hub.default.instance=${API_HUB_DEFAULT_INSTANCE}
api.hub.default.company=${API_HUB_DEFAULT_COMPANY}

# Database Products
## Bioenergia - Database
bioenergia.database.dbms=oracle
bioenergia.database.oracle.connection.type=${BIOENERGIA_TIPO_CONEXAO_DATABASE}
bioenergia.database.connection.dialect=org.hibernate.dialect.Oracle11cDialect
bioenergia.database.user=${BIOENERGIA_USER_DATABASE}
bioenergia.database.password=${BIOENERGIA_PASSWORD_DATABASE}
bioenergia.database.host=${BIOENERGIA_IP_DATABASE}
bioenergia.database.port=${BIOENERGIA_PORTA_DATABASE}
bioenergia.database.name=${BIOENERGIA_NAME_DATABASE}
bioenergia.database.url=jdbc:oracle:thin:@//${BIOENERGIA_IP_DATABASE}:${BIOENERGIA_PORTA_DATABASE}/${BIOENERGIA_NAME_DATABASE}

## Industria MI - Database
industria.mi.database.dbms=oracle
industria.mi.database.oracle.connection.type=${INDUSTRIA_MI_TIPO_CONEXAO_DATABASE}
industria.mi.database.connection.dialect=org.hibernate.dialect.Oracle11gDialect
industria.mi.database.user=${INDUSTRIA_MI_USER_DATABASE}
industria.mi.database.password=${INDUSTRIA_MI_PASSWORD_DATABASE}
industria.mi.database.host=${INDUSTRIA_MI_IP_DATABASE}
industria.mi.database.port=${INDUSTRIA_MI_PORTA_DATABASE}
industria.mi.database.name=${INDUSTRIA_MI_NAME_DATABASE}
industria.mi.database.url=jdbc:oracle:thin:@//${INDUSTRIA_MI_IP_DATABASE}:${INDUSTRIA_MI_PORTA_DATABASE}/${INDUSTRIA_MI_NAME_DATABASE}

## Industria PI - Database
industria.pi.database.dbms=oracle
industria.pi.database.oracle.connection.type=${INDUSTRIA_PI_TIPO_CONEXAO_DATABASE}
industria.pi.database.connection.dialect=org.hibernate.dialect.Oracle11gDialect
industria.pi.database.user=${INDUSTRIA_PI_USER_DATABASE}
industria.pi.database.password=${INDUSTRIA_PI_PASSWORD_DATABASE}
industria.pi.database.host=${INDUSTRIA_PI_IP_DATABASE}
industria.pi.database.port=${INDUSTRIA_PI_PORTA_DATABASE}
industria.pi.database.name=${INDUSTRIA_PI_NAME_DATABASE}
industria.pi.database.url=jdbc:oracle:thin:@//${INDUSTRIA_PI_IP_DATABASE}:${INDUSTRIA_PI_PORTA_DATABASE}/${INDUSTRIA_PI_NAME_DATABASE}

# Middleware
middleware.enabled=false
middleware.ip=
middleware.port=

# SSL / HTTPS
ssl.enabled=${SSL_ENABLED}
ssl.keystore.path=${SSL_KEYSTORE_PATH}
ssl.keystore.password=${SSL_KEYSTORE_PASSWORD}

# Memory JVM
memory.initial=${MEMORY_INITIAL}
memory.max=${MEMORY_MAX}

# Credentials API
credentials.client.id=${CREDENTIALS_CLIENT_ID}
credentials.client.secret=${CREDENTIALS_CLIENT_SECRET}

##


EXECUTANDO A INSTALAÇÃO / ATUALIZAÇÃO

Após configurado o arquivo totvs-agro-ta-api-hub-oracle.propertiesApós configurado o arquivo auto-install.xml, para iniciar o processo de instalação / atualizaçao em modo silencioso, basta executar o arquivo autoinstall-installsilent.bat em modo Administrador, e o processo irá iniciar automaticamente.

Image Added


FALHA NO PROCESSO DE INSTALAÇÃO / ATUALIZAÇÃO

Caso alguma informação no arquivo totvs-agro-ta-api-hub-oracle.properties esteja incorreta ou inválida, o processo de instalação, ao identificar a inconsistência, será abortado, exibindo a mensagem informativa, conforme exemplo abaixo:

Image Added