Pular para o conteúdo principal
Versão: 2.2.3

Configuração do banco de dados

LINUX

Microsoft SQL Server

Esta seção aborda o procedimento para criar e configurar o banco de dados no SQL Server. Para isso, siga os passos abaixo:

Consulte o documento "SoftExpert Suite - Requisitos do Sistema" para obter mais detalhes sobre as considerações para o SQL Server.

cuidado

Observação: Se a versão do banco de dados for SQL Server 2019, o banco deve estar, no mínimo, com o patch 15.04138 (CU11), conforme a lista de patches no site: https://sqlserverupdates.com/sql-server-2019-updates/. É extremamente recomendado manter os patches de correções dos bancos de dados sempre atualizados, pois podem conter correção de bugs da Engine.

Este procedimento considera que o SQL Server está instalado corretamente.

  1. Abra o SQL Server Management Studio.

  2. Conecte-se com o servidor.

  3. Clique com o botão direito em Databases e, em seguida, na opção New Database.

  4. Do lado esquerdo, na página General, informe um nome em Database name.

Exemplo: sesuite

  1. Do lado esquerdo, na página Options, escolha o 'collation' a ser utilizado e clique em OK.

Os collations que podem ser utilizados, nas línguas ocidentais, para a base do SoftExpert Suite no SQL Server são:

  • SQL_Latin1_General_CP1_CI_AS

  • SQL_Latin1_General_CP1_CI_AI

  • Latin1_General_CI_AS

  • Latin1_General_CI_AI

O parâmetro CI (Case Insensitive) do collation sempre deve ser utilizado. Recomendamos a utilização do parâmetro AI (Accent Insensitive) para novas bases a partir da 2.0. Para línguas orientais, consulte o Suporte da SoftExpert.

  1. Na árvore hierárquica, expanda o item Security.

  2. Clique com o botão direito em Logins.

  3. Clique em New Login.

  4. Do lado esquerdo, na página General, informe um nome para o login em Login name.

Exemplo: sesuite

  1. Marque a opção SQL Server authentication.

  2. Em Password, informe uma senha e confirme em Confirm password.

  3. Desmarque a opção Enforce password policy.

  4. Em Default database, selecione o banco de dados criado nos passos 3 ao 5.

  5. Em Default language, selecione o idioma English.

  6. Clique na página User Mapping e, em Users mapped to this login, selecione o banco de dados criado nos passos 3 ao 5.

  7. Na caixa Database Role membership, marque as seguintes opções:

  • Public;
  • db_owner.
  1. Clique em OK.
perigo

IMPORTANTE: As regras mencionadas anteriormente são as únicas exigidas para o funcionamento da Suite, adicionar quaisquer outras regras pode resultar em questões de segurança.

  1. Execute esses comandos para aplicar uma propriedade requerida pela aplicação em seu banco - propriedade ALLOW_SNAPSHOT_ISOLATION_ON:
ALTER DATABASE <Database> SET ALLOW_SNAPSHOT_ISOLATION ON GO
  1. Propriedade SET READ_COMMITTED_SNAPSHOT ON GO.
ALTER DATABASE <Database> SET READ_COMMITTED_SNAPSHOT ON GO

IMPORTANTE: O DEFAULT_SCHEMA do usuário da aplicação obrigatoriamente deve ser o padrão "dbo" do SQL Server; caso contrário, você enfrentará problemas durante a equalização do banco de dados.

  1. Execute este comando para alterar o schema.
USE <Database>;
ALTER USER [user] WITH DEFAULT_SCHEMA = dbo;

Configuração de rede

