# Operating a CDO Server

Author: Eike Stepper

Table of Contents

1 | Deploying a CDO Server
2 | Starting a CDO Server
3 | Stopping a CDO Server

## 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.

Copyright (c) 2004-2023 Eike Stepper (Loehne, Germany) and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html