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 "Setting up a CDO Server"

(Launch your server)
(Launch your server)
Line 30: Line 30:
 
[[Image:export-cdo-server-configuration.png]]<br><br>
 
[[Image:export-cdo-server-configuration.png]]<br><br>
  
== Create a launch your server ==
+
== Create a launch configuration ==
  
 
To launch the server you may use the [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/features/org.eclipse.emf.cdo.server.product/CDOServer.product?logsort=date&root=Modeling_Project&view=markup launch configuration] held in the server product feature. Open it and run it once. Even though this fails, you now have a launch configuration you can edit.
 
To launch the server you may use the [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/features/org.eclipse.emf.cdo.server.product/CDOServer.product?logsort=date&root=Modeling_Project&view=markup launch configuration] held in the server product feature. Open it and run it once. Even though this fails, you now have a launch configuration you can edit.

Revision as of 09:41, 6 August 2008

Quickstart

In this section you'll be told how get a running server quickly. Most likely there are setups that fit your needs better. This sections tries to get you up and running as quickly as possible.

Install all CDO bundles

Install all CDO features and bundles and dependencies listed on the resources page in the CDO wiki.
You may either download zips or direct your update manager to the EMF update site to install these bundles and features.

Checkout org.eclipse.emf.cdo.server.product

Checkout the whole org.eclipse.emf.cdo.server.product feature. You may use the [org.eclipse.emf.cdo.server.product.psf team project set file] or do it manually:

Cvs-org.eclipse.emf.cdo.server.product.png

Configure your server

An examplary server configration is included in the feature you now have in your workspace.
Change at least the location for the db files:

Change-db-file-cdo-server-xml.png

In the next step you have to copy it to a configuration folder in your home-directory:

linux:   /home/yoda/configuration/cdo-server.xml or

windows: C:\Documents and Settings\Yoda\configuration\cdo-server.xml

You can achieve this by exporting the configuration directory and the cdo-server.xml to the file system:

Export-to-file-system.png

Export-cdo-server-configuration.png

Create a launch configuration

To launch the server you may use the launch configuration held in the server product feature. Open it and run it once. Even though this fails, you now have a launch configuration you can edit.

Get-cdo-server-launch.png


Adapt the launch configuration

You'll now have to modify this launch configuration to get the server up and running. The first thing you need to adapt is to tell it to generate a fresh config.ini:

Launch-generate-config.png

Furhermore you'll have to make sure your server gets all plugins it needs. Most plugins are declared to dependent on in the bundle manifests, so hitting Add required Plug-ins is all you need to get them included. The database backend (beside the client/server-communication and other components) is configurable and resolved at runtime. You'll therefore have to add those manually. If you stay with the default configuration, that uses an embedded derby database, you'll have to add:

* org.apache.derby
* org.apache.derby.core
* org.eclipse.net4j.db.derby
* org.eclipse.net4j.tcp


Launch-select-plugins.png

Start and Stop your server

You are now ready to launch your server. Hit the trigger and watch it get up and running.
Launch-started.png

You're running an embedded derby database in an OSGI container. Terminating it by stopping the execution thread in the debugger does not allow it to shut down tidily. To achieve that, get your cursor to the osgi console and close the server by entering close.

Launch-close.png


Wikis: CDO | Net4j | EMF | Eclipse

Back to the top