É necessário habilitar a conexão TCP/IP no SQL Server Configuration Manager. Para isso, siga os passos abaixo:

  1. Abra o SQL Server Configuration Manager.

  2. Na árvore hierárquica, expanda o item SQL Server <versão> Network Configuration.

  3. Clique em Protocols for MSSQLSERVER.

  4. Na caixa do lado direito, clique com o botão direito em TCP/IP.

  5. Clique em Properties.

  6. Na aba Protocol, em Enable, selecione o valor Yes.

  7. Acesse a aba IP Addresses.

  8. Em cada IP existente, em Enable, selecione o valor Yes.

  9. Em cada IP existente, confira se a porta definida em TCP Port é 1433.

  10. Clique em OK e reinicie o serviço do SQL Server.

Oracle

Configuração do Oracle

Esta seção aborda o procedimento para criar e configurar o Schema no Oracle. Para isso, siga os passos abaixo:

info

Estes procedimento considera que o Oracle está instalado com instância criada e que o TNSNames está configurado corretamente no servidor onde o SoftExpert Suite será instalado.

  1. Inicie o SQLPlus:
sqlplus@<tnsnames>
  1. Conecte-se com o servidor usando um usuário DBA.

Criação das tablespaces

  1. Crie uma tablespace chamada SOFTEXPERT_DATA:
CREATE TABLESPACE SOFTEXPERT_DATA LOGGING DATAFILE 'tablespaces_directory\SOFTEXPERT_DATA.DBF' SIZE 2000M AUTOEXTEND ON NEXT 200M MAXSIZE UNLIMITED;
info

Substitua <tablespaces_directory> pelo caminho onde a tablespace deverá ser criada no servidor Oracle.

info

2000M é o tamanho inicial recomendado para a tablespace de dados.

  1. Crie uma tablespace chamada SOFTEXPERT_INDEXES:
CREATE TABLESPACE SOFTEXPERT_INDEXES LOGGING DATAFILE 'tablespaces_directory\SOFTEXPERT_INDEXES.DBF' SIZE 200M AUTOEXTEND ON NEXT 50M MAXSIZE UNLIMITED;
info

Substitua <tablespaces_directory> pelo caminho onde a tablespace deverá ser criada no servidor Oracle.

info

200M é o tamanho inicial recomendado para a tablespace de índices.

Criação do usuário para o SoftExpert Suite

  1. Crie um usuário para o SoftExpert Suite:
CREATE USER <user> PROFILE DEFAULT IDENTIFIED BY <password> DEFAULT TABLESPACE SOFTEXPERT_DATA ACCOUNT UNLOCK;
info

Substitua <user> e &ltpassword> pelo nome do usuário e senha, respectivamente.

  1. Defina os 'grants' necessários para o usuário criado no passo 5:
ALTER USER <user> QUOTA UNLIMITED ON SOFTEXPERT_DATA;
ALTER USER <user> QUOTA UNLIMITED ON SOFTEXPERT_INDEXES;
GRANT CREATE SESSION TO <user>;
GRANT CREATE TABLE TO <user>;
GRANT CREATE VIEW TO <user>;
GRANT CREATE SEQUENCE TO <user>;
GRANT CREATE PROCEDURE TO <user>;
GRANT CREATE TRIGGER TO <user>;
  1. Saia do SQLPlus.
exit

PostgreSQL

Esta seção aborda o procedimento para criar e configurar o PostgreSQL. Para isso, siga os passos abaixo:

Consulte o documento "SoftExpert Suite - Requisitos do Sistema" para obter mais detalhes sobre as considerações para o PostgreSQL.

Para executar o procedimento a seguir, certifique-se de que o serviço do postgres esteja parado; se não estiver, pare o serviço:

pg_ctl stop -D postgresql_installation_directory/data
  1. Edite o arquivo de configuração pg_hba.conf:
vi postgresql_installation_directory/data/pg_hba.conf
  1. Localize o bloco de configuração IPv4 local connections e adicione uma nova linha com os dados de rede do servidor onde o SoftExpert Suite está sendo instalado:
# IPv4 local connections:
host all all 127.0.0.1/32 md5
host all all 192.168.200.55 255.255.255.0 md5
  1. Salve e feche o arquivo de configuração:
