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