Server-side installation

OME's installation and deployment process is handled by an install script which is included in the standard distribution. This install script will need to be executed as the UNIX root user. You must have administrative (root) access to the computer in order to perform an OME install. However, you should not download and unpack the distribution as the root user, since this imparts superuser permissions onto all of the OME files.

Therefore, make sure to unpack the tar file (or perform your CVS checkout) as a normal Unix user. Then use the su or sudo commands (as appropriate to your installation) to execute the installer as root:

su
        enter the root password
        perl install.pl
        logout

(or as required)

sudo perl install.pl
        enter your own password

This will walk you through the entire OME installation and deployment. Once finished, the installer will store the configuration you provided in OME's base directory (default: /etc/ome-install.store) where it can be used for further upgrades or library/Perl module checks.

When debugging an installation, it is sometimes desireable to run the installer non-interactively. This is possible with the -y flag. If the installation never completed successfully, then there will be no /etc/ome-install.store file to work from. Some example files that can be used for the -f flag for install.pl are in the doc/install-configs/ directory.

Open the appropriate file in a text editor and edit it as recommended in the file's comments before using it for an installation!

Developer's Installation

To install a developer's configuration of the server, you must answer "y" to two prompts that install.pl will provide. Under the "Apache Configuration" and "Web-UI HTML Templates" options, type "yes" for the "Developer Configuration" option.