Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Before You Begin

Before adding you add a new monitored devices device to DPOD, you ensure to perform the following:

  1. You may backup the objects that

...

  1. DPOD will alter during the configuration phase, such as the XML management interface, the WS-M agent, etc.
    For detailed information regarding IDG DPOD related objects backup and restore see Backing Up and Restoring DPOD IDG Related Configuration

...

  1. .
  2. Check network routing and access from a the monitored device:.
    The DataPower Gateway needs to route packets to DPOD Agents agents through the desired interface. Validate You may validate this through the DataPower 's [control panel->Troubleshooting->TCP Web GUI: [Control panel → Troubleshooting → TCP Connection Test]
  3. Log-in to DPOD Web Console

...

  1. Make sure the device locale is set to EN. Adding a device with a locale other than EN may cause some DPOD features to not work as expected.

Add the Device to DPOD

  1.  Inside DPOD's Web Console, navigate to the gateways page [Manage ->Devices->Gateways→ Devices → Gateways] and click on “New”.

    Image Added
  2. Enter the required information . (Consult consult Device Management for details):
      Note that the
      1. The device name must be identical to the System Identifier/Appliance Name of the DataPower Gateway as set in the

      IDG itself, and
      1. Gateway itself.
        It must meet the requirements detailed in http://www-01.ibm.com/support/docview.wss?uid=swg21668456.

      info
      1. If you wish to add a Tenant device, enter the landlord's name but use the tenant's SOMA host and port
      ,
      1. . DPOD will display the tenant's name as tenant@landlord
      Image Removed
    1. Click “Add”
    2. If you choose not to monitor device resources (not recommended), this message will appear:
      Image Removed
      This means that this
      1. .
      2. It is highly recommended to enable device resources monitoring. Disabling it will cause this device's health
      will
      1. to be missing in System Health dashboard
      .
      Also,
      1. , as well as provide unexpected results in dashboards, reports and alerts that are based on
      data collected when monitoring device resources will not work (i.e. Device Resources dashboard).

    ...

      1. this data.
    1. Click “Add”

    Configure the New Monitored Device

    Tip

    If you change DPOD's or the monitored device's IP address, you will need to repeat the setup.


    Info
    If you wish to monitor transactions in the default domain, please follow the instructions in Monitoring Transactions in the Default Domain


    Right after adding the device, the "Setup" tab will be displayed, the tab is divided into six parts.

    Image Removed
    Image Addedwing sections 'inside'?

    1. Device Syslog Agent - select the desired Syslog Agent according to the architecture design, click "Setup Syslog" and wait until the action completes successfully.

    2. Domains Syslog Agent  -

      Tip

      This section will apply the same setup too to all domains in the gateway, to . To select a different configuration for each domain, see the section "Domain Level Configuration" later on this page.

      Select the desired Analysis Level, select the Syslog agent according to the architecture design and click "Setup Syslog", the . The operation may take a few minutes.

    3. Auto Setup Domains (Optional) -
      This feature will automatically detect and setup new domains created on the gateway. This is especially useful for dynamically created API Connect domains.
      Select a Syslog agent that the domains should report to, select the desired Analysis Level, enter the domain pattern (you may use asterisk as wildcard) and click save.
      DPOD will scan the monitored devices every 2 minutes and will setup the new domain. You may change the scan interval on the system parameters page. (restart DPOD's resources service via the CLI after changing this interval)
      For domains that match the auto setup pattern - DPOD will also try to detect if any domain was reset and setup it again.

    4. Domains WS-M Setup (Optional)

      Tip

      This section will apply the same setup too all domains in the device, to select a different configuration for each domain, see the section "Domain Level Configuration" later on this page.

      If you wish to record and view payloads, or to record API-C policy variables, select the desired WS-M Agent according to the architecture design and click "Setup WS-M”, the operation may take a few minutes.
      For supported WS-M payload capture services see IDG WS-M Payload Capture Support.
      Click on "Record Payload" to open the payload capture page where you can start capturing payloads

    5. Certificate Monitor Setup (Optional)
      If you wish to use DPOD's expired certificate dashboard, click on "Setup Certificate Monitor"  .
      Consult the System Parameters List ("Certificate monitoring duration in days") for information regarding the time interval parameter.

    6. Extended Transaction Setup (Optional, Deprecated)

      Warning

      This feature is deprecated and was replaced by a non-intrusive method.
      Please do not use this feature unless advised by L2/L3 support.

    ...

    Extended Transaction setup for all services (Optional, Deprecated)

    This feature is deprecated and was replaced by a non-intrusive method.
    Please do not use this feature unless advised by L2/L3 support, this feature was deprecated and was replaced by a non-intrusive method.
    Under "Services Extended Transaction Setup", click "Setup Extended Transaction for all services” and wait until the action completes successfully.

    Warning

    This step will MODIFY SERVICES PROCESSING POLICIES. You must test and verify that the services are not affected by this change before setting this up on production environments.

    ...