DBIx::PgLink::Manual::Install

- NAME
- PREREQUISITES
- BUILDING
- TESTING
- INSTALLING
- SEE ALSO
- AUTHOR
- COPYRIGHT AND LICENSE

# NAME

Installation of DBIx::PgLink

Back to Top

# 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

Back to Top

# BUILDING

Run

      perl Makefile.PL
      make

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

or

      perl Build.PL
      ./Build

Back to Top

# 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.

Back to Top

# 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>

Back to Top

# SEE ALSO

the DBIx::PgLink::Manual::Usage manpage, http://pgfoundry.org/projects/dbi-link/

Back to Top

# AUTHOR

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

Back to Top

# COPYRIGHT AND LICENSE

Copyright (C) 2007 by Alexey Sharafutdinov

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.

Back to Top

DBIx::PgLink::Manual::Install