Setup Developer Environment

  1. Install Git for Windows
    1. Goto https://git-scm.com/download/win
    2. Download the 64-bit Git for Windows Setup version and install to your directory of choice
  2. Install Eclipse Modeling Tools
    1. Goto https://www.eclipse.org/downloads/packages/release/2019-12/r/eclipse-modeling-tools
    2. Download the Windows x86_64 version and extract to your directory of choice
    3. Execute eclipse.exe from the root folder
      1. If it can’t be started, you may need to install/update your Java installation
      2. Try https://www.eclipse.org/openj9/docs/adoptopenjdk . Note, you might need to add the “bin” directory of the Java installation to the “path” environment variable if not already done so, otherwise, Eclipse might not be able to start
      3. If you are asked for a default workspace location, it is recommended to use “C:/YourInstallationFolder/workspace”, to contain Eclipse for the sake of good order in one folder. You also may check “Use this as the default and do not ask again”
  3. Setup some Eclipse preferences
    1. Prevent some compile errors
      1. In Eclipse, open Window | Preferences
      2. In the left tree, goto Java > Compiler > Error/Warnings
      3. Under Deprecated and restricted API, choose Ignore for Forbidden reference (access rules)
      4. Click Apply and Close
    2. See only errors/problems for current selection
      1. Open the Problems view (via Window | Show View | Problems)
      2. In the right/top area of that view, click the vertical ellipsis symbol  ⋮  (or the down-pointing triangle symbol for eclipse versions older than 2019-12) for the drop-down list and choose Filters
      3. Select and check Errors/Warnings on Selection (and ensure that On selected elements and its children is checked)
      4. Click Apply and Close
    3. Link the current active editor with the explorer tree
      1. Open the Model Explorer view (via Window | Show View | Model Explorer)
      2. In the right/top area of that view, click the leftwards arrow over rightwards arrow symbol ⇆. This allows the explorer tree to highlight the location of a file associated to an opened editor
  4. Install 3rd Party dependencies to Eclipse
    1. PostgreSQL driver
      1. In Eclipse, open Help | Install New Software
      2. Click Add
      3. Use “PostgreSQL Driver” as Name and “http://www.elver.org/eclipse/2.2.0/update” as Location
      4. Click Add
      5. Expand the tree and check Postgresql
      6. Click Next, Next, accept the terms of the license agreement and Finish. Click Install anyway in the Security Warning dialog. Restart IDE when asked
    2. Net4j PostgreSQL adapter
      1. Open Help | Install New Software
      2. Click Add
      3. Use “Net4j” as Name and “http://download.eclipse.org/modeling/emf/cdo/updates/releases/4.7” as Location
      4. Click Add
      5. Expand the tree and check Net4j DB Framework > Net4j DB Framework PostgreSQL Adapter
      6. Click Next, Next, accept the terms of the license agreement and Finish. Restart IDE when asked
    3. Web applications support
      1. Open Help | Install New Software
      2. In the Work with field, click the down arrowhead symbol ⌄ for the drop-down list and choose “2019-12 - http://download.eclipse.org/releases/2019-12” (or a different eclipse version)
      3. Expand Web, XML, Java EE and OSGi Enterprise Development
      4. Check RAP Tools. This allows you to launch a RAP application from Eclipse (configured in .launch files)
      5. Also check WAR Products (Incubation). This allows you to build .war files (from .warproduct files)
      6. Click Next, Next, accept the terms of the license agreement and Finish. Restart IDE when asked
  5. Add a couple of Git repositories
    1. Open the Git Repositories view (via Window | Show View | Other and then Git > Git Repositories)
    2. Main repository for the RAAS technology
      1. In the right/top area of that view, click the vertical ellipsis symbol  ⋮  for the drop-down list and choose Clone a Repository
      2. Use “https://github.com/patins1/raas4emf.git” as URI
      3. Click Next, Next and Finish
      4. When cloning is finished, right click raas4emf [master] in the Git Repositories view and click Import Projects
      5. Click Deselect All
      6. Check following projects:
        • org.eclipse.jqvt.runtime (unless you plan to install JQVT as 3rd Party dependency)
        • org.ifc4emf.metamodel.ifc
        • org.raas4emf.cms.core
        • org.raas4emf.cms.propertysets
        • org.raas4emf.cms.transformation
        • org.raas4emf.cms.ui
        • org.raas4emf.cms.ui.discriminator
        • org.raas4emf.cms.ui.rap
        • org.raas4emf.cms.ui.rcp
        • org.raas4emf.metamodel.propertysets
        • org.raas4emf.metamodel.raascms
        • org.raas4emf.metamodel.raascms.edit
        • org.raas4emf.metamodel.restexample
        • org.raas4emf.raasgenerator.feature
        • org.raas4emf.server
        • org.raas4emf.service
      7. Click Finish
      8. Cancel any Marketplace solutions available dialog if it should appear
    3. Main repository for the IFC support
      1. In the Git Repositories view, again click the vertical ellipsis symbol  ⋮  and choose Clone a Repository
      2. Use “https://github.com/patins1/ifc4emf.git” as URI
      3. Click Next, Next and Finish
      4. When cloning is finished, right click ifc4emf [master] in the Git Repositories view and click Import Projects
      5. Click Deselect All
      6. Check following projects:
        • org.ifc4emf.metamodel.express
        • org.ifc4emf.metamodel.ifcheader
        • org.ifc4emf.metamodel.modelblob
        • org.ifc4emf.metamodel.trace
        • org.ifc4emf.part21
      7. Click Finish
      8. Cancel any Marketplace solutions available dialog if it should appear
  6. Advanced: Configure RAP target platform (only required if migrating to newer Eclipse version)
    1. Open Window | Preferences
    2. In the left tree, goto Plug-in Development > Target Platform
    3. Select (but not check) EMF + RAP and click Edit
    4. Edit the entry similar to http://download.eclipse.org/releases/2019-12
      1. Add the repository that has a newer version, e.g. http://download.eclipse.org/releases/2020-12
      2. Check EclipseRT Target Platform Components > EMF RAP Target Components
      3. Click Finish
    5. Edit the entry similar to https://download.eclipse.org/rt/rap/3.7
      1. Add the repository that has a newer version, e.g. https://download.eclipse.org/rt/rap/3.11
      2. Check all components of Remote Application Platform (RAP)
      3. Click Finish
    6. Click Finish and then click Apply and Close
  7. Switch to RAP target platform
    1. Open Window | Preferences
    2. In the left tree, goto Plug-in Development > Target Platform
    3. Check EMF + RAP
    4. Click Apply and Close
  8. Get started
    1. There should be no compile erros in the workspace by now
    2. Launch the web application
      1. Open Run | Run Configurations
      2. Goto RAP Application > raascms
      3. Click Run
      4. A browser window should open up with the address http://localhost:8123/raascms/ui
      5. You should be able to login as Operator with the password “o”
    3. Generate the WAR file
      1. First, delete the org.antlr.runtime_4.x plugin from the Eclipse plugins folder, similar to eclipse\plugins\org.antlr.runtime_4.3.0.v201502022030.jar and restart the Eclipse IDE
      2. Open File | Export
      3. Select Plug-in Development > WAR Product and click Next
      4. Select org.raas4emf.cms.ui.rap > raascms.warproduct and click Next
      5. Use “C:\bim\NOLServer\apache-tomcat\webapps\raascms.war” as WAR File and click Finish
      6. While the war file will be created after some seconds to minutes, the wizard may reports an error, see https://www.eclipse.org/forums/index.php?t=msg&th=1087206&goto=1770878