Index: openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp,v diff -u -r1.12 -r1.13 --- openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp 16 Jun 2002 17:56:37 -0000 1.12 +++ openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp 20 Jun 2002 22:32:57 -0000 1.13 @@ -23,20 +23,17 @@
Read the dotLRN FAQ
- Especially important is the State of dotLRN Development section. -
Get and Install OpenACS from development CVS
- If you have a working OpenACS installation from the latest - development CVS, skip to the next section. - + development CVS, make sure that you have all the packages required + below then skip to the next section.
@@ -73,55 +70,60 @@ Here's the current list of non-core packages needed for dotlrn:
- NEW! (June 13) the new - notifications package is required by the new - forums package (which replaces bboard and - sloan-bboard) + NEW! (June 19) notifications is + a new service package that is used by the new forums + package. The new forums package will not conflict with + the bboard package. The bboard package is not + reqiured for dotlrn.
- acs-datetime + acs-datetime + acs-developer-support (optional) acs-events acs-mail-lite bulk-mail calendar faq - forums file-storage + forums general-comments news notifications ref-timezones user-preferences - developer-support (optional)-
+
Do not install or remove these - packages since they conflict with dotlrn packages: - -
- portal (conflicts with new-portal) - spam (conflicts with bulk-mail) -+ packages since they conflict with dotlrn packages: portal + (conflicts with new-portal) and spam + (conflicts with bulk-mail)
cd to the newly created /openacs-4/packages - directory before the next step. + directory before the next command.
- cvs -z3 -d :pserver:anonymous@openacs.org:/cvsroot co - acs-datetime \ acs-events acs-mail-lite bulk-mail calendar faq - forums file-storage \ general-comments news notifications - ref-timezones user-preferences \ developer-support + cvs -z3 -d :pserver:anonymous@openacs.org:/cvsroot co \ + acs-datetime acs-developer-support acs-events acs-mail-lite \ + bulk-mail calendar faq file-storage forums general-comments news \ + notifications ref-timezones user-preferences+
+ Installation timesaver: In the /packages/ref-timezones/sql/common/ + directory, cut down the files to a few insert statements apeace. + This is fine for test system, and will save you alot of time in the + installation process. +
- NEW! (June 16) You have to make one - minor modification to the OpenACS sources for dotlrn to work - properly. Comment out ALL the code in + NEW! (June 16) You have to make one minor + modification to the OpenACS sources for dotlrn to work + properly. Comment out the + file_storage_post_instantiation procedure in /packages/file-storage/tcl/file-storage-init.tcl
@@ -136,9 +138,23 @@ working on a permanent solution to this.
- You will now have an /openacs-4 directory with all of OpenACS - required by dotLRN. + You will now have an /openacs-4 directory with all of + OpenACS required by dotLRN. To double check, your + /openacs-4/packages directory should look similar to this: +
+ $ ls + acs-admin acs-kernel acs-templating general-comments + acs-api-browser acs-mail acs-util news + acs-bootstrap-installer acs-mail-lite acs-workflow notifications + acs-content acs-messaging bulk-mail page + acs-content-repository acs-notification calendar ref-timezones + acs-core-docs acs-reference CVS search + acs-datetime acs-service-contract faq skin + acs-developer-support acs-subsite file-storage user-preferences + acs-events acs-tcl forums ++
Get dotLRN from CVS
@@ -161,12 +177,7 @@ /openacs-4/packages directory:
- NEW! forums-portlet and - dotlrn-forums replaces bboard-portlet - and dotlrn-bboard -
-
dotlrn dotlrn-syllabus @@ -207,14 +218,14 @@ Go the the "ACS Package Manager" (APM) on your system at http://yourserver/acs-admin/apm and hit the "Install packages" link. After the installer loads, you - will see a list of the dotlrn packages you just got from - CVS. Install them, return to the main APM page, and restart - your server. + will see a list of the packages you just got from CVS. Click the + button at the bottom of the page to Install them. You do not + have to restart your server at ths point.- Go to the "Site Map" on your system at + Next go to the "Site Map" on your system at http://yourserver/admin/site-map. Click the "new sub folder" link to the right of the "Main Site" link at the top of the table. Enter dotlrn in the @@ -239,37 +250,60 @@ the right of the "dotlrn/" URL.
- +- - You must now restart your server, wait, and reload the - "Site Map" page in your browser After the server - restarts, refresh the "Site Map". You will see a - "(+)" to the left of the dotlrn/ URL and a new URL: - "portal/" with application "new-portal". + NEW! (June 20) Install the + "notifications" application at the URL + "/notifications" the same way you installed + "dotlrn" +
-+ + +
- Aren't seeing the "(+)" beside dotlrn/? - Something went wrong. Did you restart your server? Restart again - while doing a tail -f of the error log. Unique constraint - violations while creating certain site-nodes are a known issue, - but any other errors should be reported to us. + Next you must set some parameters from the Site Map + page. -
+
+ + You must now restart your server, wait a few minutes, and + reload the "Site Map" page in your browser After + the server restarts, refresh the "Site Map". You will + see a "(+)" to the left of the dotlrn/ URL and a new + URL: "portal/" with application "new-portal". - One last step: Then set the - "DefaultMaster" parameter - of the Root ("Main site") from - /www/default-master to - /packages/dotlrn/www/dotlrn-default-master +
++ + Aren't seeing the "(+)" beside dotlrn/? + Something went wrong. Did you restart your server? Restart again + while doing a tail -f of the error log with debug turned + on in your AOLServer configuration. Please report all errors you + encounter to dotlrn@openforce.net