eng-standards-constraint-naming.html

Fixed:

> missing link to http://openacs.org/doc/openacs-4-6-2/files/analog-dev.cfg.txt
> http://openacs.org/doc/openacs-4-6-2/individual-programs.html

Removed the link altogether - removed all links to files actually in
the tarball

----------------------------------------------------------------------

> I'm running Mandrake 9.1 on my new workstation here, and when all the docbook
> stuff's installed there's a convenient "xsl-stylesheets" symbolic link to

Using symlink in openacs.xsl

----------------------------------------------------------------------

In qmail section, link to download page for ucspi and qmail

----------------------------------------------------------------------

>Which is the best keyword for "your service name?" in the docs. It should be
>easily recognized as a placeholder, easy to search-replace, and should
>be generic enough that most users can leave it unchanged. Currently we use
>"service0", which meets the last two of the three requirements.
>Earlier docs used "birdnotes," which met the first two requirements.

Decided I didn't care

----------------------------------------------------------------------

>Red Hat 9 issue:
>code change to compile daemontools and qmail

>http://www.riverside.org/archive/html/djbdns/2003-01/msg00307.html
>http://article.gmane.org/gmane.mail.qmail.general/13960
>put "#include <errno.h>" in /usr/local/src/postgresql-7.2.3/src/include/postgres.h

Added comment to instructions

----------------------------------------------------------------------

> Add text about which version of PostgreSQL works to top of that
section.

added.

----------------------------------------------------------------------

>First, in http://openacs.org/doc/openacs-4-6-2/postgres.html the make
>install didn't work for me when I used postgres so I had to use root and
>then do 'chown -R postgres.web /usr/local/pgsql'

Could not repro.

----------------------------------------------------------------------

> Second, in the [postgres.html] doc, in point 8 for Red Hat, why is
> there chmod 700 for the script? All the other scripts in
> /etc/rc.d/init.d are 755.

Changed to 755.

----------------------------------------------------------------------

>Optimizing Postgres:
>should optimize kernel settings for Postgres
>http://developer.postgresql.org/docs/postgres/kernel-resources.html

Added postgres tuning instructions

----------------------------------------------------------------------
>For compiling nsopenssl, this was necessary on Debian:

>apt-get install libssl-dev
>make OPENSSL=/usr/lib/ssl

>nsopenssl needs 0.9.6 or newer. Debian stable currently runs openssl
>0.9.6c

Added note.
----------------------------------------------------------------------

>If you are on Oracle, you have to su - oracle, then su to root to get
>your environment right. Otherwise, nsoracle won't compile.

Added note.

----------------------------------------------------------------------
>The web user wasn't added in the Oracle install step, so I added it
>now: groupadd web

Already mentioned in the doc.

----------------------------------------------------------------------

>For some reason, the include and sample-config.tcl files were owned by
>500.500 instead of root root. So:
>chown -R root.root include sample.config.tcl

owned by remadmin in reference platform. Seems harmless so didn't add anything to instructions.

----------------------------------------------------------------------
>bin and lib were group owned by staff. I changed that to root as well:
>chown -R root.root bin lib modules

could not repro
----------------------------------------------------------------------
> We should be recommending at least ANALYZE (by itself). If we are
> going to recommend VACUUM, we should recommend VACUUM ANALYZE once an
> hour (or so) and a VACUUM FULL ANALYZE once a night.

Changed default suggestion to --analyze (once per day) to be conservative due to forum thread about full analyze affecting performance due to locking

----------------------------------------------------------------------

> Red hat 9: Stock SSL doesn't work - kerberos problem and also not compiled with
> thread support. (there's an OpenACS thread to fix this)

>http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=84331
> edit nsopenssl Makefile to say

> CFLAGS += -I$(OPENSSL)/include <b>-I/usr/kerberos/include<b>

Added pointer to thread