Documentation

Why migrate to GXportal 6.0?

Table of content

Installation on Linux (Java/MariaDB)

Requirements

Below are the minimum requirements to install and run the GXportal backend and frontend.
Installing the database, and the GXportal Backend and Frontend in different servers is recommended. 

Basic software requirements for GXportal

  • Database engine: MariaDB 10.2
  • Java Virtual Machine 1.6 or 1.8
  • Servlet Container to implement the Servlet 2.3 specifications
    • Tomcat
    • JBOSS
    • WildFly
    • WebSphere
  • Apache 2.4

Hardware recommendations

For security reasons, it is recommended that the database server be separated from the web server. If it is not necessary to access the GXportal backend online, it could be installed separately from the Frontend.

For the database server, at least 8GB of memory and processors equivalent to the Intel Xeon generation are recommended. At least 6GB of memory and two or more Intel Xeon-like processors are recommended for web servers.

Installation

For the installation, the file gxportal_60_java_mariadb.zip is used. Click here to download it.
The following steps explain the commands performed on a Linux Ubuntu distribution. They must be adjusted to the Linux distribution to be used.

Note: the website domain used as an example is www.example.com and it must be changed to the corresponding website domain. The same happens with the passwords to be configured. The database name used is "gxportal60" and the username used is "gxportal60;" they can be changed.

The user "gxportal60" must be created in Linux:
sudo useradd -m -d /opt/gxportal60 gxportal60

Configure a password for the user "gxportal60":
sudo passwd gxportal60

Log in with the username "gxportal60" (optional):
su - gxportal60

Uncompress the GXportal zip file at "/opt/gxportal60":
unzip gxportal_60_Java_MariaDB.zip -d /opt/gxportal60

Create the database manually
Create the database "gxportal60":
CREATE SCHEMA 'gxportal60' DEFAULT CHARACTER SET utf8;
Create the user gxportal60 for the previous schema:
CREATE USER 'gxportal60'@'%' IDENTIFIED BY '<db_password>';
Give permissions to the user "gxportal60":
GRANT ALL ON gxportal60.* TO 'gxportal60'@'%' IDENTIFIED BY '<db_password>';

Configure the database connection:
sh gxportal.sh -connection -server <database server name> -port 3306 -database gxportal60 -user gxportal60 -password <db_password>

Create the tables:
sh gxportal.sh -createtables -dbpassword <db_password>

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

Install the license administrator:
sh gxportal.sh -deploy licmgr

Configure the protection:
sh gxportal.sh -protection -registerdb -dbpassword <db_password>

Generate the WAR files:
sh gxportal.sh -deploy war -path /opt/gxportal60/war

Take the WAR files from "/opt/gxportal60/war" and deploy them in Tomcat:
sudo cp /opt/gxportal60/war/* /var/lib/tomcat8/webapps/ 
Note: Tomcat version can be 7, in which case you have to change tomcat8 to tomcat7 in the previous command path.

Enable in Apache the modules required by 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

Create a directory in Apache for the website:
sudo mkdir -p /var/www/www.example.com/public_html

Create a virtualhost in Apache based on the sample file:
sudo cp /opt/gxportal60/bin/config/apache/example.conf /etc/apache2/sites-available/example.conf

Enable the virtualhost:
sudo a2ensite example.conf

Create the directory for the multimedia files:
sudo mkdir /var/www/www.example.com/public_html/media
Note: www.example.com must be replaced with the name of the domain to use.

Associate the "media" directory with the Tomcat group:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/media

Give the Tomcat group permissions to read/write in "media:"
sudo chmod 775 /var/www/www.example.com/public_html/media

Create the directory for the css files:
sudo mkdir /var/www/www.example.com/public_html/css

Associate the "css" directory with the Tomcat group:
sudo chgrp tomcat8 /var/www/www.example.com/public_html/css

Give the Tomcat group permissions to read/write in "css:"
sudo chmod 775 /var/www/www.example.com/public_html/css

Give write permissions to Tomcat over the licmgr directory:
chgrp tomcat8 /opt/gxportal60/licmgr/

Create the directory for the temporary files:
sudo mkdir /opt/gxportal60/tmp

Associate the "tmp" directory with the Tomcat group:
sudo chgrp tomcat8 /opt/gxportal60/tmp

Give the Tomcat group permissions to read/write in "tmp:"
sudo chmod 775 /opt/gxportal60/tmp

To confirm that it has been correctly installed, access the backend: http://www.example.com/backend60/

To use GXportal, it is necessary to request keys and activate the corresponding licenses.  The steps to do so are outlined here.

Next, log into the GXportal backend with the administrator user (GXPADMIN) and make the required settings to view the images and pages as if navigating the production website. The steps to do so are outlined here.