:wq!
  1. Edite o arquivo de configuração postgresql.conf:
vi postgresql_installation_directory/data/postgresql.conf
  1. Localize o parâmetro listen_addresses, descomente a linha e altere o seu valor, conforme mostrado abaixo:
listen_addresses = '*'        # what IP address(es) to listen on;
  1. Salve e feche o arquivo de configuração:
:wq!

Criação das pastas para as tablespaces

  1. Devem ser criadas 2 pastas (softexpert_data e softexpert_indexes) com permissão total para o usuário postgres. Crie os seguintes diretórios para as tablespaces:
mkdir postgresql_installation_directory/data/tbs
mkdir postgresql_installation_directory/data/tbs/softexpert_data
mkdir postgresql_installation_directory/data/tbs/softexpert_indexes
perigo

A criação e o uso de tablespaces com nomes duplicados não são permitidos, pois podem provocar lentidão na aplicação.

  1. Defina as permissões:
chown postgres.postgres -R postgresql_installation_directory/data/tbs

Usuário e permissões

info

O PostgreSQL é case-sensitive.

  1. Inicie o PSQL com o usuário postgres criado durante a instalação do PostgreSQL:
psql -U postgres -h localhost -d postgres
  1. Crie um usuário para o SoftExpert Suite:
CREATE ROLE <user> LOGIN ENCRYPTED PASSWORD '<password>' SUPERUSER VALID UNTIL 'infinity';
info

Substitua <user> e <password> pelo nome do usuário e senha, respectivamente.

Tablespaces

  1. Crie uma tablespace chamada SOFTEXPERT_DATA:
CREATE TABLESPACE "SOFTEXPERT_DATA" OWNER <user> LOCATION 'postgresql_installation_directory/data/tbs/softexpert_data';
  1. Crie uma tablespace chamada SOFTEXPERT_INDEXES:
CREATE TABLESPACE "SOFTEXPERT_INDEXES" OWNER <user> LOCATION 'postgresql_installation_directory/data/tbs/softexpert_indexes';

Database

  1. Crie o banco de dados para o SoftExpert Suite:
CREATE DATABASE <database_name> WITH ENCODING='UTF8' OWNER=<user> tablespace="SOFTEXPERT_DATA";
info

O Encoding UTF8 suporta todos os idiomas.

Iniciando e parando o serviço do PostgreSQL

  1. Para iniciar o serviço do PostgreSQL:
su - postgres
pg_ctl start -D postgresql_installation_directory/data
logout
  1. Para parar o serviço do PostgreSQL:
su - postgres
pg_ctl stop -D postgresql_installation_directory/data
logout
dica

Você pode criar um script para iniciar e parar o serviço do PostgreSQL. Veja a seguir os passos necessários para a criação de script de inicialização para o PostgreSQL.

Criação do script de inicialização

A seguir, serão apresentados os passos para a criação de um script de inicialização. Caso deseje utilizar um script, siga o exemplo abaixo, alterando os diretórios conforme os dados do seu ambiente de instalação.

  1. Acesse o diretório onde são armazenados os serviços do sistema:
cd /etc/init.d
  1. Crie um arquivo chamado postgresql e abra-o para edição:
vim postgresql
  1. Cole no arquivo o conteúdo abaixo, alterando os dados de acordo com o seu ambiente:
#!/bin/sh

# description: PostgreSQL Server

# chkconfig: 2345 80 30

# processname: postgresql

case "$1" in

"start")

echo "Starting PostgreSQL Server"
sudo -u postgres postgresql_installation_directory/bin/pg_ctl start -D postgresql_installation_directory/data

;;

"stop")

echo "Stopping PostgreSQL Server"
sudo -u postgres postgresql_installation_directory/bin/pg_ctl stop -D postgresql_installation_directory/data

;;

"restart")

/etc/init.d/postgresql stop
/etc/init.d/postgresql start

