view release on metacpan or  search on metacpan

INSTALLATION  view on Meta::CPAN

ln -s libicuucbmc.so.32 libicuucbmc.so
ln -s libicudatabmc_lx64.so.32 libicudatabmc_lx64.so
ln -s libicui18nbmc_lx64.so.32 libicui18nbmc_lx64.so
ln -s libicuiobmc_lx64.so.32 libicuiobmc_lx64.so
ln -s libicuucbmc_lx64.so.32 libicuucbmc_lx64.so

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<base path>/api764sp5linux/lib


TESTED OS'S

This extension has been successfully built and used under the following
OS versions:

   o  Solaris 2.4 - 8
   o  Irix 6.2
   o  HPUX*
   o  WindowsNT, 2000, XP (But NOT win95)
   o  Linux (RHEL through v7)

Users of other OS's might encounted problems with compiling. We'd be
interested in hearing about your experiences and if you got it working
under a new OS.


BUILDING

To build the extension, change into the root directory of the distribution
and edit the Makefile.PL file. Change the following lines in it to point to
the location of your ARS API directory (e.g. /u/remedy/api/lib)

$ARSAPI = "/opt/remedy/api764sp5linux";
$ARCHITECTURE = "lx64";     # Linux 64-bit

Under Sunos 4.1.x, you will also need to add -lntc to $ARS_LIBS.
Under Irix 6.2, you will need to remove the -lnsl option from $ARS_LIBS.
Under HP-UX, you will need to build it statically into Perl.
Under WindowsNT you will need to insert the appropriate libraries
(arapi.lib and nts.lib) from the API kit included with NT Server,
and the path to the include files, into Makefile.pl (or the resulting
Makfile).

then execute the following comands:

> perl Makefile.PL
> make
> make install

The first command will construct a Makefile.
The second comand will compile the source files.
The third command might require special (i.e. root) access if your
perl distribution is not owned by your userid.


BUILDING ON WINDOWS WITH STRAWBERRY PERL  
(Note to Windows Developers: While this is the correct procedure, it will not 
yet provide a stable 64-bit module)

1) Download ARSPerl source and unpack

2) Download and install 32 or 64-bit Strawberry perl from strawberryperl.com

3) Download desired ARS API files from RRR and unpack 
   (https://rrr.se/cgi/index?pg=arapi)

4) Edit Makefile.PL, and update $ARSAPI to indicate where ARS API files have 
   been unpacked

5) If compiling for 64-bit, the following lines need updating in Makefile.PL 
   as well:
 
      $ARS_LIBS = join(' ', map { "$ARSAPI/lib/" . $_ } @{$ra_arlibs});

      change to:

      $ARS_LIBS = join(' ', map { "$ARSAPI/lib64/" . $_ } @{$ra_arlibs});
     

      $ARS_LDPATH = qq{-L"$ARSAPI/lib"};

      change to:

      $ARS_LDPATH = qq{-L"$ARSAPI/lib64"};


      my $ar_lib_dir = join('/', $path_to_api_dir, 'lib');

      change to:

      my $ar_lib_dir = join('/', $path_to_api_dir, 'lib64');
    
6) cd to ARSPerl directory and run perl Makefile.PL

7) dmake

8) If desired (and able!), run dmake test

9) dmake install

10) Prior to using the compiled ARSPerl, update %PATH% first.

   %PATH% update notes:
   -    32-bit: Add the bin and lib directories from where the ARS API files 
        were unpacked
   -    64-bit: Add the lib64 directory from where the ARS API files were 
        unpacked