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