view release on metacpan or  search on metacpan

lib/DBIx/PgLink/Manual/Install.pod  view on Meta::CPAN

     DBI
     DBD::Pg
     Moose
     MooseX::Method
     Tie::Cache::LRU

     DBD driver for remote database

Moose requires L<Class::MOP> module. 
Ensure that you have latest Class::MOP version installed, 
for notable performance boost in 0.49.

=item *

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

=head1 BUILDING

Run

  perl Makefile.PL
  make

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

or

  perl Build.PL
  ./Build

=head1 TESTING

=over

=item *

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.

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


=item *

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.


=item *

Change permission on some directories for PostgreSQL owner account

=over

=item read permissions for ./blib

  chmod -R o=r,+X blib

=item read and write permissions for ./examples

  chmod -R o=rw,+X examples

Only if you plan testing of XBase or SQLite data sources

=back

=item *

Run test

  make test

or

  ./Build test

Check for errors.

=back

=head1 INSTALLING

=over

=item *

Install Perl module

Run as root

  make install

or

  ./Build install

=item *

Install database objects

Run

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

=back