PORTAL DE DOCUMENTAÇÃO
Tecnologia - versão 6.10.4 / 5.10.4
Tecnologia > Manual de Instalação > Instalação > Passo a passo para a instalação do Servidor de Aplicativos > Configurações de Produto > Gestão de Pessoas > Configurações de instalação da nova interface do Gestão do Ponto

Instalação da nova interface do Gestão do Ponto

Passo a passo das configurações necessárias para a instalação da nova interface do módulo Gestão do Ponto, do sistema Gestão de Pessoas | HCM.

A partir das versões 6.10.1 e 6.10.3, a instalação da nova interface do Gestão do Ponto, pode ser feita automaticamente, porém, alguns passos manuais permanecem sendo obrigatórios.

Os arquivos para a instalação manual são disponibilizados no Portal do Cliente > Central de Sistemas > Atualização de ambiente > selecione sua versão do sistema > Gestão do Ponto Nova Interface. Para a instalação automática, deve ser copiado o arquivo gestaopontonovainterface.irp na pasta Vetorh.

Importante

ClosedPré-requisitos
ClosedConfiguração do WildFly

Acesse a documentação WildFly e veja como realizar a configuração dele.

ClosedConfiguração do Redis

O Redis é um banco de dados em memória, que é utilizado para as telas em que o usuário executa diversas alterações antes de salvar. Essa necessidade ocorre devido ao servidor não armazenar mais as sessões de usuário na nova interface. Para que ele funcione, é necessário que esteja configurado no Central de Configurações Senior. Acesse Central de Configurações Senior > Sistemas > Gestão de Pessoas > Gestão do Ponto e configure.

  1. Baixe o arquivo do Portal do Cliente em atualização de ambiente > Ferramentas > Redis.zip > e faça a sua instalação;
  2. Acesse a pasta raiz de instalação, padrão utilizado: C:\Program Files\Redis\Conf;
  3. Altere no arquivo redis.conf, a chave #requirepass foobared para requirepass <senha> (senha do banco de dados Redis). É recomendável inserir uma senha extensa;
  4. Para que os dados não sejam persistidos, no arquivo redis.conf comente, adicionando "#" na frente das chaves padrões de configuração save:
    • #save 900 1
    • #save 300 10
    • #save 60 10000
  5. Inicie o serviço Redis.

Redis distribuído

Para utilizar, opcionalmente, o Redis em alta disponibilidade é necessário ter pelo menos dois nós do redis-server em execução, somente um nó Master e os demais Slaves (escravos). Somente o nó Master possui autorização para acessar e gravar os dados. Desta maneira, quando o nó Master parar de executar, os nós sentinelas verificam quais são os outros nós Slaves em execução e definem por votação qual é o novo nó Master.

É recomendável possuir no mínimo três nós de sentinelas em execução para que a votação não resulte em empate. E obrigatório a utilização do Redis com Sentinel na versão 3.2.100.

Master

  1. Baixe o arquivo do Portal do Cliente em atualização de ambiente > Ferramentas > Redis.zip > e faça a sua instalação;
  2. Acesse a pasta raiz de instalação, padrão utilizado: C:\Program Files\Redis\Conf;
  3. Altere no arquivo redis.conf, a chave #requirepass foobared para requirepass <senha> (senha do banco de dados Redis). É recomendável inserir uma senha extensa;
  4. Ajuste a chave port para a porta desejada; e a chave 127.0.0.1 para #bind 127.0.0.1 ou ajuste 127.0.0.1 para o IP do nome da máquina.

Slave

  1. Baixe o arquivo do Portal do Cliente em atualização de ambiente > Ferramentas > Redis.zip > e faça a sua instalação;
  2. Acesse a pasta raiz de instalação, padrão utilizado: C:\Program Files\Redis\Conf;
  3. Altere no arquivo redis.conf, as seguintes chaves:
    • port para a porta desejada;
    • #slaveof <masterip> <masterport> para slaveof <masterip> <masterport> informando o IP ou o nome do servidor e porta em que está localizado o nó Master;
    • #masterauth <master-password> para masterauth <master-password> informando a senha definida na chave requirepass do nó Master;
    • #requirepass foobared para requirepass <senha>, com a mesma senha definida para o Master;
    • bind 127.0.0.1 para #bind 127.0.0.1 ou ajuste 127.0.0.1 para o IP do nome da máquina.

