Steps for a successful Linux Installation
1. Download and install the Sun Java JRE or JDK 5.0 from http://www.java.com or http://java.sun.com ; gcc-java does not work and is bundled with some Linux distributions
2. Download and install Tomcat 5.5 stable "Core" from
http://tomcat.apache.org/download-55.cgi ; Apache Tomcat is bundled with some Linux distributions and fails if it was compiled with gcc-java
3. Depending on the total memory of your system, typically set Tomcat’s memory to half of the server by setting the following environment variable (directly in the startup.sh file):
export JAVA_OPTS="-Xms512 -Xmx512m -XX:PermSize=64m -XX:MaxPermSize=128m"
4. Enable software graphics rending, or else Centric CRM will fail, by setting the following environment variable (directly in the startup.sh file):
export CATALINA_OPTS=-Djava.awt.headless=true
5. Download and copy the Centric CRM application (centric.war) from
http://www.centriccrm.com into Tomcat’s "webapps" directory
6. Setup a service to automatically have Tomcat start and stop during startup and shutdown, according to Tomcat’s documentation; the user that starts Tomcat must have a home directory as this is where Java stores preferences for Java applications
Permissions for the Tomcat User
The Java API tries to store a preference in the user's home directory. If the user that runs Tomcat does not have a home directory, then after a restart the user will be prompted to configure the application again. Choosing the same path reloads the existing configuration.
If this occurs, then in the Tomcat startup script, you can add a variable called CATALINA_OPTS, or use an environment variable, with a directory that the tomcat user does have access to...
CATALINA_OPTS="-Djava.awt.headless=true -Djava.util.prefs.userRoot=/var/lib/centric_crm/fileLibrary/userPrefs -Djava.util.prefs.systemRoot=/var/lib/centric_crm/fileLibrary/systemPrefs"
1. java.awt.headless is used for any server generated graphics
2. the other two specify the directory to write the prefs to (and must already exist with the correct permissions).
Notes about gcc-java
GCJ supports most of the Java 1.4 libraries plus some 1.5 additions, but not all. This causes Centric CRM to break. If you are using a Linux distribution with gcj then you can take the following steps after installing Sun Java and Apache Tomcat (do not use the versions included with Linux):
- Overwrite (or rename) the existing bin/java command by creating a soft link to Sun's bin/java
- Update /etc/init.d/tomcat with the user that should be running Tomcat
- Make changes to /etc/ant.conf (if using Centric CRM source)
Sign in to add your comment.