Rhythmyx 7.3.2 Installation & Configuration Guide

Installation / Upgrade

The installation and upgrade procedure follows standard Rhythmyx installer procedures outlined in the Installation Guide.   The upgrade will install the files necessary to deploy Jetty and will also deploy the JBOSS Application server.  JBOSS can be removed after the upgrade has been successfully completed. 

Please note that if you are upgrading that you ensure Rhythmyx is on the latest patch of either 7.3.1 or 7.3.0.

Jetty Configuration Files

The new Jetty Application Server is deployed to the {RHYTHMYX_HOME}\jetty directory.

Configuration files are stored in {RHYTHMYX_HOME}\jetty\base\etc directory.

Mandatory step for Jetty server:

Please make sure all custom RhythmyxServer.lax(for windows)/RhythmyxServer.bin.lax(Linux) configurations are ported to jetty/base/start.d/jvm.ini file as described in this Memory and Java Settings document. 

Sample jvm.ini file

Enabling Database Support

MySQL Server

When configuring MySQL make sure to use the updated MySQL connector jar that matches the version of the MySQL Server that you are using.

For example if you have upgraded your MySQL server to 5.6 or 5.7, ensure that the MySQL Connector used by Rhythmyx is the MySQL jar that is deployed to {RHYTHMYX_HOME}\jetty\defaults\lib\mysql-connector.jar.  The jar you use, filename must match "mysql-connector.jar". 

Custom Datasources

It is recommended that custom datasources are edited and maintained using the Server Administrator tool, this tool has been updated to support both Jetty and JBOSS style of data sources.

Starting Jetty

For testing the startup you can startup in the command line window:

cd {RHYTHMYX_HOME}\jetty\

StartJetty.bat or StartJetty.sh depending on your OS (Windows vs Linux).  

To keep the server running you should start up by installing the Rhythmyx jetty service located in the {RHYTHMYX_HOME}\jetty\service directory (either install-jetty-service.bat or install-jetty-service.sh). 

Service Startup

Logging

Logging is configured using the log4j.xml file in {RHYTHMYX_HOME}\jetty\base\resources\log4j.xml.  Currently the logs are incorrectly being placed in {RHYTHMYX_HOME}\jetty\base\logs.  

Removing JBOSS

Renaming or removing the{RHYTHMYX_HOME}\AppServer folder will remove the old JBOSS Application server from your installation.  We recommend that you backup your installation prior to removing this folder. 

Additional Information

Please view the Working with Jetty documentation for information on additional configuration on SSL, data sources, and more.