Versions Compared

Key

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

...

Expand
titleInstall Intellij

Install the Intellij IDE

  • Download and install the latest "ultimate" version of Intellij for your platform at http://www.jetbrains.com/idea/download/
  • Open source licenses for Kuali development are available, ask you team leader.
  • Go to your install directory, then open the 'bin' folder and edit idea64.vmoptions. You will want to increase the base memory settings, but the below should be a good starting point.

    Code Block
    -Xms256m
    -Xmx1024m
    -XX:MaxPermSize=712m
    -XX:ReservedCodeCacheSize=128m
  • Start Intellij. It will ask you what plugins you want to enable. Selecting the default is fine.

 

Check out the KHR project from subversion

  • Under "VCS", select "Checkout from Version Control" --> "Subversion"
  • Click the green "+" button and add the kpme repository: https://svn.kuali.org/repos/kpme
  • After adding the repository, it should be listed in the current window. Expand the repository and select the folder you want to check out (usually trunk or something in branches)
  • Click "Checkout"
  • Select your destination folder (usually something like c:/java/projects/kpme or /java/projects/kpme). You can create folders in this window if they do not exist.
    • Highlight (click) on the folder you want to check out the project to
  • Click "OK"
  • Click "OK" again
  • Select your subversion working copy format.
    • 1.7 or 1.8 should work fine
    • generally it is a good idea to keep this in line with any other subversion client installations you are running (tortoiseSvn, collabnet, etc) to maintain compatibility
  • Click "OK"
  • After the project has downloaded you should see a window similar to this:
  • Click "Yes"
  • Intellij will then open your project, which may take several minutes.
    • During this, Intellij will ask you if you want to schedule several files for addition to subversion.
      • These are Intellij project files for each of the modules
    • Click "No"
  • You may get a window saying "Language level changes will take effect on project reload. Would you like to reload the project "kpme" now?"
    • Click "Yes"
  • Intellij will restart.

A few environment variables you need to set

  • ANT_OPTS: -Xmx1g -XX:MaxPermSize=512m
  • MAVEN_OPTS: -Xmx1g -XX:MaxPermSize=512m

A few common setup tasks

After 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:

  • Upper left of the workspace (big darker gray area) there is a button for "Project". Clicking this will give a very nice folder view of the project
  • "Changes", bottom, next to TODO, and Terminal is your subversion client
    • Clicking this will present a window at the bottom with local changes, repository changes, and incoming changes tabs
    • To update your project to the latest code base, click Changes, Incoming, Refresh (button that looks like two arrows creating a circle), and then the Update Project button.

 

Setting up run configurations

Several run configurations can be set up to make life easier.

Set JUnit defaults

In the Run Configuration window (Run --> Edit Configurations), expand the Defaults, and select JUnit

Jetty (Using maven plugin)

Update database (liquibase update)

Run Test suite
Maven clean and install

 

Tomcat (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.