ASNMTAP

 view release on metacpan or  search on metacpan

INSTALL  view on Meta::CPAN

  vi $AMPATH/Asnmtap.cnf and modify at least <COMMON>...</COMMON>
  ...
  # Common variables - - - - - - - - - - - - - - - - - - - - - - - - - -
  <COMMON>
    APPLICATION     Application Monitoring
    BUSINESS        CITAP
    DEPARTMENT      Development
    COPYRIGHT       2003-2011
    SENDEMAILTO     alex.peeters@citap.be
  # TYPEMONITORING  central                      # central or distributed
  # RUNCMDONDEMAND  localhost                    # localhost or probe
  </COMMON>
  ...


Information about how to build ASNMTAP Plugins can be found at:
  - man ASNMTAP::Asnmtap::Plugins
  - man ASNMTAP::Asnmtap::Plugins::IO
  - man ASNMTAP::Asnmtap::Plugins::Modem
  - man ASNMTAP::Asnmtap::Plugins::Mail
  - man ASNMTAP::Asnmtap::Plugins::Nagios
  - man ASNMTAP::Asnmtap::Plugins::SOAP
  - man ASNMTAP::Asnmtap::Plugins::WebTransact
  - man ASNMTAP::Asnmtap::Plugins::XML
  - man ASNMTAP::Time


Information about how to build NAGIOS Plugins can be found at:
  - man ASNMTAP::Asnmtap::Plugins::Nagios
  - man ASNMTAP::Time
  

When you use ASNMTAP only form building plugins. This is all.


-------------------------------------------------------------------------
- ASNMTAP Application Monitor                                           -
-------------------------------------------------------------------------
  