Sentinel

  1. Baixe o arquivo do Portal do Cliente em atualização de ambiente > Ferramentas > Redis.zip > e faça a sua instalação;
  2. Acesse a pasta raiz de instalação, padrão utilizado: C:\Program Files\Redis\Conf;
  3. Crie um arquivo nessa pasta com o nome sentinel.conf e com o seguinte conteúdo:

    port 26380

    sentinel monitor <master-name> <masterip> <masterport> <quorum>

    sentinel down-after-milliseconds <master-name> 5000

    sentinel failover-timeout <master-name> 5000

    sentinel auth-pass <master-name> <password>

  4. Altere nesse as seguintes chaves:
    • port para a porta desejada para cada nó sentinela;
    • sentinel monitor <master-name> <masterip> <masterport> <quórum>:
      • em <master-name> informe um nome para o nó Master;
      • em <masterip> defina o nome ou IP do nó Master;
      • em <masterport> defina a porta que o nó Master está executando;
      • em <quórum> defina a quantidade mínima de sentinelas para votação, padrão 2.
    • sentinel down-after-miliseconds <master-name> <miliseconds>. Em <master-name> informe o nome definido anteriormente para o nó Master;
    • sentinel failover-timeout <master-name> <miliseconds>. Em <master-name> informe o nome definido anteriormente para o nó Master;
    • sentinel auth-pass <master-name> <password>. Em <master-name> informe o nome definido anteriormente para o nó Master.
    5. ClosedExemplo:

    port 26380

    sentinel monitor mymaster 10.1.27.147 6379 2

    sentinel down-after-milliseconds mymaster 5000

    sentinel failover-timeout mymaster 5000

    sentinel auth-pass mymaster minhasenha

  5. Para criar o Redis Sentinel como serviço do Windows, execute o seguinte comando no console: sc create redis-sentinel binPath=”C:\Program Files\Redis\redis-server –service-run C:\Program Files\Redis\sentinel.conf –sentinel”.
ClosedExemplo:

Testar execução

A partir da pasta raiz da instalação do Redis, insira o comando redis-cli.exe -h <Nome do servidor> -p <porta>​ -a <senha>. Por padrão, a porta do Redis é 6379.

Retorno:

  • OK: Redis está funcionando corretamente.
  • (error) NOAUTH Authentication required: senha incorreta.
  • Could not connect to Redis at localhost:6379: Unknown error: falha na conexão.
ClosedExemplo:

Testar execução:

​C:\Program Files\Redis>redis-cli.exe -h pcbnu003687 -p 6379 -a senior

redis pcbnu003687:6379> set teste teste

Senha incorreta:

C:\Program Files\Redis>redis-cli.exe -h pcbnu003687 -p 6379 -a seniorErrada

redis pcbnu003687:6379> set teste teste

(error) NOAUTH Authentication required.

redis pcbnu003687:6379>​

Falha na conexão:

C:\Program Files\Redis>redis-cli.exe -h localhost -p 6379 -a senior

Could not connect to Redis at localhost:6379: Unknown error

not connected>​

ClosedCriação das conexões JDBC no WildFly
  1. Pare o WildFly e acesse seu diretório de instalação. Por padrão, ele está localizado em: C:[WILDFLY_DIR]\.
  2. Na pasta C:[WILDFLY_DIR]\modules\system\layers\base adicione o arquivo JDBC e module.xml.

Observação

Será necessário incluir na pasta main (ou criar o caminho para as pastas caso não existam) os arquivos JDBC e module.xml conforme o banco de dados utilizado. Veja os exemplos abaixo de como deve ser a estrutura de pastas:

  • Oracle: ${wildfly_home}/modules/system/layers/base/com/oracle/main/${Insira os arquivos aqui};
  • SQL Server: ${wildfly_home}/modules/system/layers/base/com/microsoft/sqlserver/main/${Insira os arquivos aqui};

Onde baixar o JDBC:

Como criar o arquivo module.xml:

  • Oracle

<module xmlns="urn:jboss:module:1.0" name="com.oracle">

<resources>

<resource-root path="ojdbc.jar"/> <!-- Atualizar conforme o nome do .jar utilizado -->

</resources>

<dependencies>

<module name="javax.api"/>

<module name="javax.transaction.api"/>

</dependencies>

</module>

  • SQL Server

<module xmlns="urn:jboss:module:1.0" name="com.microsoft.sqlserver">

<resources>

<resource-root path="mssql-jdbc.jar"/> <!-- Atualizar conforme o nome do .jar utilizado -->

</resources>

<dependencies>

<module name="javax.api"/>

<module name="javax.transaction.api"/>

</dependencies>

</module>

 

ClosedConfiguração Thread Pools

1. No console de administração do WildFly, acesse o menu Runtime > Server Group > View > JVMs:

  1. Clique em Add e informe o campo:
  2. Name: default;
  3. Clique em Add.

