Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Flux/Running Flux
attention, this is work in progress
This is a brief description how to run the Flux implementation locally. Since Flux is a highly decoupled and distributed system that is aimed at running in the cloud on different nodes and cloud regions, running Flux locally requires a number of individual components to be installed and run locally.
Contents
Infrastructure
- Download RabbitMQ (RabbitMQ download page)
- Install and start RabbitMQ (for Mac, for example: Install and Run RabbitMQ on Mac)
Once RabbitMQ is running, you can configure. This is used as the messaging backbone for Flux.
Flux node server
- you need node and npm installed on your machine (Node.js)
- run "npm install eclipse-flux"
- run "npm start eclipse-flux"
You will see logging output appearing on the console.
Eclipse IDE integration
- get your favorite Eclipse distribution (Eclipse Downloads)
- install the Flux integration via "Install New Software..." (Flux update site: http://download.eclipse.org/flux/snapshots)
After restarting your Eclipse IDE, there is a new context menu section called "Flux", which you can use to connect and disconnect projects to/from Flux.
Orion Web UI
- open a browser at: http://localhost:3000/
This gives you a simplified Orion web UI for navigating and working with the projects that are connected to Flux. Once you have the headless JDT service running on your machine (see below), the advanced features for Java like auto-completion as well as errors and warnings appear in the Orion code editor.
Headless JDT service
- download the headless JDT that fits your platform:
- extract that package somewhere on your drive
- download the headless JDT service manager
- to run the JDT service manager, go to the console and run:
- java -jar org.eclipse.flux.jdt.service.provider-0.0.1-SNAPSHOT-jar-with-dependencies.jar
- include the following paramters:
- -app <path to the headless JDT package that you extracted above>