TOTVS AGRO

Páginas filhas
  • TOTVS Agro PIMSConnector

 A instalação silenciosa é um método de instalação de software que ocorre sem interação do usuário. Isso significa que não são exibidas janelas, mensagens ou prompts durante o processo, tornando-o ideal para cenários em que é necessário instalar o TOTVS Agro PIMSConnector por meio de linha de comando ou através de esteiras automatizadas.





Os pacotes do TOTVS Agro PIMSConnector estão disponíveis na Central de Downloads da TOTVS. Abaixo, seguem os links que podem ser utilizados para acessá-los:








Nesta seção, serão apresentados os requisitos e os scripts de banco de dados necessários para a instalação do TOTVS Agro PIMSConnector.



A seguir, são apresentados os parâmetros, configurações e scripts utilizados para a criação do banco de dados Oracle.


Charset do banco que deverá ser atribuído nas configurações do banco de dados:

  • NLS_CHARACTERSET: WE8MSWIN1252



O TOTVS Agro PIMSConnector requer a criação das seguintes tablespaces:

  • Tablespace de Dados: PIMS_DATA
  • Tablespace de Índice: PIMS_INDX


Tablespace
CREATE TABLESPACE PIMS_DATA DATAFILE '/u01/oradata/orcl/PIMS_DATA.ORA' SIZE 20G;

CREATE TABLESPACE PIMS_INDX DATAFILE '/u01/oradata/orcl/PIMS_INDEX.ORA' SIZE 20G;


Criação do Owner e Atribuição de Permissões

Criação do Owner
CREATE USER NOME_OWNER IDENTIFIED BY "SENHA_OWNER" DEFAULT TABLESPACE PIMS_DATA TEMPORARY TABLESPACE TEMP PROFILE DEFAULT ACCOUNT UNLOCK;
    

GRANT CONNECT TO "NOME_OWNER";
GRANT RESOURCE TO "NOME_OWNER";
GRANT UNLIMITED TABLESPACE TO "NOME_OWNER";
GRANT CREATE SYNONYM TO "NOME_OWNER";
GRANT CREATE VIEW TO "NOME_OWNER";
GRANT CREATE PROCEDURE TO "NOME_OWNER";
GRANT CREATE TRIGGER TO "NOME_OWNER";
GRANT CREATE SEQUENCE TO "NOME_OWNER";
GRANT CREATE MATERIALIZED VIEW TO "NOME_OWNER";


A seguir, são apresentados os parâmetros, configurações e scripts utilizados para a criação do banco de dados SQL Server.


Collate do banco que deverá ser atribuído nas configurações do banco de dados:

  • Latin1_General_CI_AS


O modelo a seguir demonstra o processo de criação da estrutura do banco de dados com base no modelo de banco de dados com múltiplos schemas.





No script de criação do Banco de Dados, a propriedade {{DB_NAME}} deve ser substituída pelo nome do banco de dados que será criado no ambiente



Criação do Banco de Dados 
-- Description: Script de criação de banco de dados SQL Server. O Banco de dados Agro utiliza a collation Latin1_General_CI_AS.
CREATE DATABASE [{{DB_NAME}}]
 CONTAINMENT = NONE
 ON  PRIMARY 
( NAME = N'{{DB_NAME}}', FILENAME = N'{{DB_FILE_DATABASE}}{{DB_NAME}}.mdf' , SIZE = 8192KB , FILEGROWTH = 65536KB )
 LOG ON 
( NAME = N'{{DB_NAME}}_log', FILENAME = N'{{DB_FILE_DATABASE_LOG}}{{DB_NAME}}_log.ldf' , SIZE = 8192KB , FILEGROWTH = 65536KB )
 COLLATE Latin1_General_CI_AS
