OpenACS

> 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

Show less