Este documento descreve os requisitos recomendados para a instalação e operação do TOTVS Agro Meus Abastecimentos. Atender a esses requisitos é essencial para garantir desempenho adequado e estabilidade do ambiente.





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


  • TOTVS Agro Meus Abastecimentos

https://suporte.totvs.com/portal/p/10098/download#000050/125/TCLOUD_MULTICULTIVO/search/searchAll







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





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 Multicultivo requer a criação das seguintes tablespaces:

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


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 de Owner e Atribuição de Permissões


CREATE USER {{DB_USUARIO_MINHA_BORRACHARIA}} IDENTIFIED BY "{{DB_SENHA_MINHA_BORRACHARIA}}" DEFAULT TABLESPACE PIMS_DATA TEMPORARY TABLESPACE TEMP PROFILE DEFAULT ACCOUNT UNLOCK;  
 
GRANT CONNECT                    TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT "RESOURCE                  TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT UNLIMITED TABLESPACE       TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT DEBUG CONNECT SESSION      TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT DEBUG ANY PROCEDURE        TO {{DB_USUARIO_MINHA_BORRACHARIA}};  
GRANT CREATE SYNONYM             TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT CREATE VIEW                TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT CREATE PROCEDURE           TO {{DB_USUARIO_MINHA_BORRACHARIA}}; 
GRANT CREATE TRIGGER             TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT CREATE SEQUENCE            TO {{DB_USUARIO_MINHA_BORRACHARIA}}; 
GRANT CREATE MATERIALIZED VIEW   TO {{DB_USUARIO_MINHA_BORRACHARIA}};
GRANT UNLIMITED TABLESPACE       TO {{DB_USUARIO_MINHA_BORRACHARIA}};
 
ALTER USER {{DB_USUARIO_MINHA_BORRACHARIA}} QUOTA UNLIMITED ON PIMS_DATA;
ALTER USER {{DB_USUARIO_MINHA_BORRACHARIA}} QUOTA UNLIMITED ON PIMS_INDX;
CREATE USER {{DB_USUARIO_MOBILIDADE_MANFRO}} IDENTIFIED BY "{{DB_SENHA_MOBILIDADE_MANFRO}}" DEFAULT TABLESPACE PIMS_DATA TEMPORARY TABLESPACE TEMP PROFILE DEFAULT ACCOUNT UNLOCK;  

GRANT CONNECT                    TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT "RESOURCE                  TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT UNLIMITED TABLESPACE       TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT DEBUG CONNECT SESSION      TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT DEBUG ANY PROCEDURE        TO {{DB_USUARIO_MOBILIDADE_MANFRO}};  
GRANT CREATE SYNONYM             TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT CREATE VIEW                TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT CREATE PROCEDURE           TO {{DB_USUARIO_MOBILIDADE_MANFRO}}; 
GRANT CREATE TRIGGER             TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT CREATE SEQUENCE            TO {{DB_USUARIO_MOBILIDADE_MANFRO}}; 
GRANT CREATE MATERIALIZED VIEW   TO {{DB_USUARIO_MOBILIDADE_MANFRO}};
GRANT UNLIMITED TABLESPACE		 TO {{DB_USUARIO_MOBILIDADE_MANFRO}};

ALTER USER {{DB_USUARIO_MOBILIDADE_MANFRO}} QUOTA UNLIMITED ON PIMS_DATA;
ALTER USER {{DB_USUARIO_MOBILIDADE_MANFRO}} QUOTA UNLIMITED ON PIMS_INDX; 



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


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



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_MULTICULTIVO}}: Define o nome do usuário que terá acesso ao banco de dados.

  • {{DB_SENHA_MULTICULTIVO}}: 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 Usuário do {{DB_USUARIO_MULTICULTIVO}}
CREATE LOGIN {{DB_USUARIO_MULTICULTIVO}} WITH PASSWORD = '{{DB_SENHA_MULTICULTIVO}}';

-- 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_MULTICULTIVO}} FOR LOGIN {{DB_USUARIO_MULTICULTIVO}};

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



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


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


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


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



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