Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Most people will find that installing CAS 3.0.x on RHEL 5 isn't initially as straightforward as they hoped.  This is largely in part due to Redhat not officially supporting either the Sun Java Development Kit (JDK).  By default, Redhat has bundled RHEL 5 with the GNU Compiler for Java (GCJ) from JPackage, which is equivalent to J2SE 1.4.2 as of July 2007.  This can cause code compiled by newer versions of Sun JDK to be incompatible with GCJ.  However, it is not only possible but fairly easy to get CAS 3.0.x deployed on RHEL 5.

NOTE: This walkthrough uses Apache HTTP server to front-end Apache Tomcat 5.5.x for SSL by forwarding requests through the Apache mod_jk module.

NOTE: This walkthrough involves the use of precompiled Sun Java 6 and Apache Tomcat 5.5.x binaries rather than keeping RHEL 5 in sync with yum repositories.

NOTE: You can avoid step 12, 34, 4 5 and 5 6 and keep your Tomcat package in sync with the Redhat yum repo. However you'll end up with a somewhat mixed environment that may cause some issues. See http://www.ja-sig.org/wiki/display/CASUM/Switching+to+a+Sun+JVM+in+RHEL.

Step 1: Download and install Apache HTTP server


Step 2: Remove pre-installed version of Apache Tomcat 5.5.x

If your installation of RHEL 5 has Apache Tomcat 5.5.x installed by default, then it must be removed.  This can be done easily through yum as RHEL 5 saw Redhat replacing up2date with yum as the preferred package management tool.

...

Once Tomcat is removed, then we can move onto setting up our Sun Java environment!

Step

...

3: Download and install Sun JDK

NOTE:  If you are trying to install the Sun JDK on a remote server, then you will have to download the JDK through a text web browser such as elinks, which is available through yum and usually installed by default.  An interactive browser is necessary as you must agree to Sun's licensing terms.  If this is not an option, then you can always download it on another computer and FTP it to the remote server.

...

 Now that the Sun JDK is installed, we need to set up the necessary environment variables for Java and Tomcat for all users.

Step

...

4: Set up necessary environment variables

There are two main reasons why we need to set up environment variables for Java:

...

These environment variables will take effect whenever you next login to the machine.  You can also run each of these commands from the console to take effect immediately.

Step

...

5: Download and install Apache Tomcat 5.5.x

NOTE:  If you are trying to install the Apache Tomcat on a remote server, then you can download it through wget, which is available through yum and usually installed by default.  If this is not an option, then you can always download it using a text web browser such as elinks or FTP from another computer.

...

Panel

 [root@localhost local]# wget http://mirror.nyi.net/apache/tomcat/tomcat-5/v5.5.23/bin/apache-tomcat-5.5.23.tar.gz
-14:47:17http://mirror.nyi.net/apache/tomcat/tomcat-5/v5.5.23/bin/apache-tomcat-5.5.23.tar.gz
           => `apache-tomcat-5.5.23.tar.gz'
Resolving mirror.nyi.net... 64.90.181.77
Connecting to mirror.nyi.net|64.90.181.77|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 5,977,561 (5.7M) [application/x-gzip]

100%[=================================================================================================================>] 5,977,561    661.79K/s    ETA 00:00

14:47:26 (638.93 KB/s) - `apache-tomcat-5.5.23.tar.gz' saved [5977561/5977561]

[root@localhost local]# tar -xzf apache-tomcat-5.5.23.tar.gz
[root@localhost local]# useradd tomcat
[root@localhost local]# chown tomcat:tomcat -R apache-tomcat-5.5.23
[root@localhost local]# ln -s apache-tomcat-5.5.23 tomcat
[root@localhost local]# ls -l
total 80
drwxr-xr-x 11 tomcat tomcat 4096 Jun 22 12:45 apache-tomcat-5.5.23
drwxr-xr-x  2 root   root   4096 Oct 10  2006 bin
drwxr-xr-x  2 root   root   4096 Oct 10  2006 etc
drwxr-xr-x  2 root   root   4096 Oct 10  2006 games
drwxr-xr-x  2 root   root   4096 Oct 10  2006 include
drwxr-xr-x  2 root   root   4096 Oct 10  2006 lib
drwxr-xr-x  2 root   root   4096 Oct 10  2006 libexec
drwxr-xr-x  2 root   root   4096 Oct 10  2006 sbin
drwxr-xr-x  4 root   root   4096 Mar 16 04:26 share
drwxr-xr-x  2 root   root   4096 Oct 10  2006 src
lrwxrwxrwx  1 root   root     20 Jun 22 12:43 tomcat -> apache-tomcat-5.5.23
[root@localhost local]#

Step

...

6: Download and install Apache Ant


Step 7: Download and install Apache mod_jk module 


Step

...

8: Download and deploy CAS server 3.0.x