view release on metacpan or  search on metacpan

README  view on Meta::CPAN

  make realclean
  perl Makefile.PL LINKTYPE=static
  make
  make perl       (you'll need to use and install _this_ new perl binary)
  make test
  make -f Makefile.aperl inst_perl MAP_TARGET=perl  (install new perl)
  make install                                      (install DBD::Oracle)

But that's not recommended these days.

>>> Also carefully read the README.help.txt file which is full of useful
>>> tips and workarounds for various problems of various systems.


*** HOW TO REPORT PROBLEMS

This software is supported via the dbi-users@perl.org mailing list.
(You don't need to subscribe to the list in order to post.)

Please do NOT post problems to comp.lang.perl.*, perl5-porters@perl.org,
http://www.cpanforum.com/dist/DBD-Oracle, or google groups etc.

If you're *sure* the problem is a bug then you can post a bug report
to https://github.com/perl5-dbi/DBD-Oracle/issues
Problem reports that don't include sufficient detail (including the
information listed below and how to reproduce the problem)
are unlikely to get resolved.

For more information and to keep informed about progress you can join the
mailing list. Send a message to dbi-users-help@perl.org for more information.

Please post details of any problems (or changes you needed to make) to
dbi-users@perl.org.


** IT IS IMPORTANT TO INCLUDE *ALL* THE FOLLOWING INFORMATION:

1. A complete log of all steps of the build, e.g.:

    (do a make realclean first)
    perl Makefile.PL
    make
    make test

    Make sure to include the 'stderr' output. The best way to do this is
    to use the "script" command (man script). If that's not available
    then "command > command.log 2>&1" (assuming you're not using csh).
    The "2>&1" is required (after the stdout redirect) to redirect stderr
    to the same place.

    If a test fails then also include the output of:

    perl -Mblib t/<name-of-failed-test>.t

2. Full details of which version of Oracle client and server you're using
   (if it wasn't automatically found and printed by "perl Makefile.PL")

3. The output of perl -V       (that's a capital V, not lowercase)

4. If you get errors like "undefined symbol", "symbol not found",
   "undefined reference", "Text relocation remains" or any similar
   error then include the output of "perl Makefile.PL -s XXX"
   where XXX is the name of one of the symbols.
   Please don't send the entire output of this command,
   just any obviously 'interesting' parts (if there are any).
   See also the LINKTYPE=static notes above.

5. If you get a core dump, rebuild DBD::Oracle with debugging
   enabled by executing: perl Makefile.PL -g  (note the -g option)
   then rerun the code to get a new core dump file, finally use a
   debugger (gdb, sdb, dbx, adb etc) to get a stack trace from it.
   NOTE: I may not be able to help you much without a stack trace!
   It is worth fetching and building the GNU GDB debugger (>=4.15) if
   you don't have a good debugger on your system. If desperate try:
     make perl; ./perl script; echo '$c' | adb ./perl core
   Also see the Devel::CoreStack module on CPAN.

6. If the stack trace mentions XS_DynaLoader_dl_load_file then rerun
   make test after setting the environment variable PERL_DL_DEBUG to 2.

7. If your installation succeeds, but your script does not behave
   as you expect, the problem may be on your end. Before
   sending to dbi-users, try writing a *small*, easy to use test case
   to reproduce your problem. Also, use the DBI->trace method to
   trace your database calls.

It is important to check that you are using the latest version before
posting. If you're not then you're *very* likely to be told "upgrade to
the latest". You would do yourself a favour by upgrading beforehand.

Try to help yourself first, then try to help others help you by following
these guidelines carefully.  And remember, please don't mail developers
directly - use the dbi-users mailing list.

Regards,
Tim.

================================================================================
Examples and other info:

README.help.txt     -- READ IT FIRST IF YOU HAVE ANY PROBLEMS
README.win32.txt    -- building DBD::Oracle under MS Windows
README.wingcc.txt   -- building DBD::Oracle under MS Windows with gcc
README.macosx.txt   -- building DBD::Oracle under MacOS X
README.clients.txt  -- building/using DBD::Oracle on minimally configured system
README.login.txt    -- help for login problems
README.longs.txt    -- examples dealing with LONG types (blobs)

DBI 'home page': http://dbi.perl.org

Old archive site for Perl DB information:
    ftp://ftp.demon.co.uk/pub/perl/db/
Mailing list archive:                /DBI/perldb-interest/
Perl 4 Oraperl (v2.4)                /perl4/oraperl/

Jeff Stander's stuff stands out for Oraperl:
Directories of interest might be
        /pub/Oracle/sources
        /pub/Oracle/sources/jstander
        /pub/Oracle/sources/jstander/distrib
        /pub/Oracle/sources/jstander/tsmlib