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