1.1. Após criação do Server, será necessário incluir as seguintes informações:

  1. Clique em default;
  2. Clique Edit;
  3. Heap Size: 1G;
  4. JVM Options: -XX:MetaspaceSize=96M, -XX:MaxMetaspaceSize=1G, -agentlib:jdwp=transport=dt_socket,address=0.0.0.0:9099,server=y,suspend=n
  5. Max Heap Size: 4G;
  6. Clique em Save.
ClosedConfigurar Central de Configurações Senior
  1. Acesse Central de Configurações Senior > Opções de segurança > Logon integrado com criptografia:
  2. Assinale a opção Habilitar o logon integrado com criptografia;
  3. Em Chave preencha com um valor utilizado para descriptografar o token recebido.
  4. Em seguida, acesse Sistemas > Gestão de Pessoas > Gestão do Ponto e insira os valores conforme configurações necessárias.
  5. Após estas configurações, reinicie os serviços Senior.
    • Serviço de informação.
    • Serviço do Middleware.
    • WildFly.
ClosedConfiguração de reconexão com o banco

Para que a reconexão do banco funcione corretamente, é necessário realizar algumas configurações. Para isso, siga a instrução:

  1. Em gestaoponto-dataaccess, selecione a aba Validation; no campo Valid Connection Checker Class Name e no Exception Sorter Class Name adicione as informações de acordo com seu banco de dados:
    • Em casos onde o banco de dados é MSSQL, utilize os comandos:
      • org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker
      • org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLExceptionSorter
    • Em casos onde o banco de dados é Oracle pode se usar os comandos:
      • org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker
      • org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter

ClosedInstalação manual
ClosedFront-end

Selecione o servidor para instalação do Front-end. A principal diferença entre os dois servidores disponíveis, é que o Nignx permite adicionar propriedades de segurança que o Node não suporta.

Portanto, caso haja uma preocupação maior em relação a segurança da informação, escolhe o servidor Nginx.

ClosedNode
  1. Acesse a pasta Gestão do Ponto Nova Interface e faça o download e instalação do arquivo "node-v8.16.2-x64.msi";
  2. Acesse o Portal do Cliente > Atualização de ambiente > selecione sua versão > GestaoPontoNovaInterface.zip > Extrair o arquivo frontend e faça a extração da pasta gestao-ponto-frontend-server para a seu diretório local. Exemplo: C:\gestao-ponto-frontend-server;

    Observação

    Dentro da pasta gestao-ponto-frontend-server, em seu diretório, no arquivo config.js há uma porta configurada (sem certificado digital), por padrão 3000, que é utilizada para acessar a nova interface do Gestão do Ponto. Para obter certificado digital, acesse o tópico Certificados digitais (Site seguro/HTTPS/SSL) e faça as configurações necessárias.

  3. Na pasta app, edite o arquivo app.<descrição>.js; altere as tags <servidor> e <porta>, em "//<servidor>:<porta>/gestaoponto-backend/api/", para a URL do servidor do WildFly a ser utilizado no Back-end, de forma que fique conforme o exemplo: "//servidor.com.br:8080/gestaoponto-backend/api/";
  4. Retorne a pasta raiz da instalação e execute o arquivo init.bat​;
  5. Caso desejar executar este processo como serviço, basta fechar a tela de comandos, acessar os serviços do Windows e iniciar o criado anteriormente. Por exemplo, serviço Senior - Gestão do Ponto;

Caso o acesso a internet seja feita utilizando o servidor proxy, execute o seguinte comando para configurar o Nodejs: npm config set proxy "http://domain%5C​username:password@servername:port/".

ClosedExemplo:

npm config set proxy "http://senior.com.br%5C​T0030498:senha123@proxy.senior.com.br:3128/"

Além disso, se o Nodejs for instalado em um diretório diferente do diretório padrão, edite o arquivo gestaodponto.xml, localizado em <frontend>\daemon\, e informe no campo Executable o endereço de instalação do Nodejs.

Nota

Nodejs é um servidor web utilizado para disponibilizar as páginas de aplicação (Front-end).

ClosedNginx

