Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/cvs.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/cvs.xml,v diff -u -r1.4.2.2 -r1.4.2.3 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/cvs.xml 1 Dec 2003 20:25:21 -0000 1.4.2.2 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/cvs.xml 15 Dec 2003 14:18:48 -0000 1.4.2.3 @@ -23,22 +23,22 @@ Create and set permissions on a subdirectory in the local cvs repository. - [root@yourserver root]# mkdir /cvsroot/service0 -[root@yourserver root]# chown service0.web /cvsroot/service0 -[root@yourserver root]# + [root root]# mkdir /cvsroot/service0 +[root root]# chown service0.web /cvsroot/service0 +[root root]# mkdir /cvsroot/service0 chown service0.web /cvsroot/service0 Add the repository location to the user environment. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ emacs .bashrc + [root root]# su - service0 +[service0 service0]$ emacs .bashrc Put this string into /home/service0/.bashrc: export CVSROOT=/cvsroot - [service0@yourserver service0]$ exit + [service0 service0]$ exit logout -[root@yourserver root]# +[root root]# Import all files into cvs. In order to work on @@ -53,33 +53,33 @@ "OpenACS" is the vendor tag, and "&cvsversiontag;" is the release tag. These tags will be useful in upgrading and branching. -m sets the version comment. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cd /web/service0 -[service0@yourserver service0]$ cvs import -m "initial install" service0 OpenACS &cvsversiontag; + [root root]# su - service0 +[service0 service0]$ cd /web/service0 +[service0 service0]$ cvs import -m "initial install" service0 OpenACS &cvsversiontag; N service0/license.txt N service0/readme.txt (many lines omitted) N service0/www/SYSTEM/flush-memoized-statement.tcl No conflicts created by this import -[service0@yourserver service0]$ +[service0 service0]$ su - service0 cd /web/service0 cvs import -m "initial install" service0 OpenACS &cvsversiontag; Move the original directory to a temporary location, and check out the cvs repository in its place. If the service starts correctly, come back and remove the temporary copy of the uploaded files. - [service0@yourserver service0]$ cd .. -[service0@yourserver web]$ mv service0 service0.orig -[service0@yourserver web]$ cvs checkout service0 + [service0 service0]$ cd .. +[service0 web]$ mv service0 service0.orig +[service0 web]$ cvs checkout service0 cvs checkout: Updating service0 U service0/license.txt (many lines omitted) U service0/www/SYSTEM/dbtest.tcl U service0/www/SYSTEM/flush-memoized-statement.tcl -[service0@yourserver web]$ exit +[service0 web]$ exit logout -[root@yourserver web]# +[root web]# cd .. mv service0 service0.orig cvs checkout service0 Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-advanced.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-advanced.xml,v diff -u -r1.4.2.1 -r1.4.2.2 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-advanced.xml 19 Nov 2003 14:35:15 -0000 1.4.2.1 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-advanced.xml 15 Dec 2003 14:18:48 -0000 1.4.2.2 @@ -61,11 +61,11 @@ pre-written documentation files for the tutorial app. Log in as service0, create the standard directories, and copy the prepared documentation: - [service0@yourserver service0]$ cd /var/lib/aolserver/service0/packages/samplenote/ -[service0@yourserver samplenote]$ mkdir -p www/doc/xml -[service0@yourserver samplenote]$ cd www/doc/xml -[service0@yourserver xml]$ cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/samplenote/* . -[service0@yourserver xml]$ + [service0 service0]$ cd /var/lib/aolserver/service0/packages/samplenote/ +[service0 samplenote]$ mkdir -p www/doc/xml +[service0 samplenote]$ cd www/doc/xml +[service0 xml]$ cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/samplenote/* . +[service0 xml]$ OpenACS uses DocBook for documentation. DocBook is an XML standard for semantic markup of documentation. That means that the tags you use indicate meaning, not intended @@ -86,7 +86,7 @@ directory. A Makefile is provided to generate html from the xml, and copy all of the supporting files. If Docbook is set up correctly, all you need to do is: - [service0@yourserver xml]$ make + [service0 xml]$ make cd .. ; /usr/bin/xsltproc ../../../acs-core-docs/www/xml/openacs.xsl xml/index.xml Writing requirements-introduction.html for sect1(requirements-introduction) Writing requirements-overview.html for sect1(requirements-overview) @@ -102,7 +102,7 @@ Writing admin-guide.html for chapter(admin-guide) Writing bi01.html for bibliography Writing index.html for book -[service0@yourserver xml]$ +[service0 xml]$ Verify that the documentation was generated and reflects your changes by browsing to http://yoursite:8000/samplenote/doc @@ -114,20 +114,20 @@ traverse the directory tree manually and add as you go. (More on CVS) - [service0@yourserver xml]$ cd .. -[service0@yourserver doc]$ cd .. -[service0@yourserver www]$ cd .. -[service0@yourserver samplenote]$ cd .. -[service0@yourserver packages]$ cvs add samplenote/ + [service0 xml]$ cd .. +[service0 doc]$ cd .. +[service0 www]$ cd .. +[service0 samplenote]$ cd .. +[service0 packages]$ cvs add samplenote/ Directory /cvsroot/service0/packages/samplenote added to the repository -[service0@yourserver packages]$ cd samplenote/ -[service0@yourserver samplenote]$ cvs add www +[service0 packages]$ cd samplenote/ +[service0 samplenote]$ cvs add www Directory /cvsroot/service0/packages/samplenote/www added to the repository -[service0@yourserver samplenote]$ cd www -[service0@yourserver www]$ cvs add doc +[service0 samplenote]$ cd www +[service0 www]$ cvs add doc Directory /cvsroot/service0/packages/samplenote/www/doc added to the repository -[service0@yourserver www]$ cd doc -[service0@yourserver doc]$ cvs add * +[service0 www]$ cd doc +[service0 doc]$ cvs add * cvs add: cannot add special file `CVS'; skipping cvs add: scheduling file `admin-guide.html' for addition cvs add: scheduling file `bi01.html' for addition @@ -152,13 +152,13 @@ cvs add: scheduling file `user-interface.png' for addition Directory /cvsroot/service0/packages/samplenote/www/doc/xml added to the repository cvs add: use 'cvs commit' to add these files permanently -[service0@yourserver doc]$ cd xml -[service0@yourserver xml]$ cvs add Makefile index.xml +[service0 doc]$ cd xml +[service0 xml]$ cvs add Makefile index.xml cvs add: scheduling file `Makefile' for addition cvs add: scheduling file `index.xml' for addition cvs add: use 'cvs commit' to add these files permanently -[service0@yourserver xml]$ cd ../../.. -[service0@yourserver samplenote]$ cvs commit -m "new package" +[service0 xml]$ cd ../../.. +[service0 samplenote]$ cvs commit -m "new package" cvs commit: Examining . cvs commit: Examining www cvs commit: Examining www/doc @@ -170,7 +170,7 @@ initial revision: 1.1 done (many lines omitted) -[service0@yourserver samplenote]$ +[service0 samplenote]$ Delete with confirmation @@ -179,7 +179,7 @@ Add this column to the table_def in index.tcl {delete "" {} {<td><a href="note-delete?note_id=$note_id">Delete</a></td>}} Create the delete confirmation/execution page. - [service0@yourserver www]$ emacs note-delete.tcl + [service0 www]$ emacs note-delete.tcl ad_page_contract { A page that gets confirmation and then delete notes. @@ -224,7 +224,7 @@ script execution. The database commands: - [service0@yourserver www]$ emacs note-delete.xql + [service0 www]$ emacs note-delete.xql <?xml version="1.0"?> <queryset> <fullquery name="do_delete"> @@ -239,7 +239,7 @@ </fullquery> </queryset> And the adp page: - [service0@yourserver www]$ emacs note-delete.adp + [service0 www]$ emacs note-delete.adp <master> <property name="title">@title@</property> <property name="context">{@title@}</property> Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-db.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-db.xml,v diff -u -r1.7.2.2 -r1.7.2.3 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-db.xml 29 Nov 2003 15:17:54 -0000 1.7.2.2 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-db.xml 15 Dec 2003 14:18:48 -0000 1.7.2.3 @@ -55,7 +55,7 @@ by the API browser. The string $Id:$ will automatically be expanded when the file is checked in to cvs. -[service0@yourserver postgresql]$ emacs myfirstpackage-create.sql +[service0 postgresql]$ emacs myfirstpackage-create.sql Paste this into the file and save and close.
Database Creation Script - master create file @@ -88,7 +88,7 @@ Create a database file to drop everything if the package is uninstalled. - [service0@yourserver postgresql]$ emacs myfirstpackage-drop.sql + [service0 postgresql]$ emacs myfirstpackage-drop.sql
Database deletion script -- packages/myfirstpackage/sql/myfirstpackage-drop.sql @@ -107,24 +107,24 @@
Run the create script manually to add your tables and functions. - [service0@yourserver postgresql]$ psql -f myfirstpackage-create.sql + [service0 postgresql]$ psql -f myfirstpackage-create.sql psql:myfirstpackage-create.sql:14: NOTICE: CREATE TABLE / PRIMARY KEY will create implicit index 'mfp_notes_pkey' for table 'mfp_notes' psql:myfirstpackage-create.sql:14: NOTICE: CREATE TABLE will create implicit trigger(s) for FOREIGN KEY check(s) content_type__create_type --------------------------- 0 (1 row) -[service0@yourserver postgresql]$ +[service0 postgresql]$ If there are errors, use them to debug the sql file and try again. If there are errors in the database table creation, you may need to run the drop script to drop the table so that you can recreate it. The drop script will probably have errors since some of the things it's trying to drop may be missing. They can be ignored. Once you get the same output as shown above, test the drop script: - [service0@yourserver postgresql]$ psql -f myfirstpackage-drop.sql + [service0 postgresql]$ psql -f myfirstpackage-drop.sql content_type__drop_type ------------------------- 0 (1 row) -[service0@yourserver postgresql]$ +[service0 postgresql]$ Once both scripts are working without errors, run the create script one last time and proceed. Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml,v diff -u -r1.5.2.2 -r1.5.2.3 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml 19 Nov 2003 14:35:15 -0000 1.5.2.2 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-pages.xml 15 Dec 2003 14:18:48 -0000 1.5.2.3 @@ -31,13 +31,13 @@ database-specific SQL. The default page in any directory is index, so we'll build that first, starting with the tcl file: - [service0@yourserver postgresql]$ cd /var/lib/aolserver/service0/myfirstpackages/www + [service0 postgresql]$ cd /var/lib/aolserver/service0/myfirstpackages/www [service0@yourserver www emacs index.tcl Paste this into the file. ad_page_contract { 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@yourserver.test) + @author Your Name (you@example.com) @cvs-id $Id$ } @@ -98,7 +98,7 @@ ad_page_contract { 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@yourserver.test) + @author Your Name (you@example.com) @cvs-id $Id$ @param item_id If present, assume we are editing that note. Otherwise, we are creating a new note. @@ -147,7 +147,7 @@ ad_page_contract { This deletes a note - @author Your Name (you@yourserver.test) + @author Your Name (you@example.com) @cvs-id $Id$ @param item_id The item_id of the note to delete Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/aolserver.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/aolserver.xml,v diff -u -r1.15.2.3 -r1.15.2.4 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/aolserver.xml 9 Dec 2003 09:54:04 -0000 1.15.2.3 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/aolserver.xml 15 Dec 2003 14:18:48 -0000 1.15.2.4 @@ -18,8 +18,8 @@ Download the aolserver tarball and unpack it. - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz + [root root]# cd /usr/local/src +[root src]# wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz --15:38:08-- http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz => `aolserver3.3oacs1.tar.gz' Resolving uptime.openacs.org... done. @@ -30,8 +30,8 @@ 100%[====================================>] 3,858,074 66.56K/s ETA 00:00 15:39:05 (66.56 KB/s) - `aolserver3.3oacs1.tar.gz' saved [3858074/3858074] -[root@yourserver src]# tar xzf aolserver3.3oacs1.tar.gz -[root@yourserver src]# +[root src]# tar xzf aolserver3.3oacs1.tar.gz +[root src]# cd /usr/local/src wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz tar xzf aolserver3.3oacs1.tar.gz @@ -44,11 +44,11 @@ Compile and install AOLserver. First, prepare the installation directory and the source code. The message about BUILD-MODULES can be ignored. root@yourserver root]# mkdir -p /usr/local/aolserver -[root@yourserver root]# cd /usr/local/src/aolserver -[root@yourserver aolserver]# ./conf-clean +[root root]# cd /usr/local/src/aolserver +[root aolserver]# ./conf-clean cat: BUILD-MODULES: No such file or directory Done. -[root@yourserver aolserver]#mkdir -p /usr/local/aolserver +[root aolserver]#mkdir -p /usr/local/aolserver cd /usr/local/src/aolserver ./conf-clean @@ -65,8 +65,8 @@ conf-inst should contain the location where AOLserver is to be installed. Overwrite the tarball's default value with our default value, /usr/local/aolserver: - [root@yourserver aolserver]# echo "/usr/local/aolserver" > conf-inst -[root@yourserver aolserver]# + [root aolserver]# echo "/usr/local/aolserver" > conf-inst +[root aolserver]# conf-make should contain the name of the GNU Make command on your system. It defaults to @@ -81,7 +81,7 @@ make these symlinks: ln -s /usr/include/postgresql/ /usr/include/pgsql and ln -s /usr/lib/postgresql /usr/local/pgsql) - [root@yourserver aolserver]# export POSTGRES=/usr/local/pgsql; ./conf + [root aolserver]# export POSTGRES=/usr/local/pgsql; ./conf Building in /usr/local/aolserver with the following modules: aolserver @@ -102,7 +102,7 @@ Creating ... ================================================================== Done Building Sat Mar 8 10:31:35 PST 2003 -[root@yourserver aolserver]# +[root aolserver]# This takes about 5 minutes. It builds aolserver, several modules, and the database driver. (Upgraders, note that the postgres database driver has changed from postgres.so to nspostgres.so). All of the results are logged to files in /usr/local/src/aolserver/log. If you run into problems running AOLserver, check these files for build errors. @@ -121,20 +121,20 @@ Oracle - [root@yourserver aolserver]# cd /usr/local/aolserver/bin -[root@yourserver bin]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle -[root@yourserver bin]# chmod 750 nsd-oracle -[root@yourserver bin]# + [root aolserver]# cd /usr/local/aolserver/bin +[root bin]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle +[root bin]# chmod 750 nsd-oracle +[root bin]# cd /usr/local/aolserver/bin cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle chmod 750 nsd-oracle PostgreSQL - [root@yourserver aolserver]# cd /usr/local/aolserver/bin -[root@yourserver bin]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres -[root@yourserver bin]# chmod 755 nsd-postgres -[root@yourserver bin]# + [root aolserver]# cd /usr/local/aolserver/bin +[root bin]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres +[root bin]# chmod 755 nsd-postgres +[root bin]# cd /usr/local/aolserver/bin cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres chmod 755 nsd-postgres @@ -148,8 +148,8 @@ tarball, unpack it, adjust the configuration file to match our patched distribution of aolserver, and compile it. - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz + [root root]# cd /usr/local/src +[root src]# wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz --16:40:58-- http://www.tdom.org/tDOM-0.7.8.tar.gz => `tDOM-0.7.8.tar.gz' Resolving www.tdom.org... done. @@ -161,9 +161,9 @@ 16:41:04 (138.06 KB/s) - `tDOM-0.7.8.tar.gz' saved [826613/826613] -[root@yourserver src]# tar xzf tDOM-0.7.8.tar.gz -[root@yourserver src]# cd tDOM-0.7.8/unix -[root@yourserver unix]# +[root src]# tar xzf tDOM-0.7.8.tar.gz +[root src]# cd tDOM-0.7.8/unix +[root unix]# cd /usr/local/src wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz tar xzf tDOM-0.7.8.tar.gz @@ -181,22 +181,22 @@ --with-aolserver=$aolsrc \ --with-tcl=$aolsrc/tcl8.3.2/unix And configure and compile: - [root@yourserver unix]# sh CONFIG + [root unix]# sh CONFIG creating cache ./config.cache checking for memmove... yes (many lines omitted) creating Makefile creating tdomConfig.sh -[root@yourserver unix]# make +[root unix]# make gcc -pipe -DHAVE_UNISTD_H=1 -DHAVE_LIMITS_H=1 -DTCL_THREADS=1 -DHAVE_GETCWD=1 -DHAVE_OPENDIR=1 -DHAVE_STRSTR=1 -DHAVE_STRTOL=1 (many lines omitted) -Wl,-rpath,/usr/local/lib -o tcldomsh;\ fi -[root@yourserver unix]# cp libtdom0.7.8.so /usr/local/aolserver/bin/ -[root@yourserver unix]# cd /usr/local/aolserver/bin/ -[root@yourserver bin]# ln -s libtdom0.7.8.so libtdom.so -[root@yourserver bin]# +[root unix]# cp libtdom0.7.8.so /usr/local/aolserver/bin/ +[root unix]# cd /usr/local/aolserver/bin/ +[root bin]# ln -s libtdom0.7.8.so libtdom.so +[root bin]# sh CONFIG make @@ -227,10 +227,10 @@ /usr/local/aolserver/log and /usr/local/aolserver/servers. - [root@yourserver root]# cd /usr/local/aolserver -[root@yourserver aolserver]# chown -R root.web log servers -[root@yourserver aolserver]# chmod -R g+w log servers -[root@yourserver aolserver]# ls -l + [root root]# cd /usr/local/aolserver +[root aolserver]# chown -R root.web log servers +[root aolserver]# chmod -R g+w log servers +[root aolserver]# ls -l total 32 drwxr-sr-x 2 root root 4096 Mar 8 12:57 bin drwxr-xr-x 3 root root 4096 Mar 8 10:34 include @@ -239,7 +239,7 @@ drwxr-sr-x 3 root root 4096 Mar 8 10:31 modules -rw-r--r-- 1 root root 7320 Mar 31 2001 sample-config.tcl drwxrwsr-x 3 root web 4096 Mar 8 10:31 servers -[root@yourserver aolserver]# +[root aolserver]# cd /usr/local/aolserver chown -R root.web log servers @@ -252,8 +252,8 @@ hostname. It will then start up the server at port 8000 of that IP address. - [root@yourserver aolserver]# ./bin/nsd -t sample-config.tcl -u nobody -g web -[root@yourserver aolserver]# [08/Mar/2003:15:07:18][31175.8192][-main-] Notice: config.tcl: starting to read config file... + [root aolserver]# ./bin/nsd -t sample-config.tcl -u nobody -g web +[root aolserver]# [08/Mar/2003:15:07:18][31175.8192][-main-] Notice: config.tcl: starting to read config file... [08/Mar/2003:15:07:18][31175.8192][-main-] Warning: config.tcl: nsssl not loaded -- key/cert files do not exist. [08/Mar/2003:15:07:18][31175.8192][-main-] Warning: config.tcl: nscp not loaded -- user/password is not set. @@ -274,7 +274,7 @@ - [root@yourserver aolserver]# lynx localhost:8000 + [root aolserver]# lynx localhost:8000 @@ -287,8 +287,8 @@ Shutdown the test server: - [root@yourserver aolserver]# killall nsd -[root@yourserver aolserver]# + [root aolserver]# killall nsd +[root aolserver]# Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/maintenance.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/maintenance.xml,v diff -u -r1.5.2.3 -r1.5.2.4 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/maintenance.xml 29 Nov 2003 15:17:54 -0000 1.5.2.3 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/maintenance.xml 15 Dec 2003 14:18:48 -0000 1.5.2.4 @@ -33,16 +33,16 @@ tarball at /var/lib/aolserver/service0/etc/daemontools. To use it, first ill any existing AOLserver instances. As root, link the daemontools directory into the /service directory. Daemontools' svscan process checks this directory every five seconds, and will quickly execute run. - [service0@yourserver etc]$ killall nsd + [service0 etc]$ killall nsd nsd: no process killed -[service0@yourserver etc]$ exit +[service0 etc]$ exit -[root@yourserver root]# ln -s /var/lib/aolserver/service0/etc/daemontools/ /service/service0 +[root root]# ln -s /var/lib/aolserver/service0/etc/daemontools/ /service/service0 Verify that AOLserver is running. - [root@yourserver root]# ps -auxw | grep nsd + [root root]# ps -auxw | grep nsd service0 5562 14.2 6.2 22436 15952 ? S 11:55 0:04 /usr/local/aolserver/bin/nsd -it /var/lib/aolserver/service0/etc/config.tcl -u serve root 5582 0.0 0.2 3276 628 pts/0 S 11:55 0:00 grep nsd -[root@yourserver root]# +[root root]# The user service0 can now control the service service0 with these commands: @@ -89,16 +89,16 @@ Install a script to automate the stopping and starting of AOLserver services via daemontools. You can then restart a service via restart-aolserver service0 - [root@yourserver root]# cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/restart-aolserver-daemontools.txt /usr/local/bin/restart-aolserver -[root@yourserver root]# chmod 755 /usr/local/bin/restart-aolserver -[root@yourserver root]# + [root root]# cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/restart-aolserver-daemontools.txt /usr/local/bin/restart-aolserver +[root root]# chmod 755 /usr/local/bin/restart-aolserver +[root root]# At this point, these commands will work only for the root user. Grant permission for the web group to use svc commands on the service0 server. - [root@yourserver root]# svgroup web /service/service0 -[root@yourserver root]# + [root root]# svgroup web /service/service0 +[root root]# Verify that the controls work. You may want to tail -f /var/lib/aolserver/service0/log/service0-error.log in another window, so you can see what happens when you type these commands. @@ -328,17 +328,17 @@ Prepare a certificate directory for the service. - [service0@yourserver etc]$ mkdir /var/lib/aolserver/service0/etc/certs -[service0@yourserver etc]$ chmod 700 /var/lib/aolserver/service0/etc/certs -[service0@yourserver etc]$ + [service0 etc]$ mkdir /var/lib/aolserver/service0/etc/certs +[service0 etc]$ chmod 700 /var/lib/aolserver/service0/etc/certs +[service0 etc]$ mkdir /var/lib/aolserver/service0/etc/certs chmod 700 /var/lib/aolserver/service0/etc/certs It takes two files to support an SSL connection. The certificate is the public half of the key pair - the server sends the certificate to browser requesting ssl. The key is the private half of the key pair. In addition, the certificate must be signed by Certificate Authority or browsers will protest. Each web browser ships with a built-in list of acceptable Certificate Authorities (CAs) and their keys. Only a site certificate signed by a known and approved CA will work smoothly. Any other certificate will cause browsers to produce some messages or block the site. Unfortunately, getting a site certificate signed by a CA costs money. In this section, we'll generate an unsigned certificate which will work in most browsers, albeit with pop-up messages. Use an OpenSSL perl script to generate a certificate and key. - [service0@yourserver service0]$ cd /var/lib/aolserver/service0/etc/certs -[service0@yourserver certs]$ perl /usr/share/ssl/misc/CA -newcert + [service0 service0]$ cd /var/lib/aolserver/service0/etc/certs +[service0 certs]$ perl /usr/share/ssl/misc/CA -newcert Using configuration from /usr/share/ssl/openssl.cnf Generating a 1024 bit RSA private key ...++++++ @@ -347,16 +347,16 @@ Enter PEM pass phrase: Enter a pass phrase for the CA certificate. Then, answer the rest of the questions. At the end you should see this: Certificate (and private key) is in newreq.pem -[service0@yourserver certs]$ +[service0 certs]$ newreq.pem contains our certificate and private key. The key is protected by a passphrase, which means that we'll have to enter the pass phrase each time the server starts. This is impractical and unnecessary, so we create an unprotected version of the key. Security implication: if anyone gets access to the file keyfile.pem, they effectively own the key as much as you do. Mitigation: don't use this key/cert combo for anything besides providing ssl for the web site. - [root@yourserver misc]# openssl rsa -in newreq.pem -out keyfile.pem + [root misc]# openssl rsa -in newreq.pem -out keyfile.pem read RSA key Enter PEM pass phrase: writing RSA key -[service0@yourserver certs]$ +[service0 certs]$ To create the certificate file, we take the combined file, copy it, and strip out the key. - [service0@yourserver certs]$ cp newreq.pem certfile.pem -[root@yourserver misc]# emacs certfile.pem + [service0 certs]$ cp newreq.pem certfile.pem +[root misc]# emacs certfile.pem Strip out the section that looks like -----BEGIN RSA PRIVATE KEY----- Proc-Type: 4,ENCRYPTED @@ -379,12 +379,12 @@ the OpenACS tarball. - [root@yourserver src]# su - service0 -[service0@yourserver service0]$ cd /var/lib/aolserver/service0 -[service0@yourserver service0]$ cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/analog.cfg.txt etc/analog.cfg -[service0@yourserver service0]$ mkdir www/log -[service0@yourserver service0]$ cp -r /usr/share/analog-5.31/images www/log/ -[service0@yourserver service0]$ + [root src]# su - service0 +[service0 service0]$ cd /var/lib/aolserver/service0 +[service0 service0]$ cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/analog.cfg.txt etc/analog.cfg +[service0 service0]$ mkdir www/log +[service0 service0]$ cp -r /usr/share/analog-5.31/images www/log/ +[service0 service0]$ su - service0 cd /var/lib/aolserver/service0 cp /var/lib/aolserver/service0/packages/acs-core-docs/www/files/analog.cfg.txt etc/analog.cfg @@ -399,29 +399,29 @@ Run it. - [service0@yourserver service0]$ /usr/share/analog-5.31/analog -G -g/var/lib/aolserver/service0/etc/analog.cfg + [service0 service0]$ /usr/share/analog-5.31/analog -G -g/var/lib/aolserver/service0/etc/analog.cfg /usr/share/analog-5.31/analog: analog version 5.31/Unix /usr/share/analog-5.31/analog: Warning F: Failed to open DNS input file /home/service0/dnscache: ignoring it (For help on all errors and warnings, see docs/errors.html) /usr/share/analog-5.31/analog: Warning R: Turning off empty Search Word Report -[service0@yourserver service0]$ +[service0 service0]$ Verify that it works by browing to http://yourserver.test:8000/log/traffic.html Automate this by creating a file in /etc/cron.daily. - [service0@yourserver service0]$ exit + [service0 service0]$ exit logout -[root@yourserver root]# emacs /etc/cron.daily/analog +[root root]# emacs /etc/cron.daily/analog Put this into the file: #!/bin/sh /usr/share/analog-5.31/analog -G -g/var/lib/aolserver/service0/etc/analog.cfg - [root@yourserver root]# chmod 755 /etc/cron.daily/analog + [root root]# chmod 755 /etc/cron.daily/analog Test it by running the script. - [root@yourserver root]# sh /etc/cron.daily/analog + [root root]# sh /etc/cron.daily/analog Browse to http://yourserver.test/log/traffic.html Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml,v diff -u -r1.15.2.4 -r1.15.2.5 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 29 Nov 2003 15:17:54 -0000 1.15.2.4 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 15 Dec 2003 14:18:48 -0000 1.15.2.5 @@ -19,10 +19,10 @@ /var/lib/aolserver, one subdirectory per site. The first time you install an OpenACS site on a server, you must create the parent directory and set its permissions: - [root@yourserver root]# mkdir /var/lib/aolserver -[root@yourserver root]# chgrp web /var/lib/aolserver -[root@yourserver root]# chmod 770 /var/lib/aolserver -[root@yourserver root]# + [root root]# mkdir /var/lib/aolserver +[root root]# chgrp web /var/lib/aolserver +[root root]# chmod 770 /var/lib/aolserver +[root root]# mkdir /var/lib/aolserver chgrp web /var/lib/aolserver chmod 770 /var/lib/aolserver @@ -55,9 +55,9 @@ can use database and server commands associated with that group. - [root@yourserver root]# groupadd web -[root@yourserver root]# useradd -g service0 -G web service0 -d /home/service0 -[root@yourserver root]# + [root root]# groupadd web +[root root]# useradd -g service0 -G web service0 -d /home/service0 +[root root]# @@ -72,24 +72,24 @@ service's dedicated user. We put it there so that it is not overwritten when we do the main CVS checkout to the target location. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cvs -d :pserver:anonymous@openacs.org:/cvsroot co -d install openacs-4/etc/install + [root root]# su - service0 +[service0 service0]$ cvs -d :pserver:anonymous@openacs.org:/cvsroot co -d install openacs-4/etc/install cvs server: Updating install U install/README U install/TODO ... many lines omitted ... U install/tcl/twt-procs.tcl U install/tcl/user-procs.tcl -[service0@yourserver service0]$ cd install -[service0@yourserver install]$ +[service0 service0]$ cd install +[service0 install]$ Edit /home/service0/install/install.tcl and change the values as documented in the file. It will work unchanged at 127.0.0.1:8000. Run the file as root. - [service0@yourserver service0]$ exit -[root@yourserver root]# sh /home/service0/install/install.sh + [service0 service0]$ exit +[root root]# sh /home/service0/install/install.sh /home/service0/install/install.sh: Starting installation with config_file /home/service0/install/install.tcl. Using serverroot=/var/lib/aolserver/ service0, server_url=http://0.0.0.0:8000, do_checkout=yes, do_install=yes, @@ -98,7 +98,7 @@ ./install.sh: Finished (re)installing /var/lib/aolserver/service0 at Wed Nov 5 13:27:17 CET 2003. Access the new site at http://127.0.0.1:8000 with admin username admin@yourserver.test and password 1 -[root@yourserver root]# +[root root]# You can proceed to . @@ -112,20 +112,20 @@ Unpack the OpenACS tarball and rename it to service0. Secure the directory so that only the owner can access it. Check the permissions by listing the directory. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cd /var/lib/aolserver -[service0@yourserver aolserver]$ tar xzf /tmp/&tarballpath;.tgz -[service0@yourserver aolserver]$ mv &tarballpath; service0 -[service0@yourserver aolserver]$ chmod -R 700 service0 -[service0@yourserver aolserver]$ ls -al + [root root]# su - service0 +[service0 service0]$ cd /var/lib/aolserver +[service0 aolserver]$ tar xzf /tmp/&tarballpath;.tgz +[service0 aolserver]$ mv &tarballpath; service0 +[service0 aolserver]$ chmod -R 700 service0 +[service0 aolserver]$ ls -al total 3 drwxrwx--- 3 root web 1024 Mar 29 16:41 . drwxr-xr-x 25 root root 1024 Mar 29 16:24 .. drwx------ 7 service0 web 1024 Jan 6 14:36 service0 -[service0@yourserver aolserver]$ exit +[service0 aolserver]$ exit logout -[root@yourserver root]# +[root root]# su - service0 cd /var/lib/aolserver tar xzf /tmp/&tarballpath;.tgz @@ -327,20 +327,20 @@ PostgreSQL: Create a user in the database matching the service name. With default PostgreSQL authentication, a system user connecting locally automatically authenticates as the postgres user of the same name, if one exists. We currently use postgres "super-users" for everything, which means that anyone with access to any of the openacs system accounts on a machine has full access to all postgresql databases on that machine. - [root@yourserver root]# su - postgres -[postgres@yourserver pgsql]$ createuser -a -d service0 + [root root]# su - postgres +[postgres pgsql]$ createuser -a -d service0 CREATE USER -[postgres@yourserver pgsql]$ exit +[postgres pgsql]$ exit logout -[root@yourserver root]# +[root root]# Create a database with the same name as our service name, service0. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ createdb -E UNICODE service0 + [root root]# su - service0 +[service0 service0]$ createdb -E UNICODE service0 CREATE DATABASE -[service0@yourserver service0]$ +[service0 service0]$ su - service0 createdb -E UNICODE service0 @@ -350,7 +350,7 @@ Postgres Vacuuming - [service0@yourserver service0]$ export EDITOR=emacs;crontab -e + [service0 service0]$ export EDITOR=emacs;crontab -e Add this line to the file. 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. 0 1-23 * * * /usr/local/pgsql/bin/vacuumdb --full --analyze service0 0 0 * * * /usr/local/pgsql/bin/vacuumdb --full --analyze service0 @@ -359,10 +359,10 @@ Add Full Text Search Support (OPTIONAL) - [service0@yourserver service0]$ exit + [service0 service0]$ exit logout -[root@yourserver root]# +[root root]# @@ -388,9 +388,9 @@ configuration - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ cd /var/lib/aolserver/service0/etc -[service0@yourserver etc]# emacs config.tcl + [root root]# su - service0 +[service0 service0]$ cd /var/lib/aolserver/service0/etc +[service0 etc]$ emacs config.tcl You can continue without changing any values in the file. However, if you don't change address to match the computer's ip address, you won't be able to browse to your server from other machines. @@ -479,10 +479,10 @@ 501 -g 502. Second, if you are root then killall will affect all OpenACS services on the machine, so if there's more than one you'll have to do ps -auxw | grep nsd and selectively kill by job number. - [service0@yourserver etc]$ killall nsd + [service0 etc]$ killall nsd nsd: no process killed -[service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/etc/config.tcl -[service0@yourserver service0]$ [08/Mar/2003:18:13:29][32131.8192][-main-] Notice: nsd.tcl: starting to read config file... +[service0 service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/etc/config.tcl +[service0 service0]$ [08/Mar/2003:18:13:29][32131.8192][-main-] Notice: nsd.tcl: starting to read config file... [08/Mar/2003:18:13:29][32131.8192][-main-] Notice: nsd.tcl: finished reading config file. @@ -593,7 +593,7 @@ AOLserver to restart itself (ie. inittab or daemontools), you'll need to manually restart your service. - [service0@yourserver service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/config.tcl + [service0 service0]$ /usr/local/aolserver/bin/nsd-postgres -t /var/lib/aolserver/service0/config.tcl @@ -641,8 +641,8 @@ database, because those environmental variables are set by the wrapper scripts nsd-postgres and nsd-oracle. - [root@yourserver root]# su - service0 -[service0@yourserver service0]$ emacs .bashrc + [root root]# su - service0 +[service0 service0]$ emacs .bashrc Put in the appropriate lines for the database you are running. If you will use both databases, put in both sets of lines. @@ -668,10 +668,10 @@ Test this by logging out and back in as service0 and checking the paths. - [service0@yourserver service0]$ exit + [service0 service0]$ exit logout -[root@yourserver src]# su - service0 -[postgres@yourserver pgsql]$ env | grep PATH +[root src]# su - service0 +[postgres pgsql]$ env | grep PATH @@ -691,10 +691,10 @@ ORA_NLS33=$ORACLE_HOME/ocommon/nls/admin/data - [service0@yourserver service0]$ exit + [service0 service0]$ exit logout -[root@yourserver root]# +[root root]# Test your backup and recovery procedure. Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/other-software.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/other-software.xml,v diff -u -r1.9.2.3 -r1.9.2.4 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/other-software.xml 29 Nov 2003 15:17:54 -0000 1.9.2.3 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/other-software.xml 15 Dec 2003 14:18:48 -0000 1.9.2.4 @@ -23,20 +23,20 @@ The OpenACS tarball contains sample configuration files for some of the packages listed below. In order to access those files, unpack the tarball now. - [root@yourserver root]# cd /tmp -[root@yourserver tmp]# tar xzf &tarballpath;.tgz + [root root]# cd /tmp +[root tmp]# tar xzf &tarballpath;.tgz cd /tmp tar xzf &tarballpath;.tgz If you are installing from a different method and just need the configuration files, you can instead get them from CVS: -[root@yourserver root]# cd /tmp -[root@yourserver tmp]# cvs -d :pserver:anonymous@openacs.org:/cvsroot co openacs-4/packages/acs-core-docs/www/files/ +[root root]# cd /tmp +[root tmp]# cvs -d :pserver:anonymous@openacs.org:/cvsroot co openacs-4/packages/acs-core-docs/www/files/ cvs checkout: warning: failed to open /root/.cvspass for reading: No such file or directory cvs server: Updating openacs-4/packages/acs-core-docs/www/files U openacs-4/packages/acs-core-docs/www/files/README.TXT (many lines omitted) U openacs-4/packages/acs-core-docs/www/files/template-ini.ini U openacs-4/packages/acs-core-docs/www/files/winnsd.txt -[root@yourserver tmp]# mv openacs-4 &tarballpath; +[root tmp]# mv openacs-4 &tarballpath; cd /tmp cvs -d :pserver:anonymous@openacs.org:/cvsroot co openacs-4/packages/acs-core-docs/www/files/ mv openacs-4 openacs-5.0.0a4 @@ -49,9 +49,9 @@ CVS is a source control system. Create and initialize a directory for a local cvs repository. - [root@yourserver tmp]# mkdir /cvsroot -[root@yourserver tmp]# cvs -d /cvsroot init -[root@yourserver tmp]# + [root tmp]# mkdir /cvsroot +[root tmp]# cvs -d /cvsroot init +[root tmp]# mkdir /cvsroot cvs -d /cvsroot init @@ -68,9 +68,9 @@ fixes the backspace -> help mis-mapping that often occurs in terminals. - [root@yourserver tmp]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/emacs.txt /etc/skel/.emacs + [root tmp]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/emacs.txt /etc/skel/.emacs cp: overwrite `/etc/skel/.emacs'? y -[root@yourserver tmp]# +[root tmp]# Debian users: apt-get install psgml Note: The new nxml mode for emacs, when used in combination with psgml, provides a pretty good set of functionality that makes DocBook editing much less painless. In particular, nxml does syntax testing in real-time so that you can see syntax errors immediately instead of in the output of the xsltproc hours or days later. For debian, apt-get install nxml. @@ -95,18 +95,18 @@ Red Hat 8 - [root@yourserver root]# mkdir -p /package -[root@yourserver root]# chmod 1755 /package/ -[root@yourserver root]# cd /package/ -[root@yourserver package]# tar xzf /tmp/daemontools-0.76.tar.gz -[root@yourserver package]# cd admin/daemontools-0.76/ -[root@yourserver daemontools-0.76]# package/install + [root root]# mkdir -p /package +[root root]# chmod 1755 /package/ +[root root]# cd /package/ +[root package]# tar xzf /tmp/daemontools-0.76.tar.gz +[root package]# cd admin/daemontools-0.76/ +[root daemontools-0.76]# package/install Linking ./src/* into ./compile... Creating /service... Adding svscanboot to inittab... init should start svscan now. -[root@yourserver root]# +[root root]# mkdir -p /package chmod 1755 /package cd /package @@ -120,12 +120,12 @@ /tmp, or download it. - [root@yourserver root]# mkdir -p /package -[root@yourserver root]# chmod 1755 /package/ -[root@yourserver root]# cd /package/ -[root@yourserver package]# tar xzf /tmp/daemontools-0.76.tar.gz -[root@yourserver package]# cd admin -[root@yourserver admin]# wget http://moni.csi.hu/pub/glibc-2.3.1/daemontools-0.76.errno.patch + [root root]# mkdir -p /package +[root root]# chmod 1755 /package/ +[root root]# cd /package/ +[root package]# tar xzf /tmp/daemontools-0.76.tar.gz +[root package]# cd admin +[root admin]# wget http://moni.csi.hu/pub/glibc-2.3.1/daemontools-0.76.errno.patch --14:19:24-- http://moni.csi.hu/pub/glibc-2.3.1/daemontools-0.76.errno.patch => `daemontools-0.76.errno.patch' Resolving moni.csi.hu... done. @@ -137,14 +137,14 @@ 14:19:24 (346.68 KB/s) - `daemontools-0.76.errno.patch' saved [355/355] -[root@yourserver admin]# cd daemontools-0.76 -[root@yourserver daemontools-0.76]# patch -p1 < ../daemontools-0.76.errno.patch -[root@yourserver daemontools-0.76]# package/install +[root admin]# cd daemontools-0.76 +[root daemontools-0.76]# patch -p1 < ../daemontools-0.76.errno.patch +[root daemontools-0.76]# package/install Linking ./src/* into ./compile...(many lines omitted) Creating /service... Adding svscanboot to inittab... init should start svscan now. -[root@yourserver root]# +[root root]# mkdir -p /package chmod 1755 /package cd /package @@ -165,16 +165,16 @@ Verify that svscan is running. If it is, you should see these two processes running: - [root@yourserver root]# ps -auxw | grep service + [root root]# ps -auxw | grep service root 13294 0.0 0.1 1352 272 ? S 09:51 0:00 svscan /service root 13295 0.0 0.0 1304 208 ? S 09:51 0:00 readproctitle service errors: ....................................... -[root@yourserver root]# +[root root]# Install a script to grant non-root users permission to control daemontools services. - [root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/svgroup.txt /usr/local/bin/svgroup -[root@yourserver root]# chmod 755 /usr/local/bin/svgroup + [root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/svgroup.txt /usr/local/bin/svgroup +[root root]# chmod 755 /usr/local/bin/svgroup cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/svgroup.txt /usr/local/bin/svgroup chmod 755 /usr/local/bin/svgroup @@ -195,9 +195,9 @@ This program handles incoming tcp connections. Download ucspi and install it. - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz -[root@yourserver src]# tar xzf ucspi-tcp-0.88.tar.gz + [root root]# cd /usr/local/src +[root src]# wget http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz +[root src]# tar xzf ucspi-tcp-0.88.tar.gz cd /usr/local/src wget http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz tar xzf ucspi-tcp-0.88.tar.gz @@ -207,26 +207,26 @@ patch -p1 <../ucspi-tcp-0.88.errno.patch cd .. All platforms continue: -[root@yourserver src]# cd ucspi-tcp-0.88 -[root@yourserver ucspi-tcp-0.88]# make +[root src]# cd ucspi-tcp-0.88 +[root ucspi-tcp-0.88]# make ( cat warn-auto.sh; \ echo 'main="$1"; shift'; \(many lines omitted) ./compile instcheck.c ./load instcheck hier.o auto_home.o unix.a byte.a -[root@yourserver ucspi-tcp-0.88]# make setup check +[root ucspi-tcp-0.88]# make setup check ./install ./instcheck -[root@yourserver ucspi-tcp-0.88]# +[root ucspi-tcp-0.88]# cd ucspi-tcp-0.88 make make setup check Verify that ucspi-tcp was installed successfully by running the tcpserver program which is part of ucspi-tcp: - [root@yourserver ucspi-tcp-0.88]# tcpserver + [root ucspi-tcp-0.88]# tcpserver 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@yourserver ucspi-tcp-0.88]# +[root ucspi-tcp-0.88]# qmail @@ -243,8 +243,8 @@ it's an attempt to relay mail, and rejects it. So these two commands set up an exception so that any mail sent from 127.0.0.1 is allowed to send outgoing mail. - [root@yourserver ucspi-tcp-0.88]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp -[root@yourserver ucspi-tcp-0.88]# tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp + [root ucspi-tcp-0.88]# cp /tmp/&tarballpath;/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/&tarballpath;/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp @@ -259,9 +259,9 @@ Download qmail, set up the standard supporting users and build the binaries: - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget http://www.qmail.org/netqmail-1.04.tar.gz -[root@yourserver src]# tar xzf netqmail-1.04.tar.gz + [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 --15:04:11-- http://www.qmail.org/netqmail-1.04.tar.gz => `netqmail-1.04.tar.gz' Resolving www.qmail.org... done. @@ -273,18 +273,18 @@ 15:04:21 (24.04 KB/s) - `netqmail-1.04.tar.gz' saved [242310/242310] -[root@yourserver src]# mkdir /var/qmail -[root@yourserver src]# groupadd nofiles -[root@yourserver src]# useradd -g nofiles -d /var/qmail/alias alias -[root@yourserver src]# useradd -g nofiles -d /var/qmail qmaild -[root@yourserver src]# useradd -g nofiles -d /var/qmail qmaill -[root@yourserver src]# useradd -g nofiles -d /var/qmail qmailp -[root@yourserver src]# groupadd qmail -[root@yourserver src]# useradd -g qmail -d /var/qmail qmailq -[root@yourserver src]# useradd -g qmail -d /var/qmail qmailr -[root@yourserver src]# useradd -g qmail -d /var/qmail qmails -[root@yourserver src]# cd netqmail-1.04 -[root@yourserver netqmail-1.04]# ./collate.sh +[root src]# mkdir /var/qmail +[root src]# groupadd nofiles +[root src]# useradd -g nofiles -d /var/qmail/alias alias +[root src]# useradd -g nofiles -d /var/qmail qmaild +[root src]# useradd -g nofiles -d /var/qmail qmaill +[root src]# useradd -g nofiles -d /var/qmail qmailp +[root src]# groupadd qmail +[root src]# useradd -g qmail -d /var/qmail qmailq +[root src]# useradd -g qmail -d /var/qmail qmailr +[root src]# useradd -g qmail -d /var/qmail qmails +[root src]# cd netqmail-1.04 +[root netqmail-1.04]# ./collate.sh You should see 7 lines of text below. If you see anything else, then something might be wrong. @@ -295,8 +295,8 @@ [5] Renaming qmail-1.03 to netqmail-1.04... [6] Continue installing qmail using the instructions found at: [7] http://www.lifewithqmail.org/lwq.html#installation -[root@yourserver netqmail-1.04]# cd netqmail-1.04 -[root@yourserver netqmail-1.04]# make setup check +[root netqmail-1.04]# cd netqmail-1.04 +[root netqmail-1.04]# make setup check ( cat warn-auto.sh; \ echo CC=\'`head -1 conf-cc`\'; \(many lines omitted) ./install @@ -323,13 +323,13 @@ sendmail removing - [root@yourserver qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail -[root@yourserver qmail-1.03]# ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail -[root@yourserver qmail-1.03]# + [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 ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail Configure qmail - specifically, run the config script to set up files in /var/qmail/control specifying the computer's identity and which addresses it should accept mail for. This command will automatically set up qmail correctly if you have correctly set a valid host nome. If not, you'll want to read /var/qmail/doc/INSTALL.ctl to find out how to configure qmail. - [root@yourserver qmail-1.03]# ./config-fast yourserver.test + [root qmail-1.03]# ./config-fast yourserver.test Your fully qualified host name is yourserver.test. Putting yourserver.test into control/me... Putting yourserver.test into control/defaultdomain... @@ -338,14 +338,14 @@ Putting yourserver.test into control/rcpthosts... Now qmail will refuse to accept SMTP messages except to yourserver.test. Make sure to change rcpthosts if you add hosts to locals or virtualdomains! -[root@yourserver qmail-1.03]# +[root qmail-1.03]# ./config-fast yourserver.test All incoming mail that isn't for a specific user is handled by the alias user. This includes all root mail. These commands prepare the alias user to receive mail. - [root@yourserver qmail-1.03]# cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root -[root@yourserver alias]# chmod 644 ~alias/.qmail* -[root@yourserver alias]# /var/qmail/bin/maildirmake ~alias/Maildir/ -[root@yourserver alias]# chown -R alias.nofiles /var/qmail/alias/Maildir -[root@yourserver alias]# + [root qmail-1.03]# cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root +[root alias]# chmod 644 ~alias/.qmail* +[root alias]# /var/qmail/bin/maildirmake ~alias/Maildir/ +[root alias]# chown -R alias.nofiles /var/qmail/alias/Maildir +[root alias]# cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root chmod 644 ~alias/.qmail* /var/qmail/bin/maildirmake ~alias/Maildir/ @@ -356,41 +356,41 @@ 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@yourserver alias]# echo "./Maildir" > /var/qmail/bin/.qmail -[root@yourserver alias]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc -[root@yourserver alias]# chmod 755 /var/qmail/rc -[root@yourserver alias]# + [root alias]# echo "./Maildir" > /var/qmail/bin/.qmail +[root alias]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc +[root alias]# chmod 755 /var/qmail/rc +[root alias]# echo "./Maildir" > /var/qmail/bin/.qmail cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc chmod 755 /var/qmail/rc Set up the skeleton directory so that new users will be configured for qmail. - [root@yourserver root]# /var/qmail/bin/maildirmake /etc/skel/Maildir -[root@yourserver root]# echo "./Maildir/" > /etc/skel/.qmail -[root@yourserver root]# + [root root]# /var/qmail/bin/maildirmake /etc/skel/Maildir +[root root]# echo "./Maildir/" > /etc/skel/.qmail +[root root]# /var/qmail/bin/maildirmake /etc/skel/Maildir echo "./Maildir/" > /etc/skel/.qmail As recommended, we will run qmail with daemontools control files. Create daemontools control directories, set up a daemontools control script, copy the supervise control files, and set permissions. The last line links the control directories to /service, which will cause supervise to detect them and execute the run files, causing qmail to start. - [root@yourserver root]# mkdir -p /var/qmail/supervise/qmail-send/log -[root@yourserver root]# mkdir -p /var/qmail/supervise/qmail-smtpd/log -[root@yourserver root]# mkdir /var/log/qmail -[root@yourserver root]# chown qmaill /var/log/qmail -[root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmailctl.txt /var/qmail/bin/qmailctl -[root@yourserver root]# chmod 755 /var/qmail/bin/qmailctl -[root@yourserver root]# ln -s /var/qmail/bin/qmailctl /usr/bin -[root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-send-run.txt /var/qmail/supervise/qmail-send/run -[root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-send-log-run.txt /var/qmail/supervise/qmail-send/log/run -[root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-smtpd-run.txt /var/qmail/supervise/qmail-smtpd/run -[root@yourserver root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-smtpd-log-run.txt /var/qmail/supervise/qmail-smtpd/log/run -[root@yourserver root]# chmod 755 /var/qmail/supervise/qmail-send/run -[root@yourserver root]# chmod 755 /var/qmail/supervise/qmail-send/log/run -[root@yourserver root]# chmod 755 /var/qmail/supervise/qmail-smtpd/run -[root@yourserver root]# chmod 755 /var/qmail/supervise/qmail-smtpd/log/run -[root@yourserver root]# ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service -[root@yourserver root]# ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service + [root root]# mkdir -p /var/qmail/supervise/qmail-send/log +[root root]# mkdir -p /var/qmail/supervise/qmail-smtpd/log +[root root]# mkdir /var/log/qmail +[root root]# chown qmaill /var/log/qmail +[root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmailctl.txt /var/qmail/bin/qmailctl +[root root]# chmod 755 /var/qmail/bin/qmailctl +[root root]# ln -s /var/qmail/bin/qmailctl /usr/bin +[root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-send-run.txt /var/qmail/supervise/qmail-send/run +[root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-send-log-run.txt /var/qmail/supervise/qmail-send/log/run +[root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-smtpd-run.txt /var/qmail/supervise/qmail-smtpd/run +[root root]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/qmail-smtpd-log-run.txt /var/qmail/supervise/qmail-smtpd/log/run +[root root]# chmod 755 /var/qmail/supervise/qmail-send/run +[root root]# chmod 755 /var/qmail/supervise/qmail-send/log/run +[root root]# chmod 755 /var/qmail/supervise/qmail-smtpd/run +[root root]# chmod 755 /var/qmail/supervise/qmail-smtpd/log/run +[root root]# ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service +[root root]# ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service mkdir -p /var/qmail/supervise/qmail-send/log mkdir -p /var/qmail/supervise/qmail-smtpd/log mkdir /var/log/qmail @@ -409,14 +409,14 @@ ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service Wait ten seconds or so, and then verify that that the four qmail processes are running. If uptimes don't rise above 1 second, this may indicate broken scripts that are continuously restarting. In that case, start debugging by checking permissions. - [root@yourserver root]# qmailctl stat + [root root]# qmailctl stat /service/qmail-send: up (pid 32700) 430 seconds /service/qmail-send/log: up (pid 32701) 430 seconds /service/qmail-smtpd: up (pid 32704) 430 seconds /service/qmail-smtpd/log: up (pid 32705) 430 seconds messages in queue: 0 messages in queue but not yet preprocessed: 0 -[root@yourserver root]# +[root root]# Further verify by sending and receiving email. Incoming mail for root is stored in /var/qmail/alias/Maildir. @@ -425,19 +425,19 @@ Install Analog web file analyzer Download the Analog source tarball in /tmp. Unpack, compile, and install analog. - [root@yourserver aolserver]# cd /usr/local/src -[root@yourserver src]# tar xzf /tmp/analog-5.32.tar.gz -[root@yourserver src]# cd analog-5.32 -[root@yourserver analog-5.32]# make + [root aolserver]# cd /usr/local/src +[root src]# tar xzf /tmp/analog-5.32.tar.gz +[root src]# cd analog-5.32 +[root analog-5.32]# make cd src && make make[1]: Entering directory `/usr/local/src/analog-5.32/src' (many lines omitted) ***IMPORTANT: You must read the licence before using analog *** make[1]: Leaving directory `/usr/local/src/analog-5.32/src' -[root@yourserver analog-5.32]# cd .. -[root@yourserver src]# mv analog-5.32 /usr/share/ -[root@yourserver src]# +[root analog-5.32]# cd .. +[root src]# mv analog-5.32 /usr/share/ +[root src]# cd /usr/local/src tar xzf /tmp/analog-5.32.tar.gz cd analog-5.32 @@ -469,22 +469,22 @@ Install Tsearch. This is a PostgreSQL module that OpenFTS requires. - [root@yourserver root]# su - postgres -[postgres@yourserver pgsql]$ cd /usr/local/src/postgresql-7.2.4/contrib/tsearch/ -[postgres@yourserver tsearch]$ make + [root root]# su - postgres +[postgres pgsql]$ cd /usr/local/src/postgresql-7.2.4/contrib/tsearch/ +[postgres tsearch]$ make sed 's,MODULE_PATHNAME,$libdir/tsearch,g' tsearch.sql.in >tsearch.sql /usr/bin/flex -8 -Ptsearch_yy -o'parser.c' parser.l(many lines omitted) rm -f libtsearch.so ln -s libtsearch.so.0.0 libtsearch.so -[postgres@yourserver tsearch]$ make install +[postgres tsearch]$ make install mkdir /usr/local/pgsql/share/contrib mkdir /usr/local/pgsql/doc/contrib (2 lines omitted) /bin/sh ../../config/install-sh -c -m 755 libtsearch.so.0.0 /usr/local/pgsql/lib/tsearch.so -[postgres@yourserver tsearch]$ exit +[postgres tsearch]$ exit logout -[root@yourserver root]# +[root root]# su - postgres cd /usr/local/src/postgresql-7.2.4/contrib/tsearch make @@ -494,28 +494,28 @@ Unpack the OpenFTS tarball and compile and install the driver. - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# tar xzf /tmp/Search-OpenFTS-tcl-0.3.2.tar.gz -[root@yourserver src]# cd /usr/local/src/Search-OpenFTS-tcl-0.3.2/ -[root@yourserver Search-OpenFTS-tcl-0.3.2]# ./configure --with-aolserver-src=/usr/local/src/aolserver/aolserver --with-tcl=/usr/lib/ + [root root]# cd /usr/local/src +[root src]# tar xzf /tmp/Search-OpenFTS-tcl-0.3.2.tar.gz +[root src]# cd /usr/local/src/Search-OpenFTS-tcl-0.3.2/ +[root Search-OpenFTS-tcl-0.3.2]# ./configure --with-aolserver-src=/usr/local/src/aolserver/aolserver --with-tcl=/usr/lib/ checking prefix... /usr/local checking for gcc... gcc (many lines omitted) configure: creating ./config.status config.status: creating Makefile.global -[root@yourserver Search-OpenFTS-tcl-0.3.2]# make +[root Search-OpenFTS-tcl-0.3.2]# make (cd parser; make all) make[1]: Entering directory `/usr/local/src/Search-OpenFTS-tcl-0.3.2/parser' (many lines omitted) packages provided were {Lingua::Stem::Snowball 0.3.2} processed fts_base_snowball.tcl -[root@yourserver Search-OpenFTS-tcl-0.3.2]# cd aolserver -[root@yourserver aolserver]# make +[root Search-OpenFTS-tcl-0.3.2]# cd aolserver +[root aolserver]# make gcc -c -fPIC -DPACKAGE=\"OPENFTS\" -DVERSION=\"0.3.2\" -DHAVE_UNISTD_H=1 -DSTDC_HEADERS=1 -DHAVE_SYS_TYPES_H=1 -DHAVE_SYS_STAT_H=1 -DHAVE_STDLIB_H=1 -DHAVE_STR (many lines omitted) n_stem.o italian_stem.o norwegian_stem.o portuguese_stem.o russian_stem.o nsfts.o -o nsfts.so -[root@yourserver aolserver]# cp nsfts.so /usr/local/aolserver/bin/ -[root@yourserver aolserver]# +[root aolserver]# cp nsfts.so /usr/local/aolserver/bin/ +[root aolserver]# cd /usr/local/src tar xzf /tmp/Search-OpenFTS-tcl-0.3.2.tar.gz cd /usr/local/src/Search-OpenFTS-tcl-0.3.2/ @@ -528,21 +528,21 @@ Build some supplemental modules. - [root@yourserver aolserver]# cd /usr/local/src/Search-OpenFTS-tcl-0.3.2 -[root@yourserver Search-OpenFTS-tcl-0.3.2]# cp -r pgsql_contrib_openfts /usr/local/src/postgresql-7.2.4/contrib -[root@yourserver Search-OpenFTS-tcl-0.3.2]# cd /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts -[root@yourserver pgsql_contrib_openfts]# make + [root aolserver]# cd /usr/local/src/Search-OpenFTS-tcl-0.3.2 +[root Search-OpenFTS-tcl-0.3.2]# cp -r pgsql_contrib_openfts /usr/local/src/postgresql-7.2.4/contrib +[root Search-OpenFTS-tcl-0.3.2]# cd /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts +[root pgsql_contrib_openfts]# make sed 's,MODULE_PATHNAME,$libdir/openfts,g' openfts.sql.in >openfts.sql gcc -O2 -Wall -Wmissing-prototypes -Wmissing-declarations -fpic -I. -I../../src/include -c -o openfts.o openfts.c gcc -shared -o openfts.so openfts.o rm openfts.o -[root@yourserver pgsql_contrib_openfts]# su postgres -[postgres@yourserver pgsql_contrib_openfts]$ make install +[root pgsql_contrib_openfts]# su postgres +[postgres pgsql_contrib_openfts]$ make install /bin/sh ../../config/install-sh -c -m 644 openfts.sql /usr/local/pgsql/share/contrib /bin/sh ../../config/install-sh -c -m 755 openfts.so /usr/local/pgsql/lib /bin/sh ../../config/install-sh -c -m 644 ./README.openfts /usr/local/pgsql/doc/contrib -[postgres@yourserver pgsql_contrib_openfts]$ exit -[root@yourserver pgsql_contrib_openfts]# +[postgres pgsql_contrib_openfts]$ exit +[root pgsql_contrib_openfts]# cd /usr/local/src/Search-OpenFTS-tcl-0.3.2 cp -r pgsql_contrib_openfts /usr/local/src/postgresql-7.2.4/contrib cd /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts @@ -565,16 +565,16 @@ to work, you must also install the PostgreSQL OpenFTS module and prerequisites.) - [service0@yourserver service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/tsearch/tsearch.sql + [service0 service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/tsearch/tsearch.sql BEGIN CREATE (many lines omitted) INSERT 0 1 COMMIT -[service0@yourserver service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts/openfts.sql +[service0 service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts/openfts.sql CREATE CREATE -[service0@yourserver service0]$ +[service0 service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/tsearch/tsearch.sql /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/pgsql_contrib_openfts/openfts.sql @@ -601,8 +601,8 @@ Click Install Packages Restart the service. -[service0@yourserver service0]$ svc -t /service/service0 -[service0@yourserver service0]$ +[service0 service0]$ svc -t /service/service0 +[service0 service0]$ Wait a minute, then browse back to the home page. @@ -648,8 +648,8 @@ Restart the service. - [service0@yourserver service0]$ svc -t /service/service0 -[service0@yourserver service0]$ + [service0 service0]$ svc -t /service/service0 +[service0 service0]$ Wait a minute, then click on Main Site at the top of the page. @@ -674,8 +674,8 @@ Restart the service. - [service0@yourserver service0]$ svc -t /service/service0 -[service0@yourserver service0]$ + [service0 service0]$ svc -t /service/service0 +[service0 service0]$ Test FTS. (INCOMPLETE). Add a package that supports search,like "note," add some content, and search for it. @@ -702,17 +702,17 @@ url="http://openacs.org/forums/message-view?message_id=92882">this thread for details on compiling nsopenssl.) - [root@yourserver bin]# cd /usr/local/src/aolserver -[root@yourserver aolserver]# wget --passive http://www.scottg.net/download/nsopenssl-2.1.tar.gz -[root@yourserver aolserver]# tar xzf nsopenssl-2.1.tar.gz -[root@yourserver aolserver]# cd nsopenssl-2.1 -[root@yourserver nsopenssl-2.1]# make OPENSSL=/usr/local/ssl + [root bin]# cd /usr/local/src/aolserver +[root aolserver]# wget --passive http://www.scottg.net/download/nsopenssl-2.1.tar.gz +[root aolserver]# tar xzf nsopenssl-2.1.tar.gz +[root aolserver]# cd nsopenssl-2.1 +[root nsopenssl-2.1]# make OPENSSL=/usr/local/ssl gcc -I/usr/local/ssl/include -I../aolserver/include -D_REENTRANT=1 -DNDEBUG=1 -g -fPIC -Wall -Wno-unused -mcpu=i686 -DHAVE_CMMSG=1 -DUSE_FIONREAD=1 -DHAVE_COND_EINTR=1 -c -o nsopenssl.o nsopenssl.c (many lines omitted) gcc -shared -nostartfiles -o nsopenssl.so nsopenssl.o config.o init.o ssl.o thread.o tclcmds.o -L/usr/local/ssl/lib -lssl -lcrypto -[root@yourserver nsopenssl-2.1]# cp nsopenssl.so /usr/local/aolserver/bin -[root@yourserver nsopenssl-2.1]# cp https.tcl /usr/local/aolserver/modules/tcl/ -[root@yourserver nsopenssl-2.1]# +[root nsopenssl-2.1]# cp nsopenssl.so /usr/local/aolserver/bin +[root nsopenssl-2.1]# cp https.tcl /usr/local/aolserver/modules/tcl/ +[root nsopenssl-2.1]# cd /usr/local/src/aolserver wget --passive http://www.scottg.net/download/nsopenssl-2.1.tar.gz tar xzf nsopenssl-2.1.tar.gz Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/postgres.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/postgres.xml,v diff -u -r1.15.2.4 -r1.15.2.5 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/postgres.xml 9 Dec 2003 09:54:05 -0000 1.15.2.4 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/postgres.xml 15 Dec 2003 14:18:48 -0000 1.15.2.5 @@ -41,17 +41,17 @@ environment (more information): - [root@yourserver root]# ln -s /usr/lib/pgsql/ /var/lib/pgsql/lib -[root@yourserver root]# ln -s /var/lib/pgsql /usr/local/pgsql -[root@yourserver root]# ln -s /etc/init.d/postgresql /etc/init.d/postgres -[root@yourserver root]# service postgresql start + [root root]# ln -s /usr/lib/pgsql/ /var/lib/pgsql/lib +[root root]# ln -s /var/lib/pgsql /usr/local/pgsql +[root root]# ln -s /etc/init.d/postgresql /etc/init.d/postgres +[root root]# service postgresql start Initializing database: [ OK ] Starting postgresql service: [ OK ] -[root@yourserver root]# echo "export LD_LIBRARY_PATH=/usr/local/pgsql/lib" >> ~postgres/.bash_profile -[root@yourserver root]# echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bash_profile -[root@yourserver root]# groupadd web -[root@yourserver root]# su - postgres +[root root]# echo "export LD_LIBRARY_PATH=/usr/local/pgsql/lib" >> ~postgres/.bash_profile +[root root]# echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bash_profile +[root root]# groupadd web +[root root]# su - postgres -bash-2.05b$ ln -s /usr/lib/pgsql/ /var/lib/pgsql/lib @@ -72,9 +72,9 @@ /tmp/postgresql-7.3.4.tar.gz, get it. - [root@yourserver root]# cd /usr/local/src -[root@yourserver src]# tar xzf /tmp/postgresql-7.3.4.tar.gz -[root@yourserver src]# + [root root]# cd /usr/local/src +[root src]# tar xzf /tmp/postgresql-7.3.4.tar.gz +[root src]# cd /usr/local/src tar xzf /tmp/postgresql-7.3.4.tar.gz @@ -88,12 +88,12 @@ directly as that user, we'll leave the password blank. - [root@yourserver src]# groupadd web -[root@yourserver src]# useradd -g web -d /usr/local/pgsql postgres -[root@yourserver src]# mkdir -p /usr/local/pgsql -[root@yourserver src]# chown -R postgres.web /usr/local/pgsql /usr/local/src/postgresql-7.3.4 -[root@yourserver src]# chmod 750 /usr/local/pgsql -[root@yourserver src]# + [root src]# groupadd web +[root src]# useradd -g web -d /usr/local/pgsql postgres +[root src]# mkdir -p /usr/local/pgsql +[root src]# chown -R postgres.web /usr/local/pgsql /usr/local/src/postgresql-7.3.4 +[root src]# chmod 750 /usr/local/pgsql +[root src]# groupadd web useradd -g web -d /usr/local/pgsql postgres mkdir -p /usr/local/pgsql @@ -107,18 +107,18 @@ libraries. For convenience, we'll simply append the necessary lines to the postgres shell config file. - [root@yourserver src]# echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib" >> ~postgres/.bashrc -[root@yourserver src]# echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bashrc + [root src]# echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib" >> ~postgres/.bashrc +[root src]# echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bashrc echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib" >> ~postgres/.bashrc echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bashrc Test this by logging in as postgres and checking the paths; you should see /usr/local/pgsql/bin - [root@yourserver src]# su - postgres -[postgres@yourserver pgsql]$ env | grep PATH + [root src]# su - postgres +[postgres pgsql]$ env | grep PATH LD_LIBRARY_PATH=:/usr/local/pgsql/lib PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/usr/bin/X11:/usr/X11R6/bin:/root/bin:/usr/local/pgsql/bin:/usr/local/pgsql/bin -[postgres@yourserver pgsql]$ exit +[postgres pgsql]$ exit @@ -131,21 +131,21 @@ UnicodeUnicodein PostgreSQL support, add the flags --enable-locale and --enable-multibyte. If you want to see what the other possibilities are, run ./configure --help. - [root@yourserver src]# su - postgres -[postgres@yourserver pgsql]$ cd /usr/local/src/postgresql-7.3.4 -[postgres@yourserver postgresql-7.3.4]$ ./configure + [root src]# su - postgres +[postgres pgsql]$ cd /usr/local/src/postgresql-7.3.4 +[postgres postgresql-7.3.4]$ ./configure creating cache ./config.cache checking host system type... i686-pc-linux-gnu (many lines omitted> linking ./src/makefiles/Makefile.linux to src/Makefile.port linking ./src/backend/port/tas/dummy.s to src/backend/port/tas.s -[postgres@yourserver postgresql-7.3.4]$ make all +[postgres postgresql-7.3.4]$ make all make -C doc all make[1]: Entering directory `/usr/local/src/postgresql-7.3.4/doc' (many lines omitted) make[1]: Leaving directory `/usr/local/src/postgresql-7.3.4/src' All of PostgreSQL successfully made. Ready to install. -[postgres@yourserver postgresql-7.3.4]$ make install +[postgres postgresql-7.3.4]$ make install make -C doc install make[1]: Entering directory `/usr/local/src/postgresql-7.3.4/doc' (many lines omitted) @@ -166,15 +166,15 @@ PostgreSQL. - [postgres@yourserver tsearch]$ /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data + [postgres tsearch]$ /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data The files belonging to this database system will be owned by user "postgres". This user must also own the server process. (17 lines omitted) or /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start -[postgres@yourserver tsearch]$ /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l /usr/local/pgsql/data/server.log start +[postgres tsearch]$ /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l /usr/local/pgsql/data/server.log start postmaster successfully started -[postgres@yourserver tsearch]$ +[postgres tsearch]$ /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l /usr/local/pgsql/data/server.log start @@ -191,15 +191,15 @@ databases are created. We can verify that it was created with the createlang command in list mode. - [postgres@yourserver pgsql]$ createlang plpgsql template1 -[postgres@yourserver pgsql]$ createlang -l template1 + [postgres pgsql]$ createlang plpgsql template1 +[postgres pgsql]$ createlang -l template1 Procedural languages Name | Trusted? ---------+---------- plpgsql | t (1 row) -[postgres@yourserver pgsql]$ +[postgres pgsql]$ createlang plpgsql template1 createlang -l template1 @@ -209,9 +209,9 @@ Create a database and try some simple commands. The output should be as shown. - [postgres@yourserver pgsql]$ createdb mytestdb + [postgres pgsql]$ createdb mytestdb CREATE DATABASE -[postgres@yourserver pgsql]$ psql mytestdb +[postgres pgsql]$ psql mytestdb Welcome to psql, the PostgreSQL interactive terminal. Type: \copyright for distribution terms @@ -235,12 +235,12 @@ (1 row) mytestdb=# \q -[postgres@yourserver pgsql]$ dropdb mytestdb +[postgres pgsql]$ dropdb mytestdb DROP DATABASE -[postgres@yourserver pgsql]$ exit +[postgres pgsql]$ exit logout -[root@yourserver src]# +[root src]# Set PostgreSQL to start on boot. First, we copy the @@ -255,24 +255,24 @@ Red Hat RPM: The init script is already installed; just turn it on for the appropriate run levels. - [root@yourserver root]# chkconfig --level 345 postgresql on -[root@yourserver root]# + [root root]# chkconfig --level 345 postgresql on +[root root]# Red Hat from source: - [root@yourserver src]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/postgresql.txt /etc/init.d/postgresql -[root@yourserver src]# chown root.root /etc/rc.d/init.d/postgresql -[root@yourserver src]# chmod 755 /etc/rc.d/init.d/postgresql -[root@yourserver src]# + [root src]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/postgresql.txt /etc/init.d/postgresql +[root src]# chown root.root /etc/rc.d/init.d/postgresql +[root src]# chmod 755 /etc/rc.d/init.d/postgresql +[root src]# cp /tmp/&tarballpath;/packages/acs-core-docs/www/files/postgresql.txt /etc/init.d/postgresql chown root.root /etc/rc.d/init.d/postgresql chmod 755 /etc/rc.d/init.d/postgresql Test the script. - [root@yourserver root]# service postgresql stop + [root root]# service postgresql stop Stopping PostgreSQL: ok -[root@yourserver root]# +[root root]# If PostgreSQL successfully stopped, then use the following command to make sure that the script is run appropriately at boot @@ -281,13 +281,13 @@ - [root@yourserver root]# chkconfig --add postgresql -[root@yourserver root]# chkconfig --level 345 postgresql on -[root@yourserver root]# chkconfig --list postgresql + [root root]# chkconfig --add postgresql +[root root]# chkconfig --level 345 postgresql on +[root root]# chkconfig --list postgresql postgresql 0:off 1:off 2:on 3:on 4:on 5:on 6:off -[root@yourserver root]# service postgresql start +[root root]# service postgresql start Starting PostgreSQL: ok -[root@yourserver root]# +[root root]# chkconfig --add postgresql chkconfig --level 345 postgresql on chkconfig --list postgresql @@ -410,8 +410,8 @@ Change the kernel parameter for maximum shared memory segment size to 128Mb: - [root@yourserver root]# echo 134217728 >/proc/sys/kernel/shmmax -[root@yourserver root]# + [root root]# echo 134217728 >/proc/sys/kernel/shmmax +[root root]# Make that change permanent by editing /etc/sysctl.conf to add these lines at the end: Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/recovery.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/recovery.xml,v diff -u -r1.6.2.5 -r1.6.2.6 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/recovery.xml 9 Dec 2003 15:34:24 -0000 1.6.2.5 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/recovery.xml 15 Dec 2003 14:18:48 -0000 1.6.2.6 @@ -177,12 +177,12 @@ PostgreSQL Create a backup file and verify that it was created and has a reasonable size (several megabytes). - [root@localhost root]# su - service0 - [service0@localhost service0]$ pg_dump -f /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp service0 - [service0@localhost service0]$ ls -al /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp + [root root]# su - service0 + [service0 service0]$ pg_dump -f /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp service0 + [service0 service0]$ ls -al /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp -rw-rw-r-x 1 service0 service0 4005995 Feb 21 18:28 /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp - [service0@localhost service0]$ exit - [root@localhost root]# + [service0 service0]$ exit + [root root]# su - service0 pg_dump -f /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp openacs-dev ls -al /var/lib/aolserver/service0/database-backup/before_upgrade_to_4.6.dmp @@ -231,32 +231,32 @@ recursive backup. - [root@yourserver root]# su - service0 - [service0@yourserver service0]$ tar -cpsj --exclude /var/lib/aolserver/service0/etc/daemontools/supervise --file /tmp/service0-backup.tar.bz2 /var/lib/aolserver/service0/ + [root root]# su - service0 + [service0 service0]$ tar -cpsj --exclude /var/lib/aolserver/service0/etc/daemontools/supervise --file /tmp/service0-backup.tar.bz2 /var/lib/aolserver/service0/ tar: Removing leading `/' from member names - [service0@yourserver service0]$ + [service0 service0]$ Suffer a catastrophic failure on your production system (We'll simulate this step) - [root@yourserver root]# svc -d /service/service0 - [root@yourserver root]# mv /var/lib/aolserver/service0/ /var/lib/aolserver/service0.lost - [root@yourserver root]# rm /service/service0 + [root root]# svc -d /service/service0 + [root root]# mv /var/lib/aolserver/service0/ /var/lib/aolserver/service0.lost + [root root]# rm /service/service0 rm: remove symbolic link `/service/service0'? y - [root@yourserver root]# ps -auxw | grep service0 + [root root]# ps -auxw | grep service0 root 1496 0.0 0.0 1312 252 ? S 16:58 0:00 supervise service0 - [root@yourserver root]# kill 1496 - [root@yourserver root]# ps -auxw | grep service0 - [root@yourserver root]# su - postgres - [postgres@yourserver pgsql]$ dropdb service0 + [root root]# kill 1496 + [root root]# ps -auxw | grep service0 + [root root]# su - postgres + [postgres pgsql]$ dropdb service0 DROP DATABASE - [postgres@yourserver pgsql]$ dropuser service0 + [postgres pgsql]$ dropuser service0 DROP USER - [postgres@yourserver pgsql]$ exit + [postgres pgsql]$ exit logout - [root@yourserver root]# + [root root]# @@ -273,11 +273,11 @@ Restore the OpenACS files and database backup file. - [root@yourserver root]# su - service0 - [service0@yourserver service0]$ cd /var/lib/aolserver - [service0@yourserver aolserver]$ tar xjf /tmp/service0-backup.tar.bz2 - [service0@yourserver aolserver]$ chmod -R 775 service0 - [service0@yourserver aolserver]$ chown -R service0.web service0 + [root root]# su - service0 + [service0 service0]$ cd /var/lib/aolserver + [service0 aolserver]$ tar xjf /tmp/service0-backup.tar.bz2 + [service0 aolserver]$ chmod -R 775 service0 + [service0 aolserver]$ chown -R service0.web service0 @@ -307,30 +307,30 @@ Because of a bug in Postgres backup-recovery, database objects are not guaranteed to be created in the right order. To compensate, we pre-creating some critical items first, which leads to some harmless errors. - [root@yourserver root]# su - postgres - [postgres@yourserver pgsql]$ createuser service0 + [root root]# su - postgres + [postgres pgsql]$ createuser service0 Shall the new user be allowed to create databases? (y/n) y Shall the new user be allowed to create more new users? (y/n) y CREATE USER - [service0@yourserver web]$ createdb service0 + [service0 web]$ createdb service0 CREATE DATABASE - [service0@yourserver web]$ psql -f /var/lib/aolserver/service0/packages/acs-kernel/sql/postgresql/postgresql.sql service0 + [service0 web]$ psql -f /var/lib/aolserver/service0/packages/acs-kernel/sql/postgresql/postgresql.sql service0 (many lines omitted) - [service0@yourserver web]$ psql service0 < /var/lib/aolserver/service0/database-backup/database-backup.dmp + [service0 web]$ psql service0 < /var/lib/aolserver/service0/database-backup/database-backup.dmp (many lines omitted) - [service0@yourserver web]$ exit - [postgres@yourserver pgsql]$ exit + [service0 web]$ exit + [postgres pgsql]$ exit logout Activate the service - [root@yourserver root]# ln -s /var/lib/aolserver/service0/etc/daemontools /service/service0 - [root@yourserver root]# sleep 10 - [root@yourserver root]# svgroup web /service/service0 - [root@yourserver root]# + [root root]# ln -s /var/lib/aolserver/service0/etc/daemontools /service/service0 + [root root]# sleep 10 + [root root]# svgroup web /service/service0 + [root root]# @@ -370,29 +370,29 @@ safety, you can apply a tag to your current files. You will still need to back up your database. Note that, if you did the CVS options in this document, the /var/lib/aolserver/service0/etc directory is not included in cvs and you may want to add it. - [root@localhost root]# su - service0 - [service0@localhost service0]$ cd /var/lib/aolserver/service0 - [service0@localhost service0]$ cvs commit -m "last-minute commits before upgrade to 4.6" + [root root]# su - service0 + [service0 service0]$ cd /var/lib/aolserver/service0 + [service0 service0]$ cvs commit -m "last-minute commits before upgrade to 4.6" cvs commit: Examining . cvs commit: Examining bin (many lines omitted) - [service0@localhost service0]$ cvs tag before_upgrade_to_4_6 + [service0 service0]$ cvs tag before_upgrade_to_4_6 cvs server: Tagging bin T bin/acs-4-0-publish.sh T bin/ad-context-server.pl (many lines omitted) - [service0@localhost service0]$ exit - [root@localhost root]# + [service0 service0]$ exit + [root root]# su - service0 cd /var/lib/aolserver/service0 cvs commit -m "last-minute commits before upgrade to 4.6" cvs tag before_upgrade_to_4_6 exit To restore files from a cvs tag such as the one used above: - [root@localhost root]# su - service0 - [service0@localhost service0]$ cd /var/lib/aolserver/service0 - [service0@localhost service0]$ cvs up -r current - [service0@localhost service0]$ exit + [root root]# su - service0 + [service0 service0]$ cd /var/lib/aolserver/service0 + [service0 service0]$ cvs up -r current + [service0 service0]$ exit su - service0 cd /var/lib/aolserver/service0 cvs up -r current Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/red-hat.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/red-hat.xml,v diff -u -r1.5.2.3 -r1.5.2.4 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/red-hat.xml 29 Nov 2003 15:17:54 -0000 1.5.2.3 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/red-hat.xml 15 Dec 2003 14:18:48 -0000 1.5.2.4 @@ -238,7 +238,7 @@ prompt, log in: yourserver login: root Password: -[root@yourserver root]# +[root root]# Install any security patches. For example, insert your CD with @@ -305,11 +305,11 @@ is better, it's a pain in the ass to deal with and nobody's had any trouble leaving PostgreSQL the way it is.) -[root@yourserver root]# service pcmcia stop -[root@yourserver root]# service netfs stop -[root@yourserver root]# chkconfig --del pcmcia -[root@yourserver root]# chkconfig --del netfs -[root@yourserver root]# +[root root]# service pcmcia stop +[root root]# service netfs stop +[root root]# chkconfig --del pcmcia +[root root]# chkconfig --del netfs +[root root]# service pcmcia stop service netfs stop chkconfig --del pcmcia @@ -332,9 +332,9 @@ Warning: Permanently added 'yourserver.test (1.2.3.4)' (DSA) to the list of known hosts. Password: Last login: Mon Mar 3 21:15:27 2003 from host-12-01.dsl-sea.seanet.com -[remadmin@yourserver remadmin]$ su - +[remadmin remadmin]$ su - Password: -[root@yourserver root]# +[root root]# If you didn't burn a CD of patches and use it, can still @@ -345,8 +345,8 @@ Red Hat 8.0 system kernel (2.4.18-14, which you can check with uname -a) has several security problems. Download the new kernel, install it, and reboot. -[root@yourserver root]# cd /tmp -[root@yourserver tmp]# wget http://updates.redhat.com/7.1/en/os/i686/kernel-2.4.18-27.7.x.i686.rpm +[root root]# cd /tmp +[root tmp]# wget http://updates.redhat.com/7.1/en/os/i686/kernel-2.4.18-27.7.x.i686.rpm --20:39:00-- http://updates.redhat.com/7.1/en/os/i686/kernel-2.4.18-27.7.x.i686.rpm => `kernel-2.4.18-27.7.x.i686.rpm' Resolving updates.redhat.com... done. @@ -362,12 +362,12 @@ warning: kernel-2.4.18-27.7.x.i686.rpm: V3 DSA signature: NOKEY, key ID db42a60e Preparing... ########################################### [100%] 1:kernel ########################################### [100%] -[root@yourserver tmp]# reboot +[root tmp]# reboot Broadcast message from root (pts/0) (Sat May 3 20:46:39 2003): The system is going down for reboot NOW! -[root@yourserver tmp]# +[root tmp]# cd /tmp wget http://updates.redhat.com/7.1/en/os/i686/kernel-2.4.18-27.7.x.i686.rpm rpm -Uvh kernel-2.4.18-27.7.x.i686.rpm Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/upgrade.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/upgrade.xml,v diff -u -r1.6.2.3 -r1.6.2.4 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/upgrade.xml 29 Nov 2003 15:17:54 -0000 1.6.2.3 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/upgrade.xml 15 Dec 2003 14:18:48 -0000 1.6.2.4 @@ -125,16 +125,16 @@ make install exit In order for the OpenACS 4.6 OpenFTS Engine to use the OpenFTS 0.3.2 driver, we need some commands added to the database. - [root@localhost root]# su - nsadmin -[nsadmin@localhost dev]$ psql openacs-dev -f /usr/local/pgsql/share/contrib/openfts.sql + [root root]# su - nsadmin +[nsadmin dev]$ psql openacs-dev -f /usr/local/pgsql/share/contrib/openfts.sql CREATE CREATE -[nsadmin@localhost dev]$ psql openacs-dev -f /usr/local/src/postgresql-7.2.3/contrib/tsearch/tsearch.sql +[nsadmin dev]$ psql openacs-dev -f /usr/local/src/postgresql-7.2.3/contrib/tsearch/tsearch.sql BEGIN CREATE (~30 more lines) -[nsadmin@localhost dev]$ exit -[root@localhost root]# +[nsadmin dev]$ exit +[root root]# su - nsadmin psql openacs-dev -f /usr/local/pgsql/share/contrib/openfts.sql psql openacs-dev -f /usr/local/src/postgresql-7.2.3/contrib/tsearch/tsearch.sql @@ -146,7 +146,7 @@ Stop the server - [root@localhost root]# svc -d /service/openacs-dev + [root root]# svc -d /service/openacs-dev @@ -159,12 +159,12 @@ Upgrading files without CVS Unpack the tarball into a new directory and copy its contents on top of your working directory. - [root@localhost root]# su - nsadmin -[nsadmin@localhost aolserver]$ cd /web -[nsadmin@localhost web]$ tar xzf /tmp/openacs-4-6.tgz -[nsadmin@localhost web]$ cp -r openacs-4-6/* openacs-4 -[nsadmin@localhost openacs-upgrade]$ exit -[root@localhost root]# + [root root]# su - nsadmin +[nsadmin aolserver]$ cd /web +[nsadmin web]$ tar xzf /tmp/openacs-4-6.tgz +[nsadmin web]$ cp -r openacs-4-6/* openacs-4 +[nsadmin openacs-upgrade]$ exit +[root root]# su - nsadmin cd /web tar xzf /tmp/openacs-4-6.tgz @@ -179,18 +179,18 @@ Unpack the new files into a working directory. - [root@localhost root]# su - nsadmin -[nsadmin@localhost aolserver]$ cd /tmp -[nsadmin@localhost tmp]$ tar xzv openacs-4-6.tgz -[nsadmin@localhost tmp]$ cd openacs-4.6 + [root root]# su - nsadmin +[nsadmin aolserver]$ cd /tmp +[nsadmin tmp]$ tar xzv openacs-4-6.tgz +[nsadmin tmp]$ cd openacs-4.6 Import the new files into your cvs repository; where they match existing files, they will become the new version of the file. - [nsadmin@localhost openacs-4.6]$ cvs import -m "upgrade to OpenACS 4.6" openacs + [nsadmin openacs-4.6]$ cvs import -m "upgrade to OpenACS 4.6" openacs OpenACS openacs-4-6 Create a new directory as temporary working space to reconcile conflicts between the new files and your current work. The example uses the cvs keyword yesterday, making the assumption that you haven't checked in new code to your local tree in the last day. -[nsadmin@localhost openacs-4.6]$ cd /web -[nsadmin@localhost tmp]$ mkdir openacs-upgrade -[nsadmin@localhost tmp]$ cvs checkout -d openacs-upgrade -jOpenACS:yesterday -jOpenACS openacs > cvs.txt 2>&1 +[nsadmin openacs-4.6]$ cd /web +[nsadmin tmp]$ mkdir openacs-upgrade +[nsadmin tmp]$ cvs checkout -d openacs-upgrade -jOpenACS:yesterday -jOpenACS openacs > cvs.txt 2>&1 (CVS feedback here) su - nsadmin cd /tmp @@ -208,20 +208,20 @@ Once you've fixed any conflicts, commit the new code to your local tree. - [nsadmin@localhost tmp]$ cd openacs-upgrade -[nsadmin@localhost openacs-upgrade]$ cvs commit -m "Upgraded to 4.6" + [nsadmin tmp]$ cd openacs-upgrade +[nsadmin openacs-upgrade]$ cvs commit -m "Upgraded to 4.6" cd openacs-upgrade cvs commit -m "Upgraded to 4.6" Update your working tree with the new files. The CVS flags ensure that new directories are created and pruned directories destroyed. -[nsadmin@localhost openacs-upgrade]$ cd /web/openacs-dev -[nsadmin@localhost openacs-dev]$ cvs up -Pd +[nsadmin openacs-upgrade]$ cd /web/openacs-dev +[nsadmin openacs-dev]$ cvs up -Pd (CVS feedback) -[nsadmin@localhost openacs-dev]$ exit -[root@localhost root]# +[nsadmin openacs-dev]$ exit +[root root]# cd /web/openacs-dev cvs up -Pd exit @@ -234,7 +234,7 @@ Start the server - [root@localhost root]# svc -u /service/openacs-dev + [root root]# svc -u /service/openacs-dev @@ -261,7 +261,7 @@ When prompted, restart the server: - [root@localhost root]# restart-aolserver openacs-dev + [root root]# restart-aolserver openacs-dev Wait a minute, then browse to the package manager, http://yourserver/acs-admin/apm. @@ -292,7 +292,7 @@ Click Set Parameters - [root@localhost root]# restart-aolserver openacs-dev + [root root]# restart-aolserver openacs-dev Browse to http://yourserver/openfts