Documentación

¿Por qué migrarse a GXportal 6.0?

Tabla de contenidos

Instalación en Linux (Java/MariaDB)

Requerimientos

A continuación encontrará la lista de los requerimientos mínimos para instalar y ejecutar el Backend y Frontend de GXportal.
Se recomienda instalar en diferentes servidores la base de datos, el Backend y el Frontend de GXportal

Requerimientos de software de base para el funcionamiento de GXportal

  • Motor de base de datos: MariaDB 10.2
  • Java Virtual Machine 1.6 ó 1.8
  • Servlet Container que implemente las especificaciones Servlet 2.3
    • Tomcat
    • JBOSS
    • WildFly
    • WebSphere
  • Apache 2.4

Recomendaciones de hardware

Por seguridad se recomienda que el servidor de base de datos esté separado del servidor web. Si además no es necesario el acceso del backend de GXportal desde Internet el mismo se podría instalar separado del Frontend.
 
Para el servidor de base de datos se recomienda como mínimo 8GB de memoria y procesadores equivalentes a la generación Intel Xeon. Para los servidores web se recomienda como mínimo 6GB de memoria y dos o más procesadores similares a los Intel Xeon.

Instalación

Para la instalación de la versión 6.1 debe descargar el archivo gxportal_61_java_mariadb.zip

El setup de GXportal 6.0 está disponible aquí para su descarga.

Los siguientes pasos detallan comandos realizados sobre una distribución Ubuntu de Linux. Deberán ajustarse a la distribución de Linux que se vaya a usar.

Nota: se usa como ejemplo el dominio del sitio como www.example.com el cual deberá cambiarse por el dominio del sitio que corresponda. De la misma forma con las contraseñas a configurar. Se utiliza a continuación para el nombre de la base de datos gxportal61 y para el nombre de usuario gxportal61, los mismos pueden cambiarse.

1. Se debe crear usuario "gxportal61" en linux:

sudo useradd -m -d /opt/gxportal61 gxportal61
 
2. Configurar contraseña a usuario "gxportal61":

sudo passwd gxportal61
 
Ingresar con usuario "gxportal61" (opcional):
 
su - gxportal61
 
3. Descomprimir zip de GXportal en "/opt/gxportal61":

unzip gxportal_61_java_mariadb.zip -d /opt/gxportal61

4. Crear la BD manualmente
4.1 Crear la base de datos "gxportal61":   
CREATE SCHEMA gxportal61 DEFAULT CHARACTER SET utf8;
 
4.2 Crear el usuario gxportal61 para el esquema anterior:
CREATE USER 'gxportal61'@'%' IDENTIFIED BY '<db_password>';
 
4.3 Dar permisos al usuario "gxportal61":   
GRANT ALL ON gxportal61.* TO 'gxportal61'@'%' IDENTIFIED BY '<db_password>';
 
5. Configurar conexión a la BD:
sh gxportal.sh -connection -server <nombre del servidor de base de datos> -port 3306 -database gxportal61 -user gxportal61 -password <db_password>
 
6. Crear las tablas:
sh gxportal.sh -createtables -dbpassword <db_password>
 
7. Inicializar la metadata:
sh gxportal.sh -import metadata -path /opt/gxportal61/bin/metadata -dbpassword <db_password>

8. Instalar el administrador de licencias:
sh gxportal.sh -deploy licmgr

9. Configurar la protección:
sh gxportal.sh -protection -registerdb -dbpassword <db_password>

10. Generar los archivos WAR:
sh gxportal.sh -deploy war -path /opt/gxportal61/war

11. Tomar los war de "/opt/gxportal61/war" y desplegarlos en el Tomcat:
sudo cp /opt/gxportal61/war/* /var/lib/tomcat8/webapps/ 
Nota: la version del tomcat puede ser 7 en cuyo caso hay que cambiar tomcat8 por tomcat7 en la ruta del comando anterior

12. Activar en Apache módulos requeridos por 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. Crear directorio en Apache para el sitio:
sudo mkdir -p /var/www/www.example.com/public_html

14. Crear virtualhost en Apache partiendo del archivo de ejemplo:
sudo cp /opt/gxportal61/bin/config/apache/example.conf /etc/apache2/sites-available/example.conf

15. Activar el virtualhost:
sudo a2ensite example.conf

16. Crear el directorio para los archivos multimedia:
sudo mkdir /var/www/www.example.com/public_html/media
Nota: en lugar de www.example.com va el nombre del dominio que se quiere usar

17. Asociar el directorio "media" al grupo del tomcat:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/media

18. Dar permisos al grupo del tomcat para leer/escribir en "media":
sudo chmod 775 /var/www/www.example.com/public_html/media

19. Crear el directorio para los archivos css:
sudo mkdir /var/www/www.example.com/public_html/css

20. Asociar el directorio "css" al grupo del tomcat:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/css

21. Dar permisos al grupo del tomcat para leer/escribir en "css":
sudo chmod 775 /var/www/www.example.com/public_html/css

22. Dar permisos de escritura al tomcat sobre el directorio licmgr:
chgrp tomcat8 /opt/gxportal61/licmgr/

23. Crear el directorio para los archivos temporales:
sudo mkdir /opt/gxportal61/tmp

24. Asociar el directorio "tmp" al grupo del tomcat:
sudo chgrp tomcat8 /opt/gxportal61/tmp

25. Dar permisos al grupo del tomcat para leer/escribir en "tmp":
sudo chmod 775 /opt/gxportal61/tmp

Para verificar que haya quedado correctamente instalado, acceder al backend: http://www.example.com/backend61/

Es necesario solicitar claves y activar las licencias correspondientes para poder utilizar GXportal. Los pasos para esto se describen aquí.
Luego, se accederá al backend de GXportal con el usuario administrador (GXPADMIN) y se realizarán configuraciones para poder ver las imágenes y visualizar las páginas como si se estuviera navegando en el sito en producción. Los pasos para esto se describen aquí.