
Documentação Técnica V5

Na implantação normal no local usando um servidor em rede, a SG Systems instalará e implantará software e serviços neste servidor com base nas especificações/escopo descritos do cliente. Este guia não pretende ser um guia passo a passo a ser seguido, mas sim um resumo das ações padrão que serão tomadas/software que será instalado pela SG Systems ao instalar e configurar uma nova implantação.
Mais detalhes podem ser disponibilizados mediante solicitação.
A SG Systems irá, como padrão, implantar o Edição Expressa do SQL Server 2017, embora os aplicativos SG suportem o uso de várias edições e versões até 2022 Enterprise, dependendo dos requisitos/solicitações do cliente para usar uma versão diferente.
SQL Server Management Studio também será instalado junto com a versão do servidor escolhida para permitir o gerenciamento do banco de dados. Pode ser qualquer versão até a versão mais recente (versão 20).
Essas instalações seguirão o padrão de instalação 'Básico' quando executarmos o instalador.

Os termos devem então ser aceitos e um caminho de instalação escolhido. A menos que seja instruído de outra forma pelo cliente, ele será instalado no local padrão mostrado abaixo:

Assim que este local for escolhido, 'Instalar' deverá ser selecionado. O instalador irá então baixar e instalar os dados relevantes.
Após a conclusão, várias informações, como nome da instância do SQL Server, versão, cadeia de conexão, etc., serão exibidas.
A partir daqui, a SG Systems também instalará o software de gerenciamento SQL Server, cuja versão mais recente está disponível através do botão destacado que abrirá uma página de download da versão mais recente.

Se o SSMS já estiver instalado ou estiver sendo instalado a partir de um instalador separado, esta janela poderá ser fechada agora.
SQL Server Management Studio
Ao executar o instalador SSMS, a SG Systems irá instalá-lo novamente no local padrão:

Este instalador será então executado e uma mensagem de confirmação será exibida quando concluído.

Além de realizar a instalação padrão do SQL Server/Mangement Studio descrita acima, a SG Systems também fará as seguintes alterações nas configurações dos aplicativos para facilitar a funcionalidade com o sistema V5.
Configuração da porta TCP
O SG começaria abrindo o 'SQL Server Configuration Manager' para a edição relevante do servidor que foi instalado.

Uma vez aberto e a instância correta do servidor selecionada no lado esquerdo, todos os protocolos serão habilitados, após o qual 'TCP/IP' será clicado com o botão direito e as propriedades serão selecionadas.

Aqui as portas para todos os 'IPAll' serão definidas como 1433. Outras portas podem ser usadas aqui dependendo da solicitação do cliente/disponibilidade de porta.

O serviço SQL Server será reiniciado para aplicar essas alterações.
Estúdio de gerenciamento do Microsoft SQL Server
SG fará então as seguintes alterações no MSSMS:
As propriedades do servidor serão selecionadas:

E na guia ‘Segurança’, a autenticação do servidor será definida como ‘Autenticação SQL Server e Windows’ e a configuração será aplicada.

O usuário 'sa' (encontrado nos menus 'Segurança' > 'Logins') será então editado (este é o perfil de usuário padrão que o SG usa para entrar no banco de dados a partir do software e pode não se aplicar se estiver usando diretório ativo).

Na guia 'Geral', a senha padrão do SG será inserida (disponível mediante solicitação) e 'Aplicar política de senha' será desmarcada.

E na aba ‘Status’, o login será habilitado e as alterações aplicadas.

Um banco de dados SG pode então ser carregado a partir de um backup.
A SG Systems utiliza uma versão modificada do conjunto de relatórios Jaspersoft que normalmente também será instalada no servidor do cliente como parte do pacote de software inicial. SG relata versões de suporte deste software de 7.1 a 8.0. Este pacote é executado em um backend de serviço da web Apache Tomcat 8.0 na porta 8080 para que os usuários na rede possam acessar esses recursos.
Começaríamos a instalar os relatórios da web SG executando TIB_js-jrs-cp_*.exe e selecionando 'instalação personalizada'.

Selecione o local de instalação desejado (o local padrão é mostrado aqui):

Selecione a opção Tomcat incluída.

Selecione para usar o banco de dados PostgreSQL incluído.

Selecione para usar a opção PhantomJS incluída.

Insira as portas Tomcat desejadas, os padrões já estão preenchidos. Observe aqui que dependendo se o cliente requer a instalação da API V5, então dependendo da ordem de instalação a porta aqui pode ser alterada para 8081 ou algo semelhante. Mais informações sobre a instalação da API V5 podem ser encontradas aqui..

Selecione a porta do banco de dados desejada, o padrão é 5433.

Não precisamos dos relatórios de amostra, então podemos apenas selecionar Não aqui.

Mais informações sobre o uso subsequente dos relatórios da web do SG podem ser encontradas aqui..
A família de aplicativos V5 requer a instalação do Java Runtime Environment para funcionar e, como tal, o Java será instalado em qualquer dispositivo que execute um aplicativo V5, incluindo o servidor.
Um representante da SG poderá recomendar uma versão do Java com base na configuração do sistema. Esta versão será Java 8 ou Java 11, e os guias para a instalação de ambos serão discutidos abaixo.
A versão instalada aqui é o Java 64 Update 8 de 144 bits, mas, na realidade, qualquer versão do Java 8 serve. Observe que, para instalações do WMS e do Centro de Controle, é necessário Java de 64 bits (e, portanto, um sistema operacional de 64 bits). O Terminal pode ser executado em sistemas de 32 bits.
Inicializar o instalador nos solicitará que clique em próximo:

