CELO Installation and Setup Guide
The steps for installing and setting up a CELO server are:
These instructions also include details about how to uninstall CELO
A working WIRM system is required before CELO can be setup.
1.1 Follow the steps in the WIRM Installation Guide (NOTE: The WIRM-2.0 release is missing some required features, please wait for a newer release.)
1.2 Make sure the installation is successfully running by creating a new test repository
2.1 Install the latest CELO source code into the WIRM root directory using one of the following methods:
4.1 Download and unpack the following Perl modules from CPAN.org
4.2 To install each module, use the following commands:
5.1 To successfully run the install script, you must be a user with permissions to add directories to the Apache web server directory (e.g. /usr/local/apache) and with PATH environment variable including MySql server path (e.g./usr/local/mysql)
5.2 Navigate to the celo root directory under <wirm root>/celo (or wherever you put the celo sources)
5.3 Run install.pl
5.4 Enter the MySQL password when prompted
The install script will perform the following actions. Use this list as a guide for troubleshooting any problems you run into:
Using a remote browser, verify that the CELO Main Page can be accessed. The web URL should be
<your web server name>/celo/index.htm
(index.htm may be optional if the web server is set up indicating index.htm as the default page name)
7. Edit the CELO Home Page to fit your organization's needs
Note that the content of the CELO Home Page is not appropriate for the end users. You may edit the text to provide information tailored to the specific interests or needs of your research organization. The web banner image and text can also be easily modified if desired.
7.1 On the CELO server open the file <WIRM Root>/celo/htdocs/index.htm
7.2 Edit the html as desired. It is recommended to leave the table with the links as it serves as a portal to essential components of the CELO system. This critical HTML code is clearly marked in the file.
7.3 Save and close the file. Refresh the client browser to verify the changes.
7.4 If desired, you can also edit the default web display styles for your organization. Edit the Cascading Style Sheet (CSS) file in <WIRM Root>celo/htdocs/css/celo.css
Here is an example of how you might want to edit the main page html.
8.1 Test the installation by going through the tutorial
8.2 After the installation has been verified, remove the tutorial by running uninstall.pl and specifying "tutor"
If you ever need to uninstall CELO, you can easily do this with the uninstall script
1 To successfully run the uninstall script, you must be a user with permissions to delete directories on the Apache web server directory (e.g. /usr/local/apache) and with PATH environment variable including MySql server path (e.g./usr/local/mysql)
2 Navigate to the celo root directory under <wirm root>/celo (or wherever you put the celo sources)
3 Run uninstall.pl
4 When prompted, do not enter anything in order to uninstall all laboratory systems
5 Enter the MySQL password when prompted to delete each database
6 Delete the CELO directory (with source code) to completely remove the system