How can i install the Gentics Content.Node Package?

This page described what steps are needed to install Gentics Content.Node. Additional information can be found in the Admin install guides page.

1 System requirements

  • 64Bit Linux Operation System
  • at least 4GB system memory
  • at least 12GB free disk space
  • MySQL 5.5+ installation

Please note that you have to add the i386 architecture for debian wheezy installations (e.g: dpkg —add-architecture i386 )

2 MySQL Server configuration

Please install a 64 Bit MySQL Server. The Compatibility List contains an overview of version which are supported by Gentics Content.Node.

MySQL 5.6.12 – Please note that it is mandatory to disable the sql_mode setting. By default NO_ENGINE_SUBSTITUTION and STRICT_TRANS_TABLES are enabled. Gentics Content.Node will not function properly when the STRICT_TRANS_TABLES setting is enabled.

Please note that the my.cnf mysqld setting character-set-server must be set to utf8. It is also highly suggested to set the client default-character-set to utf8.

3 Debian Linux

  • Download the installation package tar.gz file from the Gentics Updatesite using the login gcn and your licensekey.

3.1 Guided Installation


  cd /opt/
  wget https://gcn:1111-2222-3333-4444-5555-6666-7777-8888@updates.gentics.com/maven2/com/gentics/contentnode-package/5.12.0/contentnode-package-5.12.0.tar.gz
  tar xfv gcn5_package-5.12.0.tar.gz
  cd package
  ./install.sh

The installation script will prompt for host names and license keys.

3.2 Unattended Installation


  ./install.sh cms.gcn-testing.office 1111-2222-3333-4444-5555-6666-7777-8888

4 Red Hat Enterprise Linux / SUSE Linux Enterprise Server

Currently the install.sh script only supports Debian Linux. However a manual installation can be achieved on SLES/RHEL.

4.1 User Creation


  groupadd node
  groupadd node_public
  useradd -d /Node -g node -G node_public node
  useradd -d /Node -g node_public node_public

4.2 Move files into place


  cd /opt/
  wget https://gcn:1111-2222-3333-4444-5555-6666-7777-8888@updates.gentics.com/maven2/com/gentics/contentnode-package/5.12.0/contentnode-package-5.12.0.tar.gz
  tar xfv gcn5_package-5.12.0.tar.gz
  cd package
  
  # Main Installation
  cp -ra Node /
  
  # Demo Content Files
  cp -ra dumps/dbfiles/* /Node/node/content/dbfiles/
  chown node: /Node/node/content/dbfiles/*
  

4.3 Correct local file permissions


  cd /Node
  ./dist_setperm.sh

4.4 Setup the Autostart


  ln -s /Node/bin/nodectl  /etc/init.d/nodectl
  # Enable nodectl for runlevels 2,3,4,5 or use the dependency boot system tool __insserv__ or by using __sysv-rc-conf__.

4.5 Setup locales

Make sure that the locale en_US.UTF-8 has been created

4.6 Compatibility libraries

Make sure that the ia32 compatibility libraries have been installed.

4.7 License Key


  echo "1111-2222-3333-4444-5555-6666-7777-8888" > /Node/etc/tomcat/gentics/license.key
  chown node:node /Node/etc/tomcat/gentics/license.key

4.8 Gentics Content.Node Configuration

Replace the string REPLACESERVERNAME with your desired server name in the /Node/etc/httpd/sites-available/cms.conf file.

4.9 Memory configuration

The default system configuration will utilize around 2-4 GB memory for the MySQL Server, Apache Tomcat Server, Apache and caches. Information about memory configuration can be found in this FAQ (Only available in german language)

4.10 Start the MySQL


  /Node/bin/nodectl start mysql
  # Wait a moment since the mysql could take a moment to startup

4.11 Create MySQL DBs/User


  echo "CREATE DATABASE node_utf8" | mysql -u root -p
  echo "CREATE DATABASE contentrepository" | mysql -u root -p
  echo "GRANT ALL PRIVILEGES ON node_utf8.* TO 'node'@'localhost' IDENTIFIED BY 'YOURPW';" | mysql -u root -p
  echo "GRANT ALL PRIVILEGES ON contentrepository.* TO 'node_cr'@'localhost' IDENTIFIED BY 'YOURPW';" | mysql -u root -p
  flush privileges;

4.12 Insert MySQL Dumps


  # Main Gentics Content.Node Database
  cat /opt/package/dumps/node_utf8.sql | mysql -u node -p node_utf8

  # Demo ContentRepository
  cat /opt/package/dumps/contentrepository.sql | mysql -u node_cr -p contentrepository

4.13 Configure MySQL Connection

The node.conf file contains the main database settings.

node.conf

  $SETTINGS["dbtype"] = "mysql";
  $SETTINGS["db"] = "node_utf8";
  // Adapt this url so that it contains the correct port and the socket file path
  $SETTINGS["server"] = "localhost:3306:/var/run/mysqld/mysqld.sock";
  $SETTINGS["login"] = "node";
  $SETTINGS["pw"] = "YOURPW";
  $SETTINGS["charset"] = "utf8";
  $SETTINGS["jdbcparameters"] = "netTimeoutForStreamingResults=900";

The contentrepository connection properties can be changed later on within the Admin Area of Gentics Content.Node. (Administration → Content.Admin → ContentRepositories)

4.14 Start the backend


  /Node/bin/nodectl start

4.15 Crontab Entry


  echo "# Gentics Content.Node Scheduler Task" >> /etc/crontab
  echo "* * * * *         node    /Node/bin/scheduler.sh >> /Node/node/log/scheduler.log 2>&1" >> /etc/crontab

5 Final steps

You should now be able to access the Gentics Content.Node login page. The /opt/package directory can be deleted.

  • Memory Setting

Please take some time and adjust the memory settings for your new server. This is very important because it will enhance the performance and improve the usability for your editor. Details are documented in the memory and performance guide.