Configuring an OpenACS package

Prev	Part III. For OpenACS Package Developers	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

New API
Feature	Status	Description

Prev	Chapter 15. Kernel Documentation	Next

Prev	Chapter 15. Kernel Documentation	Next

New API
Feature	Status	Description
EXT-AUTH-01	A	Extend Authentication/Acct Status API
EXT-AUTH-03	A	Account Creation API
EXT-AUTH-05	A	Password Management API
EXT-AUTH-30	A	Authority Management API

Login
Feature	Status	Description
EXT-AUTH-04	A	Rewrite login, register, and admin pages to use APIs
EXT-AUTH-38	A	ad_form complain feature
EXT-AUTH-19	A	Rewrite password recovery to use API
EXT-AUTH-21	A	Rewrite email verification with API
EXT-AUTH-28	A	Username is email switch

New API
Feature	Status	Description
EXT-AUTH-01	A	Extend Authentication/Acct Status API
EXT-AUTH-03	A	Account Creation API
EXT-AUTH-05	A	Password Management API
EXT-AUTH-30	A	Authority Management API

Login
Feature	Status	Description
EXT-AUTH-04	A	Rewrite login, register, and admin pages to use APIs
EXT-AUTH-38	A	ad_form complain feature
EXT-AUTH-19	A	Rewrite password recovery to use API
EXT-AUTH-21	A	Rewrite email verification with API
EXT-AUTH-28	A	Username is email switch

Prev	Chapter 6. Production Environments	Next

Prev	Chapter 6. Production Environments	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

Prev	Chapter 4. Configuring a new OpenACS Site	Next

		Next

		Next

Prev	Appendix B. Install additional supporting software	Next

Prev	Appendix B. Install additional supporting software	Next

Table 6.1. How it +

Table 6.1. How it Works

Index: openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html,v diff -u -r1.24.2.1 -r1.24.2.2 --- openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html 23 Sep 2015 11:54:37 -0000 1.24.2.1 +++ openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html 28 Sep 2015 07:54:19 -0000 1.24.2.2 @@ -64,6 +64,6 @@ Most of this information comes from Tom Jackson's AOLserver+Daemontools Mini-HOWTO. -
Table 6.1. How it Works

Program Invoked by this program ... ... using this file Where to find errors Log goes to Use these commands to control it

svscanboot +

Table 6.1. How it Works

Program	Invoked by this program ...	... using this file	Where to find errors	Log goes to	Use these commands to control it
svscanboot	init	/etc/inittab	ps -auxw \| grep readproctitle	n/a
aolserver	supervise (a child of svscanboot)	/service/$OPENACS_SERVICE_NAME/run	/var/lib/aolserver/$OPENACS_SERVICE_NAME/log/error.log	/var/lib/aolserver/$OPENACS_SERVICE_NAME/log/$OPENACS_SERVICE_NAME.log	svc -k /service/$OPENACS_SERVICE_NAME
postgresql	Redhat init scripts during boot	/etc/init.d/postgresql	/usr/local/pgsql/data/server.log		service postgresql start (Red Hat), /etc/init.d/postgresql start (Debian)

Prev	Home	Next
Chapter 6. Production Environments	Up	AOLserver keepalive with inittab

docs@openacs.org

View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/install-qmail.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-qmail.adp,v diff -u -r1.1.2.1 -r1.1.2.2 --- openacs-4/packages/acs-core-docs/www/install-qmail.adp 23 Sep 2015 11:54:38 -0000 1.1.2.1 +++ openacs-4/packages/acs-core-docs/www/install-qmail.adp 28 Sep 2015 07:54:19 -0000 1.1.2.2 @@ -48,7 +48,7 @@ ] [ -b backlog ] [ -l localname ] [ -t timeout ] host port program [root ucspi-tcp-0.88]#

