Index: documents/trunk/documentation/src/enterprise/running.xml
===================================================================
--- documents/trunk/documentation/src/enterprise/running.xml (revision 9829)
+++ documents/trunk/documentation/src/enterprise/running.xml (revision 9829)
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE section SYSTEM "../documentation.dtd">
+<section>
+  <title>Enterprise Naked Objects</title>
+
+  <heading>Basic server</heading>
+
+  <command-listing>$ run.sh --type server --connection xstream --persistor xml</command-listing>
+
+  <para>This command runs the NOF as a server with a basic persistence
+  mechanism (the XML object store). The connection protocol used is based on
+  the XStream serialization library.</para>
+
+  <heading>Basic DND client</heading>
+
+  <command-listing>$ run.sh --type client --connection xstream</command-listing>
+
+  <para>This commands starts up a client using the DND viewer. A connection to
+  the server on <ital>localhost</ital> is made using the XStream serialization
+  library. As we are now running a multi-user system more than one client can
+  be started up.</para>
+
+  <para>WARNING - for the current version (3.0M5) the authentication mechanism
+  used is always the password mechanism and resides on each client, not the
+  server.</para>
+
+  <para>To allow the client to connect to a remote server the
+  <property>address</property> property needs to be specified. For simplicity
+  this can be added the <path>nakedobjects.properties</path> file but can also
+  be placed in a separate file called <path>client.properties</path>.</para>
+
+  <property-listing>nakedobjects.remoting.command.address = nof.acme.com</property-listing>
+
+  <heading>Integrated web server</heading>
+
+  <command-listing>$ run.sh --type server --viewer html --persistor xml
+2007-08-09 12:37:13.671::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
+2007-08-09 12:37:13.801::INFO:  jetty-6.0.2
+2007-08-09 12:37:13.954::INFO:  Started SocketConnector @ 0.0.0.0:8080
+</command-listing>
+
+  <para>This command runs up the NOF as a web server, allowing multiple
+  clients to access Naked Objects via a browser. This server is also using a
+  basic persistance mechanism, but it does not provide access for remote
+  client using the DND viewer. As for the standalone verision the users need
+  to access the URL http://<ital>server</ital>/ to access the logon
+  page.</para>
+</section>