OpenSSI-WebView

From OptionC

[edit]

Introduction

The following are the steps we took to set up OpenSSI-WebView on our little cluster.

Note: There is an issue with the way Apache2 is started - localview contect versus the defaultview context used by Apache 1.3 - which causes issues. We're not going to concern ourselves with how to fix that here, using the start-stop-daemon; we'll just use 1.3.

Note: You will need to do this installation not with the OpenSSI kernel running node1, but with a "normal" kernel. You will also have to make sure that the loop devices are created (modprobe loop).

[edit]

Installation

1) Download the Debian package from http://openssi-webview.sourceforge.net/download.php The version we used is: openssi-webview_0.2-3_all.deb

2) There's a whole lot of dependencies. We chose to install some of them up front to make sure that things are configured appropriately. 

# apt-get install apache apache-common apache2-utils libapache-mod-php4 \
          libapr0 libbz2-1.0 libexpat1 libkrb53 libldap2 libsasl2 \
          libzzip-0-12 lynx mime-support php4 php4-common \
          phpmyadmin ucf sudo

Do the necessary configuration to make sure that PHP works. Then install the package. 

# dpkg -i openssi-webview_0.2-3_all.deb

This will probably still need more dependencies. If so, type: 

# apt-get -f install

3) Add an Alias in your /etc/apache/httpd.conf file. Find the <IfModule mod_alias.c> section and add the following line: 

Alias /openssi-webview/ /usr/share/openssi-webview/

4) Test by pointing your browser to the name of the machine (example: http://ssi1). Since you're not running with an OpenSSI kernel (you did read the note, didn't you?), you'll get a message that says "The current system is not openSSI enabled, aborting."

5) Cleanup stuff. Since this is a Xen machine, you can remove the files that were created in the /boot directory. You can also remove the modules directory for the installed kernel (/lib/modules/2.6.10-ssi-686-smp).

6) Again, point your browser to the machine. This time things should run. If they run slow, you may want to turn the "Transparency" feature off in the settings.

7) Enjoy.

[edit]

Recommended Reading

The following references were useful in creating this document:

Retrieved from "http://www.option-c.com/xwiki/OpenSSI-WebView"