Information about the configuration for ASNMTAP Applications can be found at:
  man ASNMTAP::Asnmtap::Applications

  Applications.cnf
  ----------------

  mv $AMPATH/applications/Applications.cnf-orig $AMPATH/applications/Applications.cnf

  vi $AMPATH/applications/Applications.cnf and modify at least <COMMON>...</COMMON> and <DATABASE_ACCOUNT>...</DATABASE_ACCOUNT>
  ...
  # Common variables - - - - - - - - - - - - - - - - - - - - - - - - - -
  <COMMON>
     SMTPUNIXSYSTEM  1
     SERVERLISTSMTP  localhost
     SERVERSMTP      localhost
     SENDMAILFROM    asnmtap@localhost
 
     HTTPSSERVER     asnmtap.localhost
     REMOTE_HOST     localhost
     REMOTE_ADDR     127.0.0.1

     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 ...
  </COMMON>
  ...
  <DATABASE_ACCOUNT>
    ...
  </DATABASE_ACCOUNT>
  ...


  SSH access for the 'Application Monitor'
  ----------------------------------------

  cd ~/.ssh
  chown -R asnmtap:asnmtap .ssh
  #           |-------|------- user for the ASNMTAP::Application

  ssh-keygen -q -t rsa -f /home/asnmtap/.ssh/ssh -N ''

  chmod 700 .ssh
  chmod go-rwx .ssh/*

  chmod 644 ssh.pub
  chown asnmtap:asnmtap ssh.pub

  chmod 600 ssh
  chown apache:asnmtap ssh
  #        |------- user for web server

  cat /home/asnmtap/.ssh/ssh.pub >> /home/asnmtap/.ssh/authorized_keys
  chmod 600 /home/asnmtap/.ssh/authorized_keys

  vi /home/asnmtap/.ssh/authorized_keys
  add command='/opt/asnmtap/applications/sbin/sshWrapperASNMTAP.pl' before ssh.pub


  httpd.conf
  ----------

  vi /etc/httpd/conf.d/asnmtap.conf add the following content, and modify where needed like ServerName, ServerAlias, ErrorLog and CustomLog
  AddHandler cgi-script .cgi .pl

  DirectoryIndex index.htm index.html index.html.var index.shtml index.cfm index.pl

  <VirtualHost *:80>
    ServerName asnmtap.citap.com
    ServerAlias asnmtap.citap.be
    ServerAdmin webmaster@citap.com
    DocumentRoot /opt/asnmtap/applications/htmlroot
    ErrorLog /var/log/httpd/asnmtap.citap.com-error.log
    CustomLog /var/log/httpd/asnmtap.citap.com-combined.log combined
    IndexIgnore *.png *nok.txt *all.txt *.html
    IndexOptions NameWidth=* FancyIndexing FoldersFirst SuppressDescription
    IndexOrderDefault Ascending Name

    # when ASNMTAP is not installed into '/opt/asnmtap/' you need to add SetEnv ASNMTAP_PATH
    # SetEnv ASNMTAP_PATH /opt/asnmtap/

    Alias /asnmtap "/opt/asnmtap/applications/htmlroot"

    <Directory "/opt/asnmtap/applications/htmlroot">
      AllowOverride AuthConfig
      Options FollowSymLinks
      Order allow,deny
      Allow from all
    </Directory>

    Alias /results "/opt/asnmtap/results"

    <Directory "/opt/asnmtap/results">
      HeaderName HEADER.html
      ReadmeName FOOTER.html
      AllowOverride AuthConfig
      Options Indexes
    # Options Indexes FollowSymLinks
      Order allow,deny
      Allow from all
    </Directory>

    Alias /config "/opt/asnmtap/applications/tmp/config"

    <Directory "/opt/asnmtap/applications/tmp/config">
      HeaderName HEADER.html
      ReadmeName FOOTER.html
      AllowOverride AuthConfig
      Options Indexes
    # Options Indexes FollowSymLinks
      Order allow,deny
      Allow from all
    </Directory>

    ScriptAlias /asnmtap/cgi-bin/ "/opt/asnmtap/applications/htmlroot/cgi-bin/"

    <Directory "/opt/asnmtap/applications/htmlroot/cgi-bin">
      AllowOverride AuthConfig
      Options ExecCGI
      Order allow,deny
      Allow from all
    </Directory>
  </VirtualHost>


  restart your web server


  Install MySQL client need to be installed
  -----------------------------------------

  MySQL version 4.x
    mysql -u root -p  < /opt/asnmtap/applications/tools/mysql/asnmtap-3.002.003.sql
   or

INSTALL  view on Meta::CPAN

  - Plugins (to edit short description, trendline, holiday bundle and uploading plugindoc)


  4) Guest and members at http://asnmtap.citap.com/asnmtap/nav/index/

    ... TODO ...


  RSYNC tussen PROBE en CENTRALE servers
  --------------------------------------

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


  Install ChartDirector 4.x for Perl 
  -----------------------------------

    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/.
    tar -xvzf chartdir_perl_linux.tar.gz
    rm chartdir_perl_linux.tar.gz

    ASNMTAP configuration
    ---------------------

    Applications.cnf

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

  Perfparse integration
  ---------------------

    download latest snapshot from http://wiki.perfparse.org/cvs_snapshots/
    bzip2 -d perfparse-06-mm-dd.tar.bz2
    tar -xvf perfparse-06-mm-dd.tar
    cd perfparse-all

    ./configure --prefix=/opt/asnmtap/perfparse --with-imagedir=/opt/asnmtap/applications/htmlroot/img/ --with-cgidir=/opt/asnmtap/applications/htmlroot/cgi-bin --with-http_image_path=/asnmtap/img --with-data-source=asnmtap
    make
    make install-strip


  SNMPTT integration 
  ------------------

    Install net-snmp 5.4.x

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

    MySQL 5.0.x

     SQLyog -> Db -> Import from SQL Statements ... -> \opt\asnmtap-3.001.xxx\plugins\templates\snmptt\snmptt-3.002.003-v5.0.x.sql
     SQLyog -> Db -> Import from SQL Statements ... -> \opt\asnmtap-3.001.xxx\plugins\templates\snmptt\create_weblogic_configuration_database_with_SNMP-3.002.003_mysql-v5.0.x.SQL
     or
     mysql -u root -p  < /opt/asnmtap/plugins/templates/snmptt/snmptt-3.002.003-v5.0.x.sql
     mysql -u root -p  < /opt/asnmtap/plugins/templates/snmptt/create_weblogic_configuration_database_with_SNMP-3.002.003_mysql-v5.0.x.SQL

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

  NagTrap integration 
  -------------------

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

    more /opt/asnmtap/applications/htmlroot/snmptraps/.htaccess
    AuthName "CITAP's Nagios Access"
    AuthType Basic
    AuthUserFile /etc/httpd/conf/nagios-htpasswd.users
    require valid-user

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


  Install HTML to PDF converter for Perl 
  --------------------------------------

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

    Downloading the Software 
    Get the software from http://www.htmldoc.org/
    wget http://ftp.easysw.com/pub/htmldoc/1.8.25/htmldoc-1.8.25-source.tar.gz

    Installing the Software
    tar -xvzf htmldoc-1.8.27-source.tar.gz
    cd htmldoc-1.8.27
    ./configure
    make
    make install

    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 '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


  mv $AMPATH/applications/archive.sh-orig $AMPATH/applications/archive.sh
  mv $AMPATH/applications/bin/generateCollectorDaemonSchedulingReports.sh-orig $AMPATH/applications/bin/generateCollectorDaemonSchedulingReports.sh
  mv $AMPATH/applications/bin/generateReports.sh-orig $AMPATH/applications/bin/generateReports.sh
  mv $AMPATH/applications/bin/holidayBundleSetDowntimes.sh-orig $AMPATH/applications/bin/holidayBundleSetDowntimes.sh
  cp ../your-logo.gif $AMPATH/applications/htmlroot/img/logos/bodyimage.gif
  - man ASNMTAP::Asnmtap::Applications::Collector
  - man ASNMTAP::Asnmtap::Applications::Display
  - man ASNMTAP::Asnmtap::Applications::CGI


Information about the integration from ASNMTAP with HTMLDOC and Perfparse can be found at:
  - man ASNMTAP::Asnmtap::Applications


./fixRights.sh

-------------------------------------------------------------------------

How do I install a ASNMTAP module into my home directory?

If you're not the Perl administrator you probably don't have permission to install a module to its default location.
Then you should install it for your own use into your home directory like so:

  perl Makefile.PL INSTALL_BASE=~

-------------------------------------------------------------------------



( run in 0.883 second using v1.01-cache-2.11-cpan-39bf76dae61 )