GO
ALTER DATABASE [{{DB_NAME}}] SET COMPATIBILITY_LEVEL = 150
GO
ALTER DATABASE [{{DB_NAME}}] SET ANSI_NULL_DEFAULT OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET ANSI_NULLS OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET ANSI_PADDING OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET ANSI_WARNINGS OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET ARITHABORT OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET AUTO_CLOSE OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET AUTO_SHRINK OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET AUTO_CREATE_STATISTICS ON(INCREMENTAL = OFF)
GO
ALTER DATABASE [{{DB_NAME}}] SET AUTO_UPDATE_STATISTICS ON 
GO
ALTER DATABASE [{{DB_NAME}}] SET CURSOR_CLOSE_ON_COMMIT OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET CURSOR_DEFAULT  GLOBAL 
GO
ALTER DATABASE [{{DB_NAME}}] SET CONCAT_NULL_YIELDS_NULL OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET NUMERIC_ROUNDABORT OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET QUOTED_IDENTIFIER OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET RECURSIVE_TRIGGERS OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET  DISABLE_BROKER 
GO
ALTER DATABASE [{{DB_NAME}}] SET AUTO_UPDATE_STATISTICS_ASYNC OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET DATE_CORRELATION_OPTIMIZATION OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET PARAMETERIZATION SIMPLE 
GO
ALTER DATABASE [{{DB_NAME}}] SET READ_COMMITTED_SNAPSHOT OFF 
GO
ALTER DATABASE [{{DB_NAME}}] SET  READ_WRITE 
GO
ALTER DATABASE [{{DB_NAME}}] SET RECOVERY FULL 
GO
ALTER DATABASE [{{DB_NAME}}] SET  MULTI_USER 
GO
ALTER DATABASE [{{DB_NAME}}] SET PAGE_VERIFY CHECKSUM  
GO
ALTER DATABASE [{{DB_NAME}}] SET TARGET_RECOVERY_TIME = 60 SECONDS 
GO
ALTER DATABASE [{{DB_NAME}}] SET DELAYED_DURABILITY = DISABLED 
GO
USE [{{DB_NAME}}]
GO
ALTER DATABASE SCOPED CONFIGURATION SET LEGACY_CARDINALITY_ESTIMATION = Off;
GO
ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET LEGACY_CARDINALITY_ESTIMATION = Primary;
GO
ALTER DATABASE SCOPED CONFIGURATION SET MAXDOP = 0;
GO
ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET MAXDOP = PRIMARY;
GO
ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = On;
GO
ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET PARAMETER_SNIFFING = Primary;
GO
ALTER DATABASE SCOPED CONFIGURATION SET QUERY_OPTIMIZER_HOTFIXES = Off;
GO
ALTER DATABASE SCOPED CONFIGURATION FOR SECONDARY SET QUERY_OPTIMIZER_HOTFIXES = Primary;
GO
USE [{{DB_NAME}}]
GO
IF NOT EXISTS (SELECT name FROM sys.filegroups WHERE is_default=1 AND name = N'PRIMARY') ALTER DATABASE [{{DB_NAME}}] MODIFY FILEGROUP [PRIMARY] DEFAULT
GO

No script de criação da estrutura do schema SSMA_ORACLE (também conhecido como SYSDB), é necessário substituir a propriedade {{DB_NAME}} pelo nome do banco de dados que será utilizado no ambiente. O script está disponível no arquivo totvs-agro-template_ssma_oracle.sql.


Devido ao extenso número de linhas, o conteúdo não será exibido diretamente nesta página, mas estará disponível como um arquivo anexo. Após realizar o download, substitua a propriedade {{DB_NAME}} pelo nome do banco de dados criado na seção anterior.



totvs-agro-template_ssma_oracle.sql


Nesta etapa, será necessário modificar as propriedades indicadas entre {{ }}. Essas propriedades são responsáveis por configurar a criação das estruturas de Login, Usuário e Schema. Além disso, o processo inclui a atribuição das permissões necessárias e o estabelecimento dos relacionamentos entre os schemas e suas respectivas dependências.

As propriedades que precisam ser ajustadas são:

  • {{DB_USUARIO_PCONNECTOR}}: Define o nome do usuário que terá acesso ao banco de dados.

  • {{DB_SENHA_PIMS_CONNECTOR}}: Define a senha associada ao usuário do banco de dados.

  • {{DB_NAME}}: Define o nome do banco de dados que será utilizado.


Criação do Usuario e Schena
-- Criação do Usuário do {{DB_USUARIO_PCONNECTOR}}
CREATE LOGIN {{DB_USUARIO_PCONNECTOR}} WITH PASSWORD = '{{DB_SENHA_PIMS_CONNECTOR}}';

-- Utilizando o Banco de Dados {{DB_NAME}}
USE [{{DB_NAME}}];
GO

-- Criar Usuário no Banco de Dados {{DB_USUARIO_PCONNECTOR}}
CREATE USER {{DB_USUARIO_PCONNECTOR}} FOR LOGIN {{DB_USUARIO_PCONNECTOR}};

