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
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.
Before OpenACS 3.3, the OpenACS startup process was extremely @@ -29,38 +32,30 @@ AOLserver/OpenACS startup.
As soon as the nsd
daemon is
-executed by the init
process
-(or otherwise), AOLserver reads its configuration file and
-chroot
s 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 chroot
s 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:
/packages/acs-bootstrap-installer/bootstrap.tcl
,
+which does the following:
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.
-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.
+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.
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.