notify-dpml AT lists.ibiblio.org
Subject: DPML Notify
List archive
svn commit: r1644 - development/main/central/site/src/docs/guide/setup
- From: niclas AT netcompartner.com
- To: notify-dpml AT lists.ibiblio.org
- Subject: svn commit: r1644 - development/main/central/site/src/docs/guide/setup
- Date: Sun, 30 Jan 2005 20:24:57 +0100
Author: niclas
Date: Sun Jan 30 20:24:57 2005
New Revision: 1644
Modified:
development/main/central/site/src/docs/guide/setup/dpml.xml
Log:
Added fuller installation instructions for Transit. Steve will move these
elsewhere later.
Modified: development/main/central/site/src/docs/guide/setup/dpml.xml
==============================================================================
--- development/main/central/site/src/docs/guide/setup/dpml.xml (original)
+++ development/main/central/site/src/docs/guide/setup/dpml.xml Sun Jan 30
20:24:57 2005
@@ -4,34 +4,96 @@
<properties>
<author email="mcconnell AT dpml.net">Stephen McConnell</author>
<title>DPML Guide</title>
- </properties>
+ </properties>
<body>
<section name="DPML Setup">
<p>
- An optional but recommended practice is to create an environment
variable
- named DPML_HOME that refers to the DPML home directory and is used
to
- construct the ${dpml.home} value. You should also include
DPML_HOME/bin in
+<!-- Niclas: this paragraph because a bit misplaced. TODO: rewrite
+ An optional but recommended practice is to create an environment
variable
+ named DPML_HOME that refers to the DPML home directory and is used to
+ construct the ${dpml.home} value. You should also include
DPML_HOME/bin in
your PATH environment variable.
+-->
</p>
- <subsection name="For Unix">
-
- <source>
-$ DPML_HOME=/dpml
-$ export DPML_HOME
-$ PATH=$PATH:$DPML_HOME/bin
-$ export PATH
- </source>
+ <subsection name="Single-user Unix/Linux setup">
+ <p>
+ If you are installing on a single user system, we recommend the
following
+ installation. We assume that the binary
+ Transit distribution has been downloaded to the $HOME directory.
+ </p>
+ <source>
+mkdir $HOME/.dpml
+cd /$HOME/.dpml
+tar xvfz $HOME/dpml-transit-nnnn.tar.gz
+chown -R $USER .
+ </source>
+ <p>
+ And enter the following into your own login script, e.g.
$HOME/.bashrc.
+ $HOME/.bash_profile (system dependent).
+ </p>
+ <source>
+DPML_HOME=$HOME/.dpml
+export DPML_HOME
+PATH=$PATH:$DPML_HOME/bin
+export PATH
+ </source>
+ </subsection>
+ <subsection name="Multi-user Unix/Linux setup">
+ <p>
+ If you are installing on a multi-user system it is important that
the
+ permissions are properly set up. We recommend that the following
+ commands are executed as root. We assume that the binary Transit
+ distribution has been downloaded to the /root directory, and that
the
+ system has a group named "users" which all users belong to.
+ </p>
+ <source>
+mkdir /usr/share/dpml
+cd /usr/share/dpml
+tar xvfz /root/dpml-transit-nnnn.tar.gz
+chown -R root.users cache
+chmod -R g+w cache
+cd cache
+umask 0002
+ </source>
+ <p>
+ And the following setup to be entered into the shared user login
script,
+ e.g. /etc/profile (system dependent).
+ </p>
+ <source>
+DPML_HOME=/var/dpml
+export DPML_HOME
+PATH=$PATH:$DPML_HOME/bin
+export PATH
+ </source>
+ <p>
+ If you want to further strengthen the security, you should probably
+ not use a shared DPML_HOME at all, and just instruct each user to
+ go for a single user installation. Alternatively, can edit the
+ <code>$DPML_HOME/transit/authority/cache.properties</code> file to
+ the following.
+ </p>
+ <source>
+# The location of the cache system
+dpml.transit.cache.location=${user.home}/.dpml/cache
+
+# The class that implements the cache handler
+dpml.transit.cache.class=net.dpml.transit.artifact.FileCacheHandler
+ </source>
+ <p>
+ which will ensure that each user has its own set of cached artifact
+ and that the shared instance is write-protected.
+ </p>
</subsection>
<subsection name="On Windows">
-
+
<p>
- Under Windows NT select Properties for 'My Computer', select the
- 'Advanced' tab, and choose 'Environment Variables'. Create a new
+ Under Windows NT select Properties for 'My Computer', select the
+ 'Advanced' tab, and choose 'Environment Variables'. Create a new
environment variabled named DPML_HOME.
</p>
@@ -42,7 +104,7 @@
<subsection name="Updating you PATH">
<p>
- Finally, edit the PATH environment variable to include the
+ Finally, edit the PATH environment variable to include the
<code>%DPML_HOME%\bin</code> path.
</p>
- svn commit: r1644 - development/main/central/site/src/docs/guide/setup, niclas, 01/30/2005
Archive powered by MHonArc 2.6.24.