Index: openacs-4/packages/acs-developer-support/www/doc/index.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-developer-support/www/doc/index.html,v diff -u -r1.1 -r1.2 --- openacs-4/packages/acs-developer-support/www/doc/index.html 20 Apr 2001 20:51:09 -0000 1.1 +++ openacs-4/packages/acs-developer-support/www/doc/index.html 7 Aug 2017 23:47:56 -0000 1.2 @@ -1,12 +1,12 @@ -Developer Support +ACS Developer Support -

Developer Support

+

ACS Developer Support

-part of the ArsDigita Community System, by Jon Salz +

part of the ArsDigita Community System, by Jon Salz


@@ -20,14 +20,14 @@ -

The Big Picture

- +

The Big Picture

+

Software development is a big feedback loop: a developer writes something, tests it, and then repeats until the results are satisfactory. It's important to streamline this cycle by having a development environment which makes it easy to analyze what the software is doing under the hood. -

Peeking Under the Hood

+

Peeking Under the Hood

Our development environment previously consisted largely of Emacs, and tail -f /web/servername/log/servername-error.log. Now this has been augmented: @@ -52,7 +52,7 @@ administrator! Revealing this information to anyone else would pose a huge security risk. -

Comments

+

Comments

Tired of using ns_log to instrument your code, then grokking the error log to see what's wrong with your page? Use the ds_comment routine instead: @@ -66,31 +66,26 @@

Comments are displayed even if an error occurs in the page!

Enabling It

+

+Load the packate acs-developer-support via package manager, +browse to /ds and enable the desired options. +

+Be careful of you enable developer support on busy production systems - they probably +incur a performance hit. -Add the following to your -parameters/yourservername.ini file: - -

[ns/server/yourservername/acs/developer-support]
-; remember information about connections, for developers' benefit?
-EnabledP=1
-; remember information about every database request?
-DatabaseEnabledP=1
-; remember information for which client hosts?
-EnabledIPs=*
-; remember this information for how long? sweep how often? (in seconds)
-DataLifetime=900
-DataSweepInterval=900
- -Note that you may not want to enable this stuff for production systems - they probably -incur a slight performance hit (although this hasn't been benchmarked). - -

How It Works

- +

How It Works

+

The security subsystem registers preauth and trace filters which store relevant connection information in shared variables (nsvs). The security subsystem also renames the AOLserver ns_db procedure and registers a wrapper which aggregates information about database queries. +

+Example output of ACS +Developer Support. +

Release Notes

+ +

Please file bugs in the Bug Tracker.


jsalz@mit.edu