Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Orion/Selfhosting"

(fix repo URLS, add more details for non-committers)
Line 1: Line 1:
This page explains the steps necessary to get set up for self-hosting on [http://orion.eclipse.org orion.eclipse.org]. This server is being used by the Orion committers to work on Orion itself. Non-committers can follow these steps too, but must use the [http://orionhub.org OrionHub] server instead.
+
== Self Hosting ==
 +
''Self hosting'' means running a [[Orion/Documentation/User_Guide/Getting_started#Launching_your_project_as_a_website|site configuration]] on an Orion server that will host the Orion client code at a different URL, while proxying server API requests to the running server at the original URL.
  
 +
It provides a convenient way to run the latest Orion client code without having to set up an Eclipse development workspace, or frequently download new builds. It also protects you from destroying your editing environment when you are editing the Orion client code itself. For example, if you make a change that breaks the Orion editor, you can fall back to the "outer" site, revert the change, then return to your self-hosted "inner" site.
 +
 +
== Instructions ==
 +
This section explains the steps necessary to get set up for self-hosting on [http://orion.eclipse.org orion.eclipse.org]. This server is being used by the Orion committers to work on Orion itself. Non-committers can follow the same steps: just replace any mention of orion.eclipse.org with [http://orionhub.org OrionHub], or your locally-running server, like <tt>http://localhost:8080</tt>.
 +
 +
=== Creating self hosting site ===
 
#Log into [http://orion.eclipse.org orion.eclipse.org].
 
#Log into [http://orion.eclipse.org orion.eclipse.org].
 
#Go to your user profile page. Enter your committer email and name in the Git section and save. This is important to do first so that Git commits are made using your committer username and can therefore be pushed back to git.eclipse.org.
 
#Go to your user profile page. Enter your committer email and name in the Git section and save. This is important to do first so that Git commits are made using your committer username and can therefore be pushed back to git.eclipse.org.
 
#Click on '''Repositories''' in the top banner, then click '''Clone Repository''' in the toolbar. In the URL field, enter  
 
#Click on '''Repositories''' in the top banner, then click '''Clone Repository''' in the toolbar. In the URL field, enter  
#*For committers: <tt>ssh://myCommitterId@git.eclipse.org/gitroot/e4/org.eclipse.orion.client.git</tt> (replacing your committer id, of course).
+
#*For committers: <tt>ssh://myCommitterId@git.eclipse.org/gitroot/orion/org.eclipse.orion.client.git</tt> (replacing your committer id, of course).
#*For non-committers: <tt>http://git.eclipse.org/gitroot/e4/org.eclipse.orion.client.git</tt> or <tt>git://git.eclipse.org/gitroot/e4/org.eclipse.orion.client.git</tt> .
+
#*For non-committers: <tt>http://git.eclipse.org/gitroot/orion/org.eclipse.orion.client.git</tt> or <tt>git.eclipse.org/gitroot/orion/org.eclipse.orion.client.git</tt> .
 
#You'll see a confirmation dialog asking you to accept the server's RSA key. Click '''Yes'''.
 
#You'll see a confirmation dialog asking you to accept the server's RSA key. Click '''Yes'''.
 
#Next a prompt will appear asking for credentials.
 
#Next a prompt will appear asking for credentials.
Line 13: Line 20:
 
#Go back to the Navigator, and verify that a new folder was created called <tt>org.eclipse.orion.client</tt>, and that it contains the Orion client code.
 
#Go back to the Navigator, and verify that a new folder was created called <tt>org.eclipse.orion.client</tt>, and that it contains the Orion client code.
 
#Click on the '''Sites''' link in the header, and create a new site configuration. Enter any name. On the page for the site configuration, click on the '''Add&#8230;''' button and then '''while holding the Shift key''', select <tt>org.eclipse.orion.client</tt> from the menu that appears. This hidden feature will create the necessary entries for self-hosting.  
 
#Click on the '''Sites''' link in the header, and create a new site configuration. Enter any name. On the page for the site configuration, click on the '''Add&#8230;''' button and then '''while holding the Shift key''', select <tt>org.eclipse.orion.client</tt> from the menu that appears. This hidden feature will create the necessary entries for self-hosting.  
#Start the site configuration by clicking on "Start" in the toolbar.  
+
#Start the site configuration by clicking on "Start" in the toolbar.
#Now you can log into your new instance :-)
+
#*A site will be launched with a name like <tt>site.eclipse.org:8080</tt> or <tt>127.0.0.2:8080</tt> if you're running a local server.
 +
#Log into your new instance, using the same credentials as in Step 1.
 +
#You're all set :-)
 +
 
 +
=== Updating client code ===
 +
1. Using the Orion Git tools, pull the latest code from the <tt>master</tt> branch of the <tt>org.eclipse.orion.client</tt> repository.
 +
2. You're done: the next time you load a page on your self-hosted site, it will be running the latest code.
 +
 
 +
== Limitations ==
 +
From time to time, changes are made to ''both'' the Orion server and client code as new features are added. In these cases, the latest client code from Git may fail to work with an older server. To resolve this, you'll have to upgrade your Orion server by downloading a new build. Make sure to copy the [[Orion/Server_admin_guide|<tt>serverworkspace</tt> directory]] from your old server, so you can pick up working from where you left off.
  
 +
== More ==
 
While working on Orion, you may want to install some additional plugins. You can use the links below.
 
While working on Orion, you may want to install some additional plugins. You can use the links below.
  

Revision as of 12:47, 21 September 2011

Self Hosting

Self hosting means running a site configuration on an Orion server that will host the Orion client code at a different URL, while proxying server API requests to the running server at the original URL.

It provides a convenient way to run the latest Orion client code without having to set up an Eclipse development workspace, or frequently download new builds. It also protects you from destroying your editing environment when you are editing the Orion client code itself. For example, if you make a change that breaks the Orion editor, you can fall back to the "outer" site, revert the change, then return to your self-hosted "inner" site.

Instructions

This section explains the steps necessary to get set up for self-hosting on orion.eclipse.org. This server is being used by the Orion committers to work on Orion itself. Non-committers can follow the same steps: just replace any mention of orion.eclipse.org with OrionHub, or your locally-running server, like http://localhost:8080.

Creating self hosting site

  1. Log into orion.eclipse.org.
  2. Go to your user profile page. Enter your committer email and name in the Git section and save. This is important to do first so that Git commits are made using your committer username and can therefore be pushed back to git.eclipse.org.
  3. Click on Repositories in the top banner, then click Clone Repository in the toolbar. In the URL field, enter
  4. You'll see a confirmation dialog asking you to accept the server's RSA key. Click Yes.
  5. Next a prompt will appear asking for credentials.
    • Non-committers: just click OK.
    • Committers: enter your eclipse.org account name and ssh password, then click OK.
  6. Wait for a moment while the repository is cloned. The toolbar area will let you know when it's done.
  7. Go back to the Navigator, and verify that a new folder was created called org.eclipse.orion.client, and that it contains the Orion client code.
  8. Click on the Sites link in the header, and create a new site configuration. Enter any name. On the page for the site configuration, click on the Add… button and then while holding the Shift key, select org.eclipse.orion.client from the menu that appears. This hidden feature will create the necessary entries for self-hosting.
  9. Start the site configuration by clicking on "Start" in the toolbar.
    • A site will be launched with a name like site.eclipse.org:8080 or 127.0.0.2:8080 if you're running a local server.
  10. Log into your new instance, using the same credentials as in Step 1.
  11. You're all set :-)

Updating client code

1. Using the Orion Git tools, pull the latest code from the master branch of the org.eclipse.orion.client repository. 2. You're done: the next time you load a page on your self-hosted site, it will be running the latest code.

Limitations

From time to time, changes are made to both the Orion server and client code as new features are added. In these cases, the latest client code from Git may fail to work with an older server. To resolve this, you'll have to upgrade your Orion server by downloading a new build. Make sure to copy the serverworkspace directory from your old server, so you can pick up working from where you left off.

More

While working on Orion, you may want to install some additional plugins. You can use the links below.

Back to the top