Documentação

Como migrar o conteúdo para outra ferramenta?

Tabela de conteúdos

Documentação de versões anteriores

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 da versão 6.1 você deve baixar o arquivo gxportal_61_java_mariadb.zip

O setup do GXportal 6.0 está disponível aqui para download.

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 gxportal61 e para o nome de usuário gxportal61, eles podem ser alterados.

1. Você precisa criar ou usar "gxportal61" não linux:
sudo useradd -m -d /opt/gxportal61 gxportal61

2. Definir senha para o usuário "gxportal61": 
sudo passwd gxportal61
 
Entrar com o usuário "gxportal61" (opcional):
su - gxportal61

3. Descompacte o zip GXportal em "/opt/gxportal61":
unzip gxportal_61_java_mariadb.zip -d /opt/gxportal61

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

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

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

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

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

11. Tomar os war de "/opt/gxportal61/war" e desdobre-os no Tomcat:
sudo cp /opt/gxportal61/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

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

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

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

15. Ative o virtualhost:
sudo a2ensite example.conf

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

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

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

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

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

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

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

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

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