Index: openacs-4/packages/acs-core-docs/www/bootstrap-acs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/bootstrap-acs.html,v diff -u -r1.8.2.1 -r1.8.2.2 --- openacs-4/packages/acs-core-docs/www/bootstrap-acs.html 24 Nov 2002 21:29:17 -0000 1.8.2.1 +++ openacs-4/packages/acs-core-docs/www/bootstrap-acs.html 29 Mar 2003 20:44:52 -0000 1.8.2.2 @@ -1,5 +1,5 @@ -Bootstrapping OpenACS

Bootstrapping OpenACS

+Bootstrapping OpenACS

Bootstrapping OpenACS

by Jon Salz
OpenACS docs are written by the named authors, but may be edited by OpenACS documentation staff. @@ -34,11 +34,11 @@ by trimming the final component from the path to the Tcl library directory (/web/yourservername/tcl). But 0-acs-init.tcl's has an important function, namely sourcing -/packages/acs-core/bootstrap.tcl, which does the following:

  1. Initialize some NSVs used by the core. These NSVs are +/packages/acs-core/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 +

    3. 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 @@ -47,18 +47,18 @@ bootstrap.tcl scans through this list, logging error messages to the log if any of these files exist. -

    4. Source *-procs.tcl files in the OpenACS core. +

    5. 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 the following steps. -

    6. Ensure that the database is available by grabbing and +

    7. Ensure that the database is available by grabbing and releasing a handle. If we can't obtain a handle, we terminate initialization (since OpenACS couldn't possibly start up the server without access to the database). -

    8. Register any new packages in the /packages -directory. In each directory inside /packages, we look +

    9. Register any new packages in the /packages +directory. In each directory inside /packages, we look for a .info file; if we find a package that hasn't yet been registered with the package manager (i.e., it's been copied there manually), we insert information about it into the database. (The first time @@ -68,23 +68,23 @@ initially disabled; they must be manually enabled in the package manager before they can be used. -

    10. Ensure that the acs-kernel package is -enabled. If the OpenACS core isn't initialized, the server +

    11. Ensure that the acs-kernel package is +enabled. If the OpenACS core isn't initialized, the server couldn't possibly be operational, so if there's no enabled version of the OpenACS core we simply mark the latest installed one as enabled. -

    12. Load *-procs.tcl files for enabled -packages, activating their APIs. +

    13. Load *-procs.tcl files for enabled +packages, activating their APIs. -

    14. Load *-init.tcl files for enabled packages, +

    15. Load *-init.tcl files for enabled packages, giving packages a chance to register filters and procedures, initialize data structures, etc. -

    16. Verify that the core has been properly initialized by +

    17. Verify that the core has been properly initialized by checking for the existence of an NSV created by the request processor initialization code. If it's not present, the server won't be operational, so we log an error.

    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$)
View comments on this page at openacs.org
+

($Id$)
View comments on this page at openacs.org