Index: openacs-4/packages/acs-core-docs/www/install-steps.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-steps.adp,v diff -u -N -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/install-steps.adp 25 Apr 2018 08:38:27 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/install-steps.adp 2 Mar 2019 19:30:05 -0000 1.4.2.1 @@ -1,5 +1,5 @@ -{/doc/acs-core-docs {ACS Core Documentation}} {Basic Steps} +{/doc/acs-core-docs/ {ACS Core Documentation}} {Basic Steps} Basic Steps Install OpenACS 5.9.0).

-

Specific instructions are available for Mac OS X and Windows2000 -(see the section called -“OpenACS Installation Guide for Mac OS X” or the section called +

Specific instructions are available for macOS and Windows2000 +(see the section called “OpenACS +Installation Guide for macOS” or the section called “OpenACS Installation Guide for Windows”).

Binaries and other shortcuts

You can try out OpenACS using some binary installers. In @@ -53,83 +53,84 @@ use this guide

  • This is text you will see on -screen, such as a -Button or -link in a radio button list or -menu.

  • This is text that you will +screen, such as a +Button or link in a radio button list +or menu.

  • This is text that you will type.

  • This is text from a program or file which you may need to examine or edit:

    if {$database eq "oracle"} {
               set db_password        "mysitepassword"
     }
  • This is text that you will see and type in a command shell, -including text you may have to -change. It is followed by a list of just the commands, -which you can copy and paste. The command prompt varies by system; -in the examples we use the form[$OPENACS_SERVICE_NAME aolserver]$, where +including text +you may have to change. It is followed by a list of +just the commands, which you can copy and paste. The command prompt +varies by system; in the examples we use the form[$OPENACS_SERVICE_NAME aolserver]$, where $OPENACS_SERVICE_NAME is the current user and aolserver is the current directory. The root prompt is shown ending in # and all other prompts in $.

     [root root]# su - $OPENACS_SERVICE_NAME
    -[$OPENACS_SERVICE_NAME aolserver]$ svc -d /service/$OPENACS_SERVICE_NAME
    +[$OPENACS_SERVICE_NAME aolserver]$ svc -d /service/$OPENACS_SERVICE_NAME
     
    -[$OPENACS_SERVICE_NAME aolserver]$ dropdb $OPENACS_SERVICE_NAME
    +[$OPENACS_SERVICE_NAME aolserver]$ dropdb $OPENACS_SERVICE_NAME
     
     DROP DATABASE
    -[$OPENACS_SERVICE_NAME aolserver]$ createdb $OPENACS_SERVICE_NAME
    +[$OPENACS_SERVICE_NAME aolserver]$ createdb $OPENACS_SERVICE_NAME
     
     CREATE DATABASE
    -su - $OPENACS_SERVICE_NAME
    -svc -d /service/$OPENACS_SERVICE_NAME
    -dropdb $OPENACS_SERVICE_NAME
    -createdb $OPENACS_SERVICE_NAME
    -
    +su - $OPENACS_SERVICE_NAME
    +svc -d /service/$OPENACS_SERVICE_NAME
    +dropdb $OPENACS_SERVICE_NAME
    +createdb $OPENACS_SERVICE_NAME
    +
     

    Setting a global shell -variable for cut and paste.  In order to cut and -paste the instructions into your shell, you must set the -environment variable $OPENACS_SERVICE_NAME. In order to set it -globally so that it works for any new users or special service -users you may create, edit the file /etc/profile ( /etc/share/skel/dot.profile for FreeBSD) -and add this line:

    export OPENACS_SERVICE_NAME=service0
    +variable for cut and paste. In order to cut and paste
    +the instructions into your shell, you must set the environment
    +variable $OPENACS_SERVICE_NAME. In order to set it globally so that
    +it works for any new users or special service users you may create,
    +edit the file /etc/profile (
    +/etc/share/skel/dot.profile for
    +FreeBSD) and add this line:

    +export OPENACS_SERVICE_NAME=service0
     

-Paths and Users

-

Table 2.1. Default directories +Paths and Users

+

Table 2.1. Default directories for a standard install

- + +$OPENACS_SERVICE_NAME (set to service0 +in default install) - + - + - + - + - + - + @@ -141,9 +142,9 @@
Fully qualified domain name of your serveryourserver.testFully qualified domain name of your serveryourserver.test
name of administrative access accountremadmin
OpenACS service -$OPENACS_SERVICE_NAME (set to -service0 in default install)
OpenACS service account$OPENACS_SERVICE_NAMEOpenACS service account$OPENACS_SERVICE_NAME
OpenACS database name$OPENACS_SERVICE_NAMEOpenACS database name$OPENACS_SERVICE_NAME
Root of OpenACS service file tree (SERVERROOT)/var/lib/aolserver/$OPENACS_SERVICE_NAMERoot of OpenACS service file tree (SERVERROOT)/var/lib/aolserver/$OPENACS_SERVICE_NAME
Location of source code tarballs for new software/var/tmp
The OpenACS tarball contains some files which are useful while setting up other software. Those files are located at:/var/tmp/openacs-5.9.0/packages/acs-core-docs/www/files
Database backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backupDatabase backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup
Service config files/var/lib/aolserver/$OPENACS_SERVICE_NAME/etcService config files/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
Service log files/var/lib/aolserver/$OPENACS_SERVICE_NAME/logService log files/var/lib/aolserver/$OPENACS_SERVICE_NAME/log
Compile directory/usr/local/src

None of these locations are set in stone - they're simply the values that we've chosen. The values that you'll -probably want to change, such as service name, are marked like this. The other values -we recommend you leave unchanged unless you have a reason to change -them.

+probably want to change, such as service name, are marked like +this. The other values we recommend you leave +unchanged unless you have a reason to change them.

Note

Some of the paths and user accounts have been changed from those recommended in previous versions of this document to improve security and maintainability. See this thread for discussion.

@@ -176,8 +177,8 @@ there's a SQL error in the Tcl error or in the log, post that too.

  • If you find errors in this document or if you have ideas about making it better, please post them in our BugTracker.

  • -

    ($‌Id: overview.xml,v 1.30 2017/08/07 -23:47:55 gustafn Exp $)

    +
    ($‌Id: overview.xml,v 1.31 2018/07/04 10:20:42 +gustafn Exp $)