Overview

Integrating your application with Kuali Rice starts with a knowledge of how the Rice environment works. This starts with sending a request for access to kr-access@ucdavis.edu. Upon subsequent approval of the Anchor Application Service Managers , the Kuali Rice team will provision the following accounts for you.
Access to DEV environment:

1. Shell Account to account on rice-dev.ucdavis.edu for managing
   • manage your designated Tomcat instance
2. DB account for managing Rice DEV schema
3. dev instance
   • check logs
   • tweak Rice properties
4. Account on the Rice development database
   • load your own data
   • refresh the entire schema
   • manage schema objects like sequences, stored procedures, etc.
5. LDAP service account to ldap-test.ucdavis.edu
   • read access to LDAP directory
   Rice instances wiki link
   See embedding Kuali Rice
   See hit list for current issues

These accounts will allow you to manage your own Rice development instance.

Managing Your Rice Instance

Accessing Your Shell

1. Use an SSH2 compliant terminal client like SecureCRT or PuTTY
2. Your home directory is located in /home/<user name>

Tomcat

1. Starting/stopping Tomcat instance:

   Code Block
   borderStyle solid
   [~/]$ sudo /etc/init.d/tomcatX start (or stop)

2. Tomcat log is at /usr/share/tomcat*X*/logs/catalina.out, where X represents your /wiki/spaces/UCDK/pages/119111827.

Rice Settings

1. Rice Configuration: /usr/local/rice/dev-X-<Rice version>/rice-config.xml, where X is the name of your application (MIV, KFS, KC, etc.).
2. Log4J: /usr/local/rice/dev-X-<Rice version>/log4j.properties

Database Access

1. You will find your database URL and credentials in rice-config.xml. Look for the properties datasource.url, datasource.username and datasource.password

Subversion Prep

Project Structure

1. Your Rice-specific data will be stored at https://svn.ucdavis.edu/svn/kuali/RiceApplications/<my application>. It is up to you to manage the structure underneath this directory.
2. The Impex Tool, Rice Bootstrap Data, and Schema Utilities are stored at https://svn.ucdavis.edu/svn/kuali/RiceStandaloneServer/rice-db/tags/<Rice version>. These are needed for managing your schemas.

Checking Out Projects

1. Create a directory where you will store working copies of files to be checked out from Subversion, such as /home/oracle/subversion/rice-db
2. Navigate to /home/oracle/subversion/rice-db
3. Checking out schema-related files

   Code Block
   borderStyle solid
   [/home/oracle/subversion/rice-db]$ svn co https://svn.ucdavis.edu/svn/kuali/RiceStandaloneServer/rice-db/tags/<Rice version>.

   Info
   Under /home/oracle/subversion/rice-db, there will now be a /<Rice version> directory

Refreshing Your Schema

Configure the Impex Tool

1. Copy /home/oracle/subversion/rice-db/<Rice version>/impex-build.properties.sample to your home directory and rename it to impex-build.properties
2. Modify /wiki/spaces/UCDK/pages/119111688 to suit. There are helpful schema utility scripts located in /home/oracle/subversion/rice-db/<Rice version>/schema-utils.

   Info
   The impex-build.properties.sample file already has pre-import and post-import scripts defined.

Execute the Refresh

1. Navigate to /home/oracle/subversion/rice-db/<Rice version>/database-impex
2. Set the classpath to include libraries required by the Impex Tool

   Code Block
   borderStyle solid
   [/home/oracle/subversion/rice-db/<Rice version>/database-impex}]$ export classpath=./lib;$CLASSPATH

3. Execute the refresh

   Code Block
   borderStyle solid
   [/home/oracle/subversion/rice-db/<Rice version>/database-impex}]$ ant import