Na próxima página, e se estiver usando uma versão Java que inclua o Java Development Kit (JDK), podemos optar por omitir aqui o elemento 'Código Fonte', pois apenas o Java Runtime Environment (JRE) é necessário para executar as aplicações V5 .

O instalador então baixa os arquivos apropriados e então teremos a opção de onde instalar o Java. Como de costume, a SG Systems irá instalá-lo no local padrão solicitado pelo instalador.

Assim que o instalador for executado a partir daqui, o processo será concluído e o instalador será fechado. Agora desabilitaremos as atualizações automáticas do Java:
No menu iniciar do Windows, procure por “Configurar Java” e abra-o:

Clique na guia Atualizar > desmarque “Verificar atualizações automaticamente” > Não verificar > OK. Isso impedirá que o Java seja atualizado automaticamente para uma versão mais recente que possa comprometer a funcionalidade dos aplicativos V5.

Se a caixa de seleção “Verificar atualizações..” estiver esmaecida, você deverá fechá-lo e executá-lo novamente, mas desta vez como administrador.
Em casos em que o Java 11 estiver instalado, use o instalador fornecido para a versão 26 do Java 11 e execute-o.

Após clicar em "Avançar" aqui, escolha um local de instalação – caso seja necessário um diferente do padrão.

Clicar em "Avançar" aqui instalará o Java 11 no local especificado e, em seguida, concluirá a instalação. Clique em "Fechar" para sair do instalador.

Essa é toda a ação necessária aqui, diferentemente do Java 8, nenhuma etapa adicional é necessária.
A SG Systems finalmente instalará uma seleção de aplicativos V5 no servidor do cliente. Novamente, isso é determinado pelo escopo do sistema originalmente especificado. Isto é conseguido através do uso do 'SG Installer'. Este instalador também pode ser usado para atualizar aplicativos no futuro.
Um guia sobre o uso do SG Installer pode ser encontrado aqui.
Por padrão, o SG Installer criará uma pasta chamada 'SG Software' em 'Arquivos de Programas (x86) e colocará as pastas de instalação do aplicativo aqui.
Assim uma instalação padrão do Centro de Controle SG será instalada no seguinte local, salvo indicação em contrário por parte do cliente:
Isto é o mesmo para TODAS as aplicações SG, incluindo SG Terminal, SG WMS e SG Data Engine.
Uma etapa extra é necessária em todas as instalações do SG para garantir que os aplicativos SG possam gravar nos arquivos de configuração dentro da pasta de instalação. Clique com o botão direito na pasta SG Software (localizada por padrão em C:\Program Files (x86)\SG Software) e clique em Propriedades. Em seguida, na guia 'Segurança', clique em 'Editar' e depois em 'Adicionar':

Na janela resultante, digite 'Todos' e clique em OK.

Por fim, destaque ‘Todos’ e marque Controle Total, antes de clicar em OK.

Para conectar o aplicativo ao servidor, a SG Systems usa arquivos '.properties', que estão localizados na pasta 'config' da instalação do aplicativo SG e que podem ser abertos e editados usando um leitor de texto básico, como o Bloco de Notas.

O arquivo 'db_settings' aqui é aquele que queremos editar para nos conectarmos ao servidor. O arquivo 'app_settings' aqui são as configurações do aplicativo, mas são controlados por meio da configuração central no próprio Control Center, portanto não serão discutidos aqui.
Abrindo isto irá mostrar algo como abaixo:

Se você estiver usando a autenticação SQL, o nome de usuário e a senha estarão neste arquivo junto com a cadeia de conexão.
Se você estiver usando o Active Directory, a string do banco de dados precisará conter “IntegratedSecurity=true;”. O software V5 usará então sqljdbc_auth para autenticar a conexão do banco de dados usando as informações da conta do Windows.
Se os dispositivos/PCs estiverem em um Domínio e usando SSO, o software V5 será inicializado automaticamente após a conexão com o banco de dados ter sido feita. Não temos um prompt de nome de usuário e senha para entrar no software V5 porque o usuário já fez login no dispositivo usando SSO, portanto isso não é necessariamente necessário.
Portanto, ao usar AD/SSO com V5, o principal é garantir que o Banco de Dados SQL esteja compartilhando o mesmo controlador AD que os dispositivos Windows para que a conexão do banco de dados possa ser autenticada usando as informações da conta do Windows. Esses usuários também precisarão ser capazes de atualizar/inserir/excluir registros do banco de dados.
A SG Systems oferece soluções completas Integração API com uma ampla variedade de soluções ERP que os clientes podem empregar. Se isso fizer parte do processo de implementação, a API V5 será instalada juntamente com outros elementos do sistema de rastreabilidade V5.
O processo que isso seguirá pode ser encontrado em nosso dedicado Guia de instalação da API V5.