NAME

Pangloss::Install - how to install Pangloss

SYNOPSIS

  % perl Build.PL
  % ./Build test
  % ./Build install

  # follow on-screen instructions

INSTALLATION

In general, the following should work:

        % perl Build.PL
        % ./Build test
        % ./Build install

If you want to install Pangloss somewhere other than /usr/local/pangloss, add a 'install_base=/path/to/install' to the first line, for example:

        % perl Build.PL install_base=~/pangloss

Follow the on-screen instructions after installing Pangloss.

CONFIGURATION

You can use the Pangloss admin tool found in the 'bin' directory to do most of the initial setup:

        % $PG_HOME/bin/pg_admin --help

First off, you must setup a Pixie store for Pangloss to use (see the Pixie documentation for stores types available and for more details on Pixie). If you are setting up a DBI store, you can do it with the Pangloss admin tool, for example:

        pangloss> create store, 'dbi:mysql:dbname=test'
        pangloss> connect 'dbi:mysql:dbname=test'

Next, you need an admin user:

        pangloss> create admin

Once that's done you're ready to load the pangloss webserver (you can use the website to create other users and such).

Most Pangloss configuration can be done with environment variables. Read the Pangloss::Config documentation to see what parameters are available:

        % man Pangloss::Config
                - or -
        % perldoc Pangloss::Config

Pangloss requires a 'controller' configuration file, which can be tailored to suit your needs. The defaults live in the $PG_HOME/conf directory, and should be sensible enough for most installations.

STANDALONE TEST SERVER

There is a standalone server available in the 'bin' directory:

        % $PG_HOME/bin/pg_test_server --help

This is useful as a smoke test to make sure you have set all the right environment variables and that there are no problems. It's also handy if you don't have Apache or mod_perl installed but would like to try out Pangloss anyway.

APACHE CONFIGURATION

Pangloss has been built to run under Apache/mod_perl. A sample configuration file is included:

        $PG_HOME/conf/sample-httpd.conf

AUTHOR

Steve Purkis <spurkis@quiup.com>

SEE ALSO

Pangloss, Pangloss::Config

cpanm Pangloss

perl -MCPAN -e shell
install Pangloss