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

-Bootstrapping OpenACS

<authorblurb>

By Jon Salz -

</authorblurb>
  • Tcl code: /tcl/0-acs-init.tcl and -/packages/acs-kernel/bootstrap.tcl

This document describes the startup (bootstrapping) process for +Bootstrapping OpenACS

+

By Jon Salz +

+OpenACS docs are written by the named authors, and may be edited by +OpenACS documentation staff.
  • Tcl code: /tcl/0-acs-init.tcl and +/packages/acs-bootstrap-installer/bootstrap.tcl

This document describes the startup (bootstrapping) process for an AOLserver running OpenACS.

The Big Picture

Before OpenACS 3.3, the OpenACS startup process was extremely @@ -29,38 +32,30 @@ AOLserver/OpenACS startup.

-The Startup Process

As soon as the nsd daemon is -executed by the init process -(or otherwise), AOLserver reads its configuration file and -chroots itself if necessary. It -then loads shared libraries indicated in the .ini file (e.g., the Oracle driver and -nssock), and sources Tcl module -files (generally in /home/aol30/modules/tcl). This step is, and -has always been, the same for all AOLservers, regardless of whether -they are running OpenACS.

Next AOLserver sources, in lexicographical order, each file in +The Startup Process

When nsd is started, it +reads its configuration file and chroots itself if necessary. It then loads +the configured modules (e.g., Database and network drivers, Tcl +module files). This step is, and has always been, the same for all +NaviServer/AOLservers, regardless of whether they are running +OpenACS (see the NaviServer/AOLserver documentation for more +details).

Next AOLserver sources, in lexicographical order, each file in the /tcl directory. The first such file is 0-acs-init.tcl, which doesn't do much directly except to determine the OpenACS path root (e.g., /var/lib/aolserver/yourservername) by trimming the final component from the path to the Tcl library directory (/var/lib/aolserver/yourservername/tcl). But 0-acs-init.tcl's has an -important function, namely sourcing /packages/acs-core/bootstrap.tcl, which -does the following:

    +important function, namely sourcing /packages/acs-bootstrap-installer/bootstrap.tcl, +which does the following:

    1. Initialize some NSVs used by the core. These NSVs are documented in /packages/acs-core/apm-procs.tcl - no need to worry about them unless you're an OpenACS core hacker.

    2. -Verify the deletion of obsolete -OpenACS files. The /tcl directory has evolved quite a bit over -the months and years, and a few files have come and gone. The -/www/doc/removed-files.txt file -contains a list of files which must be -deleted from the AOLserver installation, at the risk of -causing weird conflicts, e.g., having several security filters -registered. bootstrap.tcl scans -through this list, logging error messages to the log if any of -these files exist.

    3. +Verify that OpenACS is fully +installed. If not (e.g. at the first installation) +it prompts a form for providing essential information about the +installation.

    4. Source *-procs.tcl files in the OpenACS core. We source each file matching the *-procs.tcl glob in the /packages/acs-kernel directory, in lexicographical order. These procedure are needed to perform any of @@ -100,8 +95,8 @@

    At this point, bootstrap.tcl is done executing. AOLserver proceeds to source the remaining files in the /tcl directory (i.e., -unpackaged libraries) and begins listening for connections.

    ($‌Id: bootstrap-acs.xml,v 1.7 2006/07/17 -05:38:38 torbenb Exp $)

    +unpackaged libraries) and begins listening for connections.

    ($‌Id: bootstrap-acs.xml,v 1.7 2006/07/17 +05:38:38 torbenb Exp $)