;;

*)
echo "Usage: $0 {start|stop|restart}"
;;

esac
  1. Salve e feche o arquivo:
:wq!
  1. Após instalar o serviço, defina a permissão de execução para o script de inicialização do PostgreSQL:
chmod +x /etc/init.d/postgresql
  1. Configure o script para ser inicializado automaticamente com o Sistema Operacional:
  • Para distribuições baseadas em CentOS/RedHat/OracleLinux, execute:
chkconfig --add postgresql
chkconfig --level 235 postgresql on
  • Para distribuições baseadas em Debian, execute:
update-rc.d postgresql defaults

PostgreSQL - TLS

Nesta seção, será apresentado o procedimento de configuração de certificado TLS no PostgreSQL.

Este procedimento opcional serve para habilitar o certificado TLS com o PGSQL durante a instalação do SoftExpert Suite, tanto no Windows Server quanto no Linux.

As conexões SSL/TLS fornecem uma camada de segurança, criptografando dados que se movem entre o cliente e uma instância de banco de dados. O uso de um certificado de servidor fornece uma camada extra de segurança, validando se a conexão está sendo feita em comum com a instância de banco de dados.

Para obter o certificado, é necessário, primeiramente, realizar a compra de um certificado digital. Feito isso, a unidade emissora irá disponibilizá-lo.

Para configurar o certificado TLS no PostgreSQL, realize os seguintes passos:

  1. Acesse o servidor do banco de dados que será utilizado e verifique os seguintes parâmetros no arquivo postgresql_installation_directory/data/postgresql.conf:
sudo vi postgresql_installation_directory/data/postgresql.conf
ssl = on
ssl_ca_file = '<certificado_client.crt>'
ssl_cert_file = '<certificado_server.crt>'
ssl_key_file = '<chave_certificado_server.key>'

Sendo:

  • certificado_client.crt: O certificado assinado pela CA e utilizado na aplicação para conexão com o banco.
  • certificado_server.crt: O certificado do banco de dados.
  • chave_certificado_server.key: A chave do certificado do banco de dados.
info

Certifique-se de que os arquivos dos certificados estão todos na pasta postgresql_installation_directory/data.

  1. Execute os seguintes comandos para adicionar permissões aos arquivos:
sudo chmod 400 <certificado_server.key>
sudo chown postgres.postgres <certificado_server.key>
  1. Adicione ao arquivo postgresql_installation_directory/data/pg_hba.conf a seguinte linha:
hostssl all all 0.0.0.0/0 md5
  1. Reinicie o serviço do PostgreSQL.
sudo /etc/init.d/postgresql restart
  1. Utilize o procedimento do guia de instalação para continuar.
dica

Para mais informações sobre a utilização do certificado SSL/TLS, acesse: https://www.postgresql.org/docs/12/ssl-tcp.html

info

Caso este não esteja de acordo com a versão de seu banco, verifique qual versão corresponde à sua.

WINDOWS

Microsoft SQL Server

Esta seção aborda o procedimento para criar e configurar o banco de dados no SQL Server. Para isso, siga os passos abaixo:

Consulte o documento "SoftExpert Suite - Requisitos do Sistema" para obter mais detalhes sobre as considerações para o SQL Server.

cuidado

Observação: Se a versão do banco de dados for SQL Server 2019, o banco deve estar, no mínimo, com o patch 15.04138 (CU11), conforme a lista de patches no site: https://sqlserverupdates.com/sql-server-2019-updates/. É extremamente recomendado manter os patches de correções dos bancos de dados sempre atualizados, pois podem conter correção de bugs da Engine.

Este procedimento considera que o SQL Server está instalado corretamente.

  1. Abra o SQL Server Management Studio.

  2. Conecte-se com o servidor.

  3. Clique com o botão direito em Databases e, em seguida, na opção New Database.

  4. Do lado esquerdo, na página General, informe um nome em Database name.

