1. Step 1. Checkout the OpenDRIM PCG components into Eclipse
    2. Step 2. Checkout the OpenDRIM PCG feature configuration
    3. Step 3. Checkout the OpenDRIM PCG update site configuration
    4. Step 4. Build the Plug-in / Fragment / Feature
    5. Step 5. Upload the Update site files

Note: For retro-compatibility make sure that the Eclipse default JRE (Java Runtime Environment) is set to SUN Java version 5 (jdk1.5.0) and make sure the Java Compiler compliance level is 5.0.

  • To set the default JRE in Eclipse go to Window / Preferences... / Java / Installed JREs
  • To set the default Java Compiler compliance level go to Window / Preferences... / Java / Compiler

Note: The following Eclipse plug-ins are required to build the Code Generator plug-in:

  • Models and Model Development / Eclipse Modeling Framework Runtime + End-User Tools (EMF)
  • Models and Model Development / Java Emitter Templates (JET)

Step 1. Checkout the OpenDRIM PCG components into Eclipse

  • MOF_Parser
    • Project name: MOF_Parser
    • Project type: Java
    • SVN location: http://www.opendrim.org/svn/opendrim/Code_Generator/Eclipse_Plugin_Components/MOF_Parser/trunk
    • Project dependencies: jsr48, org.opendrim.cim.factory
    • Jar archive name: opendrim_cim_mof_parser_M.m.r.jar
    • Special requirements: javacc (>= version 4.0)
    • Note: You MAY have to configure the JAVACC_HOME variable in the build.xml file.
    • Note: To change the name (version) of the Jar libraries edit the build.xml file.
    • Note: To build Right click on build.xml then go to Run As / Ant Build... / Targets. Select all and jar and then click Run. jsr48 and org.opendrim.cim.factory Jar libraries are build in the lib directory while the MOF_Parser Jar library is build in the output directory.
  • org.opendrim.cim.repository
    • Project name: org.opendrim.cim.repository
    • Project type: Java
    • SVN location: http://www.opendrim.org/svn/opendrim/Code_Generator/Eclipse_Plugin_Components/org.opendrim.cim.repository/trunk
    • Project dependencies: jsr48, org.opendrim.cim.factory
    • Jar dependencies: opendrim_cim_mof_parser_M.m.r.jar
    • Jar archive name: opendrim_cim_repository_M.m.r.jar
    • Note: To build this component go to the Eclipse export wizard in File / Export to create a Jar archive. The manifest (MANIFEST.MF) you should use to create this archive is provided in the META-INF directory. Be aware that if the name of the Jar libraries of the other components have been modified it should be reflected in the MANIFEST.MF file.
    • Note: It is possible to rebuild the Code Generator internal CIM repository using this component. Go to README file / Update the provider code generator CIM repository section for more information.
  • org.opendrim.pcg
    • Project name: org.opendrim.pcg
    • Project type: Plug-in
    • SVN location: http://www.opendrim.org/svn/opendrim/Code_Generator/Eclipse_Plugin_Components/org.opendrim.pcg/trunk
    • Project dependencies: jsr48, org.opendrim.pcg.factory, org.opendrim.repository, org.opendrim.pcg.libraries
    • Jar dependencies: opendrim_cim_mof_parser_M.m.r.jar
    • Note: The file build.xml already contains all the plug-in information so you don't need to complete this information when you enter the Plug-in wizard. Simply enter the name of the project and click Finish.
    • Note: If you modified the name of the jsr48 Jar archive you MUST modify the org.opendrim.pcg.jet.JETGatway.jet.generate() method (in the source code) according to the new name of the jsr48 library.
    • Note: If you modified the name of the Jar archive of another component of the Code Generator you MUST reflect this change in the Build / Extra Classpath Entries options of the pcg plug-in.
    • Note: The pcg plug-in comes with no template. The templates are separate projects and should be copied manually into the templates directory of the pcg plug-in.
    • Note: To launch the pcg plug-in as an Eclipse Application the pcg binaries should be exported as a jar archive named opendrim_pcg.jar placed at the root of the org.opendrim.pcg project. This steps also requires the org.opendrim.pcg.libraries fragment project to be installed.
  • org.opendrim.pcg.libraries
    • Project name: org.opendrim.pcg.libraries
    • Project type: Fragment
    • SVN location: http://www.opendrim.org/svn/opendrim/Code_Generator/Eclipse_Plugin_Components/org.opendrim.pcg.libraries/trunk
    • Project dependencies: -
    • Jar dependencies: -
    • Note: It is possible to rebuild the Code Generator internal CIM repository using this component. Go to README file / Update the provider code generator CIM repository section for more information.
    • Note: To update this components simply override the existing Jar archives. Be aware of the dependencies since the org.opendrim.pcg project uses the names of the Jar archives IN it's source code.

Step 2. Checkout the OpenDRIM PCG feature configuration

Step 3. Checkout the OpenDRIM PCG update site configuration

  • Project name: PCG
  • Project type: Update Site
  • SVN location: http://www.opendrim.org/svn/opendrim/Code_Generator/PCG/trunk
  • Note: The file site.xml already contains all the update site information so you don't need to complete this information when you enter the Update Site wizard. Simply enter the name of the project and click Finish.

Step 4. Build the Plug-in / Fragment / Feature

  • Go to the PCG project setting (site.xml), Site Map tab. Select the version of the of plug-in you want to build and click synchronize and then Build.
  • Multiple versions of a same plug-in can be managed on a single Update Site. The versions of the plug-in project and feature project should be updated first and then the new version of the feature added to the Update Site in PCG project setting (site.xml), Site Map tab.

Step 5. Upload the Update site files

  • OpenDRIM PCG Update Site URL: ftp://www.opendrim.org/pub/PCG
  • OpenDRIM PCG Update Site Location in OpenDRIM server filesystem: /var/ftp/pub/PCG
  • Copy the following files / directories to the update location you selected:
    • features
    • plugins
    • web
    • index.html
    • site.xml

Attachments