view release on metacpan or  search on metacpan

INSTALL  view on Meta::CPAN

# -----------------------------------------------------------------------
# © Copyright 2003-2011 by Alex Peeters [alex.peeters@citap.be]
# -----------------------------------------------------------------------

# General - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Author       : Alex Peeters [alex.peeters@citap.be]
Latest update: dd month 2011
Version      : 3.002.003


# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# INSTALL - DRAFT v1.1  - - - - - - - - - - - - - - - - - - - - - - - - -
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

fixRights.sh
------------

vi fixRights.sh and change when needed
AMPATH=/opt/asnmtap-3.001.xxx	       # path where ASNMTAP is installed
ASNMTAPUSER=asnmtap                    # use for the ASNMTAP::Application
WWWUSER=apache                         # nobody
...

chmod 755 fixRights.sh

./fixRights.sh


Symbolic link:
--------------

ln -s /opt/asnmtap-3.001.xxx-new asnmtap


-------------------------------------------------------------------------
- ASNMTAP/Nagios PLUGINS                                                -
-------------------------------------------------------------------------

Information about the ASNMTAP/Nagios Plugins can be found at:
  man ASNMTAP::Asnmtap

  Asnmtap.cnf
  -----------

  mv $AMPATH/Asnmtap.cnf-orig $AMPATH/Asnmtap.cnf

  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>