NAME

OpenFrame::Installation - OpenFrame installation guide.

DESCRIPTION

OpenFrame should be fairly simple to install for anybody who is familiar with Perl and more specifically, mod_perl.

OpenFrame modules

As with most perl modules, simply:

perl Makefile.PL
make
make test
make install

If you want to put OpenFrame in a specific directory, then append PREFIX=<path> to the perl Makefile.PL command.

Configuration

To configure OpenFrame for the first time, simply execute the configbuilder script. This will place a file in your current directory called .openframe.conf. Edit the values in this file as you see fit. Note: for system wide config you probably want to put that file in /etc/openframe.conf

Web Server Plug in

Simply install the handler for your server. In the case of Apache it's OpenFrame::Server::Apache. We map an entire server to the one handler. You could have multiple copies of OpenFrame running, but it's not a tested configuration.

Our configuration looks similar to:

  <VirtualHost [SOME.IP.ADDRESS]>
        ServerName      [Some Server Name]
        Port            80
        DocumentRoot    [Some Directory]
        <Directory [Some Directory>
                Options -Indexes -ExecCGI -FollowSymLinks -Includes
        </Directory>
        <Location / >
                SetHandler      perl-script
                <Perl>
		  # this is only needed if you use a PREFIX.
                  use lib '/path/to/install/dir/lib/site_perl'; 
                </Perl>
                PerlHandler     OpenFrame::Server::Apache
        </Location>
  </VirtualHost>

Of course you need to edit some of those values to get any real mileage from the software, but you should have the general idea.