Índice

VISÃO GERAL

Abordaremos as etapas necessárias para o processo de instalação / atualizaçao do TOTVS Agro API Hub, por meio da ferramenta Instalador/Atualizador em modo silencioso (modo não interativo).

...

PRÉ-REQUISITOS

1. Versão Mínima para Atualização

A versão mínima necessária do TOTVS Agro API Hub, para o processo de atualização, para utilizar o instalador é a 12.1.2512.

...

PACOTE DE INSTALAÇÃO / ATUALIZAÇÃO

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 Added

/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 processo de instalação/atualização em modo silencioso.
log4j2.xml: Utilizado para configurar os logs do instalador.

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

Antes de executar o instalador em modo silencioso, é necessário que o arquivo auto-install.xml esteja corretamente preenchido, este arquivo define os parâmetros para a instalação / atualização do TOTVS Agro Indústria.

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

Bloco de código

language	xml
firstline	1
title	Arquivo auto-install.xml
linenumbers	true

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

language	xml
firstline	1
title	Arquivo auto-install.xml
linenumbers	true
collapse	true

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

language	xml
firstline	1
title	Arquivo auto-install.xml
linenumbers	true
collapse	true

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

language	xml
firstline	1
title	Arquivo log4j2.xml
linenumbers	true

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

Após configurado o arquivo auto-install.xml, para iniciar o processo de instalação / atualizaçao em modo silencioso, basta executar o arquivo auto-install.bat em modo Administrador, e o processo irá iniciar automaticamente.

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

VISÃO GERAL

PRÉ-REQUISITOS

1. Versão Mínima para Atualização

PACOTE DE INSTALAÇÃO / ATUALIZAÇÃO

EXECUÇÃO DO INSTALADOR EM MODO SILENCIOSO

ESTRUTURA DE ARQUIVOS

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

CONFIGURAÇÃO DE LOGS

EXECUTANDO A INSTALAÇÃO / ATUALIZAÇÃO

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

VISÃO GERAL

PRÉ-REQUISITOS

1. Versão Mínima para Atualização

PACOTE DE INSTALAÇÃO / ATUALIZAÇÃO

EXECUÇÃO DO INSTALADOR EM MODO SILENCIOSO

ESTRUTURA DE ARQUIVOS

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

CONFIGURAÇÃO DE LOGS

EXECUTANDO A INSTALAÇÃO / ATUALIZAÇÃO