1. Checking out the rice2.x-OLE codebase
- Checkout the rice2.x-OLE codebase from rice2.x-OLE
Create a file called rice2.x-OLE-config.xml under "user.home"/kuali/main/dev/. Alternatively you can copy it from the additionalfiles folder within the codebase.
Create a file called rice.keystore files under "user.home"/kuali/main/dev. Alternatively copy the rice.keystore file as well from the additionalfiles folder within the project codebase and place it under "user.home"/kuali/main/dev.
2. Setup database
DB Username and Password when executing the maven commands for db setup
If you don't have the sampleapp-config.xml (which would have had the username/password) the default username/password is rice/rice
1. Download the db folder from the rice trunk from the following location: rice-db-trunk (https://svn.kuali.org/repos/rice/trunk/db)
2. Navigate to the rice/db/impex/master folder
3. run the following command: mvn validate -Pdb,mysql -Dimpex.dba.password=[password]
4. run the following command: mvn clean install -Pdb,mysql -Dimpex.dba.password=[password]
5. Upon success verify the database is setup with tables etc.
3. Clear your .m2/repository/org/kuali/rice Folder
- In order to start clean and to ensure there weren't any older versions of rice.jars around, need to wipe out the entire rice folder.
4. Run mvn clean install
- Navigate to the project directory and execute the following command: mvn clean install -DskipTests=true
5. 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. Also once IntelliJ is done with all the processes you need to right click on the main project and go down to the maven menu option and click on "Force Re-import". This is needed the first time you will download the codebase and whenever there are changes made to the pom.xml.
6. Setup Tomcat Configuration
Artifact for deployment
Note - The artifact that you will need to mark for deployment will be 'rice2x-OLE:war exploded'. Also make sure the webapps folder in your default tomcat folder does not have any other war files (.war or folders)
7. Launch App
Launch the app program by running tomcat. In the login prompt enter admin as the username and you should get to the main menu.
6. Setup for Ecliplse
1. Setup the Database
Follow the instructions in the wiki
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 )