2.2 Installing dm Server

Although the steps are similar, the details of installing dm Server depend on the operating system.

Obtain the free Community Edition of dm Server from the dm Server download site (http://www.springsource.org/dmserver). This guide is consistent with version 2.0.0.RC1 of dm Server.

Installing dm Server on Windows™ operating systems

Unzip the download of dm Server to the root directory of a drive (this will avoid possible problems with long pathnames). Set an environment variable %DMS_HOME% to refer to the unzipped folder…

prompt> cd C:\
prompt> "%JAVA_HOME%"\bin\jar xf \path\to\springsource-dm-server-2.0.0.RC1.zip
prompt> set DMS_HOME=C:\springsource-dm-server-2.0.0.RC1

To verify the installation, issue the command: "%DMS_HOME%"\bin\startup.bat and ensure a message numbered UR0001I is displayed. You will see many other messages about starting and installing other required artifacts, but the UR0001I message indicates that the user region is ready for your use. (Timestamps have been removed and thread names and other details may vary with different installations and versions.)

system-artifacts   <TC0000I> Starting Tomcat.
system-artifacts   <TC0010I> Creating HTTP/1.1 connector with scheme http on port 8080.
system-artifacts   <TC0010I> Creating HTTP/1.1 connector with scheme https on port 8443.
system-artifacts   <TC0010I> Creating AJP/1.3 connector with scheme http on port 8009.
system-artifacts   <TC0001I> Started Tomcat.
system-artifacts   <DE0004I> Starting bundle 'com.springsource.server.web.core' version '2.0.0.M6'.
system-artifacts   <DE0004I> Starting bundle 'com.springsource.server.web.dm' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.server.web.dm' version '2.0.0.M6'.
system-artifacts   <DE0005I> Started bundle 'com.springsource.server.web.tomcat' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.osgi.webcontainer.tomcat' version '1.0.0.CI-102'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.server.web.core' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started plan 'com.springsource.server.web' version '2.0.0'.
Thread-2           <UR0001I> User region ready. 

Shut down the server by pressing Ctrl-C.

Installing dm Server on UNIX™ operating systems

Unzip the download of dm Server to a suitable location on the file system, such as the home directory. (If the download was automatically unzipped by the operating system, simply move the unzipped directory to the chosen location.) Set an environment variable $DMS_HOME to refer to the unzipped folder…

prompt$ mkdir /path/to/home/springsource
prompt$ cd /path/to/home/springsource
prompt$ unzip /path/to/springsource-dm-server-2.0.0.RC1.zip
prompt$ export DMS_HOME=/path/to/home/springsource/springsource-dm-server-2.0.0.RC1

To verify the installation, use a terminal window to issue the command: $DMS_HOME/bin/startup.sh and ensure a message numbered UR0001I is displayed. You will see many other messages about starting and installing other required artifacts, but the UR0001I message indicates that the user region is ready for your use. (Timestamps have been removed and thread names and other details may vary with different installations and versions.)

system-artifacts   <TC0000I> Starting Tomcat.
system-artifacts   <TC0010I> Creating HTTP/1.1 connector with scheme http on port 8080.
system-artifacts   <TC0010I> Creating HTTP/1.1 connector with scheme https on port 8443.
system-artifacts   <TC0010I> Creating AJP/1.3 connector with scheme http on port 8009.
system-artifacts   <TC0001I> Started Tomcat.
system-artifacts   <DE0004I> Starting bundle 'com.springsource.server.web.core' version '2.0.0.M6'.
system-artifacts   <DE0004I> Starting bundle 'com.springsource.server.web.dm' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.server.web.dm' version '2.0.0.M6'.
system-artifacts   <DE0005I> Started bundle 'com.springsource.server.web.tomcat' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.osgi.webcontainer.tomcat' version '1.0.0.CI-102'.
start-signalling-1 <DE0005I> Started bundle 'com.springsource.server.web.core' version '2.0.0.M6'.
start-signalling-1 <DE0005I> Started plan 'com.springsource.server.web' version '2.0.0'.
Thread-2           <UR0001I> User region ready. 

Shut down the server by pressing Ctrl-C.