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 se cuenta con el archivo gxportal_60_java_mariadb.zip, haga clic 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 gxportal60 y para el nombre de usuario gxportal60, los mismos pueden cambiarse.

Se debe crear usuario "gxportal60" en linux:
sudo useradd -m -d /opt/gxportal60 gxportal60

Configurar contraseña a usuario "gxportal60":
sudo passwd gxportal60

Ingresar con usuario "gxportal60" (opcional):
su - gxportal60

Descomprimir zip de GXportal en "/opt/gxportal60":
unzip gxportal_60_Java_MariaDB.zip -d /opt/gxportal60
 
Crear la BD manualmente
Crear la base de datos "gxportal60":   
CREATE SCHEMA 'gxportal60' DEFAULT CHARACTER SET utf8;
Crear el usuario gxportal60 para el esquema anterior:
CREATE USER 'gxportal60'@'%' IDENTIFIED BY '<db_password>';
Dar permisos al usuario "gxportal60":   
GRANT ALL ON gxportal60.* TO 'gxportal60'@'%' IDENTIFIED BY '<db_password>';

Configurar conexión a la BD:
sh gxportal.sh -connection -server <nombre del servidor de base de datos> -port 3306 -database gxportal60 -user gxportal60 -password <db_password>

Crear las tablas:
sh gxportal.sh -createtables -dbpassword <db_password>

Inicializar la metadata:
sh gxportal.sh -import metadata -path /opt/gxportal60/bin/metadata -dbpassword <db_password>

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

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

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

Tomar los war de "/opt/gxportal60/war" y desplegarlos en el Tomcat:
sudo cp /opt/gxportal60/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

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

Crear directorio en Apache para el sitio:
sudo mkdir -p /var/www/www.example.com/public_html

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

Activar el virtualhost:
sudo a2ensite example.conf

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

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

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

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

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

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

Dar permisos de escritura al tomcat sobre el directorio licmgr:
chgrp tomcat8 /opt/gxportal60/licmgr/

Crear el directorio para los archivos temporales:
sudo mkdir /opt/gxportal60/tmp

Asociar el directorio "tmp" al grupo del tomcat:
sudo chgrp tomcat8 /opt/gxportal60/tmp

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

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

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