Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Java JDK 8
  • Maven version 3.3 or higher
  • Tomcat version 78 or higher
  • Mysql version 5.6
  • Mysql JDBC driver version 5.1.25 or higher

...

  1. Download the newest Tomcat 7 8+ core.  Unzip that to the folder where you would like to run rice.
  2. Download spring-instrument-tomcat-3.2.12.RELEASE.jar and put it in the tomcat lib folder.
  3. Copy the mysql driver to the tomcat lib folder.
  4. Delete everything under the webapps folder.
  5. Download the rice server file.  This this link was the most current version of Rice at the time this page was created.  Rename the file to kr-dev.war and copy the file to the webapps folder inside the tomcat folder.
  6. Edit the server.xml file in the tomcat conf folder.  Change port 8005 to 8006, port 8009 to 8010 and port 8080 to port 8081.  This is required so this version of tomcat will not interfere with the version of tomcat used to run financials.
  7. Create a folder inside tomcat named rice.  Under this folder make the folders pluginskew_attachmentsxml.
  8. Copy the rice-config.xml, log4j.properties and rice.keystore files into the rice folder.  Edit the rice-config.xml and make sure paths are correct.
  9. Run the SQL here (to update db for Rice 2.6 changes).
  10. If you are on Windows, edit the file bin/setclasspath.bat, otherwise bin/setclasspath.sh.  Add a line after the comment.  Adjust the path as necessary:

    Code Block
    bin/setclasspath.sh should have this line added:
     
    export JAVA_OPTS=-Dadditional.config.locations=/Users/user/rice/apache-tomcat-7.0.65/$CATALINA_BASE/rice/rice-config.xml
    
    bin/setclasspath.bat should have this line added:
     
    set JAVA_OPTS=-Dadditional.config.locations=C:\rice\apache-tomcat-7.0.65\rice\rice$CATALINA_BASE/rice/rice-config.xml
     
    Run the SQL here (to update db for Rice 2.6 changes).


Running Standalone Rice

Run catalina.bat run on Windows or catalina.sh run if not.

...

Code Block
base.url=http://localhost:8080

rice.server.url=http://localhost:8081/kr-dev
rice.url=http://localhost:8081/kr-dev
rice.ksb.registry.serviceUrl=${rice.url}/remoting/soap/ksb/v2_0/serviceRegistry

keystore.file=/Users/user/git/financials/kfs-core/src/main/config/demo/rice.keystore
log4j.settings.file=/Users/user/kfs/log4j.properties

kfs.datasource.username=kfs
kfs.datasource.password=${kfs.datasource.username}
kfs.datasource.url=jdbc:mysql://localhost/${kfs.datasource.username}
kfs.datasource.validating.query=select 1
kfs.datasource.pool.maxActive=50
kfs.datasource.pool.minIdle=5
kfs.datasource.pool.initialSize=5

kfs.datasource.ddl.url=${kfs.datasource.url}
kfs.datasource.ddl.username=${kfs.datasource.username}
kfs.datasource.ddl.password=${kfs.datasource.password}

rice.datasource.username=rice
rice.datasource.password=${rice.datasource.username}
rice.datasource.url=jdbc:mysql://localhost/${rice.datasource.username}
rice.datasource.validating.query=select 1
rice.datasource.pool.maxSize=50
rice.datasource.pool.minSize=5

rice.datasource.ddl.url=${rice.datasource.url}
rice.datasource.ddl.username=${rice.datasource.username}
rice.datasource.ddl.password=${rice.datasource.password}

# Set this to true the first time you run financials.  It will ingest all the document types.
# After that, set it to false.  Leaving it set to true will make financials startup take
# longer.
updateWorkflowOnStartup=true

updateDatabaseOnStartup=true
updateDocumentstoreOnStartupupdateDatabaseContext=truedemo
 
workflow.path=classpath:org/kuali/kfs/sys/workflow/parent/*.xml,\
  classpath:org/kuali/kfs/sys/workflow/child/*.xml,\
  classpath:org/kuali/kfs/module/ar/workflow/*.xml,\
  classpath:org/kuali/kfs/module/cam/workflow/*.xml,\
  classpath:org/kuali/kfs/module/cg/workflow/*.xml,\
  classpath:org/kuali/kfs/module/ec/workflow/*.xml,\
  classpath:org/kuali/kfs/module/ld/workflow/*.xml,\
  classpath:org/kuali/kfs/module/purap/workflow/*.xml

...