Ubuntu install notes produced by an external developer
These install notes were produced by Philip Schatz <schatzp@purdue.edu> of Purdue University. He is a graduate student there and interested in contributing to Rhaptos development. These notes are from his installations of Rhaptos on Ubuntu which were partially successful.
Experience installing Rhaptos (plone25
branch) on Ubuntu and on Windows XP
These notes were produced by Philip Schatz <schatzp at purdue dot edu> from
his efforts to install and configure Rhaptos.
================
Ubuntu Install
================
For starters, I installed Rhaptos on Ubuntu 7.10 using the Plone2.5
install script (from the rhaptos site) and have a few notes:
1. `apt-get` should install `libc6-dev` instead of `libc6`.
2. `apt-get` should install `texlive-latex-base`.
3. `RhaptosCacheTool` should be downloaded as well from SVN.
4. The DTD should be updated instead of redirecting to cnx.org/aboutus/...
Since lenses don't work, I changed a few files to optionally include
lens content, namely:
* `RhaptosCollection/skins
/rhaptos_collection/collection_view.pt`
* `RhaptosContent/skins/rhaptos_content/module_export_template.pt`
* `RhaptosRepository/Repository.py`
Since the URLs to xsl sheets and DTDs are redirected and remote, it
would help to make them local.
Also, the `isBrowserDefault` check in
`RhaptosSite/skins/rhaptos_overrides/folder_contents.pt` did not work
for me, so I removed it.
Aside from the changes above, I was able to publish courses and modules
without a problem.
=================
Windows Install
=================
Currently, I can create modules and courses but am porting pycvs to
commit content.
Both PostgreSQL and CVSNT required specific options so I erred on the
side of caution, supplying details liberally (eventually screenshots).
I also created a zip file containing pycvs, ZpsycopgDA, and Rhaptos that
you can extract on top of the Plone install folder.
Listed below are my instructions (unverified by others) to install on
Windows.
They fall into several sections:
1. Install PostgreSQL 8.2
2. Install Plone 2.5.4
3. Install Rhaptos
4. Set Up a Rhaptos Site
5. Set Up a User Manually (no SMTP server)
6. Install CVSNT
7. Notes and Status
Install PostgreSQL 8.2
--------------------------
Download from http://www.postgresql.org/ftp/binary/v8.2.4/win32/
(click
on **postgresql-8.2.4-1.zip**)
1. Pick a Language - `Next`
2. Installation options - `Next`
3. Service Configuration
a) Enter a password you'll remember (I used ``postgres``).
b) The password is necessary if you want to install/update Postgres.
c) Yes, create the account.
d) No, don't replace with a random password (unless you write it down).
4. Initialize database cluster:
You can be adventurous but using the defaults didn't work for me.
They failed at the end of the install when the database was
automatically initialized.
The rest of this step and the next one assume you're installing
manually.
a) **Uncheck** the Initialize checkbox. My install on a clean copy
of windows fails unless I manually init the db.
b) Next. Yes, I'm sure I want to continue without running initdb.
c) At some point between `Next` clicks, you should get a screen to
install optional components.
Make sure `tsearch` and `tsearch2` are selected.
d) `Next`, wait, done.
5. Now, we'll create the database manually:
a) We'll create the DB:
(1) Open up a command window: `Start, Run`, enter ``cmd``.
(2) Switch to your PostgreSQL install location's bin folder (``cd
"\Program Files\PostgreSQL\8.2\bin"``).
(3) type ``initdb -D ..\Data`` (don't close the command window).
(4) If it fails the first time, try again running step 3.
b) Start up the PostgreSQL service:
(1) Right-click `My Computer` and select `Manage`.
(2) Expand `Services and Applications` and select `Services`.
(3) Find `PostgreSQL Database Server 8.2` in the list and click
`Start`.
c) Create the DBA user:
(1) In the commandline window, type ``createuser --superuser
--pwprompt postgres`` (and I entered ``postgres`` as the password.
d) At this point, you can make sure PostgreSQL is running by going
to `Start, All Programs, PostgreSQL 8.2, pgAdmin III`.
Install Plone 2.5.4
-----------------------
Download from http://plone.googlecode.com/files/Plone-2.5.4-zope-2.9.exe
and run it.
1. I recommend Installing it in ``C:\Plone2`` but you can put it anywhere.
2. Pick an admin user/password for the web-based UI for Zope (I did
``admin`` and ``admin``).
3. Finish the Install.
Install Rhaptos
----------------
You should be able to extract the zip on top of your Plone2 folder
(``C:\Plone2``) and it should add all the necessary files:
1. The Rhaptos code.
2. External Zope Products needed by Rhaptos.
3. The hacked pycvs library (to store published modules in a versioned
repository).
4. The ZpsycopgDA libraries (to communicate with a PostgreSQL database).
Set Up a Rhaptos Site
----------------------
1. Start up Plone: `Start, Programs, Plone, Plone`.
2. Cilck `Start Plone`.
3. Click `Zope Management Interface`.
4. Enter ``admin`` and ``admin``
5. From `Select type to add...`, select `Rhaptos Site`.
6. Enter the following:
- Id: ``rhaptos``
- Exiting DBA username: ``postgres``
- password: ``postgres``
- DB username: ``postgres``
- DB password: ``postgres``
- DB with name: ``repository``
- server: ``localhost``
- port: ``5432``
7. Click `Add Rhaptos Site`.
Set Up a User Manually
-----------------------
Since you probably don't have an email (SMTP) server running on your
machine, you can't use Plone to create a new user, so we'll do it manually:
1. While still logged in as admin (assuming you didn't close your
browser), head to http://localhost:8080/rhaptos/plone_control_panel ,
click on `Portal Settings`, and select `Allow users to select their
initial password` and click `save`.
2. From the control panel, select `Users and Groups Administration`, and
click on `add new user`.
3. Enter the required information, and click `Next`.
4. Enter a username, and click `continue`, then click `request Account`.
5. Now, go back to the ZMI: http://localhost:8080/manage .
6. Click `rhaptos`, `acl_users`, and then `source_groups`.
7. Click the `?` next to Administrators, and add your userid to the
`Active` box.
8. Do the same with the `Reviewers` group.
9. In `rhaptos / acl_users / source_users`, click `Password` next to
your user and set their password.
10. In the ZMI go to `rhaptos/Members` and add `Workgroup` with your
username as the Id and select `WorkgroupAT` option.
11. Log off by clicking the `Zope Quick Start` drop-down on the
top-right of the browser window, and select `Logout` (*DON'T REENTER*
the login/pass).
12. Close your browser and reopen it (to remove the cache).
13. Go to http://localhost:8080/rhaptos and log in.
Now you should be able to create courses and modules.
Install CVSNT
--------------
This one's easy but you end up getting a CVS server that you don't need.
It appears that any customization will cause cvs.exe to not work
properly (**Invalid triggers error**).
1. Download CVSNT from http://cvsnt.org and run through the installer
using the defaults for everything.
2. Create a repository in `C:\var\lib\cvs` (you can extract it from the
zip file).
Notes
------
At this point you should be able to create modules and courses.
However, when you try to publish, either my hacked pycvs or something
else fails.
To get pycvs to work on Windows, I did the following (it's not thread-safe):
1. Replace all occurrences of ``cd %s`` with a call to a chdir function
that stores the old current dir.
2. Replace all occurrences of ``commands.getstatusoutput`` with a custom
getstatusoutput that does **NOT** wrap the command in curly braces which
only works on a Unix-based OS, and upon completion changes the directory
back.
branch) on Ubuntu and on Windows XP
These notes were produced by Philip Schatz <schatzp at purdue dot edu> from
his efforts to install and configure Rhaptos.
================
Ubuntu Install
================
For starters, I installed Rhaptos on Ubuntu 7.10 using the Plone2.5
install script (from the rhaptos site) and have a few notes:
1. `apt-get` should install `libc6-dev` instead of `libc6`.
2. `apt-get` should install `texlive-latex-base`.
3. `RhaptosCacheTool` should be downloaded as well from SVN.
4. The DTD should be updated instead of redirecting to cnx.org/aboutus/...
Since lenses don't work, I changed a few files to optionally include
lens content, namely:
* `RhaptosCollection/skins
* `RhaptosContent/skins/rhaptos
* `RhaptosRepository/Repository
Since the URLs to xsl sheets and DTDs are redirected and remote, it
would help to make them local.
Also, the `isBrowserDefault` check in
`RhaptosSite/skins/rhaptos
for me, so I removed it.
Aside from the changes above, I was able to publish courses and modules
without a problem.
=================
Windows Install
=================
Currently, I can create modules and courses but am porting pycvs to
commit content.
Both PostgreSQL and CVSNT required specific options so I erred on the
side of caution, supplying details liberally (eventually screenshots).
I also created a zip file containing pycvs, ZpsycopgDA, and Rhaptos that
you can extract on top of the Plone install folder.
Listed below are my instructions (unverified by others) to install on
Windows.
They fall into several sections:
1. Install PostgreSQL 8.2
2. Install Plone 2.5.4
3. Install Rhaptos
4. Set Up a Rhaptos Site
5. Set Up a User Manually (no SMTP server)
6. Install CVSNT
7. Notes and Status
Install PostgreSQL 8.2
--------------------------
Download from http://www.postgresql.org/ftp
on **postgresql-8.2.4-1.zip**)
1. Pick a Language - `Next`
2. Installation options - `Next`
3. Service Configuration
a) Enter a password you'll remember (I used ``postgres``).
b) The password is necessary if you want to install/update Postgres.
c) Yes, create the account.
d) No, don't replace with a random password (unless you write it down).
4. Initialize database cluster:
You can be adventurous but using the defaults didn't work for me.
They failed at the end of the install when the database was
automatically initialized.
The rest of this step and the next one assume you're installing
manually.
a) **Uncheck** the Initialize checkbox. My install on a clean copy
of windows fails unless I manually init the db.
b) Next. Yes, I'm sure I want to continue without running initdb.
c) At some point between `Next` clicks, you should get a screen to
install optional components.
Make sure `tsearch` and `tsearch2` are selected.
d) `Next`, wait, done.
5. Now, we'll create the database manually:
a) We'll create the DB:
(1) Open up a command window: `Start, Run`, enter ``cmd``.
(2) Switch to your PostgreSQL install location's bin folder (``cd
"\Program Files\PostgreSQL\8.2\bin"``).
(3) type ``initdb -D ..\Data`` (don't close the command window).
(4) If it fails the first time, try again running step 3.
b) Start up the PostgreSQL service:
(1) Right-click `My Computer` and select `Manage`.
(2) Expand `Services and Applications` and select `Services`.
(3) Find `PostgreSQL Database Server 8.2` in the list and click
`Start`.
c) Create the DBA user:
(1) In the commandline window, type ``createuser --superuser
--pwprompt postgres`` (and I entered ``postgres`` as the password.
d) At this point, you can make sure PostgreSQL is running by going
to `Start, All Programs, PostgreSQL 8.2, pgAdmin III`.
Install Plone 2.5.4
-----------------------
Download from http://plone.googlecode.com
and run it.
1. I recommend Installing it in ``C:\Plone2`` but you can put it anywhere.
2. Pick an admin user/password for the web-based UI for Zope (I did
``admin`` and ``admin``).
3. Finish the Install.
Install Rhaptos
----------------
You should be able to extract the zip on top of your Plone2 folder
(``C:\Plone2``) and it should add all the necessary files:
1. The Rhaptos code.
2. External Zope Products needed by Rhaptos.
3. The hacked pycvs library (to store published modules in a versioned
repository).
4. The ZpsycopgDA libraries (to communicate with a PostgreSQL database).
Set Up a Rhaptos Site
----------------------
1. Start up Plone: `Start, Programs, Plone, Plone`.
2. Cilck `Start Plone`.
3. Click `Zope Management Interface`.
4. Enter ``admin`` and ``admin``
5. From `Select type to add...`, select `Rhaptos Site`.
6. Enter the following:
- Id: ``rhaptos``
- Exiting DBA username: ``postgres``
- password: ``postgres``
- DB username: ``postgres``
- DB password: ``postgres``
- DB with name: ``repository``
- server: ``localhost``
- port: ``5432``
7. Click `Add Rhaptos Site`.
Set Up a User Manually
-----------------------
Since you probably don't have an email (SMTP) server running on your
machine, you can't use Plone to create a new user, so we'll do it manually:
1. While still logged in as admin (assuming you didn't close your
browser), head to http://localhost:8080/rhaptos
click on `Portal Settings`, and select `Allow users to select their
initial password` and click `save`.
2. From the control panel, select `Users and Groups Administration`, and
click on `add new user`.
3. Enter the required information, and click `Next`.
4. Enter a username, and click `continue`, then click `request Account`.
5. Now, go back to the ZMI: http://localhost:8080/manage .
6. Click `rhaptos`, `acl_users`, and then `source_groups`.
7. Click the `?` next to Administrators, and add your userid to the
`Active` box.
8. Do the same with the `Reviewers` group.
9. In `rhaptos / acl_users / source_users`, click `Password` next to
your user and set their password.
10. In the ZMI go to `rhaptos/Members` and add `Workgroup` with your
username as the Id and select `WorkgroupAT` option.
11. Log off by clicking the `Zope Quick Start` drop-down on the
top-right of the browser window, and select `Logout` (*DON'T REENTER*
the login/pass).
12. Close your browser and reopen it (to remove the cache).
13. Go to http://localhost:8080/rhaptos and log in.
Now you should be able to create courses and modules.
Install CVSNT
--------------
This one's easy but you end up getting a CVS server that you don't need.
It appears that any customization will cause cvs.exe to not work
properly (**Invalid triggers error**).
1. Download CVSNT from http://cvsnt.org and run through the installer
using the defaults for everything.
2. Create a repository in `C:\var\lib\cvs` (you can extract it from the
zip file).
Notes
------
At this point you should be able to create modules and courses.
However, when you try to publish, either my hacked pycvs or something
else fails.
To get pycvs to work on Windows, I did the following (it's not thread-safe):
1. Replace all occurrences of ``cd %s`` with a call to a chdir function
that stores the old current dir.
2. Replace all occurrences of ``commands.getstatusoutput`` with a custom
getstatusoutput that does **NOT** wrap the command in curly braces which
only works on a Unix-based OS, and upon completion changes the directory
back.