Eclipse IDE Setup

The Eclipse environment is used for platform development and editing of the internal GridAPPS-D Java code used by GOSS-GridAPPSD and other platform packages.

Application developers do not need to set up this environment

  1. Download or clone the repository from github

    1. Install github desktop or sourcetree

    2. Clone the GOSS-GridAPPS-D repository or download the GOSS-GridAPPS-D source

  2. Install java 1.8 SDK and set JAVA_HOME variable

  3. Install Eclipse http://www.eclipse.org/downloads/packages/release/Mars/1 (Mars 4.5.1 or earlier, 4.5.2 appears to have bugs related to bundle processing) TODO what about neon?

  4. Open eclipse with workspace set to GOSS-GridAPPS-D download location, eg. C:UsersusernameDocumentsGOSS-GridAPPS-D

  5. Install BNDTools plugin: Help->Install New Software->Work with: http://dl.bintray.com/bndtools/bndtools/3.0.0 and Install Bndtools 3.0.0 or earlier

  6. Import projects into workspace

    1. File->Import General->Existing Projects into workspace

    2. Select root directory, GOSS-GridAPPS-D download location

    3. Select cnf, pnnl.goss.gridappsd

  7. If errors are detected, Right click on the pnnl.goss.gridappsd project and select release, then release all bundles

  8. If you would like to you a local version of GOSS-Core (Optional)

    1. Update cnf/ext/repositories.bnd

    2. Select source view and add the following as the first line

    3. aQute.bnd.deployer.repository.LocalIndexedRepo;name=GOSS Local Release;local=/GOSS-Core2/cnf/releaserepo;pretty=true,

    4. verify by switching to bndtools and verify that there are packages under GOSS Local Relase

  9. Open pnnl.goss.gridappsd/bnd.bnd, Rebuild project, you should not have errors

  10. Open pnnl.goss.gridappsd/run.bnd.bndrun and click Run OSGI

gridappsd-logo