O Nginx é um servidor web utilizado para disponibilizar as páginas da aplicação (Front-end). Verifique o passo a passo para a sua instalação:

  1. Acesse o Portal do Cliente > Atualização de ambiente > Ferramentas > gestaoponto-frontend-nginx-server.zip e faça a extração do arquivo;
  2. Copie a pasta e cole em seu diretório;
  3. Em C:\ gestaoponto-frontend-nginx-server\html\ crie a pasta gestaoponto;
  4. Acesse a pasta Gestão do Ponto > Nova Interface > Frontend > app e copie todos os arquivos para a pasta criada anteriormente: gestaoponto;
  5. Na pasta gestaoponto, edite o arquivo app.<descrição>.js; altere as tags <servidor> e <porta>, em "//<servidor>:<porta>/gestaoponto-backend/api/", para a URL do servidor do WildFly a ser utilizado no Back-end, de forma que fique conforme o exemplo: "//servidor.com.br:8080/gestaoponto-backend/api/";
  6. Crie o servidor para o Gestão do Ponto; Para isso, dentro da pasta C:\gestaoponto-frontend-nginx-server\conf edite o arquivo nginx.conf e crie um novo server;
    ClosedExemplo:

    http {

    server {

    listen 3000;

    server_name servidor;

     

    location / {

    root html/gestaoponto;

    index index.html index.htm;

    try_files $uri $uri/ /index.html;

    }

    error_page 500 502 503 504 /50x.html;

    location = /50x.html {

    root html;

    }

    }

    }

    Observação

    O servidor é criado na porta 3000 e sem certificado digital. Para obter o certificado digital, acesse o tópico Certificados digitais (Site seguro/HTTPS/SSL) e faça as configurações necessárias.

  7. Abra o prompt de comando como administrador e acesse a pasta C:\ gestaoponto-frontend-nginx-server \service\;
  8. Caso a pasta de instalação estiver em um diretório diferente do diretório padrão (C:\), edite o arquivo nginxservice.xml;
  9. Por fim, execute o comando nginxservice.exe install.

Segurança da informação

Para saber como configurar a segurança da informação no Front-end do módulo Gestão do Ponto, acesse o Manual de Segurança da Informação.

ClosedDeploy

O deploy do Back-end deverá ser efetuado no server group em que o sistema já possui um deploy. Ou seja, é obrigatório estar no mesmo server group em que já exista a outra interface do Gestão do Ponto. Caso já exista um arquivo .war no Wildfly, é necessário realizar o seu undeploy primeiro, antes do deploy do arquivo .ear.

  1. Acesse o Portal do Cliente > Atualização de ambiente > selecione sua versão > GestaoPontoNovaInterface.zip > Extrair o arquivo Backend e copie o arquivo gestaoponto-backend-ear.ear para o diretório de sua preferência;
  2. Com um aplicativo de compactar/descompactar, abra o arquivo e acesse lib;
  3. Na pasta lib, remova o arquivo g6-config.jar ou g6-config<versão>.jar e substitua pelo arquivo, de mesmo nome, copiado do local de instalação.
  4. Faça deploy do arquivo no painel de administração do WildFly, na guia Deployments > Content Repository;
  5. Em Application > Deploy > Packaged File to Be Uploaded to the Server, localize o arquivo e clique em OK
ClosedInstalação automática

Após a realização dos passos manuais obrigatórios é necessário:

  1. Copie a mídia disponibilizada pela Senior e execute o processo padrão de instalação no Instalador;
  2. Ao concluir a instalação, ajuste o campo URL externa do back-end na Central de Configurações Senior em Sistemas > Gestão de Pessoas > Gestão do Ponto, definindo a URL com a porta na qual os usuários irão acessar o sistema, por exemplo: https://www.meusite.com.br/.

Caso utilize o Gestão do Ponto integrado à senior X Platform, é necessário configurar os menus do sistema, de forma que eles apontem para a nova URL do back-end e do front-end. Esta configuração é feita na Central de Configurações Senior em Sistemas > Gestão de Pessoas > Gestão do Ponto. Também é necessário configurar os cards do Analytics.

ClosedAtualização de tecnologia

A partir da versão 6.10.4, houve uma mudança na tecnologia de Glassfish para WildFly, afetando o procedimento de atualização. Durante a atualização, é necessário interromper o Glassfish. Durante esse procedimento, caso o instalador detecte a presença de um servidor Glassfish configurado, será solicitada a migração para o WildFly.

1. Configurações da migração

As seguintes configurações serão exigidas durante a migração:

  1. Diretório anterior do Glassfish.
  2. Servidor onde o WildFly está instalado.
  3. Diretório raiz do WildFly.
  4. As portas sugeridas para criação das configurações serão as mesmas portas e URL já configuradas anteriormente no Glassfish.

Abaixo segue exemplo da configuração que deve ser feita no instalador:

Importante

Quando o recurso de múltiplos domínios na Plataforma seniorX for habilitado, a chave com.senior.gestaoponto.multi_dominio.principal deverá ser adicionada no Central de Configurações Senior. O valor da chave será o nome do domínio principal da empresa, sem o @ (arroba). Como por exemplo: senior.com.br.
Após adicionar esta chave, é necessário reiniciar todos os domínios do WildFly utilizados pelo Gestão do Ponto.

Veja também:

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

Ver site completo