/etc/dotlrn/install/README is in dotlrn 2.5.0+dfsg2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | OpenACS and .LRN automated install and test scripts
*** Prerequisites in brief
tclwebtest
aolserver
oracle or postgresql
For oracle a tablespace with same name as db user must exist
user named service0
root access to server
see /packages/acs-core-docs/www/index.html for more documentation
about installing OpenACS and its prerequisites
*** Quick Guide
edit install.tcl
su -
./install.sh
By default, this will
1) stop any OpenACS service supervised at /var/lib/svscan/service0
2) drop the database service0 if it exists
3) create a CVS HEAD checkout of OpenACS at
/var/lib/aolserver/service0
4) create the database service0
5) install OpenACS, including configuring the web-driven pages, to
http://localhost:8000
The install.sh script can also be used to perform a full .LRN test
data setup, or to only perform a cvs checkout, or only recreate the
database. Invoke install.sh --help to see command line switches.
*** Prerequisites in full
1) If you already have a server running that is to be recreated - move
away and save any local changes (patches) that you have made to the
source code. If the do_checkout parameter is set to true the whole
source code tree of the server will be moved away to temporary storage
and deleted on the next recreation. Any patches that you want to apply
on recreation should be executed by a script specified in the config
file (see below) as post_checkout_script. This script will be executed
after checkout is completed. If you keep AOLserver config file and log
files under the server root dir you might want to save them before the
checkout with the pre_checkout_script (specify path in config file),
otherwise any changes to the AOLServer config file will be lost as the
whole server tree is moved away for a new checkout from CVS.
2) A tablespace must exist with the same name as the oracle user of
the server. The oracle recreate script uses statements from
http://www.pinds.com/acs-tips/oracle-statements. Make sure you
are not connected to the database user that the server uses
so that that user can be dropped (i.e. log out of any sqlplus or
psql sessions you might have).
3) Use the config template install.tcl to create
a server specific installation config file. Per default install.sh
will use the file install.tcl in the same directory but you can specify
any config file on the command line with the switch --config-file.
4) Make sure an AOLServer config file is prepared. You can use
/etc/config.tcl as a template.
5) The server you are to create/recreate must be under supervise
(i.e. ln -s /web/dotlrn-test /service/dotlrn-test).
6) Make sure you have root access since you must run install.sh
as root.
7) Fetch a fresh checkout from CVS of TclWebTest (see
http://tclwebtest.sourceforge.net) and specify the directory the
tclwebtest executable resides in in your install.tcl file.
*** FAQ
Q: How do I copy files into the source tree after checkout, but before install?
A: You can specify
|