Commit emails of the iDok project

["AFS account Roman Geus" <geus AT savannah.psi.ch>]

Author: geus
Date: Wed Feb 27 17:35:08 2008
New Revision: 769

Log:
Added corrections by Florian Hübner to installation guide

Modified:
   trunk/INSTALL.html
   trunk/doc/INSTALL.odt

Modified: trunk/INSTALL.html
==============================================================================
--- trunk/INSTALL.html  (original)
+++ trunk/INSTALL.html  Wed Feb 27 17:35:08 2008
@@ -6,7 +6,7 @@
        <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3  (Linux)">
        <META NAME="CREATED" CONTENT="0;0">
        <META NAME="CHANGEDBY" CONTENT="Roman Geus">
-       <META NAME="CHANGED" CONTENT="20080227;15574700">
+       <META NAME="CHANGED" CONTENT="20080227;17343400">
        <META NAME="SDFOOTNOTE" CONTENT=";;;;P">
        <META NAME="SDENDNOTE" CONTENT="ARABIC">
        <STYLE TYPE="text/css">
@@ -215,10 +215,10 @@
 <P LANG="en-US" CLASS="western" STYLE="margin-bottom: 0cm">To
 generate the necessary directory structures under <CODE 
CLASS="western">/tmp/idok_server</CODE>
 and some test data run <CODE CLASS="western">ant</CODE> as follows:</P>
-<PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml init-server-dirs</PRE><H3 LANG="en-US" CLASS="western">
-6.1.2The <CODE CLASS="western">svnadmin</CODE> executable need to be
-in the PATH for this to work.</H3>
-<H3 LANG="en-US" CLASS="western">6.1.3Start CORBA naming service</H3>
+<PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml init-server-dirs</PRE><P LANG="en-US" CLASS="western">
+The <CODE CLASS="western">svnadmin</CODE> executable need to be in
+the PATH for this to work.</P>
+<H3 LANG="en-US" CLASS="western">6.1.2Start CORBA naming service</H3>
 <P LANG="en-US" CLASS="western">A naming service is needed to enable
 clients to connect to the server using CORBA.</P>
 <P LANG="en-US" CLASS="western">You can start the CORBA naming
@@ -226,16 +226,19 @@
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml start-orbd</PRE><P LANG="en-US" CLASS="western" 
STYLE="margin-bottom: 0cm">
 Note, that this command will not return to the command prompt as long
 as the daemon is running.</P>
-<H3 LANG="en-US" CLASS="western">6.1.4Start iDok service</H3>
+<H3 LANG="en-US" CLASS="western">6.1.3Start iDok service</H3>
 <P LANG="en-US" CLASS="western">Start the iDok service daemon by
 running</P>
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml start-server-jacorb</PRE><P LANG="en-US" CLASS="western">
 Note, that this command will not return to the command prompt as long
 as the daemon is running.</P>
-<H3 LANG="en-US" CLASS="western">6.1.5Start iDok indexer</H3>
+<H3 LANG="en-US" CLASS="western">6.1.4Start iDok indexer</H3>
 <P LANG="en-US" CLASS="western">Start the indexer daemon by running</P>
-<PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml start-indexer</PRE><H3 LANG="en-US" CLASS="western">
-6.1.6Initialize the authorization database</H3>
+<PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ ant -f 
local-server.xml start-indexer</PRE><P LANG="en-US" CLASS="western">
+Note, that this command will not return to the command prompt as long
+as the daemon is running.</P>
+<H3 LANG="en-US" CLASS="western">6.1.5Initialize the authorization
+database</H3>
 <P LANG="en-US" CLASS="western">Before iDok can be used, the iDok
 service daemon must be instructed to perform a one time
 initialization of its authorization database. This can be achieved by
@@ -243,7 +246,7 @@
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ 
scripts/unix/idok_admin init_auth_db</PRE><P LANG="en-US" CLASS="western">
 Log in as user <CODE CLASS="western">idokadmin</CODE> with the
 password <CODE CLASS="western">pass</CODE>.</P>
-<H3 LANG="en-US" CLASS="western">6.1.7Create an iDok project and a
+<H3 LANG="en-US" CLASS="western">6.1.6Create an iDok project and a
 repository</H3>
 <P LANG="en-US" CLASS="western">Use the iDok administration command
 line client to create a project named <I>foo</I>:</P>
