.werks/1903

   1 Title: mk_oracle: Remote Monitoring of Oracle Databases
   2 Level: 2
   3 Component: checks
   4 Compatible: compat
   5 Version: 1.2.7i1
   6 Date: 1427652230
   7 Class: feature
   8
   9 mk_oracle got a major improvement in monitoring Oracle Databases.
  10
  11 This new option allows monitoring a database from another host with a
  12 running check_mk_agent.
  13
  14 H2: Requirements
  15 You need an Oracle Client from Oracle to use this feauture. The Oracle Instant Client
  16 with SQLPlus is a required minimum. You could use an existing Oracle installation as
  17 environment for mk_oracle as well.
  18
  19 The plugin sends the data with piggyback. Please keep in mind, that the agent from the
  20 host with mk_oracle is responsible for the piggyback data. If you put the Check_MK check
  21 in downtime you'll put all other database checks from mk_oracle in a downtime as well.
  22
  23 H2: Configuration
  24 You need an Oracle Client. You could use the remote option from an existing Database Server
  25 to monitor another Server. It is recommended to set <tt>REMOTE_ORACLE_HOME</tt> in <tt>mk_oracle.cfg</tt>
  26 for the <tt>ORACLE_HOME</tt> which should be used for all remote connections.
  27
  28 An existing <tt>ORACLE_HOME</tt> could be used as well, but do not do that in mixed configurations
  29 with local and remote monitoring of Oracle Databases.
  30
  31 Add the following lines to <tt>mk_oracle.cfg</tt>. The path is an example for the RPM Instant
  32 Client from Oracle for 64bit on Linux.
  33 <tt>REMOTE_ORACLE_HOME=/usr/lib/oracle/11.2/client64</tt>
  34
  35 <tt>REMOTE_INSTANCE_1=check_mk:check_mk::dbhost:1521:piggybackhost:XE:11.2</tt>
  36 <tt>REMOTE_INSTANCE_2=check_mk:check_mk::dbhost:1521:piggybackhost:XE2:11.2</tt>
  37
  38 Definition of a REMOTE_INSTANCE:
  39 <tt>REMOTE_INSTANCE_<Number>=<Configuration String></tt>
  40
  41 The definition of the database connection is as follows.
  42 <tt>username:password:sysdba:Database hostname:Listener Port:piggyback Hostname:ORACLE_SID:ORACLE-Release</tt>
  43
  44 Notes regarding <tt>REMOTE_INSTANCE_x</tt>
  45 You need to make sure, that the name of the variable including
  46 the hostname is unique for every database in <tt>mk_oracle.cfg</tt>.
  47 The Oracle Release must be 9.2, 10.1, 10.2, 11.1, 11.2 or 12.1.
  48 No other values are allowed.
  49
  50 Don't forget to use the testmode before starting the inventory on
  51 the monitoring host.
  52
  53 More details could be found on the documentation at Check_MK:
  54 https://mathias-kettner.de/checkmk_oracle.html
  55
  56 The testmode is compatible with the remote mode. Details with an
  57 example are shown in the documentation.
  58
  59 H2: Incompatible change:
  60 The compatibility against old sqlplus.sh has been removed. Please
  61 remove an exiting sqlplus.sh and configure
  62 the <tt>mk_oracle.cfg</tt>. This change is a requirement for the
  63 new remote monitoring option and the only reason for this
  64 change.
  65 There is nothing to do when <tr>sqlplus.sh</tr> was not used before this Werk.