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.
Difference between revisions of "ECF/Servers"
< ECF
(→ECF Generic Server) |
|||
| Line 10: | Line 10: | ||
#Choose a nickname and then select the 'OK' button. | #Choose a nickname and then select the 'OK' button. | ||
| − | ===Setting up an ECF Generic Server with Equinox=== | + | ===Setting up an ECF Generic Server with Equinox (ECF version 1.0.0M6 or newer)=== |
| + | |||
| + | With the following enhancement: [https://bugs.eclipse.org/bugs/show_bug.cgi?id=112890 #112890], it's | ||
| + | possible to configure an ECF generic server by providing a plugin with an extension for the | ||
| + | <b>org.eclipse.ecf.server.generic.configure</b> extension point. | ||
| + | |||
| + | <ol> | ||
| + | <li>Follow instructions for setting up the [http://www.eclipse.org/equinox/server/http_in_container.php Equinox Servlet Incubator]. Note the location of the '''<appserverhome>/webapps/bridge/WEB-INF/platform/plugins''' directory. | ||
| + | </li> | ||
| + | <li><b> | ||
| + | NOTE: ECF server requires some of the bundles that come from the Equinox core (containing org.eclipse.core.runtime packages and and others). See [http://download.eclipse.org/eclipse/equinox/ Equinox download page] for these bundles.</b> | ||
| + | </li> | ||
| + | <li>Download ECF plugins. | ||
| + | </li> | ||
| + | <li> | ||
| + | Create a new plugin, and add the following extension to this new plugin: | ||
| + | |||
| + | <pre> | ||
| + | <extension | ||
| + | point="org.eclipse.ecf.server.generic.configuration"> | ||
| + | <connector | ||
| + | hostname="localhost" | ||
| + | keepAlive="30000" | ||
| + | port="3283"> | ||
| + | <group | ||
| + | name="server"> | ||
| + | </group> | ||
| + | </connector> | ||
| + | </extension> | ||
| + | </pre> | ||
| + | </li> | ||
| + | <li> | ||
| + | Build and deploy this new plugin to server plugins directory, along with all the other ECF bundles. | ||
| + | </li> | ||
| + | <li>Start the <b>org.eclipse.ecf.server.generic</b> 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. | ||
| + | </li> | ||
| + | </ol> | ||
| + | |||
| + | ===Setting up an ECF Generic Server with Equinox (prior to version 1.0.0M6)=== | ||
<ol> | <ol> | ||
Revision as of 19:48, 12 March 2007
Contents
ECF Generic Server
ECF is currently using the Equinox Servlet Incubator to run and support the example collab application running on the 'ECF generic' provider.
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.
- 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.
-
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> - 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.
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.