This is a short guide to configuring IntelliJ IDEA to develop NetKernel modules. This guide assumes you are familiar with the IntelliJ IDEA. This guide relates to IntelliJ version 5.1.

Creating a module from scratch

1. Create a new project with a suitable name and note down the project file location for future use. Within the wizard ensure you choose the following options:
   1. Single Module Project
   2. Java Module
   3. Create a source directory (this will be the NetKernel modules root directory)
   4. Ensure the compiler output path is set to source directory so that source and compiled classes are in the same directories.
2. Add [install]/lib/1060netkernel-bootloader-*.*.*.jar to your modules classpath (Right click on your module in the Project View and select Module Settings... On the Libraries (Classpath) tab browse to locate the jar in the NetKernel installation.)
3. Add [install]/lib/1060NetKernel-*.*.*.jar to your modules classpath.
4. Add [install]/modules/ext-layer1-*.*.*.jar to your modules classpath.
5. If your module requires any specific and unique additional libraries create a /lib/ directory in your module, add your jars here and them add them to your modules classpath. (The directory named lib under the root of your project has special meaning to NetKernel, jars here will be auto-added to the modules classpath at runtime)
6. Register the path to your NetKernel modules root directory (the IntelliJ modules source directory) in [install]/etc/deployedModules.xml.
7. NetKernel may be run from the scripts supplied in [install]/bin/ however to run NetKernel from the IDE:
   1. Click the menu item Run->Edit Configurations...
   2. On the Application tab click the + button to add a new configuration
   3. Name this configuration NetKernel and set the main class to com.ten60.netkernel.bootloader.BootLoader.
   4. Add the JVM flag -Dbootloader.basepath=[install] to set the basepath of the NetKernel installation. (On Win32, it may be necessary to use 8.3 short names for path elements such as "Program Files")
   5. Add the JVM flag -Djava.endorsed.dirs=[install]/lib/endorsed/ to ensure the correct XML libraries are used by the JDK.
   6. Add the JVM flag -Dbootloader.jarDir=[install]/lib/ext/ to supply additional standard jars to the NetKernel runtime.
   7. Click Ok to save settings then click on the menu item Run->Run... to start NetKernel

Creating a module using the New Module Wizard

The new module wizard is useful for creating a stubbed out module. It will create the necessary files for you and updated the NetKernel deployedModules.xml.

1. Create a new project as per the above instructions taking note of the source directory of the IntelliJ module.
2. NetKernel must be running to access the wizard so start it using the scripts in [install]/bin/. Go to the New Module Wizard and create a NetKernel module whose source directory (on the second page) is the IntelliJ modules source directory.
3. Complete the wizard and allow NetKernel to restart
4. Continue to setup IntelliJ as per the above instructions...