Installation Instructions for Enterprise Rhaptos


Upcoming Sprints for Developers. Sprint with us October 30th, 2010 at the Plone Conference in Bristol, February 10th, 2011 at the Connexions Conference in Houston, and May 20th/21st, 2011 at the Plone East Conference. Find out more here.


Enterprise Rhaptos allows individual organizations to host their own authoring and publishing platform, based on the fully featured software that runs the global educational commons, cnx.org.

Enterprise Rhaptos enables the creation, sharing, modification, and vetting of educational materials accessible to anyone, anywhere, anytime via the World Wide Web. Rhaptos' unique features of permanent versions of all materials, a simple, semantic document language, and a powerful lensing system for post-publication quality control, customized tagging, and community-based search and discovery are the engine behind a truly reusable repository of knowledge and learning.

The following shows step-by-step instructions for installing Enterprise Rhaptos using Buildout. Buildout requires Debian (Lenny) Linux and the installation of the Rhaptos Essentials packages. Buildout downloads the current source and installs it along with an empty repository. Several users are also created so your installation is ready to be used for development, taken for a test drive, or put into production. If you are interested in customizing Rhaptos for your project, see our customization instructions and Running Rhaptos with Apache before you install Rhaptos.

Sign up for the Rhaptos mailing list: We recommend that you sign up for the Rhaptos mailing list to engage with Connexions and others using Rhaptos. We also request that you send a quick email to the list or to cnx@… letting us know that you are trying it out. Neither are required, but both help us in planning for and understanding the Rhaptos community.

Enterprise Rhaptos Software Licenses

Connexions and Rhaptos software is licensed under the terms of the GNU General Public License. Some individual Products are available separately under the LGPL. See the LICENSE.txt file in each Product for details. Connexions also builds on several additional open source projects, like Plone, Zope, and PostgreSQL. The page linked below provides more detailed information on the specific licensing requirements.

Preparing the OS

Install Debian (optional VirtualBox install instructions).

Using a root shell, create a file /etc/apt/sources.d/rhaptos.list containing this line:

deb http://rhaptos.org/debian binary/

Then Run

$ apt-get update; echo "This generated an error: NO_PUBKEY. Disregard it"
$ apt-get -y --force-yes install rhaptos-essentials connexions-xml zip

Installing Rhaptos

Note: Be sure you are logged in as a normal user (not root)

1. Get Rhaptos buildout :

$ echo 'p\n' | svn co https://software.cnx.rice.edu/svn/Releases/rhaptos/buildout 
$ cd buildout

2. Build the application with a buildout embedded PostgreSQL server:

$ python2.4 bootstrap.py
$ ./bin/buildout 

3. Start PostgreSQL, Zeo, Zope, and optionally OpenOffice (for importing) :

$ ./scripts/application start
$ ./scripts/oolaunch

4. Go to http://localhost:8080 and log in using a user account:

usernamepassword
user1user1
user2user2
user3user3
org1org1
org2org2
manager1manager1
adminadmin

5. To administer the site, you can open a browser and go to http://localhost:8080/manage using the admin username and password:

Note, using this profile Zope is using the source components inside buildout/src and you can work in this directory.

6. When you access your Rhaptos install via a URL other than localhost, you will need to modify the virtual_hosting settings to redirect top level access into the 'site' object.

You can do this by logging into the top level zope install that is 'above' the rhaptos install:

http://yourhostname.here:8080/manage

The top-level account is admin:admin.

Click on the 'virtual_hosting' object, then click on the 'mappings' tab. Below localhost add a redirect that matches your domain like:

*.your.domain.here/ /site

Save, logout. Accessing the top-level of your site should now show you the Rhaptos install. In order to get back to the top-level zope admin page, you now will need to use the IP of your server.

Rhaptos Help Files

  • The Rhaptos help files (<rhaptos install url>/help) are a slightly modified version of the Connexions help.
  • There has been some effort made to make the files somewhat Rhaptos specific, but not every reference to Connexions has been removed.
  • It is the Rhaptos installation users responsibility to correct references to cnx.org and rhaptos that should be specific to their Rhaptos installation.
  • Modification of the help files occurs during the running of Buildout. The code responsible for the help changes is in <buildout-install-location>/src/Products.RhaptosSite/Products/RhaptosSite/setup/RhaptosSetup.py. The function used is createHelpSection().
  • The files can also be hand edited by logging in as a manager user and selecting the Edit tab.
  • There are also Connexions specific screenshots that are part of some of the Help pages. These should also be changed to be installation specific. To correct this, simply upload new screenshots and replace the referenced file name or name the new screenshot the same name.

Further Questions