source: enpraxis.educommons/trunk/enpraxis/educommons/INSTALL.txt @ 568

==================================
Installing eduCommons 3.2.1-final
==================================

Download the eduCommons 3.2.1-final release, available at:

::

  http://sourceforge.net/projects/educommons/files/educommons/eduCommons-3.2.1-final/educommons.buildout-3.2.1-final.tar.gz/download



Unarchive the package to a directory which will serve as your buildout directory. Change directories and run the bootstrap script:

::

  cd eduCommons
  /usr/local/python2.4 bootstrap.py
  (in some envoronments the command will be /usr/local/bin/python2.4 bootstrap.py)


Then run the buildout script to download all the required packages and set up the eduCommons application:

::

        bin/buildout


Or run the same buildout script above, plus the Selenium test runner (needed to run acceptance tests):

::

  bin/buildout -c tests.cfg
 

Create two directories for file system storage:

::

        mkdir parts/instance/var/fss_storage
        mkdir parts/instance/var/fss_backup


Once you have the buildout ready you can launch it using the following:

::

        bin/instance start


Or to launch in the foreground of your console:

::

        bin/instance fg


You should now be able to open a browser and go to the ZMI with the following URL
(assuming that you configured Zope to run on port 8080)

::

        http://<server name>:8080/manage


You should then get a dialog prompt asking for your Zope admin username and password. The default username/password for the buildout is admin/test1234.

Install eduCommons Product in Your Zope Instance
================================================

Once you have logged into the ZMI via the management interface, you are now ready 
to create the site. Start by creating a plone site with the pull down menu in the 
top right corner. Give the plone site an ID and title. The ID will be used in the 
URL to access the site, so name it appropriately. The title will appear several 
places within the eduCommons install, and should be based on your group or institution.</p>
Under "Extension Profiles" you need to do a multi-select (hold down the CTRL or the 
Command key). Select the following so they are all highlighted:

1. Working Copy Support (Iterate)
2. ContentLicensing
3. IMSTransport
4. LinguaPlone
5. PloneBookmarklets
6. Zip File Transport
7. eduCommons
8. Left Skin

Then click "Add Plone Site." Once the eduCommons instance has been created, you will need to QuickInstall the FileSystemStorage Product.

In the ZMI:

1. Navigate to your eduCommons instance
2. Navigate to portal_quickinstaller
3. Select the checkbox to the left of FileSystemStorage
4. Click Install

If you wish to localize content in other languages you will need to QuickInstall install LinguaPlone.
This can be done either now from the ZMI or later, via Site Setup --> Add-on Products.

In the ZMI:

1. Navigate to your eduCommons instance
2. Navigate to portal_quickinstaller
3. Select the checkbox to the left of LinguPlone
4. Click Install

If you have installed LinguaPlone you will also need to select your supported languages.

In the ZMI:

1. Navigate to your eduCommons instance
2. Navigate to portal_languages
3. Select one or more Allowed languages (use the control or apple key to multi-select)
4. Click Save 

Additional instructions for localizing content using LinguaPlone are available in LOCALIZATION.txt.
Finally, you need to reorder the Layers in your eduCommons Skins Selections.
In the ZMI:

1. Navigate to your eduCommons instance
2. Navigate to portal_skins
3. Click on the Properties tab
4. Under the Skins Selections, in the Layers textbox for LeftSkin, cut the LinguaPlone entry and paste it one a new line below the eduCommons entry 
5. Click Save (be sure to click the Save button for the Skins selection section)

Configure eduCommons
====================

Additional configuration information is provided in SETUP.txt or online_. This will help you to further customize eduCommons.

.. _online: http://educommons.com/documentation/how-to/educommons-setup-instructions