ECF Generic Server
Connecting to the ECF Generic Server
- Download and install the ECF SDK.
- Right-click on a project within your workspace.
- Choose 'ECF' -> 'Connect Project...' from the popup menu.
- Select the 'ECF generic' provider from the list.
- Use ecftcp://ecf.eclipse.org:3282/server as the connect URI.
- Choose a nickname and then select the 'OK' button.
Setting up an ECF Generic Server with Equinox (ECF version 1.0.0M6 or newer)
With the following enhancement: #112890, it's possible to configure an ECF generic server by providing a plugin with an extension for the org.eclipse.ecf.server.generic.configure extension point.
- Download the Equinox SDK 3.3M6 (or newer) Note the location of the <equinoxhome>/plugins directory.
- Install the ECF SDK bundles to the <equinoxhome>/plugins directory. Get the ECF SDK here.
- ECF server requires the Eclipse bundle: org.eclipse.core.jobs,which is not yet part of the Equinox distribution. The jobs bundle can be found in the <eclipsehome>/plugins directory of an Eclipse installation, and has a name similar to: org.eclipse.core.jobs_3.3.0.v20070423.jar (the 3.3.0.v20070423 may be different). You should copy this jar into the <equinoxhome>/plugins directory. Make sure you do not remove or rename the original copy of this bundle as it will disable that copy of Eclipse.
Create a new plugin, and add the following extension to this new plugin:
<extension point="org.eclipse.ecf.server.generic.configuration"> <connector hostname="localhost" keepAlive="30000" port="3283"> <group name="server"> </group> </connector> </extension>
With the above, the server id would be 'ecftcp://localhost:3283/server'.
Change the values of 'hostname', 'keepAlive', 'port' for the connector, and add groups as desired/appropriate. For example:
<extension point="org.eclipse.ecf.server.generic.configuration"> <connector hostname="ecf.eclipse.org" keepAlive="20000" port="9999"> <group name="groupone"> </group> <group name="grouptwo"> </group> </connector> </extension>
With the above, the ids for the two groups would be 'ecftcp://ecf.eclipse.org:9999/groupone' and 'ecftcp://ecf.eclipse.org:9999/grouptwo'.
- Build and deploy this new plugin to server plugins directory, along with all the other ECF bundles.
- Start the org.eclipse.ecf.server.generic bundle. This can be done via the server console (with 'start org.eclipse.ecf.server.generic') or can be setup to start automatically via the <appserverhome>webapps/bridge/WEB-INF/platform/configuration/config.ini file. Which is chosen is dependent upon how one has setup the Equinox server.
Setting up an ECF Generic Server with Equinox (prior to version 1.0.0M6)
- Follow instructions for setting up the Equinox Servlet Incubator. Note the location of the <appserverhome>/webapps/bridge/WEB-INF/platform/plugins directory.
- NOTE: ECF server requires some of the bundles that come from the Equinox core (containing org.eclipse.core.runtime packages and and others). See Equinox download page for these bundles.
- Download ECF plugins: ECF 0.9.6 or ECF Download Page
- Copy the ECF plugins into the <appserverhome>/webapps/bridge/WEB-INF/platform/plugins directory created above.
- Edit the conf/server.xml in org.eclipse.ecf.server plugin (temporarily (0.9.6) you will need to unjar this plugin, edit the server.xml as described below and either re-jar it or create a directory for it...we'll get this fixed in subsequent releases. I've setup bug 172724 to track this).
The default content for server.xml is:
<server> <!-- <connector protocol="ecftcp" hostname="localhost" port="3282" timeout="30000"> <group name="server"/> </connector> --> </server>
Notice that this default connector is commented out. You should create connectors like this (from ecf.eclipse.org):
<server> <connector protocol="ecftcp" hostname="localhost" port="3282" timeout="30000"> <group name="server"/> <group name="se"/> </connector> </server>
This sets up two groups, with URLs:
ecftcp://ecf.eclipse.org:3282/server and ecftcp://ecf.eclipse.org:3282/se
You can add as many groups as you want for a given connector.
- Start the org.eclipse.ecf.server bundle. This can be done via the server console (with 'start org.eclipse.ecf.server') or can be setup to start automatically via the <appserverhome>webapps/bridge/WEB-INF/platform/configuration/config.ini file.