Documentação

Por que migrar para GXportal 6.0?

Tabela de conteúdos

Instalação em Linux (Java/MariaDB)

Requisitos

Abaixo, você encontrará a lista dos requisitos mínimos para instalar e executar o Backend e o Frontend do GXportal.
Recomenda-se instalar em diferentes servidores o banco de dados, o Backend e o Frontend do GXportal

Requisitos básicos de software e para o funcionamento do GXportal

  • Motor de base de datos: Maria DB 10.2
  • Java Virtual Machine 1.6 ó 1.8
  • Servlet Container que implementa as especificações Servlet 2.3
    • Tomcat
    • JBOSS
    • WildFly
    • WebSphere
  • Apache 2.4

Recomendações de hardware

Por segurança, recomenda-se que o servidor de banco de dados seja separado do servidor da web. Se, além disso, o acesso ao Backend do GXportal não for necessário da Internet, ele poderá ser instalado separadamente do Frontend.

Para o servidor de banco de dados, recomendamos pelo menos 8 GB de memória e processadores equivalentes à geração Intel Xeon. Para servidores da Web, recomendamos pelo menos 6 GB de memória e dois ou mais processadores semelhantes ao Intel Xeon.

Instalação

Para a instalação você tem o arquivo gxportal_60_java_mariadb.zip, clique aqui para baixar.

Os seguintes passos detalham os comandos feitos em uma distribuição do Ubuntu Linux. Eles devem estar de acordo com a distribuição do Linux que será usada.

Nota: o domínio do site é usado como um exemplo, como www.example.com, que deve ser alterado pelo domínio do site correspondente. Da mesma forma com as senhas para configurar. É usado abaixo para o nome do banco de dados gxportal60 e para o nome de usuário gxportal60, eles podem ser alterados.
Você precisa criar ou usar "gxportal60" não linux:
sudo useradd -m -d /opt/gxportal60 gxportal60

Definir senha para o usuário "gxportal60": 
sudo passwd gxportal60

Entrar com o usuário "gxportal60" (opcional):
su - gxportal60

Descompacte o zip GXportal em "/opt/gxportal60":
unzip gxportal_60_Java_MariaDB.zip -d /opt/gxportal60

Crie o BD manualmente:
Crie o banco de dados "gxportal60":
CREATE SCHEMA 'gxportal60' DEFAULT CHARACTER SET utf8;
Crie o usuário gxportal60 para o esquema anterior:
CREATE USER 'gxportal60'@'%' IDENTIFIED BY '<db_password>';
Dê permissão ao usuário "gxportal60":
GRANT ALL ON gxportal60.* TO 'gxportal60'@'%' IDENTIFIED BY '<db_password>';

Configurar conexão ao BD:
sh gxportal.sh -connection -server <nome do servidor de banco de dados> -port 3306 -database gxportal60 -user gxportal60 -password <db_password>
 
Crie as tabelas:
sh gxportal.sh -createtables -dbpassword <db_password>

Inicialize os metadados:
sh gxportal.sh -import metadata -path /opt/gxportal60/bin/metadata -dbpassword <db_password>

Instale o gerenciador de licença:
sh gxportal.sh -deploy licmgr
 
Configurar proteção:
sh gxportal.sh -protection -registerdb -dbpassword <db_password>

Gere arquivos WAR:
sh gxportal.sh -deploy war -path /opt/gxportal60/war

Tomar os war de "/opt/gxportal60/war" e desdobre-os no Tomcat:
sudo cp /opt/gxportal60/war/* /var/lib/tomcat8/webapps/ 
Nota: a versão do tomcat pode ser 7, caso em que você terá que alterar o tomcat8 para o tomcat7 no caminho de comando anterior

Ative nos módulos do Apache requeridos pelo GXportal (mod_proxy.so, mod_proxy_http.so, mod_proxy_ajp.so, mod_headers.so, mod_rewrite.so):
sudo a2enmod proxy proxy_http proxy_ajp headers rewrite

Crie o diretório Apache para o site:
sudo mkdir -p /var/www/www.example.com/public_html

Crie virtualhost no Apache a partir do arquivo de amostra:
sudo cp /opt/gxportal60/bin/config/apache/example.conf /etc/apache2/sites-available/example.conf

Ative o virtualhost:
sudo a2ensite example.conf

Crie o diretório para arquivos multimídia:
sudo mkdir /var/www/www.example.com/public_html/media
Nota: em vez de www.example.com, é o nome do domínio que você deseja usar

Associe o diretório "media" ao grupo tomcat:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/media
 
Conceda permissões ao grupo do tomcat para ler/escrever em "media":
sudo chmod 775 /var/www/www.example.com/public_html/media

Crie o diretório para os arquivos css:
sudo mkdir /var/www/www.example.com/public_html/css

Associe o diretório "css" ao grupo tomcat:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/css
 
Conceda permissões ao grupo do tomcat para ler/escrever em "css":
sudo chmod 775 /var/www/www.example.com/public_html/css

Dê permissões de gravação ao tomcat no diretório licmgr:
chgrp tomcat8 /opt/gxportal60/licmgr/
 
Crie o diretório para arquivos temporários:
sudo mkdir /opt/gxportal60/tmp

Associe o diretório "tmp" ao grupo tomcat:
sudo chgrp tomcat8 /opt/gxportal60/tmp

Conceda permissão ao grupo do tomcat para ler/escrever em "tmp":
sudo chmod 775 /opt/gxportal60/tmp

Para verificar se ele foi instalado corretamente, acesse o backend: 
http://www.example.com/backend60/

É necessário solicitar senhas e ativar as licenças correspondentes para poder usar o GXportal. As etapas para isso são descritas aqui.

Em seguida, o backend do GXportal será acessado com o usuário administrador (GXPADMIN) e serão feitas configurações para visualizar as imagens e exibir as páginas como se estivessem navegando no site em produção. As etapas para isso são descritas aqui.