- Right click your project
- Select Properties -> Builders
- Uncheck the "JavaScript Validator"
Then restart your Eclipse.
Welcome to KPME! If this is your first time setting up your environment, please ensure that you have administrator access to the computer, otherwise some portions of this guide may not work.
This page extends on KPME Developer Setup Guide, to include instructions for setting up KPME versions 2.0+. If you are setting up a workspace for projects earlier than V2.0, please refer to the original setup guide KPME Developer Setup Guide.
The following is a list of software that is essential to install in order to get a working KPME development environment up and running.
Follow the steps outlined by each bold heading below in order to configure the default development stack.
JAVA_HOME
to your environment variables and set it to the base directory of your installation (Example: C:\Java\jdk1.7.0_25
).JAVA_HOME/bin
to your path.M2_HOME
to your O.S. environment variables and set it to the base directory of your installation (Example: C:\Java\apache-maven-3.0.4
).M2_HOME/bin
to your path.Note: You MUST use the variable name M2_HOME. The launch configuration files reference this environment variable at run-time, and will give you a class load error if it is not defined correctly in your environment.
(Optional) If you wish to change the location of your repository to something other than your home folder, create a file named "settings.xml" in USER_HOME/.m2 with the following contents, replacing the path with your preferred location:
<settings> <localRepository>your/custom/path/to/repository</localRepository> </settings> |
The default database for KPME is MySQL 5.1 or above. While Oracle is also supported in releases, it is untested and therefore not ready for developers.
If you are on Linux or MacOSX, you need to set a parameter to force MySQL to store tables in lower case. To do this, go to /etc/my.conf
and make sure the following is set:
lower_case_table_names=1 |
The easiest way to set up databases and permissions is to do it via the command line, however you may wish to do this via your MySQL Workbench. Developers typically use two databases for their server and one database for their unit tests. The following table lists the default settings for these databases that will give the most minimal setup.
| Schema/Name | Username | Password |
KPME Client Database | tk | tk | tk_tk_tk |
Rice Server Database | krtt | krtt | krtt |
Unit Test Database | tk_test | tk | tk_tk_tk |
To configure the database from the command line, use the root user name and password you created during MySQL Server installation to log into your database server, then issue the following two commands for each row in the above table. Replace dbname with the entries from column "Schema/Name" and username and password from the corresponding Username and Password columns.
CREATE DATABASE dbname CHARACTER SET utf8 COLLATE utf8_bin; GRANT ALL ON dbname.* TO 'username'@'%' IDENTIFIED BY 'password'; |
To configure the database using MySQL Workbench:
localhost
and select the database you are editing, and click OK.
Install the Eclipse IDEThe default development environment for KPME is Eclipse 3.5 or above. Any flavor should be ok, but it is recommended to start out with the Eclipse IDE for Java Developers since it is small.
Install Subversive
Install M2Eclipse (Optional)Note: Only complete this step if using Eclipse 3.6 or below. Eclipse 3.7 and above have switched to an internal Maven implementation, m2e.
Create the KPME Maven Project in EclipseYou will be loading the project into your workspace from a repository via the Subversive plugin. Checkout and Configure the Project
At this point, Subversive for Eclipse will begin the checkout process for KPME and create a new project in your workspace. When the checkout process is complete, do the following
Maven for Eclipse will download all the jars and files that are listed in the project POM's dependencies. Install the Kuali Configuration FileIn your new project, go to
Import existing maven projects
You'll notice the disdain in the workspace with all the newly imported projects. With eclipse, we can employ the use of working sets to organize our workspace. Working Sets (this step is optional)Optionally you can set up Working Sets in Eclipse using the steps described here:
Starting the Application Server
TroubleshootingError: Could not find or load main class org.codehaus.classworlds.Launcher
Javascript Validation causing build to hangThere are two methods for successfully turning off Javascript Validation in Eclipse: 1) Exclude from Path (best solution)
The information about JavaScript source inclusion/exclusion is saved into Here is how configuration looks with the js folder removed from validation
2) Turn off the JavaScript Validator in the "Builders" config for your project:
Then restart your Eclipse. |
Install the Intellij IDE
Check out the KHR project from subversion
A few environment variables you need to set
A few common setup tasksAfter intellij restarts, you should be presented with a gray (or black) window that looks similar to this: Couple of things to point out for new Intellij Users:
Setting up run configurationsSeveral run configurations can be set up to make life easier. Set JUnit defaultsIn the Run Configuration window (Run --> Edit Configurations), expand the Defaults, and select JUnit Jetty (Using maven plugin)Update database (liquibase update)Run Test suiteMaven clean and installDownload CI dataTomcat (next two pictures)Note: for this to work, Tomcat needs to be installed, or unzipped on your computer somewhere. You can then tell intellij where it is located by clicking "Configure" on the screen below. Additionally, you will need to copy the jdbc driver you are using to the Tomcat Servers "lib" directory.
|