Versions Compared

Key

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

Before You Begin

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

  1. You may backup the objects that 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.
  2. Check network routing and access from the monitored device.
    The DataPower Gateway needs to route packets to DPOD agents through the desired interface. You may validate this through the DataPower Web GUI: [Control panel → Troubleshooting → TCP Connection Test]
  3. 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

...

make sure to Prepare your Monitored Devices.

Adding a Gateway to DPOD

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

...

Enter the

...

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

...

Image Removedwing sections 'inside'?

...

Domains Syslog Agent

Tip

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

...

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.

...

Domain Level Configuration (Optional)

You can use specific domain level configuration in the following cases:
1. Your architectural design dictates a different configuration for domains on the same gateway.
2. You want to enable WS-M and syslog collection only for specific domains. 

Switch to the "domains" tab, a list of all domains will be retrieved from the gateway, click on the domain you wish to setup.

Syslog setup (Optional)

Select the desired Analysis Level, select the desired Syslog Agent according to the architecture design and click "Setup Syslog".

Domain WS-M setup (Optional)

Select the desired WS-M Agent according to the architecture design and click "Setup WS-M”.
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

...

following information:

Field

Description

Name

The gateway name in DPOD (must be identical to the System Identifier of the gateway).
It must meet the requirements detailed in Are there any restrictions when defining the DataPower "System Identifier"?.
If you wish to add a Tenant device, enter the landlord's name. DPOD will display the tenant's name as tenant@landlord.

Host Address

IP Address used to access the gateway.
If you wish to add a Tenant device, enter the tenant's host.

SOMA port

The SOMA port configured on this gateway.
If you wish to add a Tenant device, enter the tenant's SOMA port.

SOMA User Name

The user name used to access the monitored devices via SOMA.

SOMA Password

The password of the user name used to access the monitored devices via SOMA.

Log Target Source Address

IP Address of the gateway's log target source.
This should be the IP address of the ethernet interface of the gateway from which Syslog records should be sent to DPOD.
Usually, this IP address is the same as the IP address used for the Host field mentioned above, unless the gateway is in a different network than DPOD (e.g behind NAT).
If link aggregation interface is configured in the gateway, you may define its IP address as the log target source address to take advantage of the link aggregation benefits when sending Syslog records to DPOD.

Device Resources Monitoring

Whether Device resources monitoring is enabled on this gateway.
It is highly recommended to enable device resources monitoring. Disabling it will cause this device's health to be missing in System Health dashboard, as well as provide unexpected results in dashboards, reports and alerts that are based on this data.

Service Resources Monitoring

Whether Service resources monitoring is enabled on this gateway.

Once you click the Add button, DPOD will make sure it can connect to the monitored device and if successful, the gateway will be added to DPOD as a new monitored device.

Each monitored gateway needs to be configured to send information to DPOD after added to DPOD. To configure the gateway, see Configuring Monitored Devices.