DBIx::PgLink::Manual::Install

NAME

Installation of DBIx::PgLink

PREREQUISITES

PostgreSQL 8.2 or later
Perl 5.8.6 or later
Perl modules
```
     DBI
     DBD::Pg
     Moose
     MooseX::Method
     Tie::Cache::LRU
```
```
     DBD driver for remote database
```
Moose requires the Class::MOP manpage module. Ensure that you have latest Class::MOP version installed, for notable performance boost in 0.49.
Superuser account on local PostgreSQL server

Must logon without password typing, i.e. use 'trust' authentication or store password in .pgpass/pgpass.conf file

BUILDING

Run

  perl Makefile.PL
  make

(on Windows with Microsoft Visual Studio use 'nmake')

  perl Build.PL
  ./Build

TESTING

Change t/test.conf for your environment. It's in YAML format.

First configuration entry named 'TEST' describe local PostgreSQL connection. Test will log on to this server as specified user, drop and create test database and install all database object.

WARNING: all previous content of database will be lost

This database also will be used as 'remote' database for testing.

Other entries are commented by default.
Check PostgreSQL account

Ensure that PostgreSQL owner (operating system account, usually 'postgres') can connect to his own server with specified in t/test.conf credentials. If used .pgpass file, place it to 'postgres' home directory.
Change permission on some directories for PostgreSQL owner account
read permissions for ./blib
```
  chmod -R o=r,+X blib
```
read and write permissions for ./examples
```
  chmod -R o=rw,+X examples
```
Only if you plan testing of XBase or SQLite data sources
Run test
```
  make test
```
or
```
  ./Build test
```
Check for errors.

INSTALLING

Install Perl module

Run as root
```
  make install
```
or
```
  ./Build install
```

Install database objects

Run

  psql -h <host> -p <port> -U <superuser> -f _install.sql <database>

AUTHOR

Alexey Sharafutdinov <alexey.s.v.br@gmail.com>

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

DBIx::PgLink::Manual::Install