Vipaka - Installation Guide

Standard Install

Vipaka has a standard perl install. It comes with a Makefile.PL which you use to build a makefile for your system. You can do that as follows:

$ perl Makefile.PL

The resulting ``Makefile'' can be used to make, test, and install vipaka.

Once you've installed vipaka on your system, you may want to create a vipaka user in your database. There are scripts in the ``sql'' directory for creating the user and prompting for a password.

Once you have everything installed, the

Quickstart Guide

should explain to you how to get started. See the

Configuration Guide

for more information on how to create a

read-only user

for vipaka in your database, to

edit the vipaka.conf file


Using Vipaka with a webserver

Yes, you can use vipaka with a webserver, but there isn't too much you need to do on the vipaka end of things. Basically vipaka generates a set of html pages. These by default go into ``doc_root'' in the vipaka software directory, but this path can be changed via the -k option to vipakad when you start it or the ``doc_root'' directive in your config file. Specify a valid path, and it will write the files there. Be sure to move the existing vipaka documents from doc_root to that location, and create directories named ``docs'',``help'', ``images'', and ``info'' there as well. In short, you should copy all the files from the install doc_root except maybe vipaka.html, which will be recreated.

Installing DBI

It's pretty straightforward on most machines when using cpan.

$ cpan install DBI

Installing DBD-Oracle

It's pretty straightforward on most machines where Perl is already installed. You may have to do a force install if you do not have the sample schemas installed in your database

Make sure to set your environment variables ORACLE_HOME, ORACLE_SID, be sure $ORACLE_HOME/bin is in your path, and that $ORACLE_HOME/lib is in your library path then followthese steps:

$ cpan install DBD::Oracle

Depending on whether you have the sample schemas installed you might need to do the following

$ cpan force install DBD::Oracle

Installing Oracle

Of course, none of this would be complete without an Oracle database to connect to. Oracle Database 10g XE is freely (Beer) available.