Kuali Coeus (KC) for Research Administration is a comprehensive system to manage the complexities of research administration needs from the faculty researcher through grants administration to federal funding agencies. KC is using MIT’s proven COEUS system as its baseline design, updating its technical architecture for vendor independence and integration with other administration systems.
##Installation Prerequisites Maven 3.2.x Java 1.7.x Tomcat 7.x MySQL 5.6.x Git 2.3.x
Instructions The Kuali Coeus application uses maven as it's build tool. Inside of Kuali Coeus's maven configuration is a list of dependencies. Some of these dependencies may not be available in a publicly available maven repository. At the very least you will need to install the following projects into your maven repo. These projects may have more than one submodule.
Build Order: The projects required to install Kuali Coeus must be built in the following order:
- Kuali Coeus Rice
- Kuali Coeus API
- Kuali Coeus S2s Generator
- Kuali Coeus
Step 1. clone all required projects
cd workspace
git clone https://github.com/kuali/kc-rice
git clone https://github.com/kuali/kc-api
git clone https://github.com/kuali/kc-s2sgen
git clone https://github.com/kuali/kc
Step 2. determine correct tag versions for dependent projects. Manually search the pom.xml file in the root directory of the Kuali Coeus project, and find the version numbers for KC Rice, KC Api, and Kc S2s Generator
<coeus-api-all.version>x.x.x.x</coeus-api-all.version>
<coeus-s2sgen.version>x.x.x</coeus-s2sgen.version>
...
<rice.version>x.x.x.x</rice.version>
Then check out the correct tag before installing.
Step 3: Build Kuali Coeus Rice
GRM Profile: When building Kuali Coeus Projects you should turn the grm maven profile off. You can do this by commenting out the activation section of the profile or sending the following system parameter grm.off on the command line.
mvn clean install -Dgrm.off=true
Check out the correct rice verion and run maven clean install.
cd kc-rice
git checkout tags/rice-x.x.x.x
mvn clean install
Tip: To Include source and javadoc jars use "mvn clean source:jar javadoc:jar install"
Wait until rice has installed successfully before moving to the next step.
Step 4: Build Kuali Coeus Api Checkout the correct version of coeus api and install.
cd ../kc-api
git checkout tags/coeus-api-x.x.x.x
mvn clean install
Wait until coeus-api has installed successfully before moving to the next step.
Step 5: Build Kuali Coeus S2sGen Checkout the correct version of coeus-s2sgen and install
cd ../kc-s2sgen
git checkout tags/coeus-s2sgen-x.x.x
mvn clean install
Wait until coeus-s2sgen has installed successfully before moving to the next step.
Step 6: Build Kuali Coeus Installing Kuali Coeus
Oracle Pofile: If using an Oracle data base make sure oracle profile is used to insure Oracle specific jars are added to the classpath. Application will fail to start up if the Oracle jar is not added.
cd ../kc
mvn clean install
Step 7: Install Spring Instrumentation
For Tomcat: Download and install spring instrumentation in the tomcat lib directory
Otherwise: Configure java agent in at the jvm level.
-javaagent:/Users/user/.m2/repository/org/springframework/spring-instrument/3.2.12.RELEASE/spring-instrument-3.2.12.RELEASE.jar
Note: Application will fail to start up in spring instrumentation is not installed correctly.
##Creating DB
Kuali Coeus supports MySQL 5.5, 5.6 and Oracle. We recommend MySQL 5.6 though as that is the database we develop and support internally and are more easily able to respond to problems with that database.