Index: openacs-4/packages/acs-core-docs/www/openacs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs.html,v diff -u -r1.19 -r1.20 --- openacs-4/packages/acs-core-docs/www/openacs.html 5 Nov 2003 15:32:38 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/openacs.html 11 Nov 2003 10:28:27 -0000 1.20 @@ -1,4 +1,4 @@ -Install OpenACS 5.0.0a4

Install OpenACS 5.0.0a4

+Install OpenACS 5.0.0a4

Install OpenACS 5.0.0a4

by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -38,7 +38,7 @@ [root@yourserver root]# useradd -g service0 -G web service0 -d /home/service0 [root@yourserver root]#

Install with automated script (EXPERIMENTAL)

Starting with OpenACS 5.0, an experimental script is available to automate all of the steps for the rest of this - section. Requires tclwebtest. If you are not feeling lucky, skip to Section�, “Install from tarball”.

Get the install script from CVS. It is located within + section. Requires tclwebtest. If you are not feeling lucky, skip to the section called “Install from tarball”.

Get the install script from CVS. It is located within the main cvs tree, at /etc/install. Use anonymous CVS checkout to get that directory in the home directory of the service's dedicated user. We put it there so that it is not @@ -57,7 +57,7 @@ /home/service0/install/install.tcl and change the values as documented in the file. It will work unchanged at 127.0.0.1:8000.

Run the file as root.

[service0@yourserver service0]$ exit 
-[root@yourserver root]# ./home/service0/install/install.sh
+[root@yourserver root]# sh /home/service0/install/install.sh
 /home/service0/install/install.sh: Starting installation with config_file 
 /home/service0/install/install.tcl. Using serverroot=/var/lib/aolserver/
 service0, server_url=http://0.0.0.0:8000, do_checkout=yes, do_install=yes, 
@@ -66,7 +66,7 @@
 ./install.sh: Finished (re)installing /var/lib/aolserver/service0 at Wed Nov  
 5 13:27:17 CET 2003.  Access the new site at http://127.0.0.1:8000 with admin 
 username admin@yourserver.test and password 1
-[root@yourserver root]#

You can proceed to Section�, “Next Steps”.

Install from tarball

You should already have downloaded the OpenACS tarball +[root@yourserver root]#

You can proceed to the section called “Next Steps”.

Install from tarball

You should already have downloaded the OpenACS tarball to the /tmp directory. If not, download the OpenACS tarball and save it in @@ -207,7 +207,7 @@ SVRMGR> alter user service0 quota unlimited on service0; SVRMGR> exit;

Your table space is now ready. In case you are trying to delete a - previous OpenACS installation, consult these commands in Section�, “Deleting a tablespace” below. + previous OpenACS installation, consult these commands in the section called “Deleting a tablespace” below.

  • Make sure that you can login to Oracle using your service_name account:

    @@ -222,7 +222,7 @@
     		  You should see today's date in a format 'YYYY-MM-DD.'
     		  If you can't login, try redoing step 1 again. If the date is
     		  in the wrong format, make sure you followed the steps outlined in
    -		  Section�, “Troubleshooting Oracle Dates”
    +		  the section called “Troubleshooting Oracle Dates”
     		  

  • Prepare PostgreSQL for an OpenACS Service.�

    • PostGreSQL:

      Create a user in the database matching the service name. With default PostGreSQL authentication the name of the user of the process will be matched to this account @@ -239,7 +239,7 @@ CREATE DATABASE [service0@yourserver service0]$

      su - service0
      -createdb -E UNICODE service0
    • Automate daily database Vacuuming. This is a process which cleans out discarded data from the database. A quick way to automate vacuuming is to edit the cron file for the database user.

      [service0@yourserver service0]$ export EDITOR=emacs;crontab -e

      Add this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.

      0 1 * * * /usr/local/pgsql/bin/vacuumdb --analyze service0
    • Add Full Text Search Support (OPTIONAL)

    • [service0@yourserver service0]$ exit
      +createdb -E UNICODE service0
    • Automate daily database Vacuuming. This is a process which cleans out discarded data from the database. A quick way to automate vacuuming is to edit the cron file for the database user.

      [service0@yourserver service0]$ export EDITOR=emacs;crontab -e

      Add this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.

      0 1 * * * /usr/local/pgsql/bin/vacuumdb --analyze service0
    • Add Full Text Search Support (OPTIONAL)

    • [service0@yourserver service0]$ exit
       logout
       
       [root@yourserver root]# 
  • Configure an AOLserver Service for OpenACS.�

    1. @@ -249,7 +249,7 @@ need to configure a virtual server. The Reference Platform uses a configuration file included in the OpenACS tarball, /var/lib/aolserver/service0/etc/config.tcl. - Open it in an editor to adjust the parameters.

      [root@yourserver root]# su - service0
      +	   Open it in an editor to adjust the parameters.

      [root@yourserver root]# su - service0
       [service0@yourserver service0]$ cd /var/lib/aolserver/service0/etc
       [service0@yourserver etc]# emacs config.tcl