Exemplo: sesuite

  1. Do lado esquerdo, na página Options, escolha o 'collation' a ser utilizado e clique em OK.

Os collations que podem ser utilizados, nas línguas ocidentais, para o banco do SoftExpert Suite no SQL Server são:

  • SQL_Latin1_General_CP1_CI_AS

  • SQL_Latin1_General_CP1_CI_AI

  • Latin1_General_CI_AS

  • Latin1_General_CI_AI

O parâmetro CI (Case Insensitive) do collation sempre deve ser utilizado. Recomendamos a utilização do parâmetro AI (Accent Insensitive) para novas bases a partir da 2.0. Para línguas orientais, consulte o Suporte da SoftExpert.

  1. Na árvore hierárquica, expanda o item Security.

  2. Clique com o botão direito em Logins.

  3. Clique em New Login.

  4. Do lado esquerdo, na página General, informe em Login name um nome para o login.

Exemplo: sesuite

  1. Marque a opção SQL Server authentication.

  2. Em Password, informe uma senha e confirme em Confirm password.

  3. Desmarque a opção Enforce password policy.

  4. Em Default database, selecione o banco de dados criado nos passos 3 ao 5.

  5. Em Default language, selecione o idioma English.

  6. Clique na página User Mapping e, em Users mapped to this login, selecione o banco de dados criado nos passos 3 ao 5.

  7. Na caixa Database Role membership, marque as seguintes opções:

  • Public;
  • db_owner.
  1. Clique em OK.

  2. Execute esses comandos para aplicar uma propriedade requerida pela aplicação em seu banco - propriedade ALLOW_SNAPSHOT_ISOLATION_ON:

ALTER DATABASE <Database> SET ALLOW_SNAPSHOT_ISOLATION ON GO
  1. Propriedade SET READ_COMMITTED_SNAPSHOT ON GO.
ALTER DATABASE <Database> SET READ_COMMITTED_SNAPSHOT ON GO

IMPORTANTE: O DEFAULT_SCHEMA do usuário da aplicação obrigatoriamente deve ser o padrão "dbo" do SQL Server; caso contrário, você enfrentará problemas durante a equalização do banco de dados.

  1. Execute este comando para alterar o schema.
USE <Database>;
ALTER USER [user] WITH DEFAULT_SCHEMA = dbo;

Oracle

Configuração do Oracle

Esta seção aborda o procedimento para criar e configurar o banco de dados no Oracle. Para isso, siga os passos abaixo:

info

Este procedimento considera que o Oracle está instalado com instância criada e que o TNSNames está configurado corretamente no servidor onde o SoftExpert Suite será instalado.

  1. Inicie o SQLPlus.

  2. Conecte-se com o servidor usando um usuário DBA.

Criação das tablespaces

  1. Crie uma tablespace chamada SOFTEXPERT_DATA:
CREATE TABLESPACE SOFTEXPERT_DATA LOGGING DATAFILE 'tablespaces_directory\SOFTEXPERT_DATA.DBF' SIZE 2000M AUTOEXTEND ON NEXT 200M MAXSIZE UNLIMITED;
info

Substitua <tablespaces_directory> pelo caminho onde a tablespace deverá ser criada no servidor Oracle.

info

2000M é o tamanho inicial recomendado para a tablespace de dados.

  1. Crie uma tablespace chamada SOFTEXPERT_INDEXES:
CREATE TABLESPACE SOFTEXPERT_INDEXES LOGGING DATAFILE 'tablespaces_directory\SOFTEXPERT_INDEXES.DBF' SIZE 200M AUTOEXTEND ON NEXT 50M MAXSIZE UNLIMITED;
info

Substitua <tablespaces_directory> pelo caminho onde a tablespace deverá ser criada no servidor Oracle.

info

200M é o tamanho inicial recomendado para a tablespace de índices.

