Installation Checklist

To install Kuali Rice 1.0.3, follow these steps:

  1. Install a database. Refer to the appendices for detailed instructions on how to do this.

  2. Create a non-privileged user that will run Rice.

  3. Install a JDK

  4. Configure the Operating System.

  5. Install the JDBC drivers.

  6. Set up ImpEx process to create the database schema and populate it.

  7. Obtain the WAR file from the Rice server distribution.

  8. Install and configure a servlet container.

  9. Test the installation

Create a Non-privileged User for Rice To Use

Typically, you use this command to add a user to CentOS:

# useradd –d /home/rice –s `which bash` rice 
# passwd rice 
New UNIX password: <enter kualirice> 
Retype new UNIX password: <enter kualirice> 
passwd: all authentication tokens updated successfully.             

Distribution

To begin installation with a Kuali Rice provided distribution, just uncompress the software you retrieved from download location at the Rice web site. For the purposes of this guide, we will be focusing on installation of the server distribution.

Uncompress the server distribution downloaded from the Rice site:

  1. Verify that you are logged in as the root user

  2. Change directory to where the distributions are located

    # cd /opt/software/distribution
  3. Uncompress the distribution

    1. Follow the steps below to uncompress the Binary distribution:

      # mkdir binary
      # unzip rice-1.0.3-bin.zip -d binary
      # chmod -R 777 /opt/software                                                  
    2. Follow the steps below to uncompress the Server distribution:

      # mkdir server
      # unzip rice-1.0.3-server.zip -d server
      # chmod -R 777 /opt/software                                                 

OS Setup

It is a best practice to modify your system parameters as described here. These are just suggested system parameters. Use your best judgment about how to set up your system.

  • Verify that you are starting out in the /etc directory:

    computername $ pwd
    /etc                                
  • Add this to /etc/profile to setup ant and maven first in the path:

    JAVA_HOME=/usr/java/jdk1.6.0_16
    CATALINA_OPTS="-Xmx512m -XX:MaxPermSize=256m"
    ANT_HOME=/usr/local/ant
    ANT_OPTS="-Xmx1512m -XX:MaxPermSize=192m"
    MAVEN_HOME=/usr/local/maven
    MAVEN_OPTS="-Xmx768m -XX:MaxPermSize=128m"
    GROOVY_HOME=/usr/local/groovy
    
    PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$MAVEN_HOME/bin:$GROOVY_HOME/bin:$PATH
    export JAVA_HOME CATALINA_OPTS ANT_HOME ANT_OPTS MAVEN_OPT GROOVY_HOME                         
  • After you have completed your update of the /etc/profile file, please execute this command to immediately update your profile with the changes from above:

    source /etc/profile