Versions Compared

Key

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

Before You Begin

You will need toBefore adding new monitored devices to DPOD, you may backup the objects that the 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 DPODs IDG related configuration

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

  1. Check routing and access from a monitored device:
    The DataPower Gatweay Gateway needs to route packets to DPOD Agents through the desired interface. Validate through through the DataPower's [control panel->Troubleshooting->TCP Connection Test]
  2. Log In To DPOD UI -in to DPOD Web Console

Device Level Configuration

Add The Device In DPOD

 

...



Warning

Adding a device with a locale other than EN may cause some DPOD features to not work as expected

  1.  Inside DPOD's UI Web Console, open navigate to Monitored Devices  [Manage->Devices->Monitored Devices] and click on “Add Device”
  2. Enter the information required. (Detailed description can be found in Consult Device Management) todo this page doesn't actually contain relevant information for details)
    Note that the device name must be identical to the System Identifier/Appliance Name of the DataPower Gatweay Gateway as set before todo: set before where?in the IDG itself, and must meet the requirements detailed in http://www-01.ibm.com/support/docview.wss?uid=swg21668456.



  3. click Click “Add”
  4. DPOD will add the device, and it will be added to . (Verify by locating the new device in the list of monitored devices)


Info

When updating the "Log Target Source Address" after the device was added and syslog was setup for the device , the user must setup the syslog for device again in order for the change to take effect on the monitored device (see next item "Setup Syslog For The New Monitored Device" ).


Configure The New Monitored Device

  1. Inside DPOD's UI Web Console, open navigate to the devices list page [Manage->Devices->Monitored Devices]
  2. Click the name of the device you added in the previous step
  3. Click "Setup” and wait for an informative green message at the top todo:what does s this do? how is this now 'configured'? are the following sections 'inside'?

Setup Syslog For The New Monitored Device

  1. Under "Syslog Setup for Device", select the proper correct Syslog Agent ( according to the architecture design), click "Setup Syslog for device" and wait till until the action completes successfully.
    Image Added 

Syslog setup for all domains

  1. Under "Syslog Setup for All Domains", select the proper Syslog correct Syslog Agent ( according to the architecture design), click "Setup Syslog for all domains" and wait till until the action completes successfully.Image Removedtodo: change

Image Added 
diagram to new-name

Tip
titlePerformance

Different domains Domains may be redirected to different Syslog agents according to the architecture design. If this is the case, please set up each domain separately as documented below

...

Auto Setup Domains (Optional)

  • Under "WS-M Setup for Device", click "Setup WS-M for all domains" and wait till the action completes successfully.
  • Note: You may choose to select which domains have WS-M enabled. If this is the case, please setup each domain separately as documented below.

Image Removed

...

This feature will automatically detect and setup new domains created on the monitored device. This is especially useful for dynamically created API Connect domains.
Select a Syslog agent that the domains should report to, enter the domain pattern (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. (A UI service restart is required after changing this interval)

Image Added


Domains WS-M Setup (Optional)

Under "Domains WS-M Subscriptions for All DomainsSetup", select the proper correct WS-M Agent ( according to the architecture design), click "Subscribe to WS-M for all domains” and wait till . Click "Setup WS-M” and wait until the action completes successfully.
For the time interval please read on the appropriate variable at System Parameters List.

Tip

This feature can be done on a service or domain level.

Warning

This step will start recording payloads of transactions for a specific amount of time (currently 1 hour). You may run this later when you need payloads recorded. You may choose to record payload on a specific domain. If this is the case, please subscribe on each domain separately as documented below.

 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

Image Added

Extended Transaction setup (Optional)

Under "Extended Transaction Setup", click "Setup Extended Transaction for Device” and wait till until the action completes successfully.

Warning

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

Image RemovedImage Added

Tip

This feature can be done on used at a service or domain level.

 

Certificate Monitor (Optional)

Under "Certificate Monitor", click "Setup Certificate Monitor for Device” and wait till until the action completes successfully.
For Consult the System Parameters List for information regarding the time interval please read on the appropriate variable at System Parameters Listparameter.

Image Removed

...

Image Added


Domain Level Configuration

Configuring a specific domain (Optional)

...

  1. Navigate to the domain setup page  [Manage→ Devices→ Monitored Devices]
  2. Click the device name

...

  1. Click the domain name

...

  1. Click "Setup”
     
Tip
Different domains

Domains may be redirected to different Syslog agents according to the architecture design.

Also

Additionally, you may choose to enable WS-M on specific domains only etc. If this is

the case

required, follow the

following

steps below to configure specific domains.

If not –

Otherwise you may skip this section

...

Syslog setup (Optional)

Under "Syslog Setup", select the proper correct Syslog Agent ( according to the architecture design), click "Setup Syslog" and wait till until the action completes successfully. 

WS-M setup (Optional)

Under "Select the correct WS-M Setup", click Agent according to the architecture design. Click "Setup WS-M" M” and wait till until the action completes successfully.

 

For supported WS-M

...

Under "payload capture services see IDG WS-M Subscription", select the proper WS-M Agent (according to the architecture design), click "Subscribe to WS-M” and wait till the action completes successfully.

...

payload capture support.
Click on "Record Payload" to open the payload capture page where you can start capturing payloads

Extended Transaction setup for all services (Optional)

Under "Extended Transaction Setup for All Services", click "Setup Extended Transaction for all services” and wait till until the action completes successfully.

Warning

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

...