Operating a CDO Server

Author: Eike Stepper

Table of Contents

1  Deploying a CDO Server

The easiest way to deploy a stand-alone CDO Server is to download the latest Eclipse Installer for the target environment:

• Windows 64 Bit (self-extracting exe)
• Windows 32 Bit (self-extracting exe)
• Mac OS 64 Bit (tar.gz)
• Linux 64 Bit (tar.gz)
• Linux 32 Bit (tar.gz)

When the Eclipse Installer is started, select the "CDO Server" application:

On the second page make sure you select the product version (of the CDO Server) that matches your clients' versions:

When the installation has finished the "eclipse" folder under the installation folder contains the cdo-server.xml configuration file, which looks similar to this:

	cdo‑server.xml
<?xml version="1.0" encoding="UTF-8"?> <cdoServer>   <acceptor type="tcp" listenAddr="0.0.0.0" port="2036"/>   <repository name="repo1">     <property name="overrideUUID" value=""/>     <property name="supportingAudits" value="true"/>     <property name="supportingBranches" value="true"/>     <property name="ensureReferentialIntegrity" value="false"/>     <property name="allowInterruptRunningQueries" value="true"/>     <property name="idGenerationLocation" value="STORE"/>     <property name="serializeCommits" value="false"/>     <property name="optimisticLockingTimeout" value="10000"/>     <store type="db">       <property name="connectionKeepAlivePeriod" value="60"/>       <property name="readerPoolCapacity" value="20"/>       <property name="writerPoolCapacity" value="20"/>       <mappingStrategy type="horizontal">         <property name="qualifiedNames" value="true"/>       </mappingStrategy>       <dbAdapter name="h2"/>       <dataSource         class="org.h2.jdbcx.JdbcDataSource"         URL="jdbc:h2:database/repo1"/>     </store>   </repository> </cdoServer>

Please note that many repository configuration options can not be changed anymore after the repository has been started the first time.

See Also:

• Configuring Repositories
• Configuring Acceptors
• Managing Security

2  Starting a CDO Server

Starting a CDO Server differs a little bit depending on the target environment:

• On Windows double-click the eclipsec.exe file (mind the last "c").
• On Mac OS start the Eclipse.app/Contents/MacOS/eclipse executable from a terminal window.
• On Linux start the normal eclipse executable from a terminal window.

After successful start of the server the console should look similar to this:

Please note that many repository configuration options can not be changed anymore after the repository has been started the first time.

See Also:

• Configuring Repositories

3  Stopping a CDO Server

To gracefully shut down a running CDO server enter the command "close" into the console and confirm with "yes":

Please note that the DBStore supports automatic crash detection and recovery at startup time. Other store may or may not support similar functionality.