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 -N -r1.3 -r1.4 --- openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp 28 Apr 2002 19:22:20 -0000 1.3 +++ openacs-4/packages/dotlrndoc/www/doc/dotlrn-install.adp 28 Apr 2002 22:52:56 -0000 1.4 @@ -1,25 +1,26 @@ -<%= [dotlrn_header "dotLRN Home - OpenForce"] %> +<%= [dotlrn_header "Installing dotLRN - OpenForce"] %>

Installing dotLRN

part of dotLRN

+

Last updated: $Date$ -

Contents

+

Contents

-

Read the dotLRN FAQ

+

Read the dotLRN FAQ

@@ -29,81 +30,137 @@

+

Get and Install OpenACS from development CVS

-

Install OpenACS v4.5 from CVS (not beta1!)

-

- If you have a working OpenACS v4.5 installation from CVS, skip - to the next section. + If you have a working OpenACS installation from the latest + development CVS, skip to the next section.

+ + If you are installing OpenACS, follow the extensive + installation documenation. + Stop at the point + where the OpenACS installation instructions tell you to + "download OpenACS". Don't use the "Quick + Downloads"! Continue on with this document. - If you don't have a working copy of OpenACS v4.5 (from current - CVS), follow the extensive installation documenation. At - the point - where the OpenACS installation instructions tell you to - "download OpenACS", - get a current CVS checkout of OpenACS v4.5 from the CVS - server. Alternatively, it may be possible to use a nighly - tarball of OpenACS v4.5 and avoid dealing with CVS, but we - don't test this method and the warnings on the page apply. +

+ If you have an account on openacs.org, do this: + + 

      
+      (set the CVS_RSH variable in your shell envrioment to "ssh")
+      cvs -z3 -d youraccount@openacs.org:/cvsroot checkout acs-core
+      (enter your openacs.org password)
+
-

+

+ If you have an don't have an account on openacs.org, do this: -

+ 

      
+      cvs -d :pserver:anonymous@openacs.org/cvsroot login
+      (just hit return for the password)
+      cvs -z3 -d :pserver:anonymous@openacs.org:/cvsroot checkout acs-core
+
- dotLRN dosen't use all of the modules in the OpenACS cvs - tree. If you are installing for dotLRN only, you can save lots - of time during the installation by checking out only - the following modules: acs-core acs-datetime acs-events - acs-interface acs-reference calendar faq file-storage - general-comments news ref-timezones simple-survey spam If - you already have a CVS checkout or the nightly tarball, remove - the packages not in the above list. +

-

+ dotLRN requires some more modules that are not in + acs-core, but not all of the packages in the OpenACS + source tree. Next are the commands to get these modules. -

+

- Another installation timesaver is to cut down the huge files - in /packages/ref-timezones/sql/common/ to a few - lines. This is fine for testing. + If you have an account on openacs.org, do this: + + 

      
+      cvs -z3 -d youraccount@openacs.org:/cvsroot checkout acs-datetime \ 
+      acs-events acs-interface calendar faq file-storage \
+      general-comments news ref-timezones simple-survey spam 
+      (enter your openacs.org password)
+
-

+

+ If you have an don't have an account on openacs.org, do this: + 

      
+      cvs -z3 -d :pserver:anonymous@openacs.org:/cvsroot checkout acs-datetime \ 
+      acs-events acs-interface calendar faq file-storage \
+      general-comments news ref-timezones simple-survey spam
+
-

Get dotLRN from CVS

+

+ Installation timesavers: If you have a full checkout of the + OpenACS tree, or are trying a nightly tarball, remove all the + modules not in acs-core or the above + checkout commands. Also, cut down the huge + files in /packages/ref-timezones/sql/common/ to a few + lines.

+ You will now have an /openacs-4 directory with all of OpenACS + required by dotLRN. +

Get dotLRN from CVS

+ +

Getting dotLRN from CVS is just like getting OpenACS from CVS with a different CVSROOT. -

-

- In your /packages directory issue the following commands: + Change to your /openacs-4/packages directory issue the + following commands: - 

+      
+      cvs -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot login
+      (hit return for prompted for password)
+      cvs -z3 -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot co dotlrn-core       
+      

 
-         cvs -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot login
-         
-         (hit return for prompted for password)
-         
-         cvs -z3 -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot co dotlrn-core
+    

+      This will fetch the following packages to your
+      /openacs-4/packages directory:
 
-
+ 
+      dotlrn
+      dotlrn-syllabus
+      dotlrn-research
+      new-portal
+      profile-provider
+      sloan-bboard
+      user-profile
+      bboard-portlet
+      dotlrn-bboard
+      calendar-portlet
+      dotlrn-calendar
+      dotlrn-portlet
+      dotlrn-dotlrn
+      faq-portlet
+      dotlrn-faq
+      fs-portlet
+      dotlrn-fs
+      news-portlet
+      dotlrn-news
+      static-portlet
+      dotlrn-static
+      survey-portlet
+      dotlrn-survey
+
-

- +

+ Next, copy the /openacs-4 directory to where ever you + prefer your webserver root to be, traditionally + /web. Now you can continue with the OACS installation + document at the third bullet point. Continue with the + standard OACS installation process until your reach the + "Congratulations!" front page, then return here.

Install dotLRN on your system