Index: openacs-4/packages/acs-core-docs/www/individual-programs.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/individual-programs.adp,v diff -u -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/individual-programs.adp 24 Mar 2018 00:14:57 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/individual-programs.adp 25 Apr 2018 08:38:27 -0000 1.5 @@ -3,20 +3,20 @@ Prerequisite Software -
+ leftLink="install-steps" leftLabel="Prev" + title="Chapter 2. Installation +Overview" + rightLink="complete-install" rightLabel="Next"> +

Prerequisite Software

<authorblurb>

by Joel Aufrecht

</authorblurb>

OpenACS requires, at a minimum, an operating system, database, and webserver to work. Many additional programs, such as a build environment, Mail Transport Agent, and source control system, are also needed for a fully effective installation.

-

Table 2.2. Version -Compatibility Matrix

+

Table 2.2. Version Compatibility +Matrix

@@ -85,12 +85,12 @@ both PostgreSQL and Oracle. Some scripts require bash shell.

  • -Operating System.  OpenACS is -designed for a Unix-like system. It is developed primarily in -Linux. It can be run on Mac OS X, and in Windows within VMWare.

      +Operating System.  OpenACS is designed for +a Unix-like system. It is developed primarily in Linux. It can be +run on Mac OS X, and in Windows within VMWare.

      • -GNU/Linux.  The installation -assumes a linux kernel of 2.2.22 or newer, or 2.4.14 or newer.

      • +GNU/Linux.  The installation assumes a +linux kernel of 2.2.22 or newer, or 2.4.14 or newer.

      • FreeBSD. FreeBSD guide. The OpenACS Reference Platform uses shell scripts written for bash, which is the standard Linux shell. If you are using a different shell, you will need to @@ -99,67 +99,66 @@ scripts. Substitute fetch when the instructions suggest you use wget to download software.

      • Mac OS X. the section called -“OpenACS Installation Guide for Mac OS -X” +“OpenACS Installation Guide for Mac OS X”

      • Windows/VMWare. the section called -“OpenACS Installation Guide for -Windows” The only way to run OpenACS on Windows is -through the VMWare emulator. (Please let me know if you have -OpenACS running directly in Windows.)

      • +“OpenACS Installation Guide for Windows” The only way to run +OpenACS on Windows is through the VMWare emulator. (Please let me +know if you have OpenACS running directly in Windows.)

    • -Build Environment.  The Reference -Platform installation compiles most programs from source code.

        +Build Environment.  The Reference Platform +installation compiles most programs from source code.

        • -glibc 2.2 or newer, REQUIRED.  You -need recent versions of these libraries for Oracle to work -properly. For Unicode support, you need glibc 2.2 or newer. This -should be included in your operating system distribution.

        • +glibc 2.2 or newer, REQUIRED.  You need +recent versions of these libraries for Oracle to work properly. For +Unicode support, you need glibc 2.2 or newer. This should be +included in your operating system distribution.

        • GNU Make -3.76.1 or newer, REQUIRED.  PostgreSQL and -AOLserver require gmake to compile. Note that on most linux -distributions, GNU Make is simply named make and there is no gmake, whereas on BSD distributions, -make and gmake are different --use gmake.

        • +3.76.1 or newer, REQUIRED.  PostgreSQL and AOLserver +require gmake to compile. Note that on most linux distributions, +GNU Make is simply named make +and there is no gmake, whereas +on BSD distributions, make and +gmake are different --use +gmake.

      • Tcl 8.5.x. 

        • -Tcl 8.5.x, REQUIRED.  OpenACS is -written in Tcl, an interpreted language. A threaded version of the -Tcl interpreter must be installed for OpenACS to work. The Tcl +Tcl 8.5.x, REQUIRED.  OpenACS is written +in Tcl, an interpreted language. A threaded version of the Tcl +interpreter must be installed for OpenACS to work. The Tcl interpreter that is included in most standard distributions may not be thread safe.

        • Tcl 8.5.x development headers and libraries, -OPTIONAL.  The site-wide-search service, -OpenFTS, requires these to compile. (Debian users: apt-get install tcl8.5-dev). You need this +OPTIONAL.  The site-wide-search service, OpenFTS, +requires these to compile. (Debian users: apt-get install tcl8.5-dev). You need this to install OpenFTS.

      • -Tcllib, REQUIRED.  OpenACS -5.9.0 uses those Tcl extensions to send e-mail out, among -others.

        +Tcllib, REQUIRED.  OpenACS 5.9.0 +uses those Tcl extensions to send e-mail out, among others.

      • -tDOM, REQUIRED.  OpenACS 5.9.0 -stores queries in XML files, so we use an AOLserver module called -tDOM to parse these files. (This replaces libxml2, which was used -prior to 4.6.4.)

        +tDOM, REQUIRED.  OpenACS 5.9.0 stores +queries in XML files, so we use an AOLserver module called tDOM to +parse these files. (This replaces libxml2, which was used prior to +4.6.4.)

      • -tclwebtest, OPTIONAL.  -tclwebtest is a tool for testing web interfaces via Tcl -scripts.

        +tclwebtest, OPTIONAL.  tclwebtest +is a tool for testing web interfaces via Tcl scripts.

      • Web Server.  The web server handles @@ -170,8 +169,8 @@ mod_nsd.

        • -AOLserver 4.x, REQUIRED.  Provides -the base HTTP server

          +AOLserver 4.x, REQUIRED.  Provides the +base HTTP server

        Mat Kovach is graciously maintaining an AOLserver distribution that includes all the patches and modules needed to run OpenACS 5.9.0. These instructions will describe how to install using his @@ -200,36 +199,35 @@

      • -ns_pam 0.1 or newer, -OPTIONAL.  Provides PAM capabilities for -AOLserver. You need this if you want OpenACS users to authenticate -through a PAM module (such as RADIUS).

        +ns_pam 0.1 or newer, OPTIONAL.  +Provides PAM capabilities for AOLserver. You need this if you want +OpenACS users to authenticate through a PAM module (such as +RADIUS).

      • -pam_radius 1.3.16, OPTIONAL.  -Provides RADIUS capabilities for PAM. You need this if you want to -use RADIUS authentication via PAM in OpenACS.

        +pam_radius 1.3.16, OPTIONAL.  Provides +RADIUS capabilities for PAM. You need this if you want to use +RADIUS authentication via PAM in OpenACS.

      • -ns_ldap 0.r8, OPTIONAL.  -Provides LDAP capabilities for AOLserver. You need this if you want -to use LDAP authentication in OpenACS.

        +ns_ldap 0.r8, OPTIONAL.  Provides +LDAP capabilities for AOLserver. You need this if you want to use +LDAP authentication in OpenACS.

      • -OpenFTS Tcl 0.3.2, -OPTIONAL.  Adds full-text-search to PostgreSQL -and includes a driver for AOLserver. You need this if you want -users to be able to search for any text on your site. For postgres -7.4.x and higher, full text search is also available via -tsearch2.

        +OpenFTS Tcl 0.3.2, OPTIONAL.  Adds +full-text-search to PostgreSQL and includes a driver for AOLserver. +You need this if you want users to be able to search for any text +on your site. For postgres 7.4.x and higher, full text search is +also available via tsearch2.

      • -Analog 5.32 or newer, OPTIONAL.  -This program examines web server request logs, looks up DNS values, -and produces a report. You need this if you want to see how much +Analog 5.32 or newer, OPTIONAL.  This +program examines web server request logs, looks up DNS values, and +produces a report. You need this if you want to see how much traffic your site is getting.

      • Balance 3.11 or newer, OPTIONAL.  @@ -239,84 +237,81 @@ production site and do not have an external load balancing system.

      • -Database.  The data on your site -(for example, user names and passwords, calendar entries, and -notes) is stored in the database. OpenACS separates the database -with an abstraction layer, which means that several different -databases all function identically. While you can run the core -OpenACS on any supported database, not all contributed packages -support all databases.

          +Database.  The data on your site (for +example, user names and passwords, calendar entries, and notes) is +stored in the database. OpenACS separates the database with an +abstraction layer, which means that several different databases all +function identically. While you can run the core OpenACS on any +supported database, not all contributed packages support all +databases.

          • Oracle 8.1.7 (Either this or PostgreSQL is -REQUIRED).  You can register and download -Oracle from Oracle -TechNet. You need this if you want to use an Oracle -database.

          • +REQUIRED).  You can register and download Oracle from +Oracle TechNet. You need this if you want to use +an Oracle database.

          • PostgreSQL 7.4.x (Either this or Oracle is REQUIRED).  You need this if you want to use a PostgreSQL database.

        • -Process Controller.  This is -software that initiates other software, and restarts that software -if it fails. On Linux, we recommend using Daemontools to control -AOLserver and qmail.

          • +Process Controller.  This is software that +initiates other software, and restarts that software if it fails. +On Linux, we recommend using Daemontools to control AOLserver and +qmail.

            • -Daemontools 0.76, OPTIONAL.  You -need this if you want AOLserver and qmail to run -"supervised," meaning that they are monitored and -automatically restarted if they fail. An alternative would be to -run the services from inittab.

              +Daemontools 0.76, OPTIONAL.  You need this +if you want AOLserver and qmail to run "supervised," +meaning that they are monitored and automatically restarted if they +fail. An alternative would be to run the services from inittab.

          • -Mail Transport Agent.  A Mail -Transport Agent is a program that handles all incoming and outgoing -mail. The Reference Platform uses Qmail; any MTA that provides a -sendmail wrapper (that is, that can be invoked by calling the -sendmail program with the same variables that sendmail expects) can -be used.

              +Mail Transport Agent.  A Mail Transport +Agent is a program that handles all incoming and outgoing mail. The +Reference Platform uses Qmail; any MTA that provides a sendmail +wrapper (that is, that can be invoked by calling the sendmail +program with the same variables that sendmail expects) can be +used.

              • -Netqmail 1.04, OPTIONAL.  -You need this (or a different Mail Transport Agent) if you want -your webserver to send and receive email.

              • +Netqmail 1.04, OPTIONAL.  You need +this (or a different Mail Transport Agent) if you want your +webserver to send and receive email.

              • -ucspi-tcp 0.88, OPTIONAL.  This -program listens for incoming TCP connections and hands them to a -program. We use it instead of inetd, which is insecure. You need -this if you are running qmail.

              • +ucspi-tcp 0.88, OPTIONAL.  This program +listens for incoming TCP connections and hands them to a program. +We use it instead of inetd, which is insecure. You need this if you +are running qmail.

            • -DocBook, OPTIONAL.  (docbook-xml -v4.4, docbook-xsl v1.56, libxslt 1.0.21, xsltproc 1.0.21). You need -this to write or edit documentation.

            • +DocBook, OPTIONAL.  (docbook-xml v4.4, +docbook-xsl v1.56, libxslt 1.0.21, xsltproc 1.0.21). You need this +to write or edit documentation.

            • -Source Control.  A Source Control -system keeps track of all of the old versions of your files. It -lets you recover old files, compare versions of file, and identify -specific versions of files. You can use any source control system; -the Reference Platform and the OpenACS.org repository (where you -can get patched and development code in between releases) use -cvs.

              • +Source Control.  A Source Control system +keeps track of all of the old versions of your files. It lets you +recover old files, compare versions of file, and identify specific +versions of files. You can use any source control system; the +Reference Platform and the OpenACS.org repository (where you can +get patched and development code in between releases) use cvs.

                • -cvs 1.11.18, OPTIONAL.  cvs is -included in most unix distributions. You need this if you want to -track old versions of your files, do controlled deployment of code -from development to production, or get or contribute development -code from openacs.org.

                +cvs 1.11.18, OPTIONAL.  cvs is included in +most unix distributions. You need this if you want to track old +versions of your files, do controlled deployment of code from +development to production, or get or contribute development code +from openacs.org.

            • -

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

            +

          ($‌Id: software.xml,v 1.28 2018/03/24 +00:14:57 hectorr Exp $)

        - + leftLink="install-steps" leftLabel="Prev" leftTitle="Basic Steps" + rightLink="complete-install" rightLabel="Next" rightTitle="Chapter 3. Complete +Installation" + homeLink="index" homeLabel="Home" + upLink="install-overview" upLabel="Up"> + \ No newline at end of file