Getting Started with Rice Development
Overview
Integrating your application with Kuali Rice starts with a knowledge of how the Rice environment works. Upon approval of the Anchor Application Service Managers , the Kuali Rice team will provision the following accounts for you:
- Shell account on
rice-dev.ucdavis.edu
- manage your designated Tomcat instance
- check logs
- tweak Rice properties
- Account on the Rice development database
- load your own data
- refresh the entire schema
- manage schema objects like sequences, stored procedures, etc.
- LDAP service account to
ldap-test.ucdavis.edu
- read access to LDAP directory
These accounts will allow you to manage your own Rice development instance.
Managing Your Rice Instance
Accessing Your Shell
- Use an SSH2 compliant terminal client like SecureCRT or PuTTY
- Your home directory is located in
/home/<user name>
Tomcat
- Starting/stopping Tomcat instance:
[~/]$ sudo /etc/init.d/tomcatX start (or stop)
- Tomcat log is at
/usr/share/tomcat*X*/logs/catalina.out
, where X represents your /wiki/spaces/UCDK/pages/119111827.
Rice Settings
- Rice Configuration:
/usr/local/rice/dev-X-<Rice version>/rice-config.xml
, where X is the name of your application (MIV, KFS, KC, etc.). - Log4J:
/usr/local/rice/dev-X-<Rice version>/log4j.properties
Database Access
- You will find your database URL and credentials in
rice-config.xml
. Look for the propertiesdatasource.url
,datasource.username
anddatasource.password
Subversion Prep
Project Structure
- 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.
- 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
- Create a directory where you will store working copies of files to be checked out from Subversion, such as /home/oracle/subversion/rice-db
- Navigate to /home/oracle/subversion/rice-db
- Checking out schema-related files
[/home/oracle/subversion/rice-db]$ svn co https://svn.ucdavis.edu/svn/kuali/RiceStandaloneServer/rice-db/tags/<Rice version>.
Under
/home/oracle/subversion/rice-db
, there will now be a /<Rice version> directory
Refreshing Your Schema
Configure the Impex Tool
- Copy
/home/oracle/subversion/rice-db/<Rice version>/impex-build.properties.sample
to your home directory and rename it toimpex-build.properties
- 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
.The
impex-build.properties.sample
file already has pre-import and post-import scripts defined.
Execute the Refresh
- Navigate to
/home/oracle/subversion/rice-db/<Rice version>/database-impex
- Set the classpath to include libraries required by the Impex Tool
[/home/oracle/subversion/rice-db/<Rice version>/database-impex}]$ export classpath=./lib;$CLASSPATH
- Execute the refresh
[/home/oracle/subversion/rice-db/<Rice version>/database-impex}]$ ant import