Orion/Getting the source

This page covers how to take a look at the source, as well as how to set up for self-hosting (changing Orion code from Orion).

Accessing the code

Source for Orion can be forked from our Git repositories:

• org.eclipse.orion.server.git
• org.eclipse.orion.client.git

Self hosting setup

We assume you are familiar with git. If not, review the Eclipsepedia Git Page.

Self-hosting involves running an Orion server on localhost, pointing your Orion editor at your local git repo directories, and working within Orion to make changes. Changes are committed with command line tools (or egit). Currently, the commit phase is separate from the Orion workflow. Here are the steps needed to get up and running, which assume you are a committer on the e4 project.

• Ensure that your user name and email are set up properly so that your email matches the foundation's email address of record. Otherwise you can't push changes. See Git#Committers_new_to_Git
• Clone the orion client and server repositories (choose a target directory that works for you, you'll be importing this code later into eclipse in order to run your changes on the local server).

   git clone ssh://myCommitterId@git.eclipse.org/gitroot/e4/org.eclipse.orion.client.git
   git clone ssh://myCommitterId@git.eclipse.org/gitroot/e4/org.eclipse.orion.server.git

• Download a stable orion build. This download will be used as a target platform when you run the server from eclipse.
• You can use any recent stable build of the Eclipse SDK to run the server. Many of us are using M4.
• Create a new workspace using your Eclipse SDK
• Use the File->Import->General->Existing Projects into Workspace wizard. In the wizard, set the root directory for the import to whatever directory you used when you cloned the repos. You'll know you have the right path when you see a bunch of org.eclipse.orion.* projects in the project list.
• Ensure that Copy projects into workspace is not checked.
• The projects should appear in your workspace. Don't worry about the compile errors just yet...
• Now you need to set up a target that points to the Orion build you downloaded. (Window->Preferences->Plug-in Development->Target Platform). Add a target, using the eclipse directory of the build. Make this the active target definition for your self-hosting workspace. Once you've done this, the workspace will be rebuilt and should compile cleanly.
• Open the Run->Run Configurations dialog and select the OSGi Framework launch called "web-ide." OSGi Framework launch configuration. In the Arguments tab, set the VM argument that controls which directories the Orion server can access on your machine. You want to ensure the Orion server can update the files in your local git repo.

-Dorg.eclipse.orion.server.core.allowedPathPrefixes=c:\myLocalGitRepos

• Run the launch and point your browser at [1]
• Push the link button and add a folder that links to your local git repos.
• You should see the projects show up in your Orion explorer and from here, you can start editing files. As you make changes to the client code, you can simply reload the page in your browser to see the changes.