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/service0Add the repository location to the user environment.
- [root@yourserver root]# su - service0
-[service0@yourserver service0]$ emacs .bashrc
+ [root root]# su - service0
+[service0 service0]$ emacs .bashrcPut 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 service0service0.orig
-[service0@yourserver web]$ cvs checkout service0
+ [service0 service0]$ cd ..
+[service0 web]$ mv service0service0.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 service0service0.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.tclad_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.sqlPaste this into the file and save and close.
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.tclPaste 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-oraclePostgreSQL
- [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/unixAnd 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/service0Verify that AOLserver is running.
- [root@yourserver root]# ps -auxw | grep nsd
+ [root root]# ps -auxw | grep nsdservice0 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/certsIt 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.pemStrip 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.htmlAutomate 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/analogPut 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/analogTest it by running the script.
- [root@yourserver root]# sh /etc/cron.daily/analog
+ [root root]# sh /etc/cron.daily/analogBrowse 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 @@
PostgresVacuuming
- [service0@yourserver service0]$ export EDITOR=emacs;crontab -e
+ [service0 service0]$ export EDITOR=emacs;crontab -eAdd 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 .bashrcPut 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;.tgzcd /tmp
tar xzf &tarballpath;.tgzIf 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 psgmlNote: 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/svgroupcp /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.gzcd /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 checkVerify 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.smtpcp /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 @@
sendmailremoving
- [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/sendmailConfigure 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.testAll 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/.qmailAs 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 /servicemkdir -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 analyzerDownload 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 PackagesRestart 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/.bashrcecho "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib" >> ~postgres/.bashrc
echo "export PATH=$PATH:/usr/local/pgsql/bin" >> ~postgres/.bashrcTest 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/postgresqlTest 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 @@
PostgreSQLCreate 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.webservice0
+ [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.webservice0
@@ -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
exitTo 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]$ exitsu - 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
exitIn 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 CVSUnpack 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.6Import 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-6Create 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-devWait 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-devBrowse to http://yourserver/openfts