-- Concedendo as Permissões ao Usuário {{DB_USUARIO_PCONNECTOR}}
GRANT SELECT, INSERT, UPDATE, DELETE TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE TABLE TO {{DB_USUARIO_PCONNECTOR}};
GRANT EXECUTE TO {{DB_USUARIO_PCONNECTOR}};
GRANT CONNECT TO {{DB_USUARIO_PCONNECTOR}};
GRANT ALTER TO {{DB_USUARIO_PCONNECTOR}};
GRANT VIEW DEFINITION TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE SYNONYM TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE PROCEDURE TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE VIEW TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE FUNCTION TO {{DB_USUARIO_PCONNECTOR}};
GRANT CREATE SCHEMA TO {{DB_USUARIO_PCONNECTOR}};



--Criação do Schema do {{DB_USUARIO_PCONNECTOR}}
USE [{{DB_NAME}}]
GO
CREATE SCHEMA [{{DB_USUARIO_PCONNECTOR}}] AUTHORIZATION [{{DB_USUARIO_PCONNECTOR}}]
GO


--Atribuição do Schema Default do {{DB_USUARIO_PCONNECTOR}}
USE [{{DB_NAME}}]
GO
ALTER USER [{{DB_USUARIO_PCONNECTOR}}] WITH DEFAULT_SCHEMA=[{{DB_USUARIO_PCONNECTOR}}]
GO


--Ajuste da Permissão do {{DB_USUARIO_PCONNECTOR}} para acessar o Schema ssma_oracle
USE [{{DB_NAME}}]
GO
ALTER AUTHORIZATION ON SCHEMA::[ssma_oracle] TO [{{DB_USUARIO_PCONNECTOR}}]


Nesta etapa, serão apresentados os requisitos necessários para o funcionamento do instalador silencioso. Esses requisitos são essenciais para a execução dos scripts de banco de dados e para a criação da estrutura de pastas que receberão os arquivos do TOTVS Agro PIMSConnector.



Utilitários para comunicação com Bancos de Dados

Nesta seção, são descritos os requisitos de software para comunicação entre o Instalador/Atualizador do TOTVS Agro PIMSConnector e as ferramentas necessárias para execução de scripts em banco de dados:


  • SQLPLUS - Ferramenta utilitária para execução de instruções SQL
    • Windows
      • Versões homologadas (sqlplus)
        • Versão 12.1.0.2.0
        • Versão 19.3.0.0.0
    • Linux
      • Versões homologadas (sqlplus)
        • Versão 12.1.0.2.0
        • Versão 19.6.0.0.0


É necessário criar um diretório dedicado para armazenar os artefatos do produto, como o JDK, o Wildfly e demais arquivos essenciais para a instalação e configuração do sistema. 

Windows

Sugestão de diretório:
C:\TOTVS\TOTVSPIMSConnector

Permissões recomendadas:

  • Modificação

  • Leitura & Execução

  • Escrita

Linux

Sugestão de diretório:
/opt/TOTVS/TOTVSPIMSConnector

Permissões recomendadas:

  • Propriedade:

    • Usuário

    • Grupo

  • Permissões do diretório:

    • Modificação: rwxr-xr-x (755)

  • Essas permissões precisam ser atribuidas recursivamente para todos os subdiretórios 


Os parâmetros de entrada são definidos por meio do preenchimento de um arquivo de propriedades, que pode ser totvs-agro-pimsconnector-oracle.properties ou totvs-agro-pimsconnector-sqlserver.properties, dependendo do banco de dados utilizado. Esses atributos, que serão aplicados durante a instalação, devem ser preenchidos previamente com todos os valores necessários, os quais normalmente seriam fornecidos pelo usuário em uma instalação convencional.


# TOTVS Agro PIMSConnector - Linux + Oracle

target.os=unix
action=NEW_INSTANCE
unix.distro=RedHat

#target
path=${CAMINHO_DA_INSTALACAO}

#instance
selected.instance.name=${NOME_INSTANCIA}
selected.service.name=${NOME_SERVICO}
selected.service.description=${DESCRICAO_SERVICO}

#database
database.dbms=oracle
database.oracle.connection.type=${TIPO_CONEXAO_DATABASE} # Exemplo: sid / servicename
database.host=${IP_DATABASE} # Exemplo: 255.255.255.255
database.port=${PORTA_DATABASE}
database.name=${NOME_BASE_DATABASE}
database.user=${USER_DATABASE}
database.password=${PASSWORD_DATABASE}
database.url=jdbc:oracle:thin:@//${IP_DATABASE}:${PORTA_DATABASE}/${NOME_BASE_DATABASE}
database.idle.timeout.minutes=5
database.min.pool.size=5
database.max.pool.size=20