Criação do usuário para o SoftExpert Suite

  1. Para criar um usuário para o SoftExpert Suite e definir as permissões necessárias, execute os passos a seguir:

  2. Crie um usuário para o SoftExpert Suite:

CREATE USER <SESUITE> PROFILE DEFAULT IDENTIFIED BY <PASSWORD> DEFAULT TABLESPACE SOFTEXPERT_DATA ACCOUNT UNLOCK;
info

Substitua <SESUITE> e <PASSWORD> pelo nome do usuário e senha, respectivamente.

  1. Defina os 'grants' necessários para o usuário criado no passo 5:
ALTER USER <user> QUOTA UNLIMITED ON SOFTEXPERT_DATA;

ALTER USER <user> QUOTA UNLIMITED ON SOFTEXPERT_INDEXES;

GRANT CREATE SESSION TO <user>;

GRANT CREATE TABLE TO <user>;

GRANT CREATE VIEW TO <user>;

GRANT CREATE SEQUENCE TO <user>;

GRANT CREATE PROCEDURE TO <user>;

GRANT CREATE TRIGGER TO <user>;

GRANT select_catalog_role to <user>;

  1. Saia do SQLPlus.

  2. Clique no menu Start do Windows.

  3. Clique com o botão direito em My Computer e selecione Properties.

  4. Selecione a aba Advanced e clique em Environment.

  5. Em System Variables, clique em New.

  6. Preencha o campo Variable Name com NLS_LANG.

  7. Abra o SQLPlus.

  8. Digite os seguintes comandos para retornarem os parâmetros de NLS:

  • VALUE1:
SELECT VALUE FROM NLS_SESSION_PARAMETERS WHERE PARAMETER = 'NLS_LANGUAGE';
  • VALUE2:
SELECT VALUE FROM NLS_SESSION_PARAMETERS WHERE PARAMETER = 'NLS_TERRITORY';
  • VALUE3:
SELECT VALUE FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';
  1. Preencha o campo Variable Value com a informação retornada pelo SQLPlus e na ordem do passo anterior: VALUE1_VALUE2.VALUE3
dica

Exemplo: AMERICAN_AMERICA.WE8MSWIN1252

  1. Clique em OK.

  2. Clique em OK para fechar a tela System properties.

  3. Saia do SQLPlus.

PostgreSQL

Nesta seção, são abordados os procedimentos de criação e configuração do banco de dados para o SGBD PostgreSQL. Será apresentado, inicialmente, o procedimento de instalação do PostgreSQL e do pgAdmin III.

Consulte o documento "SoftExpert Suite - Requisitos do Sistema" para obter mais detalhes sobre as considerações para o PostgreSQL.

info

Para utilizar o serviço de indexação do SoftExpert Captura, após a instalação do PostgreSQL, será necessária a instalação do PostgreSQL Native OLEDB Provider (pgoledb.msi) no servidor do SoftExpert Suite. Após a instalação, atualize a variável de ambiente PATH com o diretório da instalação do PostgreSQL Native OLEDB Provider.

Instalação do PostgreSQL

Para instalar o PostgreSQL, siga os passos abaixo:

  1. Faça o download do PostgreSQL no site: http://www.postgresql.org.

  2. Execute o arquivo de instalação do PostgreSQL.

  3. Na tela Welcome to the PostgreSQL Setup Wizard, clique em Next.

  4. Em Installation Directory, escolha um diretório para a instalação ou deixe o caminho padrão.

  5. Em Data Directory, informe o diretório onde os dados serão armazenados. Clique em Next.

  6. Informe uma senha para o superuser do banco de dados e a conta do serviço (postgre). Clique em Next.

  7. Informe a porta onde o serviço está sendo executado. Clique em Next.

  8. Use o locale padrão. Clique em Next.

  9. Na tela Ready to install, clique em Next.

  10. Desmarque a opção Launch Stack Builder at exit.

  11. Clique em Finish.

