Installation instructions for CVS version of LooperNG. Dustin Marquess -- 1. Pull code VIA cvs: $ cvs -d:pserver:anonymous@looper.cvs.sourceforge.net:/cvsroot/looper login Hit when prompted for a password. If you get a: cvs login: warning: failed to open /home/username/.cvspass for reading: No such file or directory Ignore it. That file doesn't exist because it's the first time you used CVS. CVS will automatically create it. $ cvs -z3 -d:pserver:anonymous@looper.cvs.sourceforge.net:/cvsroot/looper co -P looperng 2. Add SNMP suppport: NOTE: This is optional. If you don't plan on using SNMP, edit looperng/looperng/install.sh and comment-out lines 164-178, then proceed to step 3 or step 4. $ cd looperng/looperng/support $ mkdir -p distrib/snmp $ cd distrib/snmp $ wget http://www.switch.ch/misc/leinen/snmp/perl/dist/SNMP_Session-1.08.tar.gz $ gzip -dc SNMP_Session-1.08.tar.gz | tar xvf - && rm SNMP_Session-1.08.tar.gz $ cd .. [ If Netcool support not wanted, skip to step 4 ] 3. Add Netcool support (FreeTDS): $ mkdir netcool $ cd netcool $ ncftpget ftp://ftp.ibiblio.org/pub/Linux/ALPHA/freetds/stable/freetds-stable.tgz $ gzip -dc freetds-stable.tgz | tar xvf - && rm freetds-stable.tgz $ cd freetds-0.64 $ wget \ 'http://netcoolusers.org/DustinMarquess?action=AttachFile&do=get&target=ftds-nco-0.64-looper.patch' \ -O ftds-nco-0.64-looper.patch $ gpatch --no-backup-if-mismatch -p1 -i ftds-nco-0.64-looper.patch Note: On a GNU-based system, you might have to use "patch" instead of "gpatch". On a commercial UNIX, if you don't have "gpatch", then install it! $ rm ftds-nco-0.64-looper.patch $ cd .. $ vi ../../../install.sh Find line 203: cd freetds-0.62.4 Change it to: cd freetds-0.64 Find line 210: for dir in DBI-1.14 DBD-Sybase-1.02 Change it to: for dir in DBI-1.54 DBD-Sybase-1.07_03 $ wget http://www.peppler.org/downloads/DBD-Sybase-1.07_03.tar.gz $ gzip -dc DBD-Sybase-1.07_03.tar.gz | tar xvf - && rm DBD-Sybase-1.07_03.tar.gz $ cd DBD-Sybase-1.07_03 $ wget \ 'http://netcoolusers.org/Downloads?action=AttachFile&do=get&target=dbd_syb-nco_syb-107.patch' \ -O dbd_syb-nco_syb-107.patch $ gpatch --no-backup-if-mismatch -p1 -i dbd_syb-nco_syb-107.patch $ cd .. $ ncftpget ftp://ftp.cpan.org/pub/CPAN/modules/by-module/DBI/DBI-1.54.tar.gz $ gzip -dc DBI-1.54.tar.gz | tar xvf - && rm DBI-1.54.tar.gz $ cd .. 3. Add Netcool Support (Sybase): When using the Sybase libraries that ship w/ Netcool, you must install the Sybase headers. The FreeTDS headers will not work properly, and Netcool does not ship with headers! You currently have 2 choices of getting the Sybase headers: Download them from the GAT website, or download the free version of ASE Express Edition for Linux from Sybase and extract them from there. To get them from the GAT page, you will need a valid GAT login. Download the package from: http://gat.micromuse.com/toolsutils/bins/three/perl-omnibus-1.2.tar.gz Extract the file and look in the sybase-include directory. These are the files you want. If OMNIbus is on the machine you want Looper on, the easiest solution is to set SYBASE to $OMNIHOME/platform/ and then do: [ Open another window, do not do this in your current Looper window! ] $ mkdir $SYBASE/include $ mv sybase-include/*.h $SYBASE/include/ $ ln -s $OMNIHOME/etc/interfaces. $SYBASE/interfaces If Netcool isn't installed on the Looper machine, make a directory (/usr/local/sybase is good), set SYBASE to that directory, and then do: $ mkdir $SYBASE/lib $SYBASE/include/ $ mv sybase-include/*.h $SYBASE/include/ Copy the $OMNIHOME/etc/interfaces. file from a Netcool machine to $SYBASE/interfaces on the Looper machine. tar up the follow files from $OMNIHOME/platform//lib on a Netcool machine and untar them in $SYBASE/lib on the Looper machine: libsrv_r.so* libct_r.so* libtcl.so* libcomn.so* libcs_r.so* libct.so* libintl.so* libsrv.so* libintl_r.so* libtcl_r.so* libcomn_r.so* libcs.so* libintl_r64.so* libsrv64.so* libtcl64.so* libdldap.so* libdldap64.so* libfssl.so* libfssl64.so* libinsck.so* libinsck64.so* libintl64.so* libinsck_r.so* libinsck_r64.so* libskrb.so* libtli.so* libtli64.so* libtli_r.so* libtli_r64.so* libcomn64.so* libcomn_r64.so* libcs64.so* libcs_r64.so* libct64.so* libct_r64.so* libsrv_r64.so* libtcl_r64.so* Installing the modules with Sybase support: NOTE: Either do this on each machine AFTER Looper is completely installed, or do it as root and install it system-wide! [ Still in non-Looper Window! ] $ wget http://www.peppler.org/downloads/DBD-Sybase-1.07_03.tar.gz $ gzip -dc DBD-Sybase-1.07_03.tar.gz | tar xvf - && rm DBD-Sybase-1.07_03.tar.gz $ cd DBD-Sybase-1.07_03 $ wget \ 'http://netcoolusers.org/Downloads?action=AttachFile&do=get&target=dbd_syb-nco_syb-107.patch' \ -O dbd_syb-nco_syb-107.patch $ gpatch --no-backup-if-mismatch -p1 -i dbd_syb-nco_syb-107.patch $ perl Makefile.PL $ make && make install $ cd .. $ rm -rf DBD-Sybase-1.07_03 $ ncftpget ftp://ftp.cpan.org/pub/CPAN/modules/by-module/DBI/DBI-1.54.tar.gz $ gzip -dc DBI-1.54.tar.gz | tar xvf - && rm DBI-1.54.tar.gz $ cd DBI-1.54 $ perl Makefile.PL $ make && make install $ cd .. $ rm -rf DBI-1.54 [ Go back to Looper Window ] $ cd .. 4. Making the bundle $ cd ../.. $ ./bundle.sh This creates 2 things: looperng-distrib - Directory that can be used to install Looper on the local machine, this is identical to the diriectory that you get after you untar a looperng tarball looperng.tar.gz - A .tar.gz version of the looperng-distrib directory that you can copy to other machines. 5. Installation Follow the instructions in README. If using the Sybase libraries instead of FreeTDS, answer "N" (NO) to Netcool support!!! NOTES: If you're using FreeTDS and LooperNG fails when installing w/ install.sh, install GNU iconv (libiconv on Sunfreware) and change the "--disable-libiconv" on line 204 of install.sh to --with-libiconv-prefix=/usr/local or whatever you installed GNU iconv. If you're using the Sybase libraries, make sure to set sybasehome = for your netcool_in/netcool_out modules in your LooperNG .conf files!