#integration
integration.dbms=oracle
integration.oracle.connection.type=${TIPO_CONEXAO_INTEGRATION} # Exemplo: sid / servicename
integration.host=${IP_INTEGRATION} # Exemplo: 255.255.255.255
integration.port=${PORTA_INTEGRATION}
integration.name=${NOME_BASE_INTEGRATION}
integration.user=${USER_INTEGRATION}
integration.password=${PASSWORD_INTEGRATION}
integration.url=jdbc:oracle:thin:@//${IP_INTEGRATION}:${PORTA_INTEGRATION}/${NOME_BASE_INTEGRATION}
integration.idle.timeout.minutes=5
integration.min.pool.size=5
integration.max.pool.size=20

#network
network.ip=${IP_APLICACAO} # Exemplo: 255.255.255.255
network.port.offset=${BIND_PORT} # Exemplo: ports-01 == 8100 / ports-02 == 8280



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, listamos essas propriedades e suas respectivas funcionalidades


${CAMINHO_DA_INSTALACAO}
Descrição: Define o diretório onde o TOTVS Agro PIMSConnector será instalado.
Exemplo: C:\\TOTVS-Agro\\PIMSConnector ou /opt/totvs/PIMSConnector.


${NOME_INSTANCIA}
Descrição: Nome da instância que será criada durante a instalação.
Exemplo: PRODUCAO / HOMOLOGACAO.


${NOME_SERVICO}
Descrição: Nome do serviço que será registrado no sistema operacional.
Exemplo: TOTVS_AGRO_PIMSCONNECTOR_PRODUCAO.


${DESCRICAO_SERVICO}
Descrição: Descrição do serviço que será exibida no gerenciador de serviços do sistema operacional.
Exemplo: Serviço do TOTVS Agro PIMSCONNECTOR - Produção.


${TIPO_CONEXAO_DATABASE}
Descrição: Tipo de conexão com o banco de dados (sid ou servicename).
Exemplo: sid.


${IP_DATABASE}
Descrição: Endereço IP ou hostname do servidor do banco de dados principal.
Exemplo: 192.168.1.100.


${PORTA_DATABASE}
Descrição: Porta utilizada para conexão com o banco de dados principal.
Exemplo: 1521.


${NOME_BASE_DATABASE}
Descrição: Nome da base de dados principal.
Exemplo: AGRO_DB.


${USER_DATABASE}
Descrição: Usuário para conexão com o banco de dados principal.
Exemplo: totvs_user.


${PASSWORD_DATABASE}
Descrição: Senha do usuário para conexão com o banco de dados principal.
Exemplo: SenhaSegura123.


${TIPO_CONEXAO_INTEGRATION}
Descrição: Tipo de conexão com o banco de dados de integração (sid ou servicename). 
Exemplo: sid.


${IP_INTEGRATION}
Descrição: Endereço IP ou hostname do servidor do banco de dados de integração.
Exemplo: 192.168.1.101.


${PORTA_INTEGRATION}
Descrição: Porta utilizada para conexão com o banco de dados de integração.
Exemplo: 1521.


${NOME_BASE_INTEGRATION}
Descrição: Nome da base de dados de integração.
Exemplo: INTEGRATION_DB.


${USER_INTEGRATION}
Descrição: Usuário para conexão com o banco de dados de integração.
Exemplo: integration_user.


${PASSWORD_INTEGRATION}
Descrição: Senha do usuário para conexão com o banco de dados de integração.
Exemplo: SenhaIntegracao123.


${IP_APLICACAO}
Descrição: Endereço IP ou hostname da aplicação.
Exemplo: 192.168.1.200.



${BIND_PORT}
Descrição: Offset da porta da aplicação. 
Exemplo: ports-01 == 8100 / ports-02 == 8280


O processo de execução do instalador silencioso é realizado por meio dos utilitários:

  • install-silent.sh para Linux.

  • install-silent.bat para Windows.


A chamada do instalador deve ser feita da seguinte forma:


Linux:

./install-silent.sh <banco_de_dados>

Windows:

install-silent.bat <banco_de_dados>

O parâmetro <banco_de_dados> deve ser substituído pelo banco de dados que será utilizado, podendo ser oracle ou sqlserver.

Abaixo está um exemplo de como realizar a chamada:


Exemplo para Oracle:

./install-silent.sh oracle

Exemplo para SQL Server:

./install-silent.sh sqlserver

Produto: Engenharia & Framework Agro

Detalhes do Produto

Instalador Silencioso do TOTVS Agro PIMSConnector


Sistema Operacional Suportado

  • Linux
  • Windows

Status: Em desenvolvimento

  • Sem rótulos