view release on metacpan or  search on metacpan

lib/ASNMTAP/Asnmtap/Applications.pod  view on Meta::CPAN

=head1 NAME

ASNMTAP::Asnmtap::Applications is a Perl module that provides a nice object oriented interface for ASNMTAP Applications

=head1 Description

ASNMTAP::Asnmtap::Applications Subclass of ASNMTAP::Asnmtap

This version is still the old ASNMTAP Applications v3.000.001 addapted for using with the new ASNMTAP::Asnmtap, ASNMTAP::Asnmtap::Plugins and ASNMTAP::Asnmtap::Plugins::Nagios plugins.

We are working onto an new Object Oriented version for the ASNMTAP Applications

=head1 CONFIG FILES

=over 4

=item located at /opt/asnmtap/applications

=over 4

=item Applications.cnf

General configuration file for the ASNMTAP Applications

=over 4

=item log4perl.cnf

General configuration file for the log4perl integration for the ASNMTAP Applications

=over 4

=item HTML to PDF

For testing HTML to PDF you can rename /opt/asnmtap/applications/htmlroot/img/logos/bodyimage.gif-orig to /opt/asnmtap/applications/htmlroot/img/logos/bodyimage.gif

You can lateron copy your wanted bodyimage picture to /opt/asnmtap/applications/htmlroot/img/logos/bodyimage.gif or you can change te parameter <COMMON><HTMLTOPDF>OPTIONS into the Applications.cnf config file.

 <COMMON>
   <HTMLTOPDF>
     OPTIONS --bodyimage /opt/asnmtap/applications/htmlroot/img/logos/bodyimage.gif --charset iso-8859-1 --format pdf14 --size A4 --landscape --browserwidth 1280 --top 10mm --bottom 10mm --left 10mm --right 10mm --fontsize 10.0 --fontspacing 1.2 --he...
   </HTMLTOPDF>
 </COMMON>

If you change the --bodyimage parameter, don't forget also to change the same parameter into the file /opt/asnmtap/applications/htmlroot/cgi-bin/htmldoc.sh for the on the fly HTML to PDF generating.

=back

=back

=item located at /opt/asnmtap/applications/etc

=over 4

=item ArchiveCT

the config file used by the program archive.pl

when the Application CGI module and CGI applications are installed, this config file is automatically generated by the program generateConfig.pl

=over 4

=item format

 format: <resultsdir>#[<catalogID>_]<uniqueKey>#check_nnn[|[<catalogID>_]<uniqueKey>#check_mmm]

   <resultsdir>	: results subdir where the data from the collector is located
   <catalogID>  : unique catalogID
   <uniqueKey>	: unique key for this plugin
   check_nnn	: plugin name

=item example

 more /opt/asnmtap/applications/etc/ArchiveCT

 # ArchiveCT - CTP-CENTRAL, generated on 2010/dd/mm 17:58:36, ASNMTAP v3.002.003 or higher
 #
 # <resultsdir>#[<catalogID>_]<uniqueKey>#check_nnn[|[<catalogID>_]<uniqueKey>#check_mmm]
 #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 #
 _ASNMTAP#_ASNMTAP#CID_collectorDaemonSchedulingReports.pl
 #
 test-01#CID_DUMMY-T1#check_dummy.pl
 #
 test-02#CID_DUMMY-T2#check_dummy.pl
 #
 test-03#CID_DUMMY-T3#check_dummy.pl
 #
 test-04#CID_DUMMY-T4#check_dummy.pl
 #
 test-05#CID_DUMMY-T5#check_dummy.pl
 #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # Einde ArchiveCT - CTP-CENTRAL

=back

=back

=item located at /opt/asnmtap/applications/master

lib/ASNMTAP/Asnmtap/Applications.pod  view on Meta::CPAN

 ... TODO ... NO PART OF NORMAL SETUP ...

=item Testing configuration

 ... TODO ... NO PART OF NORMAL SETUP ...

=back

=item Install HTML to PDF converter for Perl

HTMLDOC: http://www.htmldoc.org/

=over 4

=item Downloading the Software

 Get the software from http://www.htmldoc.org/
   cd /export/download
   wget http://ftp.easysw.com/pub/htmldoc/1.8.27/htmldoc-1.8.27-source.tar.gz

=item Installing the Software

=over 4

=item Linux

 cd /export/download/directory
 rpm -i htmldoc-1.8.27-linux-intel.rpm
 /usr/bin/htmldoc

=item Solaris

 cd /export/download/directory
 tar -xvzf htmldoc-1.8.27-source.tar.gz
 cd /export/download/htmldoc-1.8.27
 ./configure
 make
 make install

=back

=item Licensing the Software

The HTMLDOC License window is shown the first time you run the software. 

Click on the Update License button to add a license to your system

 perl -MCPAN -e shell
 install HTML::HTMLDoc

 ln -s /usr/bin/htmldoc /opt/asnmtap/applications/htmlroot/cgi-bin/htmldoc.cgi

 vi httpd.conf
 AcceptPathInfo On
 AddHandler cgi-script .cgi .pl
 Options ExecCGI FollowSymLinks

=item Testing the Software

 htmldoc -f '/opt/asnmtap/results/_ASNMTAP/reports/yyyydmmdd-collectorDaemonSchedulingReports.pl-_ASNMTAP-probe02-Daily.pdf' --bodyimage /opt/asnmtap/applications/htmlroot/img/logos/bodyimage.gif --charset iso-8859-1 --format pdf14 --size A4 --landsc...
 cd /opt/asnmtap/applications/bin
 ./generateCollectorDaemonSchedulingReports.pl -D L
 ls /opt/asnmtap/results/_ASNMTAP/reports/

=back

=item Install ChartDirector 4.x for Perl

=over 4

=item Linux installation

 download chartdir_perl_linux.tar.gz from http://www.advsofteng.com/
   wget http://www.advsofteng.com/chartdir_perl_linux.tar.gz
   mv chartdir_perl_linux.tar.gz /opt/.
   cd /opt
   tar -xvzf chartdir_perl_linux.tar.gz
   rm chartdir_perl_linux.tar.gz

=item Solaris installation

 download chartdir_perl_sunos.tar.gz from http://www.advsofteng.com/
   wget http://www.advsofteng.com/chartdir_perl_sunos.tar.gz
   mv chartdir_perl_sunos.tar.gz /opt/.
   cd /opt
   tar -xvzf chartdir_perl_sunos.tar.gz
   rm chartdir_perl_sunos.tar.gz

=item ASNMTAP Chartdirector configuration

 Applications.cnf

 <COMMON>
 ...
   <CHARTDIRECTOR>
     LIB             /opt/ChartDirector/lib/.
   </CHARTDIRECTOR>
 ...
 </COMMON>

=back

=item ASNMTAP Tunneling localhost configuration

 Applications.cnf

 <COMMON>
 ...
   HTTPSSERVER       asnmtap.citap.be
   REMOTE_HOST       localhost.citap.be
   REMOTE_ADDR       127.0.0.1 ...
 </COMMON>

  through browser with normal access:
    http://asnmtap.citap.be:8080/asnmtap/nav/test/T/
    http://asnmtap.citap.be:8080/asnmtap/cgi-bin/moderator/index.pl
    http://asnmtap.citap.be:8080/asnmtap/cgi-bin/admin/index.pl
    http://asnmtap.citap.be:8080/asnmtap/cgi-bin/sadmin/index.pl

  ssh -l nagios -i ~/.ssh/nagios_dsa.id -o TCPKeepAlive=yes -L 8080:127.0.0.1:80 -N nagios@asnmtap.citap.be &