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.1 -r1.2
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 1 Feb 2002 17:14:07 -0000 1.1
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/openacs.xml 2 Feb 2002 03:47:32 -0000 1.2
@@ -23,8 +23,7 @@
joeuser:~$ su - nsadmin
Password: ***********
nsadmin:~$ cd /web
-nsadmin:/web$ tar xzf /tmp/alpha2.tgz
-
+nsadmin:/web$ tar xzf /tmp/alpha2.tgz
@@ -52,8 +51,7 @@
nsadmin:/web$ mv openacs-4 birdnotes
nsadmin:/web$ ls -l
total 4
-drwxr-xr-x 8 nsadmin nsadmin 4096 Dec 20 14:37 birdnotes
-
+drwxr-xr-x 8 nsadmin nsadmin 4096 Dec 20 14:37 birdnotes
@@ -79,25 +77,22 @@
nsadmin:~$ groups
-nsadmin dba web
-
+nsadmin dba web
If you do not see these groups, take the following action:
nsadmin:~$ su -
Password: ************
-root:~# usermod -g nsadmin -G dba,web nsadmin
-
+root:~# usermod -g nsadmin -G dba,web nsadmin
If you get an error about an undefined group, then add that group
manually:
root:~# groupadd dba
root:~# groupadd nsadmin
-root:~# groupadd web
-
+root:~# groupadd web
Make sure to logout as root when
you are finished with this step and log back in as
@@ -112,16 +107,14 @@
nsadmin:~$ svrmgrl
SVRMGR> connect internal
-Connected.
-
+Connected.
Determine where the system tablespaces are stored:
-SVRMGR> select file_name from dba_data_files;
-
+SVRMGR> select file_name from dba_data_files;
Example results:
@@ -131,8 +124,7 @@
/ora8/m01/app/oracle/oradata/ora8/temp01.dbf
/ora8/m01/app/oracle/oradata/ora8/users01.dbf
/ora8/m01/app/oracle/oradata/ora8/indx01.dbf
-/ora8/m01/app/oracle/oradata/ora8/drsys01.dbf
-
+/ora8/m01/app/oracle/oradata/ora8/drsys01.dbf
@@ -166,8 +158,7 @@
root:~# chown nsadmin.web /ora8/m02/oradata/ora8
root:~# chmod 775 /ora8/m02/oradata/ora8
root:~# exit
-nsadmin:~$
-
+nsadmin:~$
@@ -184,8 +175,7 @@
nsadmin:~$ svrmgrl
SVRMGR> connect internal;
-SVRMGR> create tablespace birdnotes datafile '/ora8/m02/oradata/ora8/birdnotes01.dbf' size 50m autoextend on default storage (pctincrease 1);
-
+SVRMGR> create tablespace birdnotes datafile '/ora8/m02/oradata/ora8/birdnotes01.dbf' size 50m autoextend on default storage (pctincrease 1);
@@ -194,22 +184,21 @@
birdnotespassword as our password.
- Write down what you specify as
- service_name
+ Write down what you specify as service_name
(i.e. birdnotes) and
database_password
- (i.e. birdnotespassword)
- . You will need this information for configuring
- exports and AOLserver.
+ (i.e. birdnotespassword). You
+ will need this information for configuring exports and
+ AOLserver.
+
SVRMGR> create user birdnotes identified by birdnotespassword default tablespace birdnotes
temporary tablespace temp quota unlimited on birdnotes;
SVRMGR> grant connect, resource, ctxapp, javasyspriv, query rewrite to birdnotes;
SVRMGR> revoke unlimited tablespace from birdnotes;
SVRMGR> alter user birdnotes quota unlimited on birdnotes;
-SVRMGR> exit;
-
+SVRMGR> exit;
Your table space is now ready. In case you are trying to delete a
@@ -229,8 +218,7 @@
----------
2001-12-20
-SQL> exit
-
+SQL> exit
You should see today's date in a format 'YYYY-MM-DD.'
@@ -248,24 +236,22 @@
nsadmin:~$ cp /tmp/nsd-oracle.txt ./bin/nsd-oracle
-nsadmin:~$ chmod 700 ./bin/nsd-oracle
-
+nsadmin:~$ chmod 700 ./bin/nsd-oracle
-
- Prepare Postgres for OpenACS
+
+ Prepare PostgreSQL for OpenACS
- Preparing Postgres is just a little bit simpler than preparing
+ Preparing PostgreSQL is just a little bit simpler than preparing
Oracle. We simply need to create a database with the name of our
service-name
(i.e. birdnotes)
nsadmin:/web$ createdb birdnotes
-CREATE DATABASE
-
+CREATE DATABASE
Next we'll set up AOLserver so that it has the proper environment
variables set before launching. Download this
nsadmin:/web$ cd
nsadmin:~$ cp /tmp/nsd-postgres.txt ./bin/nsd-postgres
-nsadmin:~$ chmod 700 ./bin/nsd-postgres
-
+nsadmin:~$ chmod 700 ./bin/nsd-postgres
@@ -309,8 +294,7 @@
nsadmin:~$ cp /tmp/openacs4.tcl.txt ./birdnotes.tcl
nsadmin:~$ chmod 660 birdnotes.tcl
-nsadmin:~$ emacs birdnotes.tcl
-
+nsadmin:~$ emacs birdnotes.tcl
Specifically, you'll have set the following variables
@@ -350,24 +334,22 @@
Kill any current running AOLserver processes and start a new
- one. (Note, if you are using Oracle, rather than postgres, replace
+ one. (Note, if you are using Oracle, rather than PostgreSQL, replace
nsd-postgres with
nsd-oracle):
nsadmin:~$ killall nsd
; Should probably see:
nsd: no process killed
-nsadmin:~$ /usr/local/aolserver/bin/nsd-postgres -t /usr/local/aolserver/birdnotes.tcl
-
+nsadmin:~$ /usr/local/aolserver/bin/nsd-postgres -t /usr/local/aolserver/birdnotes.tcl
Attempt to connect to the service from a web browser as you did
in the section. You should
specify a URL like:
-http://ip_name:ip_port/
-
+http://ip_name:ip_port/
You should see a page that looks like
-nsadmin:~$ killall nsd
-
+nsadmin:~$ killall nsd
@@ -418,8 +399,7 @@
-Loading package .info files ... this will take a few minutes
-
+Loading package .info files ... this will take a few minutes
This will really take a few minutes. Have faith! Finally,
@@ -460,8 +440,7 @@
-nsadmin:~$ /usr/local/aolserver/bin/nsd-postgres -t /usr/local/aolserver/birdnotes.tcl
-
+nsadmin:~$ /usr/local/aolserver/bin/nsd-postgres -t /usr/local/aolserver/birdnotes.tcl
@@ -553,8 +532,7 @@
root:~# chown root.web /usr/local/bin/restart-aolserver
root:~# chmod 4750 /usr/local/bin/restart-aolserver
root:~# ln -s /usr/bin/perl /usr/local/bin/perl
-root:~# exit
-
+root:~# exit
@@ -572,8 +550,7 @@
nsadmin:~$ restart-aolserver birdnotes
Killing 23727
nsadmin:~$ killall nsd
-nsd: no process killed
-
+nsd: no process killed
The number 23727 indicates the process id(s) (PIDs) of the
@@ -591,8 +568,7 @@
nsadmin:~$ su -
Password: ************
-root:~# emacs -nw /etc/inittab
-
+root:~# emacs -nw /etc/inittab
@@ -601,15 +577,14 @@
nss1 is unique.
-nss1:2345:respawn:/usr/local/aolserver/bin/nsd-postgres -i -u nsadmin -g web -t /usr/local/aolserver/birdnotes.tcl
-
+nss1:2345:respawn:/usr/local/aolserver/bin/nsd-postgres -i -u nsadmin -g web -t /usr/local/aolserver/birdnotes.tcl
- Important: Make sure there is a newline at the
- end of the file. If there is not a newline at the end of the
- file, the system may suffer catastrophic
- failures.
+ Important: Make sure there is a
+ newline at the end of the file. If there is not a newline at
+ the end of the file, the system may suffer catastrophic
+ failures.
@@ -619,8 +594,7 @@
root:~# killall nsd
nsd: no process killed
-root:~# /sbin/init q
-
+root:~# /sbin/init q
@@ -630,8 +604,7 @@
root:~# restart-aolserver birdnotes
-Killing 23750
-
+Killing 23750
@@ -652,12 +625,10 @@
Debian
-
root:~# apt-get install daemontools-installer
root:~# build-daemontools
-root:~# # answer 'yes' when asked to create symlink from /service to /var/lib/svscan
-
+root:~# # answer 'yes' when asked to create symlink from /service to /var/lib/svscan
@@ -692,8 +663,7 @@
nsadmin:~$ cd /web/birdnotes
-nsadmin:/web/birdnotes$ emacs run
-
+nsadmin:/web/birdnotes$ emacs run
Copy this text into that file:
@@ -702,8 +672,7 @@
#!/bin/sh
-exec /usr/local/aolserver/bin/nsd-postgres -it /usr/local/aolserver/birdnotes.tcl -u nsadmin -g web
-
+exec /usr/local/aolserver/bin/nsd-postgres -it /usr/local/aolserver/birdnotes.tcl -u nsadmin -g web
As root, change the ownership of this file:
@@ -713,8 +682,7 @@
nsadmin:/web/birdnotes$ su -
Password: ***********
root:~# chown root.root /web/birdnotes/run
-root:~# chmod 700 /web/birdnotes/run
-
+root:~# chmod 700 /web/birdnotes/run
Now, we'll link our web root to the
@@ -732,8 +700,7 @@
19361 pts/3 00:00:00 nsd
19362 pts/3 00:00:00 nsd
19363 pts/3 00:00:00 nsd
-19364 pts/3 00:00:00 nsd
-
+19364 pts/3 00:00:00 nsd
At this point, you should be able to use the
@@ -784,8 +751,7 @@
root:~# cp /tmp/svgroup.txt /usr/local/bin/svgroup
root:~# chmod 755 /usr/local/bin/svgroup
-root:~# svgroup web /service/birdnotes
-
+root:~# svgroup web /service/birdnotes
This command will give the web
@@ -807,8 +773,7 @@
nsadmin:~$ # now, start the server up
nsadmin:~$ svc -u /web/birdnotes
nsadmin:~$ # wait for server to come up, then restart it
-nsadmin:~$ svc -t /web/birdnotes
-
+nsadmin:~$ svc -t /web/birdnotes
Most of this information comes from Tom Jackson's
-SVRMGR> drop user birdnotes cascade;
-
+SVRMGR> drop user birdnotes cascade;
If this does not work because svrmgrl "cannot drop a user that
is currently connected", make sure to kill the AOLserver using
this user. If it still does not work, do:
-SVRMGR> select username, sid, serial# from v$session where username='birdnotes';
-
+SVRMGR> select username, sid, serial# from v$session where username='birdnotes';
and then
-SVRMGR> alter system kill session 'sid,serial#';
-
+SVRMGR> alter system kill session 'sid,serial#';
where sid and serial# are
replaced with the corresponding values for the open session.
- Use with caution!
+ Use with caution!
If you feel the need to delete everything
related to the service, you can also issue the following:
-SVRMGR> drop tablespace birdnotes including contents cascade constraints;
-
+SVRMGR> drop tablespace birdnotes including contents cascade constraints;
-
- Deleting a Postgres tablespace
+
+ Deleting a PostgreSQL tablespace
- Dropping a Postgres tablespace is easy. You have to stop any
+ Dropping a PostgreSQL tablespace is easy. You have to stop any
AOLserver instances that are using the database that you wish to
drop. If you're using daemontools, this is simple, just use the
'down' flag (-d). If you're using inittab, you have to comment out
@@ -912,8 +873,7 @@
Then, to drop the db, just do:
nsadmin:~$ dropdb birdnotes
-DROP DATABASE
-
+DROP DATABASE