part of dotLRN +
part of dotLRN
-Contents +
Contents
+Read the dotLRN FAQ +
Read the dotLRN FAQ
+- + Especially important is the State of dotLRN Development section. +
-Install OpenACS v4.5 from CVS (not beta1!) +
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 v4.5 installation from CVS, skip + to the next section. +
+ If you don't have a working copy of OpenACS v4.5 (from current CVS), follow the extensive installation documenation. At the documenation. At + the point where the OpenACS installation instructions tell you to "download OpenACS", and avoid dealing with CVS, but we don't test this method and the warnings on the page apply. +
++ 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 @@ -55,56 +67,67 @@ 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. +
- 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. -
- -Get dotLRN from CVS + 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. +
+ + +Get dotLRN from CVS
++ Getting dotLRN from CVS is just like getting OpenACS from CVS - with a different CVSROOT. + with a different CVSROOT. +
+ In your /packages directory issue the following commands:
- cvs -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot login
- (hit return for prompted for password)
+ 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 -z3 -d :pserver:anonymous@dotlrn.openforce.net:/dotlrn-cvsroot co dotlrn-core
- Install dotLRN on your system +
Install dotLRN on your system
- Go the the "ACS Package Manager" (APM) on your system at - http://yourserver/acs-admin/apm and hit the + 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. After a few moments, refresh the main APM, and you should see dotlrn, new-portal, etc. in the - list. + list. +
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 textbox, - and hit the button. - + link at the top of the table. Enter dotlrn in the + textbox, and hit the button. + +
+There will be a new entry in the URL column for @@ -113,47 +136,121 @@ Application" link. Enter dotlrn into the textbox and select "dotLRN" from the drop-down list and hit the button. - + +
+- There will now be "dotlrn" in the application column - to the right of the "dotlrn/" URL. + There will now be "dotlrn" in the application column to + the right of the "dotlrn/" URL. +
+- You must now restart your server + You must now restart your server, wait, and reload the + "Site Map" page in your browser Why you ask? We do + some initialization things once dotlrn is mounted at a URL, as + opposed to just being installed as a package. +
+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". +
+- Aren't seeing "portal"? Did you restart your server? + + Aren't seeing the "(+)" beside dotlrn/? Did you restart + your server? +
-Explore dotLRN +
+ + One last step: Then set the "DefaultMaster" parameter + of the Root ("Main site") from + /www/default-master to + /packages/dotlrn/www/dotlrn-default-master + +
+ ++ + The New Portal package requires the CSS imbeded in the + dotlrn-default-master files or XXX + +
+ + + +Explore dotLRN
+ ++ Go to dotLRN Administration at http://yourserver/dotlrn/admin. Make some dotLRN users, terms, departments, classes. + +
+ Here are some suggestions for things to check out in dotlrn: +
+Goto /dotlrn your "workspace". Click the "Control Panel" link at the top and try the "Customize this portal" link there. Goto the admin pages for a class or community and try the "Manage Membership" link. Create a new sugroup for a class or community. Edit or create new "Custom Portlets". + +
++ Enjoy! +
+ + +Reinstalling dotLRN
+ ++ + Sometimes you have to dump your DB. Here's the dotLRN reinstall + process. + +
+ % sqlplus internal < my-drop-create-script.sql ++ + Verify that your database user was droped and created + successfully. If you get an error saying: Cannot drop a + user that is currently connected, close all open + sqlplus sessions and repeat the command above. +