Eclipse Dirigible™

Eclipse Dirigible is an Integrated Development Environment as a Service (IDEaaS) for dynamic applications. It provides both development tools and runtime environment.

Enjoy Programming Like Never Before

From the end user's perspective (developer), Dirigible runs directly in the browser, therefore does not require any downloads or installations.

From the service provider's perspective (PaaS/SaaS), Dirigible packs all required components in a self-contained software bundle that can be deployed in any Java-based web server, such as Tomcat, Jetty, JBoss.

Dirigible supports access to RDBMS via JDBC. Currently supported versions for RDBMS are HANA, MaxDB, Sybase ASE, PostgreSQL, H2, and Derby.

The project started as an internal SAP initiative to address the extension and adaption use-cases related to SOA and Enterprise Services.

• Try
• Get Started
  • Download
  • Build
  • Deploy
    • Instant Trial
    • HANA Cloud Platform
    • Tomcat
    • Eclipse
    • CloudFoundry
• Additional Information
  • License
  • Contributors
  • References

Instant Trial

You can try the sandbox instance to have a quick look on the functionality you are interested http://trial.dirigible.io.

Get Started

Download

The "fast-track" - you can download the precompiled binaries produced from the Hudson builds from http://download.eclipse.org/dirigible and skip the build section.

Nevertheless, we highly recommend building the binaries from source in order to have all experimental features that are not available in the releases.

Build

2.x

Prerequisites

• Git
• Maven 3.0.x

Steps

1. Clone the project repository - master-2.x branch or download the latest 2.x sources.

2. Go to the org.eclipse.dirigible/org.eclipse.dirigible.parent folder.

3. Build the project with:

    mvn clean install
   

The build should pass successfully. The produced WAR files under target sub-folder org.eclipse.dirigible/org.eclipse.dirigible.parent/releng are ready to be deployed. There are separated deployable artifacts (WAR files) depending on the usage type.

3.x

Prerequisites

• Git
• Maven 3.0.x

Steps

1. Clone the project repository - master branch or download the latest 2.x sources.

2. Go to the root folder.

3. Build the project with:

    mvn clean install
   

The build should pass successfully. The produced WAR files under target sub-folder releng are ready to be deployed. There are separated deployable artifacts (WAR files) depending on the usage type.

Deploy

Trial

Trial package combines the deployable artifacts of Dirigible along with the Tomcat web container and Derby database. It is useful for quick exploration of Dirigible features.

Steps

1. Build the project with:

   mvn clean install -P trial

The build should pass successfully. Find the produced produced executable JAR file under target sub-folder at org.eclipse.dirigible/org.eclipse.dirigible.parent/releng.

2. Run with:

   java -jar dirigible-all-tomcat-trial-executable.jar

3. Open a web browser and go to:

    http://localhost:8080/dirigible/services/ui/anonymous.html	
   

HANA Cloud Platform

Deploy on HANA Cloud Platform with the Cloud SDK.

Prerequisites

• HANA Cloud Platform SDK

Steps

1. Go to the neo-java-web-sdk-2.xxx/tools SDK folder.

2. Deploy with command:

    neo deploy --account <your_account> --application <application_name> --user <your_user> --host <target_landscape_host> --source <source_directory> --password <your_password>
   

3. Start with command:

    neo start --account <your_account> --application <application_name> --user <your_user> --host <target_landscape_host> --password <your_password> -y
   

4. Go to https://account.hanatrial.ondemand.com/cockpit at Authorizations section. Add Developer and Operator role to your user which gives you full access to all features.

Tomcat

The Tomcat specific WAR files can be deployed on Tomcat web container. In this case the built-in Derby database is used.

More information about how to deploy on Tomcat can be found here.

Steps

1. For simplicity rename the WAR dirigible-all-tomcat-xxx.war to dirigible.war.

2. Configure Users store:

    <tomcat-users>
            <role rolename="Developer"/>
            <role rolename="Operator"/>
            <role rolename="Everyone"/>
            <user username="dirigible" password="dirigible" roles="Developer,Operator,Everyone"/>
    </tomcat-users>
   

3. Open a web browser and go to:

    http://localhost:8080/dirigible
   

4. Login with dirigible/dirigible.

Eclipse

The IDE part can be run directly via Eclipse. This is useful when testing new features during development.

Prerequisites

• Maven 3.0.x
• Eclipse IDE

Steps

1. Run preparation command

    mvn eclipse:eclipse 
   

2. Import the project as existing Maven project into your local Eclipse environment.

3. Go to project org.eclipse.dirigible/org.eclipse.dirigible.parent/platform/org.eclipse.dirigible.platform.target and open the file org.eclipse.dirigible.platform.base.target using the Target Editor.

4. Click on the Set as Target Platform link and wait until the required bundles get synchronized.

5. Use dirigible-local.launch file for Run As configuration.

6. Open a web browser and go to:

    http://localhost:8080/dirigible
   

CloudFoundry

Prerequisites

• CloudFoundry Cli

Steps

1. Login to CloudFoundry Platform with:

    cf login -a [CloudFoundry Platform Host]
   

2. Deploy on the CloudFoundry supported Cloud Platform with:

    cf push dirigible -p [path to the target directory]/dist/tomcat/allinone/ROOT.war -b https://github.com/dirigiblelabs/java-buildpack
   

3. Open a web browser and go to:

    http://dirigible.[CloudFoundry Platform Host]/
   

4. Login with user dirigible and password dirigible which are set by default in the custom buildpack used above.

Docker

Prerequisites

• Install Docker

Steps

1. Pull the already built container from Docker Hub

    docker pull dirigiblelabs/dirigible-trial
   

2. Start the container

    docker run -p 8888:8080 dirigiblelabs/dirigible-trial <&- &
   

3. Open a web browser and go to:

    http://localhost:8888/
   

4. Optionally you can enhance and customize the Dockerfile from here

Additional Information

License

This project is copyrighted by SAP SE and is available under the Eclipse Public License v 1.0. See LICENSE.txt and NOTICE.txt for further details.

Contributors

If you like to contribute to Dirigible, please read the Contributor's guide.

References

• Project Home http://www.dirigible.io

• Help Portal http://help.dirigible.io

• Simple Samples http://samples.dirigible.io

• Trial Instance http://trial.dirigible.io

• Forum https://www.eclipse.org/forums/index.php/m/1688357/

• Mailing List https://dev.eclipse.org/mailman/listinfo/dirigible-dev

• Bugzilla https://bugs.eclipse.org/bugs/describecomponents.cgi?product=Dirigible

Update Sites

• http://download.eclipse.org/dirigible/nightly/p2/bridge/
• http://download.eclipse.org/dirigible/nightly/p2/external/
• http://download.eclipse.org/dirigible/nightly/p2/ide/
• http://download.eclipse.org/dirigible/nightly/p2/lib/
• http://download.eclipse.org/dirigible/nightly/p2/repository/
• http://download.eclipse.org/dirigible/nightly/p2/runtime/
• http://download.eclipse.org/dirigible/nightly/p2/rcp/