Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml,v diff -u -r1.10 -r1.11 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 20 Aug 2003 16:20:18 -0000 1.10 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 14 Oct 2003 10:03:23 -0000 1.11 @@ -17,16 +17,15 @@ The reference install stores all OpenACS services in - /web, with one subdirectory per - service. The first time you install a service, you must create + /var/lib/aolserver, with one subdirectory per service. The first time you install a service, you must create that directory and set its permissions: - [root@yourserver root]# mkdir /web -[root@yourserver root]# chgrp web /web -[root@yourserver root]# chmod 770 /web + [root@yourserver root]# mkdir /var/lib/aolserver +[root@yourserver root]# chgrp web /var/lib/aolserver +[root@yourserver root]# chmod 770 /var/lib/aolserver [root@yourserver root]# -mkdir /web -chgrp web /web -chmod 770 /web +mkdir /var/lib/aolserver +chgrp web /var/lib/aolserver +chmod 770 /var/lib/aolserver @@ -126,21 +125,21 @@ Unpack the OpenACS tarball and rename it to service0. Secure the directory so that only the owner can access it. Check the permissions by listing the directory. [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cd /web -[service0@yourserver web]$ tar xzf /tmp/&tarballpath;.tgz -[service0@yourserver web]$ mv &tarballpath; service0 -[service0@yourserver web]$ chmod -R 700 service0 -[service0@yourserver web]$ ls -al +[service0@yourserver service0]$ cd /var/lib/aolserver +[service0@yourserver aolserver]$ tar xzf /tmp/&tarballpath;.tgz +[service0@yourserver aolserver]$ mv &tarballpath; service0 +[service0@yourserver aolserver]$ chmod -R 700 service0 +[service0@yourserver aolserver]$ ls -al total 3 drwxrwx--- 3 root web 1024 Mar 29 16:41 . drwxr-xr-x 25 root root 1024 Mar 29 16:24 .. drwx------ 7 service0 web 1024 Jan 6 14:36 service0 -[service0@yourserver web]$ exit +[service0@yourserver aolserver]$ exit logout [root@yourserver root]# su - service0 -cd /web +cd /var/lib/aolserver tar xzf /tmp/&tarballpath;.tgz mv &tarballpath; service0 chmod -R 700 service0/ @@ -155,13 +154,13 @@ these directories will be included in the tarball)Set up several additional directories in the service root: etc is for configuration and control files, log is for error and request (web page hit) log files, and database-backup is for database backup files. If you did the CVS step, note that these new directories are excluded from that step so that you can decide whether or not you want your logs and config files in source control. [root@yourserver root]# su - service0 -[service0@yourserver service0]$ mkdir /web/service0/etc /web/service0/log /web/service0/database-backup -[service0@yourserver web]$ exit +[service0@yourserver service0]$ mkdir /var/lib/aolserver/service0/etc /var/lib/aolserver/service0/log /var/lib/aolserver/service0/database-backup +[service0@yourserver aolserver]$ exit logout -[root@yourserver web]# +[root@yourserver aolserver]# su - service0 -mkdir /web/service0/etc /web/service0/log /web/service0/database-backup +mkdir /var/lib/aolserver/service0/etc /var/lib/aolserver/service0/log /var/lib/aolserver/service0/database-backup exit @@ -401,15 +400,15 @@ specific port, e.g. port 80. In order for OpenACS to work, you need to configure a virtual server. The Reference Platform uses a configuration file included in the OpenACS tarball, - /web/service0/etc/config.tcl. + /var/lib/aolserver/service0/etc/config.tcl. Open it in an editor to adjust the parameters. AOLserver configuration [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cd /web/service0/etc +[service0@yourserver service0]$ cd /var/lib/aolserver/service0/etc [service0@yourserver etc]# emacs config.tcl @@ -499,7 +498,7 @@ nsd and selectively kill by job number. [service0@yourserver etc]$ killall nsd nsd: no process killed -[service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /web/service0/etc/config.tcl +[service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/etc/config.tcl [service0@yourserver service0]$ [08/Mar/2003:18:13:29][32131.8192][-main-] Notice: nsd.tcl: starting to read config file... [08/Mar/2003:18:13:29][32131.8192][-main-] Notice: nsd.tcl: finished reading config file. @@ -513,13 +512,13 @@ url="files/openacs-start.html">this. If you imported your files into cvs, now that you know it worked you can erase the temp - directory with rm -rf /web/service0.orig. + directory with rm -rf /var/lib/aolserver/service0.orig. If you don't see the login page, view your error log - (/web/service0/log/service0-error.log) + (/var/lib/aolserver/service0/log/service0-error.log) to make sure the service is starting without any problems. The most common errors here are trying to start a port 80 server while not root, failing to connect because of @@ -612,7 +611,7 @@ AOLServer to restart itself (ie. inittab or daemontools), you'll need to manually restart your service. - [service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /web/service0/config.tcl + [service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/config.tcl