The following procedure documents how to install the DBD::SQLAnywhere interface on the supported Unix platforms, including Mac OS X.

To prepare your computer

1. Install ActivePerl 5.6.0 build 616 or later.

2. Install a C compiler.

To install the DBI Perl module on Unix and Mac OS X

1. Download the DBI module source from  www.cpan.org.

2. Extract the contents of this file into a new directory.

3. At a command prompt, change to the new directory and execute the following commands to build the DBI module.

   perl Makefile.PL

   make

   If for any reason you need to start over, you can use the command make clean to remove any partially built targets.

4. Use the following command to test the DBI module.

   make test

5. To complete the installation, execute the following command at the same prompt.

   make install

6. Optionally, you can now delete the DBI source tree. It is no longer required.

To install DBD::SQLAnywhere on Unix and Mac OS X

1. Make sure the environment is set up for SQL Anywhere.

   Depending on which shell you are using, enter the appropriate command to source the SQL Anywhere configuration script from the SQL Anywhere installation directory:

   In this shell ...	... use this command
   sh, ksh, or bash	. bin/sa_config.sh
   csh or tcsh	source bin/sa_config.csh

2. At a shell prompt, change to the sdk/perl subdirectory of your SQL Anywhere installation.

3. At a command prompt, run the following commands to build DBD::SQLAnywhere.

   perl Makefile.PL

   make

   If for any reason you need to start over, you can use the command make clean to remove any partially built targets.

4. To test DBD::SQLAnywhere, copy the sample database file to your sdk/perl directory and make the tests.

   cp samples-dir/demo.db .

   dbeng11 demo

   make test

   If the tests do not run, ensure that the bin32 or bin64 subdirectory of the SQL Anywhere installation is in your path.

5. To complete the installation, execute the following command at the same prompt.

   make install

The DBD::SQLAnywhere interface is now ready to use.