Instalação do pgAdmin III

Para instalar o pgAdmin III, execute os seguintes passos:

info

Este procedimento deve ser realizado no servidor em que será instalado o SoftExpert Suite.

  1. Faça o download do pgAdmin III no site: http://www.pgadmin.org/download.

  2. Execute o arquivo de instalação e siga as instruções do software.

  3. Abra o pgAdmin III.

  4. Clique no botão Add a connection to a server para adicionar uma conexão com o servidor de banco de dados.

  5. Em Name, informe o nome da conexão.

  6. Informe o nome do host do servidor do banco de dados.

  7. Em Port, informe a porta do PostgreSQL. A porta padrão é 5432.

  8. Selecione o banco de dados para conexão.

info

Somente visualize todos os bancos de dados após a primeira conexão.

  1. Insira o nome do usuário e a senha.

  2. Clique em OK.

Configuração da rede do PostgreSQL

Esta seção aborda o procedimento para criar e configurar o banco de dados no PostgreSQL. Para a configuração de Rede PostgreSQL, execute os passos a seguir:

  1. Acesse o diretório do PostgreSQL que contém os arquivos de configuração.

Exemplo: C:\Program Files\PostgreSQL\8.x\data

  1. Abra para edição o arquivo de configuração pg_hba.conf.

  2. Localize o bloco de configuração 'IPv4 local connections' e adicione uma nova linha com os dados de rede do servidor onde o SoftExpert Suite está sendo instalado:

# IPv4 local connections:
host all all 127.0.0.1/32 md5
host all all 192.168.200.55 255.255.255.0 md5
  1. A configuração deste arquivo também pode ser feita pelo pgAdmin III (menu File arrowrgray open pg_hba.conf), como mostra a imagem a seguir:
  1. Salve e feche o arquivo de configuração.

  2. Abra para edição o arquivo de configuração postgresql.conf:

  3. Localize o parâmetro listen_addresses e altere o seu valor, conforme mostrado abaixo:

listen_addresses = '*'                # what IP address(es) to listen on;
  1. A configuração deste arquivo também pode ser feita pelo pgAdmin III (File arrowrgray open postgresql.conf), como mostra a imagem a seguir:
  1. Salve e feche o arquivo de configuração.

  2. Reinicie o serviço do PostgreSQL.

Criação das pastas da tablespace

Para criar as pastas da tablespace, execute os passos seguintes:

  1. Acesse o diretório do PostgreSQL onde as pastas serão criadas ou utilize a pasta padrão de dados do PostgreSQL.

Exemplo: C:\Program Files\PostgreSQL\8.x\data

  1. No diretório acessado, crie uma nova pasta com o nome SOFTEXPERT_DATA.

Exemplo: C:\Program Files\PostgreSQL\8.x\data\SOFTEXPERT_DATA

  1. No diretório acessado, crie uma nova pasta com o nome SOFTEXPERT_INDEXES.

Exemplo: C:\Program Files\PostgreSQL\8.x\data\SOFTEXPERT_INDEXES

  1. Clique com o botão direito na pasta pai.

Exemplo: C:\Program Files\PostgreSQL\8.x\data

  1. Selecione Properties.

  2. Selecione a aba Security.

  3. Selecione o usuário do serviço PostgreSQL.

  4. Defina a permissão Full Control da coluna Allow para este usuário.

  5. Clique em OK.

Criação do usuário para o SoftExpert Suite

Para criar um usuário, execute os passos a seguir:

  1. Abra o assistente pgAdmin III.

  2. Do lado esquerdo, no menu Object Browser, selecione o servidor padrão e conecte-se a ele.

  3. Clique com o botão direito em Login Roles e selecione New Login Role.

  4. Na tela New Login Role que se abrirá, preencha os seguintes campos:

  • Role name: Informe um nome para o novo usuário.

  • Password: Informe a senha para o novo usuário.

  • Password (again): Redigite a senha, para confirmá-la.

  • Account expires: Se for necessário, informe a data em que a conta que está sendo criada expirará.

  1. Ainda na tela de criação do usuário, acesse a aba Role privileges e selecione Superuser.

  2. Clique em OK.

