view release on metacpan or  search on metacpan

INSTALL.ubuntu  view on Meta::CPAN

    perl -MCPAN -eshell
    install Pod::Parser
	exit
	
You can also manually download and install it from CPAN if you like.    


3) Configure & Install Helios

At this point you are ready to install the Helios core system.  Before you 
install the package however, you should edit the helios.ini config file and 
set the HELIOS_INI environment variable; this will allow the system to test 
database connectivity during the 'make test' phase.

Open the sample helios.ini file and enter the datasource name, MySQL user and 
password information in the example lines provided.  Also create the 
/var/run/helios path or change the pid_path line to a place your Helios system 
will be able to write PID files to.  Once you've done that, save the file and 
set the HELIOS_INI environment variable to point to the file:

    export HELIOS_INI=/path/to/helios.ini

Make sure the path is an absolute path!  You'll probably want to add the line 
above to the profile of the user your services will run as so Helios will 
always know where its configuration file is.

Once you're done, you can either install Helios using the CPAN shell or 
manually from this distribution.  To use the CPAN shell, use sudo (or 
become the root user) and issue the following commands:

    sudo perl -MCPAN -eshell
    install Helios
    
To install Helios manually from this distribution, use sudo or become the root
user and issue these commands:

    perl Makefile.PL
    make
    make test
    make install

If you want to install Helios in a private user directory instead of a path 
available to all users, you can use the INSTALL_BASE option of Makefile.PL:

    perl Makefile.PL INSTALL_BASE=/home/myhome/helios
    

4) Install Apache HTTP Server (optional)

If you want to submit jobs to Helios via HTTP, you'll need a web server with 
built-in CGI support.  The most obvious choice is the Apache HTTP Server, which 
you can install with:

    apt-get install apache2

You'll need to edit your Apache configuration to enable mod_cgi.  Once your 
Apache server is configured, install the submitJob.pl program as a CGI program 
by issue these commands as root or via sudo:

    cp cgi-bin/submitJob.pl /usr/lib/cgi-bin
	chown root.root /usr/lib/cgi-bin/submitJob.pl
	chmod a+rx /usr/lib/cgi-bin/submitJob.pl
	
You'll also need to edit your Apache configuration to add the HELIOS_INI env var
so submitJob.pl can find the helios.ini file; use the SetEnv directive in your 
Apache configuration for this:

    SetEnv HELIOS_INI /path/to/helios.ini


5) Install Helios::Panoptes (optional)

Helios::Panoptes is the central web-based administration tool for Helios.  You 
will only need to install it on one host.  Panoptes is packaged separately and 
has its own installation instructions; refer its README for instructions.


# FILE CHANGE HISTORY:
# [2012-01-04]: Moved Debian/Ubuntu-specific install instructions from 
# INSTALL to INSTALL.ubuntu.
# [2012-01-08]: Updated and clarified instructions based on successful tests
# on Ubuntu 11.04.
# [LH] [2012-11-06]: More clarification and updates based on successful tests 
# with Ubuntu 10.04 LTS, 11.04, and 12.04 LTS.