Checking out the Rice codebase
- Checkout the latest Rice codebase from Rice-Codebase (https://test.kuali.org/svn/rice/trunk).
Check out clover-integration (rice data)
- Checkout the clover integration folder from Clover-Integration (https://test.kuali.org/svn/kul-cfg-dbs/branches/clover-integration)
Setup sample-app-config.xml
- Create a file called sample-app-config.xml under user.home/kuali/main/dev/
Setup impex-build.properties
- Create a file called impex-build.properties under user.home
Update torque.schema.dir entry in impex-build.properties
Update the directory entry for torque.schema.dir in the impex-build.properties file to point to clover folder in your checked out rice codebase. The clover folder won't exist but its ok to point to that as you will see in the next sections why it would work.
Setup database
1. Navigate to the clover-integration/impex folder
2. run the following command: ant satellite-update
3. Upon successful run of the satellite-update verify the database is setup with tables etc.
Satellite Update
Satellite-update tries to check out whatever is set in your impex build file, but if you point it to check it out with a folder that already exists and is an svn location, it will just update that location (and use that locations svn repo).
Setup IntelliJ Project
1. Launch IntelliJ
2. Under the Quick Start menu click Open Project
3. Point to the pom.xml under the checked out rice codebase and click Ok.
4. This will create the intellij project for Rice.
Facets creation by IntellIJ
IntelliJ detects various facets if available and will prompt you to automatically create as part of the project configuration. You should accept when prompted or click on the create options when presented.
Setup Tomcat Configuration
Artifact for deployment
Note - The artifact that you will need to mark for deployment will be 'rice-sampleapp:war exploded' and not the sample-app.war.
Launch Sample App
Launch the sample app program by running tomcat. In the login prompt enter admin as the username and you should get to the main menu.
Setup for Ecliplse
1. Setup the Database
Follow the instructions in the wiki (https://wiki.kuali.org/display/KULRICE/Load+Impex+Data+via+Maven|display/KULRICE/Load+Impex+Data+via+Maven)
Do the following changes in the file c:\usr\local\rice\rice-config.xml
Old: <param name="datasource.platform">org.kuali.rice.core.database.platform.MySQLDatabasePlatform</param>
New: <param name="datasource.platform">org.kuali.rice.core.framework.persistence.platform.MySQLDatabasePlatform</param>
change the username/pwd to the following
<!- set some datasource defaults ->
<param name="datasource.username">rice</param>
<param name="datasource.password">rice</param>
In case if you have access issues with the Datbase, make sure the username has access to the rice Database.
create USER 'rice'@'localhost' IDENTIFIED BY 'rice';
grant all on *.* to 'rice'@'localhost';
2. Pull the Source Code
Follow the instruction in the wiki
If you have errors in the eclipse projects, try compile the source code from command prompt
mvn clean install -DskipTests (from the folder 'rice')
Make sure you set Maven_opts in the environemnt variable
MAVEN_OPTS=-Xms512m -Xmx1024m -XX:MaxPermSize=512m
Keep Maven offline in Eclipse Window >> Preferences >> Maven, This helps the performance of Eclipse to be little better
Have a config file (common_config.xml) in folder C:\Users\USER_FOLDER\kuali\main\dev for the sample applicaiton to work, this will have the DB driver and URL information
(you can copy the rice-config.xml too and rename it to common_config.xml)
3. Launching the Sample app
Once you have the maven build successful, it creates the war file in the following location, C:\workspace2.0\rice\sampleapp\target, copy that to your tomcat webapps folder and start the tomcat server (rename the war if needed) and access it from the browser (eg. http://localhost:8080/kr-dev )