Criação das tablespaces

Para criar uma tablespace, execute os passos a seguir:

  1. Clique com o botão direito em Tablespaces.

  2. Selecione New Tablespace e, na tela que se abrir, preencha os seguintes campos:

  • Name: Digite SOFTEXPERT_DATA para o nome da tablespace.

  • Location: Informe o diretório para a pasta da tablespace SOFTEXPERT_DATA. Exemplo: C:\Program Files\PostgreSQL\8.x\data\SOFTEXPERT_DATA.

  • Owner: Selecione o usuário criado para o SoftExpert Suite. Exemplo: sesuite.

  1. Ainda na tela de criação da tablespace, acesse a aba Privileges.

  2. Selecione a opção CREATE e clique em Add/Change.

  3. Clique em OK.

info

Repita esse processo para criar a tablespace SOFTEXPERT_INDEXES.

Criação do banco de dados

Para criar um banco de dados, execute os passos a seguir:

  1. Clique com o botão direito em Databases.

  2. Selecione New Database e, na tela que se abrir, preencha os seguintes campos:

  • Name: Informe um nome para o banco de dados.

  • Owner: Selecione o usuário criado anteriormente para o SoftExpert Suite.

  • Encoding: Selecione UTF8.

  • Tablespace: Selecione SOFTEXPERT_DATA para ser a tablespace padrão.

info

A codificação recomendada para o banco de dados é o UTF-8, pois suporta todos os idiomas.

  1. Ainda na tela de criação de banco de dados, acesse a aba Privileges e selecione ALL.

  2. Clique em Add/Change.

  3. Clique em OK.

  4. Feche o pgAdmin III.

PostgreSQL - TLS

Nesta seção, será apresentado o procedimento de configuração de certificado TLS no PostgreSQL.

Este procedimento opcional serve para habilitar o certificado TLS com o PGSQL durante a instalação do SoftExpert Suite, tanto no Windows Server quanto no Linux.

info

As conexões SSL/TLS fornecem uma camada de segurança, criptografando dados que se movem entre o cliente e uma instância de banco de dados. O uso de um certificado de servidor fornece uma camada extra de segurança, validando se a conexão está sendo feita em comum com a instância de banco de dados.

info

Para obter o certificado, é necessário, primeiramente, realizar a compra de um certificado digital. Feito isso, a unidade emissora irá disponibilizá-lo.

Para configurar o certificado TLS no PostgreSQL, realize os seguintes passos:

  1. Acesse o servidor do banco de dados que será utilizado e verifique os seguintes parâmetros no arquivo postgresql_installation_directory/data/postgresql.conf:
ssl = on
ssl_ca_file = '<certificado_client.crt>'
ssl_cert_file = '<certificado_server.crt>'
ssl_key_file = '<chave_certificado_server.key>'

Sendo:

  • certificado_client.crt: O certificado usado na aplicação para conexão com o banco.
  • certificado_server.crt: O certificado do banco de dados.
  • chave_certificado_server.key: A chave do certificado do banco de dados.

Certifique-se de que os arquivos dos certificados estão todos na pasta postgresql_installation_directory/data.

  1. Adicione ao arquivo postgresql_installation_directory/data/pg_hba.conf a seguinte linha:

hostssl all all 0.0.0.0/0 md5

  1. Reinicie o serviço do PostgreSQL.

  2. Utilize o procedimento do guia de instalação para continuar.

dica

Para mais informações sobre a utilização do certificado SSL/TLS, acesse: https://www.postgresql.org/docs/12/ssl-tcp.html

info

Caso este não esteja de acordo com a versão de seu banco, verifique qual versão corresponde à sua.