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