@@ -254,7 +257,7 @@
 line client to create a repository named <I>bar</I>, which belong  to
 the new project:</P>
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ 
scripts/unix/idok_admin create_repository foo bar</PRE><H3 LANG="en-US" 
CLASS="western">
-6.1.8Import sample repository data</H3>
+6.1.7Import sample repository data</H3>
 <P LANG="en-US" CLASS="western">As long as the Apache web server is
 configured for iDok, the import the data using the Subversion client:</P>
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">$ svn import \
@@ -267,30 +270,26 @@
      <SPAN LANG="zxx">-m &quot;Initial import&quot; -R \</SPAN>
      <SPAN LANG="zxx">misc/sample_repository_data/ \</SPAN>
      <SPAN LANG="zxx">http://localhost/foo/bar</SPAN></PRE><H3 LANG="en-US" 
CLASS="western">
-6.1.9Log files</H3>
+6.1.8Log files</H3>
 <P LANG="en-US" CLASS="western">The CORBA naming service, the iDok
 service and the iDok indexer write logging informations to files in
 the directory <CODE CLASS="western">/tmp/idok_server/log</CODE>. If
 these server processes cause trouble, the log files might prove to be
 useful.</P>
-<H3 LANG="en-US" CLASS="western">6.1.10Apache web server</H3>
+<H3 LANG="en-US" CLASS="western">6.1.9Apache web server</H3>
 <P LANG="en-US" CLASS="western">The Apache web server together with
 the <CODE CLASS="western">mod_dav_svn</CODE> and <CODE 
CLASS="western">mod_</CODE><CODE CLASS="western">authz_svn</CODE>
 modules are responsible for implementing the read and write access to
 the documents stored in iDok repositories over the HTTP(S) and
 WEBDAV(S) protocols, including authentication and authorization.</P>
-<P LANG="en-US" CLASS="western">The actual Apache configuration is
-system dependent. Thus the configuration shown below might have to be
-adapted.</P>
-<P LANG="en-US" CLASS="western">The iDok service daemon automatically
-generates per repository configuration files in the directory
-<CODE CLASS="western">/tmp/idok_server/httpd/conf.d </CODE>Apache
-should be configured to include any file matching the pattern <CODE 
CLASS="western">*.conf</CODE>
-in that directory.</P>
+<P LANG="en-US" CLASS="western">The actual Apache web server
+configuration is highly system dependent, especially the location of
+the configuration files and modules. Thus the configuration shown
+below probably needs to be adapted.</P>
 <H4 LANG="en-US" CLASS="western">Load subversion modules</H4>
 <P LANG="en-US" CLASS="western">The  <CODE CLASS="western">mod_dav_svn</CODE>
 and <CODE CLASS="western">mod_authz_svn</CODE> modules are loaded
-e.g. as follows. 
+e.g. using the following configuration directives. 
 </P>
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">LoadModule 
dav_svn_module /usr/lib/apache2/modules/mod_dav_svn.so 
 <SPAN LANG="zxx">LoadModule authz_svn_module 
/usr/lib/apache2/modules/mod_authz_svn.so </SPAN></PRE><H4 LANG="en-US" 
CLASS="western">
@@ -318,10 +317,9 @@
 test installation these configuration files are located in the
 directory <CODE CLASS="western">/tmp/idok_server/httpd/conf.d</CODE></P>
 <P LANG="en-US" CLASS="western">Apache needs to be configured in such
-a way that the files in <CODE 
CLASS="western">/tmp/idok_server/httpd/conf.d</CODE>
-are automatically loaded:</P>
+a way that the files in this directory are automatically loaded:</P>
 <PRE LANG="zxx" CLASS="western" STYLE="margin-left: 1.25cm">Include 
/tmp/idok_server/httpd/conf.d/*.conf</PRE><H3 LANG="en-US" CLASS="western">
-6.1.11File permissions and ownership</H3>
+6.1.10File permissions and ownership</H3>
 <P LANG="en-US" CLASS="western">Note that the Apache web server must
 have permissions to read all files under <CODE 
CLASS="western">/tmp/idok_server/httpd</CODE>.
 It also must have permissions to read and write files under

Modified: trunk/doc/INSTALL.odt
==============================================================================
Binary files. No diff available.