- (I'm not sure if this next step is 100% + (I'm not sure if this next step is 100% necessary, but when I skip it I get problems. If you get the error 553 sorry, that domain isn't in my list of allowed rcpthosts (#5.7.1) then you need to do @@ -68,7 +68,7 @@

-Install Qmail. +Install Qmail.

Download qmail, set up the standard supporting users and build the binaries:

@@ -131,7 +131,7 @@
 ./collate.sh
 cd netqmail-1.04
 make setup check
-

Replace sendmail with qmail's wrapper.

 [root qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail
 [root qmail-1.03]# ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail
 [root qmail-1.03]#
@@ -170,7 +170,7 @@
 chmod 644 ~alias/.qmail* 
 /var/qmail/bin/maildirmake ~alias/Maildir/ 
 chown -R alias.nofiles /var/qmail/alias/Maildir
-

Configure qmail to use the Maildir delivery format (instead of +

Configure qmail to use the Maildir delivery format (instead of mbox), and install a version of the qmail startup script modified to use Maildir.

 [root alias]# echo "./Maildir" > /var/qmail/bin/.qmail
Index: openacs-4/packages/acs-core-docs/www/install-qmail.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-qmail.html,v
diff -u -r1.41.2.1 -r1.41.2.2
--- openacs-4/packages/acs-core-docs/www/install-qmail.html	23 Sep 2015 11:54:38 -0000	1.41.2.1
+++ openacs-4/packages/acs-core-docs/www/install-qmail.html	28 Sep 2015 07:54:19 -0000	1.41.2.2
@@ -30,7 +30,7 @@
 tcpserver: usage: tcpserver [ -1UXpPhHrRoOdDqQv ] [ -c limit ] [ -x rules.cdb ] [ -B banner ] [ -g gid ] [ -u uid
 ] [ -b backlog ] [ -l localname ] [ -t timeout ] host port program
 [root ucspi-tcp-0.88]#
-

(I'm not sure if this next step is 100% necessary, but when I skip it I get problems. If you get the error 553 sorry, that domain isn't in my list of allowed rcpthosts (#5.7.1) then you need to do this.) AOLserver sends outgoing mail via the ns_sendmail command, which pipes a command to the sendmail executable. Or, in our @@ -44,7 +44,7 @@ send outgoing mail.

[root ucspi-tcp-0.88]# cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp
 [root ucspi-tcp-0.88]# tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp
 cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp 
-tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp

Install Qmail.

Download qmail, +tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp

Install Qmail.

Download qmail, set up the standard supporting users and build the binaries:

[root root]# cd /usr/local/src
 [root src]# wget http://www.qmail.org/netqmail-1.04.tar.gz
 [root src]# tar xzf netqmail-1.04.tar.gz
@@ -103,7 +103,7 @@
 cd netqmail-1.04
 ./collate.sh
 cd netqmail-1.04
-make setup check

Replace sendmail with qmail's wrapper.

[root qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail
+make setup check

Replace sendmail with qmail's wrapper.

[root qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail
 [root qmail-1.03]# ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail
 [root qmail-1.03]#
 rm -f /usr/bin/sendmail /usr/sbin/sendmail
@@ -125,7 +125,7 @@
 cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root 
 chmod 644 ~alias/.qmail* 
 /var/qmail/bin/maildirmake ~alias/Maildir/ 
-chown -R alias.nofiles /var/qmail/alias/Maildir

Configure qmail to use the Maildir delivery format +chown -R alias.nofiles /var/qmail/alias/Maildir

Configure qmail to use the Maildir delivery format (instead of mbox), and install a version of the qmail startup script modified to use Maildir.

[root alias]# echo "./Maildir" > /var/qmail/bin/.qmail
 [root alias]# cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc
 [root alias]# chmod 755 /var/qmail/rc
Index: openacs-4/packages/acs-core-docs/www/install-redhat.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-redhat.adp,v
diff -u -r1.1.2.1 -r1.1.2.2
--- openacs-4/packages/acs-core-docs/www/install-redhat.adp	23 Sep 2015 11:54:38 -0000	1.1.2.1
+++ openacs-4/packages/acs-core-docs/www/install-redhat.adp	28 Sep 2015 07:54:19 -0000	1.1.2.2
@@ -37,7 +37,7 @@
 
 Unplug
 the network cable from your computer. We don't want to connect to
-the network until we're sure the computer is secure. 
+the network until we're sure the computer is secure. 
 (Wherever you see the word secure, you should always read it as,
 "secure enough for our purposes, given the amount of work we're
 willing to exert and the estimated risk and consequences.")
Insert Red Hat 8.0 or 9.0 Disk 1 into the CD-ROM and reboot the
@@ -76,7 +76,7 @@
 screen

Configure Networking. Again, if you +

Configure Networking. Again, if you know what you're doing, do this step yourself, being sure to note the firewall holes. Otherwise, follow the instructions in this step to set up a computer directly connected to the internet with a @@ -105,7 +105,7 @@ development server we'll be setting up.

-Select any additional languages you want +Select any additional languages you want the computer to support and then click Next

Choose your time zone and click @@ -120,11 +120,11 @@ don't install a database or web server, because that would conflict with the database and web server we'll install later.

check Editors -(this installs emacs),

click Details next +(this installs emacs),

click Details next to Text-based Internet, check lynx, and click

OK

;

check

Authoring and
-Publishing

(this installs +Publishing (this installs docbook),

uncheck

Server Configuration
 Tools

uncheck

Web
 Server

uncheck

Windows File
@@ -149,7 +149,7 @@
 will appear.

 uncheck apmd
 (monitors power, not very useful for servers),
check ImageMagick
-(required for the photo-album packages,
uncheckisdn4k-utils
+(required for the photo-album packages,
uncheckisdn4k-utils
 (unless you are using isdn, this installs a useless daemon),
check mutt (a mail
 program that reads Maildir),
uncheck nfs-utils
 (nfs is a major security risk),
uncheck pam-devel (I
@@ -195,7 +195,7 @@
 Lock down SSH

 
 
- SSH is the protocol we use to connect
+ SSH is the protocol we use to connect
 securely to the computer (replacing telnet, which is insecure).
 sshd is the daemon that listens for incoming ssh connections. As a
 security precaution, we are now going to tell ssh not to allow
Index: openacs-4/packages/acs-core-docs/www/install-redhat.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-redhat.html,v
diff -u -r1.41.2.1 -r1.41.2.2
--- openacs-4/packages/acs-core-docs/www/install-redhat.html	23 Sep 2015 11:54:38 -0000	1.41.2.1
+++ openacs-4/packages/acs-core-docs/www/install-redhat.html	28 Sep 2015 07:54:19 -0000	1.41.2.2
@@ -27,7 +27,7 @@
 	
Unplug the network cable from your
           computer.  We don't want to connect to the network
           until we're sure the computer is secure.  
-           
+           
   (Wherever you see
           the word secure, you should always read it as, "secure
           enough for our purposes, given the amount of work we're
@@ -55,7 +55,7 @@
 Review (and modify if needed) the partitions created and click Next
On the pop-up window asking "Are you sure
 	  you want to do this?" click
 	  Yes
-	  IF YOU ARE WIPING YOUR HARD DRIVE.
Click Next on the boot loader screen
Configure Networking.  
+	  IF YOU ARE WIPING YOUR HARD DRIVE.
Click Next on the boot loader screen
Configure Networking.  
 Again, if you know what you're doing, do this step
           yourself, being sure to note the firewall holes. Otherwise,
           follow the instructions in this step to set up a computer directly connected to the internet with a dedicated IP address.
DHCP is a system by which a computer that
@@ -76,7 +76,7 @@
 Mail (SMTP).  In the Other ports
 box, enter 443, 8000, 8443.  Click
 Next.
-Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.
Select any additional languages you want the
+Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.
Select any additional languages you want the
 	  computer to support and then click
 	  Next
Choose your time zone and click Next.
Type in a root
 password, twice.
On the Package selection page, we're going to
@@ -88,13 +88,13 @@
 risk that's still screened by the firewall, or a resource hog.  Just
 don't install a database or web server, because that would conflict
 with the database and web server we'll install later.
-
check Editors (this installs emacs),
click Details next to Text-based Internet, check lynx, and click OK;
check Authoring and Publishing (this installs docbook),
uncheck Server Configuration Tools,
uncheck Web Server,
uncheck Windows File Server,
check SQL Database Server (this installs PostgreSQL),
check Development Tools (this installs gmake and other build tools),
uncheck Administration Tools, and
uncheck Printing Support.
At the bottom, check Select Individual Packages and click Next
We need to fine-tune the exact list of packages.
+
check Editors (this installs emacs),
click Details next to Text-based Internet, check lynx, and click OK;
check Authoring and Publishing (this installs docbook),
uncheck Server Configuration Tools,
uncheck Web Server,
uncheck Windows File Server,
check SQL Database Server (this installs PostgreSQL),
check Development Tools (this installs gmake and other build tools),
uncheck Administration Tools, and
uncheck Printing Support.
At the bottom, check Select Individual Packages and click Next
We need to fine-tune the exact list of packages.
 The same rules apply as in the last step - you can add more stuff, but
 you shouldn't remove anything the guide adds.  We're going to go
 through all the packages in one big list, so select
 Flat
 View and wait. In a minute, a
-list of packages will appear.
uncheck apmd (monitors power, not very useful for servers), 
check ImageMagick (required for the photo-album packages, 
uncheckisdn4k-utils (unless you are using isdn, this installs a useless daemon), 
check mutt (a mail program that reads Maildir),
uncheck nfs-utils (nfs is a major security risk), 
uncheck pam-devel (I don't remember why, but we don't want this), 
uncheck portmap, 
uncheck postfix (this is an MTA, but we're going to install qmail later), 
check  postgresql-devel,
uncheck rsh (rsh is a security hole), 
uncheck sendmail (sendmail is an insecure MTA; we're going to install qmail instead later),
check tcl (we need tcl), and 
uncheck xinetd (xinetd handles incoming tcp connections.  We'll install a different, more secure program, ucspi-tcp).
Click Next
Red Hat isn't completely happy with the combination
+list of packages will appear.
uncheck apmd (monitors power, not very useful for servers), 
check ImageMagick (required for the photo-album packages, 
uncheckisdn4k-utils (unless you are using isdn, this installs a useless daemon), 
check mutt (a mail program that reads Maildir),
uncheck nfs-utils (nfs is a major security risk), 
uncheck pam-devel (I don't remember why, but we don't want this), 
uncheck portmap, 
uncheck postfix (this is an MTA, but we're going to install qmail later), 
check  postgresql-devel,
uncheck rsh (rsh is a security hole), 
uncheck sendmail (sendmail is an insecure MTA; we're going to install qmail instead later),
check tcl (we need tcl), and 
uncheck xinetd (xinetd handles incoming tcp connections.  We'll install a different, more secure program, ucspi-tcp).
Click Next
Red Hat isn't completely happy with the combination
 of packages we've selected, and wants to satisfy some dependencies.
 Don't let it.  On the next screen, choose
 Ignore Package
@@ -120,7 +120,7 @@
         upgrading all of that.  Since you are upgrading the kernel,
         reboot after this step.
 
Lock down SSH

-              
+              
               SSH is the protocol we use to connect
               securely to the computer (replacing telnet, which is
               insecure).  sshd is the daemon that listens for incoming
Index: openacs-4/packages/acs-core-docs/www/install-steps.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-steps.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/install-steps.adp	23 Sep 2015 18:51:43 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/install-steps.adp	28 Sep 2015 07:54:19 -0000	1.1.2.4
@@ -9,7 +9,8 @@
 		    rightLink="individual-programs" rightLabel="Next">
 		

 
-Basic Steps
The basic steps for installing OpenACS are:

+Basic Steps
Most of the documentation in this section is kept as a
+reference. More up-to-date documentation is in the install sections in the Wiki.
The basic steps for installing OpenACS are:

 Install an OS and supporting software (see Install a
 Unix-like OS or Appendix A,
 Install Red Hat 8/9
@@ -105,8 +106,8 @@
 

 
 
-Paths and Users

-Table 2.1. Default
+Paths and Users

+Table 2.1. Default
 directories for a standard install
@@ -117,7 +118,7 @@
 
@@ -179,8 +180,8 @@
 are failing with the accompanying error. If there's a SQL error in
 the Tcl error or in the log, post that too.
If you find errors in this document or if you have ideas about
 making it better, please post them in our BugTracker.
-($Id: install-steps.html,v 1.35.2.1 2015/09/23
-11:54:39 gustafn Exp $)
+($‌Id: overview.xml,v 1.29 2014/10/27 16:39:31
+victorg Exp $)

-Basic Steps
 
 
name of administrative access account remadmin
 

 OpenACS service 
-$OPENACS_SERVICE_NAME (set to service0
+$OPENACS_SERVICE_NAME (set to service0
 in default install)
 

 OpenACS service account $OPENACS_SERVICE_NAME
 
 
 
Prev Chapter 2. Installation Overview  Next
Basic Steps

+Basic Steps
Prev Chapter 2. Installation Overview  Next
Basic Steps
Most of the documentation in this section is kept as a
+    reference. More up-to-date documentation is in the install
+    sections in the Wiki.
+  

     The basic steps for installing OpenACS are:
   
Install an OS and supporting software (see Install a Unix-like OS or Appendix A, Install Red Hat 8/9 for more details).  See the Table 2.2, “Version Compatibility Matrix”.
Install a database (see the section called “Install Oracle 8.1.7” or
         Install PostgreSQL).
 Install AOLserver (Install AOLserver 4) .
Create a unique database and system user.
@@ -41,7 +44,7 @@
 su - $OPENACS_SERVICE_NAME
 svc -d /service/$OPENACS_SERVICE_NAME
 dropdb $OPENACS_SERVICE_NAME
-createdb $OPENACS_SERVICE_NAME
Setting a global shell variable for cut and paste. In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME.  In order to set it globally so that it works for any new users or special service users you may create, edit the file /etc/profile ( /etc/share/skel/dot.profile for FreeBSD) and add this line:
export OPENACS_SERVICE_NAME=service0
Paths and Users
Table 2.1. Default directories for a standard install

-Fully qualified domain name of your server yourserver.test
name of administrative access account remadmin
OpenACS service 
+createdb $OPENACS_SERVICE_NAMESetting a global shell variable for cut and paste. In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME.  In order to set it globally so that it works for any new users or special service users you may create, edit the file /etc/profile ( /etc/share/skel/dot.profile for FreeBSD) and add this line:
export OPENACS_SERVICE_NAME=service0
Paths and Users
Table 2.1. Default directories for a standard install
Fully qualified domain name of your server yourserver.test
name of administrative access account remadmin
OpenACS service 
                 $OPENACS_SERVICE_NAME (set to service0 in default install)
OpenACS service account $OPENACS_SERVICE_NAME
OpenACS database name $OPENACS_SERVICE_NAME
Root of OpenACS service file tree (SERVERROOT) /var/lib/aolserver/$OPENACS_SERVICE_NAME
Location of source code tarballs for new software /var/tmp
The OpenACS tarball contains some files which
                 are useful while setting up other software.  Those
                 files are located at: /var/tmp/openacs-5.7.0/packages/acs-core-docs/www/files
Database backup directory /var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup
Service config files /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
Service log files /var/lib/aolserver/$OPENACS_SERVICE_NAME/log
Compile directory /usr/local/src
PostgreSQL directory /usr/local/pgsql
AOLserver directory /usr/local/aolserver


Index: openacs-4/packages/acs-core-docs/www/ix01.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/ix01.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/ix01.adp	23 Sep 2015 18:37:45 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/ix01.adp	28 Sep 2015 07:54:20 -0000	1.1.2.3
@@ -8,7 +8,7 @@
 		    rightLink="" rightLabel="">
 		

 
-Index

+Index

 
 Symbols
$OPENACS_SERVICE_NAME, Paths and Users
 
Index: openacs-4/packages/acs-core-docs/www/ix01.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/ix01.html,v
diff -u -r1.29.2.1 -r1.29.2.2
--- openacs-4/packages/acs-core-docs/www/ix01.html	23 Sep 2015 11:54:40 -0000	1.29.2.1
+++ openacs-4/packages/acs-core-docs/www/ix01.html	28 Sep 2015 07:54:20 -0000	1.29.2.2
@@ -1,3 +1,3 @@
 
-IndexPrev  
Index
Symbols
$OPENACS_SERVICE_NAME, Paths and Users
A
AOLserver
configuration, Installation Option 2: Install from tarball
Automated tests, Write automated tests
C
computeroutput
code, Code
cvs
initializing, Initialize CVS (OPTIONAL)
setup, Using CVS with an OpenACS Site
D
daemontools
installation, Install Daemontools (OPTIONAL)
docbook
installation, Install Red Hat 8/9
DocBook
DTD, OpenACS Documentation Strategy: Why DocBook?
emacs configuration for, Add PSGML commands to emacs init file (OPTIONAL)
Document structure, Document Structure
E
emacs
installation, Install Red Hat 8/9
emphasis
bold, italics, Emphasis
F
full text search
installation, Install Tsearch2 module, Install OpenFTS module, Install OpenFTS prerequisites in PostgreSQL instance
G
Graphics
Images, Graphics
I
informaltable
table, Tables
L
language
installation, Install Red Hat 8/9
Linking, Links
lists, Lists
O
OpenACS Package, What a Package Looks Like
P
photo-album
installation (see ImageMagick)
Postgres
Vacuuming, Installation Option 2: Install from tarball
Q
qmail
installation, Install qmail (OPTIONAL)
Maildir, Install qmail (OPTIONAL)
rcpthosts error message, Install qmail (OPTIONAL)
S
sect1, Headlines, Sections
sect2, Headlines, Sections
Sections
Headlines, Headlines, Sections
security
definition, Install Red Hat 8/9
firewall, Install Red Hat 8/9
sendmail
removing, Install qmail (OPTIONAL)
ssh, Install Red Hat 8/9
T
The publish point for new packages should be
+IndexPrev  
Index
Symbols
$OPENACS_SERVICE_NAME, Paths and Users
A
AOLserver
configuration, Installation Option 2: Install from tarball
Automated tests, Write automated tests
C
computeroutput
code, Code
cvs
initializing, Initialize CVS (OPTIONAL)
setup, Using CVS with an OpenACS Site
D
daemontools
installation, Install Daemontools (OPTIONAL)
docbook
installation, Install Red Hat 8/9
DocBook
DTD, OpenACS Documentation Strategy: Why DocBook?
emacs configuration for, Add PSGML commands to emacs init file (OPTIONAL)
Document structure, Document Structure
E
emacs
installation, Install Red Hat 8/9
emphasis
bold, italics, Emphasis
F
full text search
installation, Install Tsearch2 module, Install OpenFTS module, Install OpenFTS prerequisites in PostgreSQL instance
G
Graphics
Images, Graphics
I
informaltable
table, Tables
L
language
installation, Install Red Hat 8/9
Linking, Links
lists, Lists
O
OpenACS Package, What a Package Looks Like
P
photo-album
installation (see ImageMagick)
Postgres
Vacuuming, Installation Option 2: Install from tarball
Q
qmail
installation, Install qmail (OPTIONAL)
Maildir, Install qmail (OPTIONAL)
rcpthosts error message, Install qmail (OPTIONAL)
S
sect1, Headlines, Sections
sect2, Headlines, Sections
Sections
Headlines, Headlines, Sections
security
definition, Install Red Hat 8/9
firewall, Install Red Hat 8/9
sendmail
removing, Install qmail (OPTIONAL)
ssh, Install Red Hat 8/9
T
The publish point for new packages should be
         fixed., Prepare the package for distribution.
U
ulink, Links
upgrade
OpenACS 4.5 to 4.6.x
Linux/Unix, Upgrading 4.5 or higher to 4.6.3
X
XML guidelines, OpenACS Documentation Strategy: Why DocBook?
xref
linkend, Links
xreflabel, Headlines, Sections
Prev Home  
How to Update the translations Up  
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/mac-installation.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/mac-installation.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/mac-installation.adp	23 Sep 2015 18:37:45 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/mac-installation.adp	28 Sep 2015 07:54:20 -0000	1.1.2.3
@@ -11,8 +11,8 @@
 
 OpenACS Installation Guide for Mac OS
 X
See the wiki for an actual guideline: Installing OpenACS on Mac OS X
-
($Id: mac-installation.html,v 1.42.2.1
-2015/09/23 11:54:40 gustafn Exp $)
+
($‌Id: macinstall.xml,v 1.7 2014/10/27 16:39:31
+victorg Exp $)
 
 
-Figure 6.8. Query
+
Figure 6.8. Query
 Analysis example

 


 
@@ -122,7 +122,7 @@
 query, install "autotrace". I usually follow the instructions here
 http://asktom.oracle.com/~tkyte/article1/autotrace.html.

 
-Make sure, that the Oracle CBO works with
+Make sure, that the Oracle CBO works with
 adequate statistics
The Oracle Cost Based optimizer is a piece of software that
 tries to find the "optimal" execution plan for a given SQL
 statement. For that it estimates the costs of running a SQL query
Index: openacs-4/packages/acs-core-docs/www/maint-performance.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maint-performance.html,v
diff -u -r1.29.2.1 -r1.29.2.2
--- openacs-4/packages/acs-core-docs/www/maint-performance.html	23 Sep 2015 11:54:41 -0000	1.29.2.1
+++ openacs-4/packages/acs-core-docs/www/maint-performance.html	28 Sep 2015 07:54:20 -0000	1.29.2.2
@@ -2,7 +2,7 @@
 Diagnosing Performance Problems
Prev Chapter 6. Production Environments  Next
Diagnosing Performance Problems
Did performance problems happen overnight, or did they sneak up on
     you? Any clue what caused the performance problems (e.g. loading 20K
     users into .LRN)
Is the file system out of space?  Is the machine swapping to disk constantly?
Isolating and solving database problems.
Without daily internal maintenance, most databases slowly degrade in performance.  For PostGreSQL, see the section called “Vacuum Postgres nightly”.  For Oracle, use exec dbms_stats.gather_schema_stats('SCHEMA_NAME') (Andrew Piskorski's Oracle notes).
You can track the exact amount of time each database query on a page takes:
Go to Main Site : Site-Wide Administration : Install Software
Click on "Install New Application" in "Install from OpenACS Repository"
Choose "ACS Developer Support">
After install is complete, restart the server.
Browse to Developer Support, which is automatically mounted at /ds.
-              
Turn on Database statistics
Browse directly to a slow page and click "Request Information" at the bottom of the page.
This should return a list of database queries on the page, including the exact query (so it can be cut-paste into psql or oracle) and the time each query took.
Figure 6.8. Query Analysis example

Identify a runaway Oracle query: first, use ps aux or top to get the UNIX process ID of a runaway Oracle process.
Log in to SQL*Plus as the admin:
[$OPENACS_SERVICE_NAME ~]$ svrmgrl
+              
Turn on Database statistics
Browse directly to a slow page and click "Request Information" at the bottom of the page.
This should return a list of database queries on the page, including the exact query (so it can be cut-paste into psql or oracle) and the time each query took.
Figure 6.8. Query Analysis example

Identify a runaway Oracle query: first, use ps aux or top to get the UNIX process ID of a runaway Oracle process.
Log in to SQL*Plus as the admin:
[$OPENACS_SERVICE_NAME ~]$ svrmgrl
 
 Oracle Server Manager Release 3.1.7.0.0 - Production
 
@@ -59,7 +59,7 @@
     

       To be able to get a overview of how Oracle executes a particular query,
       install "autotrace". I usually follow the instructions here http://asktom.oracle.com/~tkyte/article1/autotrace.html.
-    
Make sure, that the Oracle CBO works with adequate statistics

+    
Make sure, that the Oracle CBO works with adequate statistics

     The Oracle Cost Based optimizer is a piece of software that tries to find
     the "optimal" execution plan for a given SQL statement. For that it
     estimates the costs of running a SQL query in a particular way (by default
Index: openacs-4/packages/acs-core-docs/www/maintenance-deploy.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maintenance-deploy.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/maintenance-deploy.adp	23 Sep 2015 18:37:45 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/maintenance-deploy.adp	28 Sep 2015 07:54:20 -0000	1.1.2.3
@@ -11,8 +11,8 @@
 

 Staged Deployment for Production
 Networks

-($Id: maintenance-deploy.html,v 1.24.2.1
-2015/09/23 11:54:41 gustafn Exp $)
By Joel Aufrecht
+
($‌Id: maintenance.xml,v 1.30 2010/12/11
+23:36:32 ryang Exp $)
By Joel Aufrecht
 
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.
This section describes two minimal-risk methods for deploying
@@ -24,7 +24,7 @@
 working configuration safely and quickly.
 

 
-Method 1: Deployment with CVS
With this method, we control the files on a site via CVS. This
+Method 1: Deployment with CVS
With this method, we control the files on a site via CVS. This
 example uses one developmental server (service0-dev) and one
 production server (service0). Depending on your needs, you can also
 have a staging server for extensive testing before you go live. The
@@ -102,7 +102,7 @@
 follow ...
 

 
-Method 2: A/B Deployment
The approach taken in this section is to always create a new
+Method 2: A/B Deployment
The approach taken in this section is to always create a new
 service with the desired changes, running in parallel with the
 existing site. This guarantees control, at least at the final step
 of the process: you know what changes you are about to make because
@@ -118,28 +118,28 @@
 function or risk losing data in the shuffle. It also requires extra
 steps if the database will be affected.

 
-Simple A/B Deployment: Database is not
+Simple A/B Deployment: Database is not
 changed

-Figure 6.2. Simple A/B
+
Figure 6.2. Simple A/B
 Deployment - Step 1

 


-Figure 6.3. Simple A/B
+
Figure 6.3. Simple A/B
 Deployment - Step 2

 


-Figure 6.4. Simple A/B
+
Figure 6.4. Simple A/B
 Deployment - Step 3

 


 

 
-Complex A/B Deployment: Database is
+Complex A/B Deployment: Database is
 changed

-Figure 6.5. Complex A/B
+
Figure 6.5. Complex A/B
 Deployment - Step 1

 


-Figure 6.6. Complex A/B
+
Figure 6.6. Complex A/B
 Deployment - Step 2

 


-Figure 6.7. Complex A/B
+
Figure 6.7. Complex A/B
 Deployment - Step 3

 


 

Index: openacs-4/packages/acs-core-docs/www/maintenance-deploy.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maintenance-deploy.html,v
diff -u -r1.24.2.1 -r1.24.2.2
--- openacs-4/packages/acs-core-docs/www/maintenance-deploy.html	23 Sep 2015 11:54:41 -0000	1.24.2.1
+++ openacs-4/packages/acs-core-docs/www/maintenance-deploy.html	28 Sep 2015 07:54:20 -0000	1.24.2.2
@@ -2,7 +2,7 @@
 Staged Deployment for Production NetworksPrev Chapter 6. Production Environments  Next
Staged Deployment for Production Networks
($Id$)
By Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
This section describes two minimal-risk methods for deploying changes on a production network.  The important characteristics of a safe change deployment include:  (THIS SECTION IN DEVELOPMENT)
Control: You know for sure that the change you are making is the change that you intend to make and is the change that you tested.
Rollback: If anything goes wrong, you can return to the previous working configuration safely and quickly.
Method 1: Deployment with CVS
With this method, we control the files on a site via
+        
This section describes two minimal-risk methods for deploying changes on a production network.  The important characteristics of a safe change deployment include:  (THIS SECTION IN DEVELOPMENT)
Control: You know for sure that the change you are making is the change that you intend to make and is the change that you tested.
Rollback: If anything goes wrong, you can return to the previous working configuration safely and quickly.
Method 1: Deployment with CVS
With this method, we control the files on a site via
       CVS. This example uses one developmental server (service0-dev) and one
       production server (service0). Depending on your needs, you can also
       have a staging server for extensive testing before you go
@@ -67,4 +67,4 @@
 cvs up -Pd index.adp
If you make changes that require changes to the database,
       test them out first on service0-dev, using either -create.sql or
       upgrade scripts. Once you've tested them, you then update and
-      run the upgrade scripts from the package manager. 
The production site can run "HEAD" from cvs.
The drawback to using HEAD as the live code is that you cannot commit new work on the development server without erasing the definition of 'working production code.'  So a better method is to use a tag.  This guarantees that, at any time in the future, you can retrieve exactly the same set of code.  This is useful for both of the characteristics of safe change deployment.  For control, you can use tags to define a body of code, test that code, and then know that what you are deploying is exactly that code.  For rollback, you can use return to the last working tag if the new tag (or new, untagged changes) cause problems.  .... example of using tags to follow ...
Method 2: A/B Deployment
The approach taken in this section is to always create a new service with the desired changes, running in parallel with the existing site.  This guarantees control, at least at the final step of the process: you know what changes you are about to make because you can see them directly.  It does not, by itself, guarantee the entire control chain.  You need additional measures to make sure that the change you are making is exactly and completely the change you intended to make and tested previously, and nothing more.  Those additional measures typically take the form of source control tags and system version numbers.  The parallel-server approach also guarantees rollback because the original working service is not touched; it is merely set aside.
This approach can has limitations.  If the database or file system regularly receiving new data, you must interrupt this function or risk losing data in the shuffle.  It also requires extra steps if the database will be affected.
Simple A/B Deployment: Database is not changed
Figure 6.2. Simple A/B Deployment - Step 1

Figure 6.3. Simple A/B Deployment - Step 2

Figure 6.4. Simple A/B Deployment - Step 3

Complex A/B Deployment: Database is changed
Figure 6.5. Complex A/B Deployment - Step 1

Figure 6.6. Complex A/B Deployment - Step 2

Figure 6.7. Complex A/B Deployment - Step 3

Prev Home  Next
High Availability/High Performance Configurations Up  Installing SSL Support for an OpenACS service
docs@openacs.org
View comments on this page at openacs.org
+      run the upgrade scripts from the package manager. 
The production site can run "HEAD" from cvs.
The drawback to using HEAD as the live code is that you cannot commit new work on the development server without erasing the definition of 'working production code.'  So a better method is to use a tag.  This guarantees that, at any time in the future, you can retrieve exactly the same set of code.  This is useful for both of the characteristics of safe change deployment.  For control, you can use tags to define a body of code, test that code, and then know that what you are deploying is exactly that code.  For rollback, you can use return to the last working tag if the new tag (or new, untagged changes) cause problems.  .... example of using tags to follow ...
Method 2: A/B Deployment
The approach taken in this section is to always create a new service with the desired changes, running in parallel with the existing site.  This guarantees control, at least at the final step of the process: you know what changes you are about to make because you can see them directly.  It does not, by itself, guarantee the entire control chain.  You need additional measures to make sure that the change you are making is exactly and completely the change you intended to make and tested previously, and nothing more.  Those additional measures typically take the form of source control tags and system version numbers.  The parallel-server approach also guarantees rollback because the original working service is not touched; it is merely set aside.
This approach can has limitations.  If the database or file system regularly receiving new data, you must interrupt this function or risk losing data in the shuffle.  It also requires extra steps if the database will be affected.
Simple A/B Deployment: Database is not changed
Figure 6.2. Simple A/B Deployment - Step 1

Figure 6.3. Simple A/B Deployment - Step 2

Figure 6.4. Simple A/B Deployment - Step 3

Complex A/B Deployment: Database is changed
Figure 6.5. Complex A/B Deployment - Step 1

Figure 6.6. Complex A/B Deployment - Step 2

Figure 6.7. Complex A/B Deployment - Step 3

Prev Home  Next
High Availability/High Performance Configurations Up  Installing SSL Support for an OpenACS service
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/object-identity.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/object-identity.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/object-identity.adp	23 Sep 2015 18:37:45 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/object-identity.adp	28 Sep 2015 07:54:20 -0000	1.1.2.3
@@ -50,8 +50,8 @@
 with an integer primary key that is derived from a globally unique
 sequence is the key to eliminating redundant code and replacing it
 with generic object level
-services.
($Id: object-identity.html,v 1.49.2.1
-2015/09/23 11:54:42 gustafn Exp $)
+services.
($‌Id: object-identity.xml,v 1.7 2006/07/17
+05:38:37 torbenb Exp $)
 
 created the package.
 Then, do the following:

 
-Describe the new type to the type
+Describe the new type to the type
 system
First, add an entry to the acs_object_types table with the following
 PL/SQL call:
 begin  
@@ -139,7 +139,7 @@
 attributes, so there is no need for us to define them.
 

 
-Define a table in which to store your
+Define a table in which to store your
 objects
The next thing we do is make a small modification to the data
 model to reflect the fact that each row in the notes table represents something that is
 not only an object of type note, but also an acs_object. The new table definition looks
@@ -163,7 +163,7 @@
 acs_objects.
 

 
-Define a package for type specific
+Define a package for type specific
 procedures
The next step is to define a PL/SQL package for your new type,
 and write some basic procedures to create and delete objects. Here
 is a package definition for our new type:
@@ -210,7 +210,7 @@
 We'll talk about this more later.
 

 
-Define a package body for type specific
+Define a package body for type specific
 procedures
The PL/SQL package body contains the implementations of the
 procedures defined above. The only subtle thing going on here is
 that we must use acs_object.new
@@ -361,8 +361,8 @@
 acs_objects. This means you
 should never use the fields in acs_objects for application-specific
 purposes. This is especially true for the context_id field.
-
($Id: objects.html,v 1.52.2.1 2015/09/23
-11:54:43 gustafn Exp $)
+($‌Id: objects.xml,v 1.9 2006/07/17 05:38:37
+torbenb Exp $)
 
 
 ROOT/packages/notes/sql/oracle/notes-create.sql (ROOT/packages/notes/sql/postgresql/notes-create.sql for the PG version) file created
 when we created the package.  Then, do the following:
-
Describe the new type to the type system

+
Describe the new type to the type system

 First, add an entry to the acs_object_types table with the following PL/SQL call:
 
 begin  
@@ -139,7 +139,7 @@
 because the new type note is a subtype of
 acs_object, it will inherit these attributes, so there is
 no need for us to define them.
-
Define a table in which to store your objects

+
Define a table in which to store your objects

 The next thing we do is make a small modification to the data model to
 reflect the fact that each row in the notes table
 represents something that is not only an object of type
@@ -164,7 +164,7 @@
 use the acs_objects table to find objects will
 transparently find any objects that are instances of any subtype of
 acs_objects.
-
Define a package for type specific procedures

+
Define a package for type specific procedures

 The next step is to define a PL/SQL package for your new type, and
 write some basic procedures to create and delete objects. Here is a
 package definition for our new type:
@@ -212,7 +212,7 @@
 object OBJ was "read only", then any other object that used OBJ as its
 context would also be "read only" by default. We'll talk about this more
 later.
-
Define a package body for type specific procedures

+
Define a package body for type specific procedures

 The PL/SQL package body contains the implementations of the procedures
 defined above. The only subtle thing going on here is that we must use
 acs_object.new to insert a row into
Index: openacs-4/packages/acs-core-docs/www/openacs.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/openacs.adp	23 Sep 2015 18:51:43 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/openacs.adp	28 Sep 2015 07:54:21 -0000	1.1.2.4
@@ -336,7 +336,7 @@
 automate vacuuming is to edit the cron file for the database user.
 Recommended: VACUUM ANALYZE
 every hour and VACUUM FULL
-ANALYZE every day.
+ANALYZE every day.
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ export EDITOR=emacs;crontab -e
 
Add these lines to the file. The vacuum command cleans up
 temporary structures within a PostGreSQL database, and can improve
@@ -370,7 +370,7 @@
 specific port, e.g. port 80. In order for OpenACS to work, you need
 to configure a virtual server. The Reference Platform uses a
 configuration file included in the OpenACS tarball, /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc/config.tcl.
-Open it in an editor to adjust the parameters.
+Open it in an editor to adjust the parameters.
 [root root]# su - $OPENACS_SERVICE_NAME
 
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
@@ -606,8 +606,8 @@
 recovery procedure.
Set up the section called
 “External uptime
 validation”.
-
($Id: openacs.html,v 1.51.2.1 2015/09/23
-11:54:44 gustafn Exp $)
+
($‌Id: openacs.xml,v 1.31 2006/07/17 05:38:37
+torbenb Exp $)
 
 
 su - $OPENACS_SERVICE_NAME
-/usr/local/pgsql/bin/createdb -E UNICODE $OPENACS_SERVICE_NAMEAutomate daily database Vacuuming.  This is a process which cleans out discarded data from the database.  A quick way to automate vacuuming is to edit the cron file for the database user.  Recommended: VACUUM ANALYZE every hour and VACUUM FULL ANALYZE every day.
[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ export EDITOR=emacs;crontab -e
Add these lines to the file.  The vacuum command cleans up temporary structures within a PostGreSQL database, and can improve performance.  We vacuum gently every hour and completely every day.  The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day, and every (*) day of month, month, and day of week.  Type man 5 crontab for more information.
0 1-23 * * * /usr/local/pgsql/bin/vacuumdb --analyze $OPENACS_SERVICE_NAME
+/usr/local/pgsql/bin/createdb -E UNICODE $OPENACS_SERVICE_NAME
Automate daily database Vacuuming.  This is a process which cleans out discarded data from the database.  A quick way to automate vacuuming is to edit the cron file for the database user.  Recommended: VACUUM ANALYZE every hour and VACUUM FULL ANALYZE every day.
[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ export EDITOR=emacs;crontab -e
Add these lines to the file.  The vacuum command cleans up temporary structures within a PostGreSQL database, and can improve performance.  We vacuum gently every hour and completely every day.  The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day, and every (*) day of month, month, and day of week.  Type man 5 crontab for more information.
0 1-23 * * * /usr/local/pgsql/bin/vacuumdb --analyze $OPENACS_SERVICE_NAME
 0 0 * * * /usr/local/pgsql/bin/vacuumdb --full --analyze $OPENACS_SERVICE_NAME
Depending on your distribution, you may receive
                 email when the crontab items are executed. If you
                 don't want to receive email for those crontab items,
@@ -251,7 +251,7 @@
 	  need to configure a virtual server.  The Reference Platform
 	  uses a configuration file included in the OpenACS tarball,
 	  /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc/config.tcl.
-	   Open it in an editor to adjust the parameters.
[root root]# su - $OPENACS_SERVICE_NAME
+	   Open it in an editor to adjust the parameters.
[root root]# su - $OPENACS_SERVICE_NAME
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
 [$OPENACS_SERVICE_NAME etc]$ emacs config.tcl
 

Index: openacs-4/packages/acs-core-docs/www/oracle.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/oracle.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/oracle.adp	23 Sep 2015 18:51:43 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/oracle.adp	28 Sep 2015 07:54:21 -0000	1.1.2.4
@@ -961,8 +961,8 @@
 access to the Oracle system.
 
 
($Id: oracle.html,v 1.49.2.1 2015/09/23
-11:54:44 gustafn Exp $)
+
($‌Id: oracle.xml,v 1.21 2006/07/17 05:38:37
+torbenb Exp $)
 
 
 
 Server file layout
Here is how an OpenACS 5 server is laid out starting from the
 Server root (ROOT):

-Figure 11.1. Server
+
Figure 11.1. Server
 file layout diagram
 ROOT/
     bin/
@@ -65,7 +65,7 @@
  To illustrate
 the general structure of a package, let's see what the package for
 the "notes" application should look like.

-Figure 11.2. Package
+
Figure 11.2. Package
 file layout diagram
 ROOT/
   +-- packages/    APM Root
@@ -136,7 +136,7 @@
 files are not sourced in these directories. This makes it suitable
 for storing icons, css files, javascript, and other static content
 which can be treated this way.

-Table 11.1. Package
+
Table 11.1. Package
 files
@@ -400,8 +400,8 @@
 Additional Reading
 Package Manager Design
Package Manager Requirements
package development
 tutorial
-
($Id: packages.html,v 1.51.2.1 2015/09/23
-11:54:45 gustafn Exp $)
+($‌Id: packages.xml,v 1.9 2006/07/17 05:38:37
+torbenb Exp $)
 
 
 Server file layout

       Here is how an OpenACS 5 server is laid out
       starting from the Server root (ROOT):
-    
Figure 11.1. Server file layout diagram
+    
Figure 11.1. Server file layout diagram
 ROOT/
     bin/
         Various executables and scripts for server maintanence.
@@ -51,7 +51,7 @@
       
       To illustrate the general structure of a package, let's see what the
       package for the "notes" application should look like.
-    
Figure 11.2. Package file layout diagram
+    
Figure 11.2. Package file layout diagram
 ROOT/
   +-- packages/    APM Root
         |
@@ -124,7 +124,7 @@
       directories.  This makes it suitable for storing icons, css
       files, javascript, and other static content which can be treated
       this way.
-    
Table 11.1. Package files

 
 
File Type Its Use Naming Convention
Package Specification File The package specification file is an XML file generated and
+    
Table 11.1. Package files

-File Type Its Use Naming Convention
Package Specification File The package specification file is an XML file generated and
           maintained by the OpenACS Package Manager (APM).  It specifies
           information about the package including its parameters and its
           files. notes.info
Data Model Creation Script 
Index: openacs-4/packages/acs-core-docs/www/parties.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/parties.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/parties.adp	23 Sep 2015 18:37:45 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/parties.adp	28 Sep 2015 07:54:21 -0000	1.1.2.3
@@ -321,8 +321,8 @@
 a membership relation is an ordinary acs object with object
 identity, it is as easy to extend the membership relation to
 store extra information as it is to extend the users table or the
-groups table.
($Id: parties.html,v 1.51.2.1 2015/09/23
-11:54:46 gustafn Exp $)
+groups table.
($‌Id: parties.xml,v 1.9 2006/09/25 20:32:37
+byronl Exp $)
 
 
 Context
 HierarchySuppose objects A,
 B, ..., and F form the following hierarchy.

-Table 11.2. Context
+
Table 11.2. Context
 Hierarchy Example
@@ -156,7 +156,7 @@
 
 
 

 

This can be represented in the acs_objects
 table by the following entries:

-Table 11.3. acs_objects
+
Table 11.3. acs_objects
 example data
Index: openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html,v
diff -u -r1.46.2.1 -r1.46.2.2
--- openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html	23 Sep 2015 11:54:47 -0000	1.46.2.1
+++ openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html	28 Sep 2015 07:54:22 -0000	1.46.2.2
@@ -105,7 +105,7 @@
     
Context Hierarchy

       Suppose objects A, B, ..., 
       and F form the following hierarchy. 
-    
Table 11.2. Context Hierarchy Example

 
 

+    
Table 11.2. Context Hierarchy Example

-
 	      A
 	      
   	        object_id=10
@@ -139,7 +139,7 @@
       This can be represented in the 
       acs_objects table
       by the following entries: 
-    
Table 11.3. acs_objects example data
object_id context_id
20 10
30 10
40 20
50 20
60 30


+    
Table 11.3. acs_objects example data
object_id context_id
20 10
30 10
40 20
50 20
60 30


       The first entry tells us that object 20 is the descendant of object 10, and
       the third entry shows that object 40 is the descendant of object 20. By
       running a CONNECT BY query,
Index: openacs-4/packages/acs-core-docs/www/permissions.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/permissions.adp	23 Sep 2015 18:37:46 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/permissions.adp	28 Sep 2015 07:54:22 -0000	1.1.2.3
@@ -197,8 +197,8 @@
 user rights.
The Context hierarchy allows you to define organize default
 permissions in a hierarchical fashion.
 A PL/SQL or Tcl API is then used to check permissions in
-application pages.
($Id: permissions.html,v 1.50.2.1 2015/09/23
-11:54:47 gustafn Exp $)
+application pages.
($‌Id: permissions.xml,v 1.17 2010/12/11
+23:36:32 ryang Exp $)
 
 
 more information about
 PostgreSQL
 Official PostgreSQL Docs
Migrating from 7.0 to 7.1
techdocs.postgresql.org
PostgreSQL Performance Tuning
-
($Id: postgres.html,v 1.51.2.1 2015/09/23
-11:54:47 gustafn Exp $)
+($‌Id: postgres.xml,v 1.35 2006/07/17 05:38:38
+torbenb Exp $)
 
 
 ns_set get
 to perform lookup by name, they perform a linear lookup, whereas
 arrays use a hash table, so ns_sets are slower than arrays when the
-number of entries is large.
($Id: programming-with-aolserver.html,v
-1.49.2.1 2015/09/23 11:54:48 gustafn Exp $)
+number of entries is large.
($‌Id: programming-with-aolserver.xml,v 1.7
+2014/10/27 16:39:30 victorg Exp $)
 
 
 
 Add PSGML commands to emacs init file
 (OPTIONAL)

- If you plan to write or edit any
+ If you plan to write or edit any
 documentation with emacs, install a customized emacs configuration
 file with DocBook commands in the skeleton directory, so it will be
 used for all new users. The file also fixes the backspace ->
Index: openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html,v
diff -u -r1.41.2.1 -r1.41.2.2
--- openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html	23 Sep 2015 11:54:49 -0000	1.41.2.1
+++ openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html	28 Sep 2015 07:54:23 -0000	1.41.2.2
@@ -1,5 +1,5 @@
 
-Add PSGML commands to emacs init file (OPTIONAL)
Prev Appendix B. Install additional supporting software  Next
Add PSGML commands to emacs init file (OPTIONAL)

+Add PSGML commands to emacs init file (OPTIONAL)
Prev Appendix B. Install additional supporting software  Next
Add PSGML commands to emacs init file (OPTIONAL)

 If you plan to write or edit any documentation with emacs, install a
       customized emacs configuration file with DocBook commands in the skeleton
       directory, so it will be used for all new users.  The file also
Index: openacs-4/packages/acs-core-docs/www/psgml-mode.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/psgml-mode.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/psgml-mode.adp	23 Sep 2015 18:51:43 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/psgml-mode.adp	28 Sep 2015 07:54:23 -0000	1.1.2.4
@@ -146,8 +146,8 @@
 Further reading
Start with the the section called
 “OpenACS Documentation
 Guide”
-
($Id: psgml-mode.html,v 1.48.2.1 2015/09/23
-11:54:49 gustafn Exp $)
+
($‌Id: psgml-mode.xml,v 1.8 2006/07/17 05:38:37
+torbenb Exp $)
 
 
 OpenACS Release Notes
 
 Release 5.9.0 beta

-The release contains the 78 packages of the oacs-5-9 branch.
-These packages contain the OpenACS core packages, major application
-packages (e.g. most the ones used on OpenACS.org), and DotLRN.

-Changes for all packages:

+The release of OpenACS 5.9.0 contains the 78 packages of the
+oacs-5-9 branch. These packages include the OpenACS core packages,
+the major application packages (e.g. most the ones used on
+OpenACS.org), and DotLRN 2.9.0.

+Summary of changes:

 
 SQL:

 Improved performance of acs-object deletion.
Replaced many manual referential integrity calls by built-in
-handing in PostgreSQL.
Removed various manual bookeeping and deletion operations in the
-content repository by built-in handing in PostgreSQL.
Removed tree_sortkey on acs-objects to reduce its size and to
+handing in PostgreSQL.
Removed various manual bookkeeping and deletion operations in
+the content repository by built-in handing in PostgreSQL.
Removed tree_sortkey on acs-objects to reduce its size and to
 speedup operations, where the context-id is changed (could take on
 large installation several minutes)
Remove several uncalled / redundant SQL statements and
 functions.
@@ -31,7 +32,13 @@
 Improve Performance of WebSites created with OpenACS: e.g. move
 core.js to a body requests, provide kernel parameter
 ResourcesExpireInterval to specify expiration times for
-resources.
Much better protection against XSS attacks.
Improved HTML validity (especially for admin pages)
Add lightweight support for ckeditor4 for templating::richtext
+resources.
Much better protection against XSS attacks.
Improved HTML validity (especially for admin pages)

+Improved admin interface:

+Placed all installation options to a single page.
Added pagination to /admin/applications (was unusable for large
+sites)
New admin pages for subsites linked from site-wide-admin package
+(/acs-admin).
Added explanatory text to several admin pages.
+
+
Add lightweight support for ckeditor4 for templating::richtext
 widget (configurable via package parameter "RichTextEditor" of
 acs-templating. ckeditor4 supports mobile devices (such as iPad,
 ...)
@@ -42,29 +49,31 @@
 packages in order to create responsive designs, reduce hard-coding
 of paths, HTML etc.
Improved include-handling: All includes are now theme-able,
 interfaces of includes can be defined with ad_include_contract
-(similar to ad_page_contract).
Improved themability for display_templates. One can now provide
+(similar to ad_page_contract).
Improved them-ability for display_templates. One can now provide
 a display_template_name (similar to the sql statement name) to
-refer to display templates. This enables resuabilit and is
+refer to display templates. This enables reusability and is
 theme-able.
Dimensional slider reform (ad_dimensional): Removed hard-coded
 table layout from dimensional slider Add backwards compatible
 templates Move hard-coded styles into theme styling
Notification chunks are now theme-able as well (using
 ad_include_contrat)
Complete template variable controls (adding noi18n)
 
 

 Misc:

-Improved Documentation templating (uniform appearance)
Make pretty-naming of acs-core packages more consistent
Mark unused functions of acs-tcl/tcl/table-display-procs.tcl as
+
Improved templating of OpenACS core documentation
Improved Russian Internationalization
Make pretty-names of acs-core packages more consistent
Mark unused functions of acs-tcl/tcl/table-display-procs.tcl as
 deprecated

-Version numbers:

-Require PG 9.0 (End Of Life of PostgreSQL 8.4 was July 2014)
require XOTcl 2.0 (presented at the Tcl conference in 2011).
Significant performance improvement for large installations
+Version numbers:

+Require PG 9.0 (End Of Life of PostgreSQL 8.4 was July 2014)
Require XOTcl 2.0 (presented at the Tcl conference in 2011).
Significant performance improvement for large installations
 
 
 
-
+Changes in application packages: Various bug fixes and
+improvements for e.g. file-storage, forums, news, notifications,
+xowiki.
 
 
 
Altogether, OpenACS 5.9.0 differs from OpenACS 5.8.1 in about
-xxxx modifications (yyyy commits) contributed by zzzz
-committers.
+xxxx modifications (yyyy commits) contributed by zzzz committers.
+For more details, consult the raw ChangeLog.
 

 
 Release 5.8.1

@@ -350,20 +359,20 @@
 turned off by default via the acs-kernel parameter ExcludedFiles in
 section request-processor (The variable provides a string match
 glob list of files and is defaulted to "*/CVS/* *~")
-
($Id: release-notes.html,v 1.55.2.1 2015/09/23
-11:54:49 gustafn Exp $)
+
($‌Id: release-notes.xml,v 1.30.2.1 2015/09/23
+11:55:08 gustafn Exp $)
 

 
-Release 4.6.3
Release Notes for 4.6.3
+Release 4.6.3
Release Notes for 4.6.3
 
 
-Release 4.6.2
Release Notes for 4.6.2
+Release 4.6.2
Release Notes for 4.6.2
 
 
-Release 4.6
Release Notes for 4.6
+Release 4.6
Release Notes for 4.6
 
 
-Release 4.5
Release Notes for 4.5
+Release 4.5
Release Notes for 4.5
 
 
 
 OpenACS Release NotesPrev Chapter 1. High level information: What is OpenACS?  Next
OpenACS Release Notes
Release 5.9.0 beta

-      The release contains the 78 packages of the oacs-5-9 branch.
-      These packages contain the OpenACS core packages, major
+      The release of OpenACS 5.9.0 contains the 78 packages of the oacs-5-9 branch.
+      These packages include the OpenACS core packages, the major
       application packages (e.g. most the ones used on OpenACS.org), and
-      DotLRN.
+      DotLRN 2.9.0.
     

-      Changes for all packages:
+      Summary of changes:
       
SQL:
 	

             Improved performance of acs-object deletion.
 	  

             Replaced many manual referential integrity calls by
 	    built-in handing in PostgreSQL.
 	  

-            Removed various manual bookeeping and deletion operations
+            Removed various manual bookkeeping and deletion operations
 	    in the content repository by built-in handing in PostgreSQL.
 	  

             Removed tree_sortkey on acs-objects to reduce its size and
@@ -32,6 +32,19 @@
             Much better protection against XSS attacks.
 	  

             Improved HTML validity (especially for admin pages)
+	  

+            Improved admin interface:
+	    

+		Placed all installation options to a single page.
+	      

+		Added pagination to /admin/applications (was unusable
+		for large sites)
+	      

+		New admin pages for subsites linked from
+		site-wide-admin package (/acs-admin).
+	      

+		Added explanatory text to several admin pages.
+	      

 	  
 Add lightweight support for ckeditor4 for
  	  templating::richtext widget (configurable via package
  	  parameter "RichTextEditor" of acs-templating. ckeditor4
@@ -47,10 +60,10 @@
 	    theme-able, interfaces of includes can be defined with
 	    ad_include_contract (similar to ad_page_contract).
 	  

-            Improved themability for display_templates. One can now
+            Improved them-ability for display_templates. One can now
 	    provide a display_template_name (similar to the sql
 	    statement name) to refer to display templates. This
-	    enables resuabilit and is theme-able.
+	    enables reusability and is theme-able.
 	  
 Dimensional slider reform (ad_dimensional):
  	  Removed hard-coded table layout from dimensional slider Add
  	  backwards compatible templates Move hard-coded styles into
@@ -61,26 +74,34 @@
 	  

 	
Misc:
 	

-            Improved Documentation templating (uniform appearance)
+            Improved templating of OpenACS core documentation
 	  

-            Make pretty-naming of acs-core packages more consistent
+            Improved Russian Internationalization
 	  

+            Make pretty-names of acs-core packages more consistent
+	  

             Mark unused functions of acs-tcl/tcl/table-display-procs.tcl as deprecated
 	  

 	    Version numbers:
-	    

+	    

 		Require PG 9.0 (End Of Life of PostgreSQL 8.4 was July 2014)
-	      

-		require XOTcl 2.0 (presented at the Tcl conference in 2011). 
-	      

+	      

+		Require XOTcl 2.0 (presented at the Tcl conference in 2011). 
+	      

 		Significant performance improvement for large
 		installations
 	      

  	  

+	
Changes in application packages: Various bug
+	fixes and improvements for e.g. file-storage, forums, news,
+	notifications, xowiki.
+	
 	

     
 Altogether, OpenACS 5.9.0 differs from OpenACS 5.8.1 in
   about xxxx modifications (yyyy commits) contributed by zzzz
-  committers.
+  committers. For more details, consult the
+  
+  raw ChangeLog.
   
Release 5.8.1

       The release contains the 78 packages of the oacs-5-8 branch.
       These packages contain the OpenACS core packages, major
@@ -380,4 +401,4 @@
         

            Serving backup files and files from the CVS directories is turned off by default via the acs-kernel parameter
                 ExcludedFiles in section request-processor (The variable provides a string match glob list of files and is defaulted to "*/CVS/* *~")
-        
($Id$)
Release 4.6.3
Release Notes for 4.6.3
Release 4.6.2
Release Notes for 4.6.2
Release 4.6
Release Notes for 4.6
Release 4.5
Release Notes for 4.5
Prev Home  Next
Overview Up  Part II. Administrator's Guide
docs@openacs.org
View comments on this page at openacs.org
+        
($Id$)
Release 4.6.3
Release Notes for 4.6.3
Release 4.6.2
Release Notes for 4.6.2
Release 4.6
Release Notes for 4.6
Release 4.5
Release Notes for 4.5
Prev Home  Next
Overview Up  Part II. Administrator's Guide
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp	23 Sep 2015 18:51:43 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/releasing-openacs-core.adp	28 Sep 2015 07:54:23 -0000	1.1.2.4
@@ -262,8 +262,8 @@
 
 # Clean up after ourselves...
 cd $BASE && rm -rf dotlrn-tarball tarball openacs-4 dotlrn-packages
-($Id: releasing-openacs-core.html,v 1.20.2.1
-2015/09/23 11:54:50 gustafn Exp $)
+($‌Id: releasing-openacs.xml,v 1.22 2014/10/27
+16:39:30 victorg Exp $)
 
 [ad_conn
 path_info]In a .vuh file, path_info is the trailing part of the URL not
 matched by the .vuh file.
-($Id: request-processor.html,v 1.49.2.1
-2015/09/23 11:54:52 gustafn Exp $)
+($‌Id: rp.xml,v 1.12 2010/12/11 23:36:32 ryang
+Exp $)
 
 
 0.1 Created 8/21/2000 Josh Finkler, Audrey McLoghlin
 
 
($Id: requirements-template.html,v 1.49.2.1
-2015/09/23 11:54:52 gustafn Exp $)
+
($‌Id: requirements-template.xml,v 1.6
+2006/07/17 05:38:37 torbenb Exp $)

 

 
 The set of string match expressions in the procedure above
 should be extended appropriately for other registration pages. This
 procedure does not use ad_parameter or regular expressions for
-performance reasons, as it is called by the request processor.
($Id: security-notes.html,v 1.48.2.1 2015/09/23
-11:54:53 gustafn Exp $)
+performance reasons, as it is called by the request processor.
($‌Id: security-notes.xml,v 1.7 2014/10/27
+16:39:32 victorg Exp $)
 
 
 

 0.1 Creation 12/2003 Jeff Davis
 
($Id: style-guide.html,v 1.28.2.1 2015/09/23
-11:54:54 gustafn Exp $)
+
($‌Id: style-guide.xml,v 1.3 2006/07/17 05:38:37
+torbenb Exp $)

 

 

 We also saw how to use the templating system's forms API in a
 simple way, to create forms based pages with minimal duplication of
-code.
($Id: subsites.html,v 1.48.2.1 2015/09/23
-11:54:55 gustafn Exp $)
+code.
($‌Id: subsites.xml,v 1.9 2014/10/27 16:39:30
+victorg Exp $)
 

 

 author's email address, file creation date
 #
-# $Id$
+# $‌Id: tcl-doc.xml,v 1.7 2006/07/17 05:38:38 torbenb Exp $
 #
 In addition, the inputs expected by a Tcl page (i.e., form
 variables) would be enumerated in a call to ad_page_variables, in effect, documenting
@@ -85,7 +85,7 @@
 
     \@author Jon Salz (jsalz\@mit.edu)
     \@creation-date 3 Jul 2000
-    \@cvs-id $Id$
+    \@cvs-id $‌Id$
 }
 
 
Note that:

@@ -171,7 +171,7 @@
 author. Specify the author's name, followed his or her email
 address in parentheses.
A \@creation-date tag
 indicating when the script was first created.
A \@cvs-id tag containing the
-page's CVS identification string. Just use $Id: tcl-documentation.html,v 1.2 2000/09/19
+page's CVS identification string. Just use $‌Id: tcl-documentation.html,v 1.2 2000/09/19
 07:22:35 ron Exp $ when creating the file, and CVS will
 substitute an appropriate string when you check the file in.

 
These \@ tags are optional,
@@ -191,7 +191,7 @@
 #
 # jsalz\@mit.edu, 7 Jun 2000
 #
-# $Id$
+# $‌Id: tcl-doc.xml,v 1.7 2006/07/17 05:38:38 torbenb Exp $
 
 
you'll now write:
 
@@ -203,7 +203,7 @@
 
     \@creation-date 7 Jun 2000
     \@author Jon Salz (jsalz\@mit.edu)
-    \@cvs-id $Id$
+    \@cvs-id $‌Id$
 
 }
 
@@ -215,11 +215,11 @@
 author. Specify the author's name, followed his or her email
 address in parentheses.
A \@creation-date tag
 indicating when the script was first created.
A \@cvs-id tag containing the
-page's CVS identification string. Just use $Id: tcl-documentation.html,v 1.2 2000/09/19
+page's CVS identification string. Just use $‌Id: tcl-documentation.html,v 1.2 2000/09/19
 07:22:35 ron Exp $ when creating the file, and CVS will
 substitute an appropriate string when you check the file in.

-
($Id: tcl-doc.html,v 1.49.2.1 2015/09/23
-11:54:55 gustafn Exp $)

+($‌Id: tcl-doc.xml,v 1.7 2006/07/17 05:38:38
+torbenb Exp $)
 
 
 
 
 
-Documentation
Templating system documentation
($Id: templates.html,v 1.49.2.1 2015/09/23
-11:54:55 gustafn Exp $)
+Documentation
Templating system documentation
($‌Id: templates.xml,v 1.12 2015/07/02 20:03:56
+gustafn Exp $)
 
 
 Laying out a page with CSS instead of
 tables
 
-.LRN home page with table-based
+.LRN home page with table-based
 layout
A sample of the HTML code (full source)
 <table border="0" width="100%">
   <tr>
@@ -40,7 +40,7 @@
 
 

 
-.LRN Home with CSS-based layout
A sample of the HTML code (full source)
+.LRN Home with CSS-based layout
A sample of the HTML code (full source)
 <div class="left">
   <div class="portlet-wrap-shadow">
     <div class="portlet-wrap-bl">
Index: openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html,v
diff -u -r1.12.2.1 -r1.12.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html	23 Sep 2015 11:54:57 -0000	1.12.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html	28 Sep 2015 07:54:26 -0000	1.12.2.2
@@ -1,5 +1,5 @@
 
-Laying out a page with CSS instead of tablesPrev Chapter 10. Advanced Topics  Next
Laying out a page with CSS instead of tables
.LRN home page with table-based layout
A sample of the HTML code (full source)
<table border="0" width="100%">
+Laying out a page with CSS instead of tablesPrev Chapter 10. Advanced Topics  Next
Laying out a page with CSS instead of tables
.LRN home page with table-based layout
A sample of the HTML code (full source)
<table border="0" width="100%">
   <tr>
     <td valign="top" width="50%">
       <table class="element" border=0 cellpadding="0" cellspacing="0" width="100%">
@@ -21,7 +21,7 @@
                   <table border="0" bgcolor="white" cellpadding="0" cellspacing="0" width="100%">
                     <tr>
                       <td class=element-text>
-                        MBA 101
.LRN Home with CSS-based layout
A sample of the HTML code (full source)
<div class="left">
+                        MBA 101
.LRN Home with CSS-based layout
A sample of the HTML code (full source)
<div class="left">
   <div class="portlet-wrap-shadow">
     <div class="portlet-wrap-bl">
       <div class="portlet-wrap-tr">
Index: openacs-4/packages/acs-core-docs/www/tutorial-cvs.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-cvs.adp,v
diff -u -r1.1.2.1 -r1.1.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-cvs.adp	23 Sep 2015 11:54:57 -0000	1.1.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-cvs.adp	28 Sep 2015 07:54:26 -0000	1.1.2.2
@@ -71,7 +71,7 @@
 (many lines omitted)
 [$OPENACS_SERVICE_NAME myfirstpackage]$
 

-Figure 10.1. Upgrading
+
Figure 10.1. Upgrading
 a local CVS repository

 


 

Index: openacs-4/packages/acs-core-docs/www/tutorial-cvs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-cvs.html,v
diff -u -r1.26.2.1 -r1.26.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-cvs.html	23 Sep 2015 11:54:57 -0000	1.26.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-cvs.html	28 Sep 2015 07:54:26 -0000	1.26.2.2
@@ -59,4 +59,4 @@
 initial revision: 1.1
 done
 (many lines omitted)
-[$OPENACS_SERVICE_NAME myfirstpackage]$
Figure 10.1. Upgrading a local CVS repository

Prev Home  Next
Write the Requirements and Design Specs Up  OpenACS Edit This Page Templates
docs@openacs.org
View comments on this page at openacs.org
+[$OPENACS_SERVICE_NAME myfirstpackage]$
Figure 10.1. Upgrading a local CVS repository

Prev Home  Next
Write the Requirements and Design Specs Up  OpenACS Edit This Page Templates
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/tutorial-database.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-database.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/tutorial-database.adp	23 Sep 2015 18:37:47 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-database.adp	28 Sep 2015 07:54:26 -0000	1.1.2.3
@@ -15,7 +15,7 @@
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.
 
-Code the data model
We create all database objects with scripts in the myfirstpackage/sql/ directory. All database
+Code the data model
We create all database objects with scripts in the myfirstpackage/sql/ directory. All database
 scripts are database-specific and are thus in either the
 myfirstpackage/sql/oracle or
 myfirstpackage/sql/postgresql
@@ -42,17 +42,16 @@
 simplify our database creation. (More information about ACS
 Objects. More information about the Content
 Repository.)

-Figure 9.2. Tutorial
+
Figure 9.2. Tutorial
 Data Model

 

The top of each sql file has some standard comments, including
 doc tags such as \@author which
-will be picked up by the API browser. The string $Id: tutorial-database.html,v 1.44.2.1 2015/09/23
-11:54:58 gustafn Exp $ will automatically be expanded when
+will be picked up by the API browser. The string $‌Id:$ will automatically be expanded when
 the file is checked in to cvs.
 [$OPENACS_SERVICE_NAME ~]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/sql/postgresql
 [$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-create.sql
 
Paste the text below into the file, save, and close.

-Figure 9.3. The
+
Figure 9.3. The
 Database Creation Script
 -- creation script
 --
@@ -82,7 +81,7 @@
 uninstalled.
 [$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-drop.sql
 

-Figure 9.4. Database
+
Figure 9.4. Database
 Deletion Script
 -- drop script
 --
Index: openacs-4/packages/acs-core-docs/www/tutorial-database.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-database.html,v
diff -u -r1.44.2.1 -r1.44.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-database.html	23 Sep 2015 11:54:58 -0000	1.44.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-database.html	28 Sep 2015 07:54:26 -0000	1.44.2.2
@@ -2,7 +2,7 @@
 Setting Up Database ObjectsPrev Chapter 9. Development Tutorial  Next
Setting Up Database Objects
by Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
Code the data model
We create all database objects with scripts in the
+        
Code the data model
We create all database objects with scripts in the
       myfirstpackage/sql/ directory.  All
       database scripts are database-specific and are thus in either
       the myfirstpackage/sql/oracle or
@@ -32,13 +32,13 @@
       repository functions to simplify our database creation.  (More
       information about ACS Objects.  More information about the
       Content Repository.)
-
Figure 9.2. Tutorial Data Model

The top of each sql file has some
+
Figure 9.2. Tutorial Data Model

The top of each sql file has some
       standard comments, including doc tags such as
       @author which will be picked up
       by the API browser.  The string
       $Id$ will automatically be
       expanded when the file is checked in to cvs.
[$OPENACS_SERVICE_NAME ~]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/sql/postgresql
-[$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-create.sql
Paste the text below into the file, save, and close.
Figure 9.3. The Database Creation Script
-- creation script
+[$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-create.sql
Paste the text below into the file, save, and close.
Figure 9.3. The Database Creation Script
-- creation script
 --
 -- @author joel@aufrecht.org
 -- @cvs-id &Id:$
@@ -62,7 +62,7 @@
     object.  Notice the use of "mfp."  This is derived from "My
     First Package" and ensures that our object is unlikely to conflict
     with objects from other packages.
Create a database file to drop everything if the package is uninstalled.
-[$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-drop.sql
Figure 9.4. Database Deletion Script
-- drop script
+[$OPENACS_SERVICE_NAME postgresql]$ emacs myfirstpackage-drop.sql
Figure 9.4. Database Deletion Script
-- drop script
 --
 -- @author joel@aufrecht.org
 -- @cvs-id &Id:$
Index: openacs-4/packages/acs-core-docs/www/tutorial-debug.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-debug.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/tutorial-debug.adp	23 Sep 2015 18:51:44 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-debug.adp	28 Sep 2015 07:54:27 -0000	1.1.2.3
@@ -15,7 +15,7 @@
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.

 
-Debugging

+Debugging

 Developer Support. The Developer Support
 package adds several goodies: debug information for every page; the
 ability to log comments to the page instead of the error log, and
@@ -44,7 +44,7 @@
           
 

 
-Manual testing
Make a list of basic tests to make sure it works

+Manual testingMake a list of basic tests to make sure it works

@@ -72,11 +72,11 @@
 delete your own note. Edit your own note. Search for a note.

 
-Write automated tests

+Write automated tests

 by Simon Carstensen and Joel Aufrecht
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.

- It seems to me that a lot of people have
+ It seems to me that a lot of people have
 been asking for some guidelines on how to write automated tests.
 I've done several tests by now and have found the process to be
 extremely easy and useful. It's a joy to work with automated
@@ -144,7 +144,7 @@
 myfirstpackage. You should see your test case. Run it and examine
 the results.

 
-TCLWebtest tests
API testing can only test part of our package - it doesn't test
+TCLWebtest tests
API testing can only test part of our package - it doesn't test
 the code in our adp/tcl pairs. For this, we can use TCLwebtest.
 TCLwebtest must be installed for this test to work.
 This provides a library of functions that make it easy to call a page
@@ -153,7 +153,7 @@
 example provided for one approach on integrating them.

 
-Example
Now we can add the rest of the API tests, including a test with
+Example
Now we can add the rest of the API tests, including a test with
 deliberately bad data. The complete test looks like:
 ad_library {
     Test cases for my first package.
Index: openacs-4/packages/acs-core-docs/www/tutorial-debug.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-debug.html,v
diff -u -r1.43.2.1 -r1.43.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-debug.html	23 Sep 2015 11:54:58 -0000	1.43.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-debug.html	28 Sep 2015 07:54:27 -0000	1.43.2.2
@@ -2,7 +2,7 @@
 Debugging and Automated Testing

 
 Test Num Action Expected Result
 

 
 
Prev Chapter 9. Development Tutorial  Next
Debugging and Automated Testing
by Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
Debugging
Developer Support. The Developer Support package adds several goodies: debug
+        
Debugging
Developer Support. The Developer Support package adds several goodies: debug
       information for every page; the ability to log comments to the
       page instead of the error log, and fast user switching so that you
       can test pages as anonymous and as dummy users without logging
@@ -23,16 +23,16 @@
 ? searches backward 

 / searches forward. 

           

-    
Manual testing
Make a list of basic tests to make sure it works
Test Num Action Expected Result
001 Browse to the index page while not logged in and
+    
Manual testing
Make a list of basic tests to make sure it works
Test Num Action Expected Result
001 Browse to the index page while not logged in and
             while one or more notes exist. No edit or delete or add links should appear.
002 Browse to the index page while logged in.  An Edit
             link should appear.  Click on it.  Fill out the form and
             click Submit. The text added in the form should be visible on the
             index page.
API-001 Invoke mfp::note::create with a specific word as the title. Proc should return an object id.
API-002 Given an object id from API-001, invoke mfp::note::get. Proc should return the specific word in the title.
API-003 Given the object id from API-001, invoke mfp::note::delete. Proc should return 0 for success.
Other things to test: try to delete someone else's
         note.  Try to delete your own note.  Edit your own note.
-        Search for a note.
Write automated tests
by Simon Carstensen and Joel Aufrecht
+        Search for a note.
Write automated tests
by Simon Carstensen and Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        

+        

     It seems to me that a lot of people have been asking for some guidelines on how to write automated tests. I've done several tests by now and have found the process to be extremely easy and useful. It's a joy to work with automated testing once you get the hang of it.
Create the directory that will contain the test
     script and edit the script file.  The directory location and file name are standards which are recognized by the automated testing package:
[$OPENACS_SERVICE_NAME www]$ mkdir /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/tcl/test
 [$OPENACS_SERVICE_NAME www]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/tcl/test
@@ -68,7 +68,7 @@
 goes inside -test_code {}.  We want to implement test case API-001, "Given an object id from API-001, invoke mfp::note::get.  Proc should return the specific word in the title."
       set name [ad_generate_random_string]
       set new_id [mfp::note::add -title $name]
-      aa_true "Note add succeeded" ([info exists new_id] && $new_id ne "")
To test our simple case, we must load the test file into the system (just as with the /tcl file in the basic tutorial, since the file didn't exist when the system started, the system doesn't know about it.)  To make this file take effect, go to the APM and choose "Reload changed" for "MyFirstPackage".  Since we'll be changing it frequently, select "watch this file" on the next page.  This will cause the system to check this file every time any page is requested, which is bad for production systems but convenient for developing.  We can also add some aa_register_case flags to make it easier to run the test.  The -procs flag, which indicates which procs are tested by this test case, makes it easier to find procs in your package that aren't tested at all.  The -cats flag, setting categories, makes it easier to control which tests to run.  The smoke test setting means that this is a basic test case that can and should be run any time you are doing any test. (a definition of "smoke test")
Once the file is loaded, go to ACS Automated Testing and click on myfirstpackage.  You should see your test case.  Run it and examine the results.
TCLWebtest tests
API testing can only test part of our package - it doesn't test the code in our adp/tcl pairs.  For this, we can use TCLwebtest.  TCLwebtest must be installed for this test to work.  This provides a library of functions that make it easy to call a page through HTTP, examine the results, and drive forms.  TCLwebtest's functions overlap slightly with acs-automated-testing; see the example provided for one approach on integrating them.
Example
Now we can add the rest of the API tests, including a test with deliberately bad data.  The complete test looks like:
ad_library {
+      aa_true "Note add succeeded" ([info exists new_id] && $new_id ne "")
To test our simple case, we must load the test file into the system (just as with the /tcl file in the basic tutorial, since the file didn't exist when the system started, the system doesn't know about it.)  To make this file take effect, go to the APM and choose "Reload changed" for "MyFirstPackage".  Since we'll be changing it frequently, select "watch this file" on the next page.  This will cause the system to check this file every time any page is requested, which is bad for production systems but convenient for developing.  We can also add some aa_register_case flags to make it easier to run the test.  The -procs flag, which indicates which procs are tested by this test case, makes it easier to find procs in your package that aren't tested at all.  The -cats flag, setting categories, makes it easier to control which tests to run.  The smoke test setting means that this is a basic test case that can and should be run any time you are doing any test. (a definition of "smoke test")
Once the file is loaded, go to ACS Automated Testing and click on myfirstpackage.  You should see your test case.  Run it and examine the results.
TCLWebtest tests
API testing can only test part of our package - it doesn't test the code in our adp/tcl pairs.  For this, we can use TCLwebtest.  TCLwebtest must be installed for this test to work.  This provides a library of functions that make it easy to call a page through HTTP, examine the results, and drive forms.  TCLwebtest's functions overlap slightly with acs-automated-testing; see the example provided for one approach on integrating them.
Example
Now we can add the rest of the API tests, including a test with deliberately bad data.  The complete test looks like:
ad_library {
     Test cases for my first package.
 }
 
Index: openacs-4/packages/acs-core-docs/www/tutorial-distribute.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-distribute.adp,v
diff -u -r1.1.2.1 -r1.1.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-distribute.adp	23 Sep 2015 11:54:58 -0000	1.1.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-distribute.adp	28 Sep 2015 07:54:27 -0000	1.1.2.2
@@ -13,7 +13,7 @@
 distribution.
Browse to the package manager. Click on tutorialapp.
Click on Generate a distribution file for
 this package from the filesystem.
Click on the file size (37.1KB) after the label
 Distribution File: and save the
-file to /var/tmp.
Package development guidelines
+file to /var/tmp.
Package development guidelines
 
 37.1KB)
         after the label Distribution
         File: and save the file to
-        /var/tmp.

+        /var/tmp.

 
Package development guidelines
Prev Home  Next
Profile your code Up  Distributing upgrades of your package
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.adp	23 Sep 2015 18:37:47 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.adp	28 Sep 2015 07:54:27 -0000	1.1.2.3
@@ -86,7 +86,7 @@
 
 The template should provide us with the following ETP
 layout:

-TableÂ 10.1.Â table showing
+
TableÂ 10.1.Â table showing
 ETP layout
@@ -133,8 +133,8 @@
 Who Wrote This and WhenThis problem set was originally written by Nick Carroll in August 2004 for the University of
 Sydney Course EBUS5002.
This material is copyright 2004 by Nick Carroll. It may be
 copied, reused, and modified, provided credit is given to the
-original author.
($Id: tutorial-etp-templates.html,v 1.9.2.1
-2015/09/23 11:54:59 gustafn Exp $)
+original author.
($‌Id: tutorial-advanced.xml,v 1.52 2015/06/27
+17:19:13 gustafn Exp $)
 
 
 Go to the package manager at http://yoursite/acs-admin/apm. And install  the new package: edit-this-page.
Or use the "Add Application" form available on the Main site.
Change ETP Application
Work out how to change the ETP application.
Investigate each of the available ETP templates:
Default
News
FAQ
Exercise 4: Create a New ETP Template
Browse the files for each of the above ETP templates at:
cd ~/openacs/packages/edit-this-page/templates
Use the article template as the basis of our new col2 template.
cp article-content.adp col2-content.adp
             cp article-content.tcl col2-content.tcl
             cp article-index.adp col2-index.adp
-            cp article-index.tcl col2-index.tcl
The template should provide us with the following ETP layout:
Table 10.1. table showing ETP layout

 
 
Header
Sidebar Main Content Pane

The "Main Content" pane should contain the editable content that ETP provides.
The "Header" should display the title of the page that you set in ETP.
The "Sidebar" should display the extlinks that you add as a content item in ETP.
Exercise 5: Register the col2 Template with ETP
Need to register your template with ETP so that it appears in the drop-down menu that you would have seen in Exercise 3.
cd ~/openacs/packages/edit-this-page/tcl
+            cp article-index.tcl col2-index.tcl
The template should provide us with the following ETP layout:
Table 10.1. table showing ETP layout
Header
Sidebar Main Content Pane

The "Main Content" pane should contain the editable content that ETP provides.
The "Header" should display the title of the page that you set in ETP.
The "Sidebar" should display the extlinks that you add as a content item in ETP.
Exercise 5: Register the col2 Template with ETP
Need to register your template with ETP so that it appears in the drop-down menu that you would have seen in Exercise 3.
cd ~/openacs/packages/edit-this-page/tcl
             emacs etp-custom-init.tcl
Use the function etp::define_application to register your template with ETP
Uncomment the "asc" definition
Set allow_extlinks to true, the rest should be false.
Restart your server for the changes to take effect.
Exercise 6: Configure ETP to use the col2 Template
Configure your ETP instance at /lab4/index to use the col2 template.
Create external links to link to other mounted ETP instances.
Check that your external links show up in the sidebar when you view your ETP application using the col2 template.
Who Wrote This and When
This problem set was originally written by Nick Carroll in August 2004 for the University of Sydney Course EBUS5002.
This material is copyright 2004 by Nick Carroll.  It may be copied, reused, and modified, provided credit is given to the original author.
($Id$)
Prev Home  Next
Add the new package to CVS Up  Adding Comments
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/tutorial-newpackage.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-newpackage.adp,v
diff -u -r1.1.2.1 -r1.1.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-newpackage.adp	23 Sep 2015 11:55:00 -0000	1.1.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-newpackage.adp	28 Sep 2015 07:54:27 -0000	1.1.2.2
@@ -18,7 +18,7 @@
 The intended page map
 
 
-Overview
To start developing new code in OpenACS, we build a new package.
+Overview
To start developing new code in OpenACS, we build a new package.
 A package is a a discrete collection of web pages, tcl code, and
 database tables and procedures. A package with user interface is
 called an application;
@@ -36,14 +36,14 @@
 displaying a list of text notes.
 
 
-Before you begin
You will need:

+Before you begin
You will need:

 A computer with a working installation of OpenACS. If you don't
 have this, see Chapter 2,
 Installation Overview
 .
Example files, which are included in the standard OpenACS 5.7.0
 distribution.
 

-Figure 9.1. Assumptions
+
Figure 9.1. Assumptions
 in this section
@@ -62,7 +62,7 @@
 

 
 
-Use the APM to initialize a new
+Use the APM to initialize a new
 package
We use the ACS Package Manager (APM) to add, remove, and upgrade
 packages. It handles package meta-data, such as lists of files that
 belong in the package. Each package is uniquely identified by a
@@ -102,7 +102,7 @@
 packages).
 

 
-Add an Application Instance to the
+Add an Application Instance to the
 Server
In order to see your work in progress, you must create a map
 between the URL space of incoming requests and the package
 application instance. You do this by adding the application in the
@@ -121,7 +121,7 @@
 to be satisfied from the files at /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/www.
 

 
-Quick start
The remainder of the tutorial walks you through each file one at
+Quick start
The remainder of the tutorial walks you through each file one at
 a time as you create the package. You can skip all this, and get a
 working package, by doing the following:
 cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial
Index: openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html,v
diff -u -r1.43.2.1 -r1.43.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html	23 Sep 2015 11:55:00 -0000	1.43.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html	28 Sep 2015 07:54:28 -0000	1.43.2.2
@@ -2,7 +2,7 @@
 Creating an Application Package
 
 
Prev Chapter 9. Development Tutorial  Next
Creating an Application Package
by Joel Aufrecht

           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
The intended page map
Overview
To start developing new code in OpenACS, we build a new package. A package 
+        
The intended page map
Overview
To start developing new code in OpenACS, we build a new package. A package 
       is a a discrete collection of web pages, tcl code, and database tables and procedures.
       A package with user interface is called an application; 
       a package which provides functions to other packages and has no direct interface, a
@@ -18,11 +18,11 @@
         right now.  Code that is temporary hackage is clearly marked.
       
In this tutorial, we will make an application package for
     displaying a list of text notes.
-
Before you begin
You will need:
A computer with a working installation of
+
Before you begin
You will need:
A computer with a working installation of
 	  OpenACS.  If you don't have this, see Chapter 2, Installation Overview.
 	  
Example files, which are included in the
 standard OpenACS 5.7.0 distribution.
-	  
Figure 9.1. Assumptions in this section
Fully qualified domain name of your server yourserver.test
URL of your server http://yourserver.test:8000
Name of development account $OPENACS_SERVICE_NAME
New Package key myfirstpackage

Use the APM to initialize a new package
We use the ACS Package Manager (APM) to add, remove, and
+	  
Figure 9.1. Assumptions in this section
Fully qualified domain name of your server yourserver.test
URL of your server http://yourserver.test:8000
Name of development account $OPENACS_SERVICE_NAME
New Package key myfirstpackage

Use the APM to initialize a new package
We use the ACS Package Manager (APM) to add, remove, and
     upgrade packages.  It handles package meta-data, such as lists of
     files that belong in the package.  Each package is uniquely
     identified by a package key.  To start developing a new
@@ -55,7 +55,7 @@
           /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage.
           This is the "home directory" of our new package, and all
           files in the package will be within this directory. More on the structure of
-          packages). 
Add an Application Instance to the Server
In order to see your work in progress, you must create a
+          packages). 
Add an Application Instance to the Server
In order to see your work in progress, you must create a
       map between the URL space of incoming requests and the package application instance.
       You do this by adding the application in the main site administration).  This
       creates a link between the incoming URL requests and an
@@ -66,7 +66,7 @@
       in this tutorial.
Browse to
 http://yourserver.test:8000/admin/applications/application-add/.
Choose "My First Package" from the list and click OK (the other fields are optional).
By mounting the package, we've caused all requests to
       http://yourserver.test:8000/myfirstpackage
-      to be satisfied from the files at /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/www.
Quick start
The remainder of the tutorial walks you through each file one at a time as you create the package.  You can skip all this, and get a working package, by doing the following:
cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial
+      to be satisfied from the files at /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/www.
Quick start
The remainder of the tutorial walks you through each file one at a time as you create the package.  You can skip all this, and get a working package, by doing the following:
cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial
 psql $OPENACS_SERVICE_NAME -f myfirstpackage-create.sql
 cp note-edit.* note-delete.tcl index.* ../../../../myfirstpackage/www/
 mkdir ../../../../myfirstpackage/lib
Index: openacs-4/packages/acs-core-docs/www/tutorial-pages.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-pages.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/tutorial-pages.adp	23 Sep 2015 18:51:44 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/tutorial-pages.adp	28 Sep 2015 07:54:28 -0000	1.1.2.4
@@ -15,22 +15,22 @@
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.

 
-Install some API
As a workaround for missing content-repository functionality,
+Install some API
As a workaround for missing content-repository functionality,
 copy a provided file into the directory for tcl files:
cp /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial/note-procs.tcl /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/tcl/
To make this file take effect, go to the APM and choose "Reload changed"
 for "MyFirstPackage".

 

 
-Page Map
Our package will have two visible pages. The first shows a list
+Page Map
Our package will have two visible pages. The first shows a list
 of all objects; the second shows a single object in view or edit
 mode, and can also be used to add an object. The index page will
 display the list, but since we might reuse the list later, we'll
 put it in a seperate file and include it on the index page.

-Figure 9.5. Page
+
Figure 9.5. Page
 Map

 


 
 
-Build the "Index" page
Each user-visible page in your package has, typically, three
+Build the "Index" page
Each user-visible page in your package has, typically, three
 parts. The tcl file holds the
 procedural logic for the page, including Tcl and
 database-independent SQL code, and does things like check
@@ -47,7 +47,7 @@
     This is the main page for the package.  It displays all of the Notes and provides links to edit them and to create new Notes.
 
     \@author Your Name (you\@example.com)
-    \@cvs-id $Id$
+    \@cvs-id $‌Id: index.tcl,v 1.2.22.1 2015/09/10 08:21:20 gustafn Exp $
 }
 
 set page_title [ad_conn instance_name]
@@ -126,7 +126,7 @@
     This is the view-edit page for notes.
 
     \@author Your Name (you\@example.com)
-    \@cvs-id $Id$
+    \@cvs-id $‌Id: note-edit.tcl,v 1.3.2.1 2015/09/10 08:21:20 gustafn Exp $
  
     \@param item_id If present, assume we are editing that note.  Otherwise, we are creating a new note.
 } {
@@ -185,7 +185,7 @@
     This deletes a note
 
     \@author Your Name (you\@example.com)
-    \@cvs-id $Id$
+    \@cvs-id $‌Id: note-delete.tcl,v 1.3.2.1 2015/09/10 08:21:20 gustafn Exp $
  
     \@param item_id The item_id of the note to delete
 } {
Index: openacs-4/packages/acs-core-docs/www/tutorial-pages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-pages.html,v
diff -u -r1.44.2.1 -r1.44.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-pages.html	23 Sep 2015 11:55:01 -0000	1.44.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-pages.html	28 Sep 2015 07:54:28 -0000	1.44.2.2
@@ -2,8 +2,8 @@
 Creating Web Pages
Prev Chapter 9. Development Tutorial  Next
Creating Web Pages
by Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
Install some API
As a workaround for missing content-repository functionality, copy a provided file into the directory for tcl files:
-    cp /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial/note-procs.tcl /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/tcl/
To make this file take effect, go to the APM and choose "Reload changed" for "MyFirstPackage".
Page Map
Our package will have two visible pages.  The first shows a list of all objects; the second shows a single object in view or edit mode, and can also be used to add an object.  The index page will display the list, but since we might reuse the list later, we'll put it in a seperate file and include it on the index page.
Figure 9.5. Page Map

Build the "Index" page
Each user-visible page in your package has, typically,
+        
Install some API
As a workaround for missing content-repository functionality, copy a provided file into the directory for tcl files:
+    cp /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/tutorial/note-procs.tcl /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/tcl/
To make this file take effect, go to the APM and choose "Reload changed" for "MyFirstPackage".
Page Map
Our package will have two visible pages.  The first shows a list of all objects; the second shows a single object in view or edit mode, and can also be used to add an object.  The index page will display the list, but since we might reuse the list later, we'll put it in a seperate file and include it on the index page.
Figure 9.5. Page Map

Build the "Index" page
Each user-visible page in your package has, typically,
       three parts.  The  tcl file
       holds the procedural logic for the page, including Tcl and
       database-independent SQL code, and does things like
Index: openacs-4/packages/acs-core-docs/www/unix-installation.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/unix-installation.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/unix-installation.adp	23 Sep 2015 18:37:47 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/unix-installation.adp	28 Sep 2015 07:54:28 -0000	1.1.2.3
@@ -17,7 +17,8 @@
 OpenACS documentation staff.

 
 a
-Unix-like system
You will need a computer running a unix-like system with the
+Unix-like system
Most of the documentation in this section is kept as a
+reference. More up-to-date documentation is in the install sections in the Wiki.
You will need a computer running a unix-like system with the
 following software installed:

 tdom
tcl --if you plan to use the OpenACS installation script

 gmake and the compile and build environment.

@@ -37,8 +38,8 @@
 must first do Setting a
 global shell variable for cut and paste.
To install a machine to the specifications of the Reference
 Platform, do the walkthrough
-of the Red Hat 8.0 Install for OpenACS.
($Id: unix-installation.html,v 1.33.2.1
-2015/09/23 11:55:03 gustafn Exp $)
+of the Red Hat 8.0 Install for OpenACS.
($‌Id: os.xml,v 1.15 2006/07/17 05:38:37 torbenb
+Exp $)
 
 
 Install a Unix-like system and supporting softwarePrev Chapter 3. Complete Installation  Next
Install a Unix-like system and supporting software
by Joel Aufrecht
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        
a Unix-like system
You will need a computer running a unix-like system with the following software installed:
tdom
tcl --if you plan to use the OpenACS installation script
gmake and the compile and build environment.
BSD Note
BSD users: in most places in these instructions, gmake will work better than make.  (more
+        
a Unix-like system
Most of the documentation in this section is kept as a
+    reference. More up-to-date documentation is in the install
+    sections in the Wiki.
+    
You will need a computer running a unix-like system with the following software installed:
tdom
tcl --if you plan to use the OpenACS installation script
gmake and the compile and build environment.
BSD Note
BSD users: in most places in these instructions, gmake will work better than make.  (more
           information on FreeBSD installation). Also, fetch is a native replacement for wget.
Note: Instructions for installing tDOM and threaded tcl are included with the AOLserver4 installation instructions, 
     if these are not yet installed.
The following programs may be useful or required for some configurations. They are included in most distributions:
emacs
cvs (and initialize it)
ImageMagick (used by some packages for server side image manipulation)
Aspell (more information on spell-checking)
DocBook and supporting software (and install emacs keybindings for DocBook SGML)
daemontools (install from source)
a Mail Transport Agent, such as exim or sendmail (or install qmail from source)
In order to cut and paste the example code into your shell, you must first do Setting a global shell variable for cut and paste.
To install a machine to the specifications of the Reference Platform, do the 
     walkthrough of the Red Hat 8.0 Install for OpenACS.
($Id$)
Prev Home  Next
Chapter 3. Complete Installation Up  Install Oracle 8.1.7
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.adp,v
diff -u -r1.1.2.3 -r1.1.2.4
--- openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.adp	23 Sep 2015 18:51:44 -0000	1.1.2.3
+++ openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.adp	28 Sep 2015 07:54:29 -0000	1.1.2.4
@@ -9,7 +9,7 @@
 		    rightLink="upgrade-4.6.3-to-5" rightLabel="Next">
 		
 
-Upgrading 4.5 or higher to 4.6.3
The required platform for OpenACS 4.6 is the same as 4.5, with
+Upgrading 4.5 or higher to 4.6.3
The required platform for OpenACS 4.6 is the same as 4.5, with
 the exception of OpenFTS. OpenACS 4.6 and later require OpenFTS
 0.3.2 for full text search on PostGreSQL. If you have OpenFTS 0.2,
 you'll need to upgrade.
If upgrading from 4.4, you need to manually run
Index: openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html,v
diff -u -r1.27.2.1 -r1.27.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html	23 Sep 2015 11:55:04 -0000	1.27.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html	28 Sep 2015 07:54:29 -0000	1.27.2.2
@@ -1,5 +1,5 @@
 
-Upgrading 4.5 or higher to 4.6.3
Prev Chapter 5. Upgrading  Next
Upgrading 4.5 or higher to 4.6.3
The required platform for OpenACS 4.6 is the same as
+Upgrading 4.5 or higher to 4.6.3
Prev Chapter 5. Upgrading  Next
Upgrading 4.5 or higher to 4.6.3
The required platform for OpenACS 4.6 is the same as
       4.5, with the exception of OpenFTS.  OpenACS 4.6 and later require OpenFTS 0.3.2 for full text search on PostGreSQL.  If you have OpenFTS 0.2, you'll need to upgrade.  
If upgrading from 4.4, you need to manually run acs-kernel/sql/postgres/upgrade-4.4-4.5.sql.  See Bug #632
A computer with OpenACS 4.5.
OpenACS 4.6 tarball or CVS checkout/export.
Required for Full Text Search on PostgreSQL: OpenFTS 0.3.2
Make a Backup. Back up the database and file system (see the section called “Manual backup and recovery”).
OPTIONAL: Upgrade OpenFTS. the section called “Upgrading OpenFTS from 0.2 to 0.3.2”

             Stop the server
           
[root root]# svc -d /service/$OPENACS_SERVICE_NAME
Upgrade the file system. the section called “Upgrading the OpenACS files”

Index: openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.adp	23 Sep 2015 18:51:44 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.adp	28 Sep 2015 07:54:29 -0000	1.1.2.3
@@ -12,7 +12,7 @@
 Upgrading
 the OpenACS files

 
-Chosing a Method to Upgrade your
+Chosing a Method to Upgrade your
 Files
OpenACS is distributed in many different ways:

 as a collection of files
as one big tarball
via CVS
via automatic download from within the APM (package manager)
 
Upgrades work by first changing the file system (via any of the
@@ -27,7 +27,7 @@
 
 

 
-Methods of upgrading OpenACS files

+Methods of upgrading OpenACS files

 
 
 Upgrading files for a site which is not in a CVS
@@ -56,7 +56,7 @@
 version, without overriding your own local customizations.
This diagram explains the basic idea. However, the labels are
 incorrect. Step 1(a) has been removed, and Step 1(b) should be
 labelled Step 1.

-Figure 5.2. Upgrading a
+
Figure 5.2. Upgrading a
 local CVS repository

 


 
@@ -194,7 +194,7 @@
 
 

 
-Upgrading a Production Site Safely
If you are upgrading a production OpenACS site which is on a
+Upgrading a Production Site Safely
If you are upgrading a production OpenACS site which is on a
 private CVS tree, this process lets you do the upgrade without
 risking extended downtime or an unusable site:

 Declare a freeze on new cvs updates - ie, you cannot run cvs
Index: openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html,v
diff -u -r1.27.2.1 -r1.27.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html	23 Sep 2015 11:55:05 -0000	1.27.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html	28 Sep 2015 07:54:29 -0000	1.27.2.2
@@ -1,5 +1,5 @@
 
-Upgrading the OpenACS files
Prev Chapter 5. Upgrading  Next
Upgrading the OpenACS files
Chosing a Method to Upgrade your Files
OpenACS is distributed in many different ways:
+Upgrading the OpenACS files
Prev Chapter 5. Upgrading  Next
Upgrading the OpenACS files
Chosing a Method to Upgrade your Files
OpenACS is distributed in many different ways:
         
as a collection of files
 as one big tarball
 via CVS
 via automatic download from within the APM
             (package manager)

       
Upgrades work by first changing the file system (via any
@@ -11,7 +11,7 @@
         describes whether or not you need to be upgrading using this
         page or not:
         the section called “Upgrading an OpenACS 5.0.0 or greater installation”
-      
Methods of upgrading OpenACS files
Upgrading files for a site which is not in a CVS repository. Unpack the tarball into a new directory and copy its
+      
Methods of upgrading OpenACS files
Upgrading files for a site which is not in a CVS repository. Unpack the tarball into a new directory and copy its
           contents on top of your working directory. Or just 'install
           software', select remote repository, and upgrade your files
           from there.
[root root]# su - $OPENACS_SERVICE_NAME
@@ -32,7 +32,7 @@
         with the latest OpenACS version, without overriding your own
         local customizations. 
This diagram explains the basic idea. However, the
         labels are incorrect. Step 1(a) has been removed, and Step
-        1(b) should be labelled Step 1.
Figure 5.2. Upgrading a local CVS repository

Step 0: Set up a working CVS checkout. To get your OpenACS code into your local CVS
+        1(b) should be labelled Step 1.
Figure 5.2. Upgrading a local CVS repository

Step 0: Set up a working CVS checkout. To get your OpenACS code into your local CVS
                 repository, you will set up a working CVS checkout of
                 OpenACS. When you want to update your site, you'll
                 update the working CVS checkout, import those changes
@@ -97,7 +97,7 @@
       
[$OPENACS_SERVICE_NAME ~]$ cd /var/lib/aolserver/$OPENACS_SERVICE_NAME
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ cvs up -Pd
 (CVS feedback)
-[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$
Upgrading a Production Site Safely
If you are upgrading a production OpenACS site which is on a private CVS tree, this process lets you do the upgrade without risking extended downtime or an unusable site:
Declare a freeze on new cvs updates - ie, you cannot run cvs update
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$
Upgrading a Production Site Safely
If you are upgrading a production OpenACS site which is on a private CVS tree, this process lets you do the upgrade without risking extended downtime or an unusable site:
Declare a freeze on new cvs updates - ie, you cannot run cvs update
    on the production site

             Make a manual backup of the production site in addition to the
    automated backups
Import the new code (for example, OpenACS 5.0.4, openacs-5-0-compat versions of
Index: openacs-4/packages/acs-core-docs/www/upgrade-overview.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-overview.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/upgrade-overview.adp	23 Sep 2015 18:37:48 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/upgrade-overview.adp	28 Sep 2015 07:54:29 -0000	1.1.2.3
@@ -26,11 +26,11 @@
 upgrade scripts, and prompt you to restart the server. After
 restarting the server again, the upgrade is complete.

 

-Figure 5.1. Upgrading
+
Figure 5.1. Upgrading
 with the APM

 

It's always a good idea to precede an upgrade attempt with a
 snapshot backup.

-Table 5.1. Assumptions
+
Table 5.1. Assumptions
 in this section
Index: openacs-4/packages/acs-core-docs/www/upgrade-overview.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-overview.html,v
diff -u -r1.27.2.1 -r1.27.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-overview.html	23 Sep 2015 11:55:05 -0000	1.27.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-overview.html	28 Sep 2015 07:54:29 -0000	1.27.2.2
@@ -4,4 +4,4 @@
     or better, you should always be able to upgrade all of your core
     packages automatically.  If you haven't changed anything, no
     manual intervention should be required.  If you are running
-    OpenACS prior to 4.5, upgrading will require manual effort.
If all of these conditions are true:
Your OpenACS Core is 5.0.0 or later
You do not keep your OpenACS site in a local CVS repository
You do not have any custom code
then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter.  To upgrade directly from the OpenACS repository using the APM:
Browse to the Installer.
Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.
The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server.  After restarting the server again, the upgrade is complete.
Figure 5.1. Upgrading with the APM

It's always a good idea to precede an upgrade attempt with a snapshot backup.
Table 5.1. Assumptions in this section

 
 
name of OpenACS user $OPENACS_SERVICE_NAME
OpenACS server name $OPENACS_SERVICE_NAME
Root of OpenACS file tree /var/lib/aolserver/$OPENACS_SERVICE_NAME
Database backup directory /var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup

Prev Home  Next
Chapter 5. Upgrading Up  Upgrading 4.5 or higher to 4.6.3
docs@openacs.org
View comments on this page at openacs.org
+    OpenACS prior to 4.5, upgrading will require manual effort.
If all of these conditions are true:
Your OpenACS Core is 5.0.0 or later
You do not keep your OpenACS site in a local CVS repository
You do not have any custom code
then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter.  To upgrade directly from the OpenACS repository using the APM:
Browse to the Installer.
Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.
The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server.  After restarting the server again, the upgrade is complete.
Figure 5.1. Upgrading with the APM

It's always a good idea to precede an upgrade attempt with a snapshot backup.
Table 5.1. Assumptions in this section
name of OpenACS user $OPENACS_SERVICE_NAME
OpenACS server name $OPENACS_SERVICE_NAME
Root of OpenACS file tree /var/lib/aolserver/$OPENACS_SERVICE_NAME
Database backup directory /var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup

Prev Home  Next
Chapter 5. Upgrading Up  Upgrading 4.5 or higher to 4.6.3
docs@openacs.org
View comments on this page at openacs.org
Index: openacs-4/packages/acs-core-docs/www/variables.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/variables.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/variables.adp	23 Sep 2015 18:37:48 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/variables.adp	28 Sep 2015 07:54:30 -0000	1.1.2.3
@@ -12,14 +12,14 @@
 Variables
 
 Date and Time Variables

-($Id: variables.html,v 1.30.2.1 2015/09/23
-11:55:06 gustafn Exp $)
By joel\@aufrecht.org
+
($‌Id: variables.xml,v 1.3 2006/07/17 05:38:37
+torbenb Exp $)
By joel\@aufrecht.org
 
 OpenACS docs are written by the named authors, and may be edited by
 OpenACS documentation staff.
Starting with OpenACS 5.0 and the introduction of acs-lang, we
 recommend retrieving date/time information from the database in
 ANSI format and then using lc_time_fmt to format it for display.

-Example 12.1. Getting
+
Example 12.1. Getting
 datetime from the database ANSI-style
 db_multirow -extend { mydate_pretty } {
     select to_char(mydate, 'YYYY-MM-DD HH24:MI:SS') as mydate_ansi,
Index: openacs-4/packages/acs-core-docs/www/variables.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/variables.html,v
diff -u -r1.30.2.1 -r1.30.2.2
--- openacs-4/packages/acs-core-docs/www/variables.html	23 Sep 2015 11:55:06 -0000	1.30.2.1
+++ openacs-4/packages/acs-core-docs/www/variables.html	28 Sep 2015 07:54:30 -0000	1.30.2.2
@@ -4,7 +4,7 @@
           by OpenACS documentation staff.
         
Starting with OpenACS 5.0 and the introduction of acs-lang,
     we recommend retrieving date/time information from the database in
-    ANSI format and then using lc_time_fmt to format it for display.
Example 12.1. Getting datetime from the database ANSI-style
db_multirow -extend { mydate_pretty } {
+    ANSI format and then using lc_time_fmt to format it for display.
Example 12.1. Getting datetime from the database ANSI-style
db_multirow -extend { mydate_pretty } {
     select to_char(mydate, 'YYYY-MM-DD HH24:MI:SS') as mydate_ansi,
           ...
     ...
Index: openacs-4/packages/acs-core-docs/www/win2k-installation.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/win2k-installation.adp,v
diff -u -r1.1.2.2 -r1.1.2.3
--- openacs-4/packages/acs-core-docs/www/win2k-installation.adp	23 Sep 2015 18:37:48 -0000	1.1.2.2
+++ openacs-4/packages/acs-core-docs/www/win2k-installation.adp	28 Sep 2015 07:54:30 -0000	1.1.2.3
@@ -297,8 +297,8 @@
 bin\nsd -I -s iguanasdirect -t iguanasdirect.tcl
 
In the services control panel you should see two services:
 AOLserver-lintcollectors and
-AOLserver-iguanasdirect.
($Id: win2k-installation.html,v 1.49.2.1
-2015/09/23 11:55:07 gustafn Exp $)
+AOLserver-iguanasdirect.
($‌Id: win2kinstall.xml,v 1.10 2006/07/17
+05:38:38 torbenb Exp $)
 
 
 Release 5.9.0 beta
   
     
-      The release contains the 78 packages of the oacs-5-9 branch.
-      These packages contain the OpenACS core packages, major
+      The release of OpenACS 5.9.0 contains the 78 packages of the oacs-5-9 branch.
+      These packages include the OpenACS core packages, the major
       application packages (e.g. most the ones used on OpenACS.org), and
-      DotLRN.
+      DotLRN 2.9.0.
     
 
     
-      Changes for all packages:
+      Summary of changes:
       
 	SQL:
 	
@@ -65,7 +65,7 @@
 	  
 
 	  
-            Removed various manual bookeeping and deletion operations
+            Removed various manual bookkeeping and deletion operations
 	    in the content repository by built-in handing in PostgreSQL.
 	  
 
@@ -99,6 +99,31 @@
             Improved HTML validity (especially for admin pages)
 	  
 
+	  
+            Improved admin interface:
+	    
+	      	   
+	      
+		Placed all installation options to a single page.
+	      
+
+	      
+		Added pagination to /admin/applications (was unusable
+		for large sites)
+	      
+
+	      
+		New admin pages for subsites linked from
+		site-wide-admin package (/acs-admin).
+	      
+
+	      
+		Added explanatory text to several admin pages.
+	      
+
+	    
+	  
+
  	   Add lightweight support for ckeditor4 for
  	  templating::richtext widget (configurable via package
  	  parameter "RichTextEditor" of acs-templating. ckeditor4
@@ -123,10 +148,10 @@
 	  
 
 	  
-            Improved themability for display_templates. One can now
+            Improved them-ability for display_templates. One can now
 	    provide a display_template_name (similar to the sql
 	    statement name) to refer to display templates. This
-	    enables resuabilit and is theme-able.
+	    enables reusability and is theme-able.
 	  
 
 	   Dimensional slider reform (ad_dimensional):
@@ -147,11 +172,15 @@
 	Misc:
 	
  	  
-            Improved Documentation templating (uniform appearance)
+            Improved templating of OpenACS core documentation
 	  
 
+	  
+            Improved Russian Internationalization
+	  
+	  
  	  
-            Make pretty-naming of acs-core packages more consistent
+            Make pretty-names of acs-core packages more consistent
 	  
 
 	  
@@ -160,13 +189,13 @@
 
  	  
 	    Version numbers:
-	    
+	    
 	      
 		Require PG 9.0 (End Of Life of PostgreSQL 8.4 was July 2014)
 	      
 
 	      
-		require XOTcl 2.0 (presented at the Tcl conference in 2011). 
+		Require XOTcl 2.0 (presented at the Tcl conference in 2011). 
 	      
 
 	      
@@ -177,12 +206,21 @@
  	  
 	
 	
+	
+	Changes in application packages: Various bug
+	fixes and improvements for e.g. file-storage, forums, news,
+	notifications, xowiki.
+	
+	
       
      
   
    Altogether, OpenACS 5.9.0 differs from OpenACS 5.8.1 in
   about xxxx modifications (yyyy commits) contributed by zzzz
-  committers.
+  committers. For more details, consult the
+  
+  raw ChangeLog.
   
 
 
Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/os.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/os.xml,v
diff -u -r1.15 -r1.15.14.1
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/os.xml	17 Jul 2006 05:38:37 -0000	1.15
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/os.xml	28 Sep 2015 07:54:30 -0000	1.15.14.1
@@ -11,6 +11,11 @@
   
   
     a Unix-like system
+    Most of the documentation in this section is kept as a
+    reference. More up-to-date documentation is in the install
+    sections in the Wiki.
+    
     You will need a computer running a unix-like system with the following software installed:
     
       tdom
Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml,v
diff -u -r1.29 -r1.29.2.1
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml	27 Oct 2014 16:39:31 -0000	1.29
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml	28 Sep 2015 07:54:30 -0000	1.29.2.1
@@ -8,6 +8,13 @@
 
   Basic Steps
 
+  Most of the documentation in this section is kept as a
+    reference. More up-to-date documentation is in the install
+    sections in the Wiki.
+  
+
+  
   
     The basic steps for installing OpenACS are: