Versions Compared

Key

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

IBM DataPower Operations Dashboard contains an extensive set of parameters that let administrators fine-tune the system's behavior to the installation requirements.
The following sections describe these parameters in detail. 

...

ParameterCategoryDefault ValueDescription
Enable Queries Emails SMTPAlertstrueEnable / Disable publishing alerts via SMTP server
Enable Queries Emails SMTP WSAlertsfalseEnable / Disable publishing alerts via Web Service
Fields to Ignore in ElasticSearch Response in AlertsAlertsdoc_count_error_upper_bound,sum_other_doc_countField to omit from alert description
Enable Queries Output FileAlertsfalseEnable / Disable publishing alerts as file in local file system
Syslog Severity Field ValueAlertsinfoSyslog record message level.
Possible values: debug, info, notice, warning, err, crit, alert, emerg
Alerts Syslog Server HostnameAlerts172.77.77.7Syslog server hostname or IP address.
Alerts Syslog Server PortAlerts60031Syslog server listening port.

...

Parameter

Category

Default Value

Description

From Address

Email

from@example.com

The from address used for the report email.

SMTP Host

Email SMTP

smtp.example.com

Destination SMTP host

SMTP Password

Email SMTP

********

Password for logging in to the SMTP host. If no authentication required leave this field empty.

SMTP Port

Email SMTP

465

Destination SMTP host port

SMTP User

Email SMTP

mailer@example.com

Username for logging in to the SMTP host. If no authentication required leave this field empty.

SMTP SSL EnabledEmail SMTPtrueEnable / Disable TLS/SSL


SMTP WS Endpoint URI

Email SMTP WS

/SMTPSender

Destination URI for sending reports via Web-Service

SMTP WS Host

Email SMTP WS

localhost

Destination hostname for sending reports via Web-Service

SMTP WS Port

Email SMTP WS

8080

Destination port for sending reports via Web-Service

SMTP WS Protocol

Email SMTP WS

HTTP

Protocol for accessing the Web-Service host

Valid values: HTTP / HTTPS

SMTP WS User

Email SMTP WS

user

User used for sending reports via Web-Service. This value is sent using HTTP Basic Authentication.

SMTP WS Password

Email SMTP WS

********

Password used for sending reports via Web-Service. This value is sent using HTTP Basic Authentication.

...

The following parameters control configuration and connection to an LDAP registry, used for role-based security.

All parameters below are mandatory when enabling LDAP role-based security (by switching on the Enable LDAP parameter).
If LDAP RBM is disabled, all these parameters should be left blank.

...

Parameter

...

Category

Warning

The LDAP parameters should not be altered manually and should exactly match the values in the services configuration files.
Instead, use the LDAP Configuration Script which tests the parameters, encrypts the passwords and changes the configuration files in addition to System Parameters.


LDAP The LDAP filter (using LDAP filter syntax) to search for groups by a member user or a member group (in case of nested search), Use {0} as a placeholder for the full DN of the member user or the member group (in case of nested search)

Parameter

Category

Default Value

Description

Enable LDAPLDAPfalseWhether the LDAP RBM is enabled.
Valid Values: true / false
See LDAP Configuration Script
LDAP Connection URLsLDAPOne or more LDAP server address(es), separated by commas
See LDAP Configuration Script
Enable LDAP Host Name VerificationLDAPtrueEnable host name verification of certificates when using LDAPSSee LDAP Configuration Script

LDAP Connection Name (DN)

LDAPUsername for connecting to the LDAP server (sometimes called “bind user”)


See LDAP Configuration Script

LDAP Connection Password

LDAPPassword for connecting to the LDAP server


See LDAP Configuration Script

LDAP Referral (ignore/follow)

LDAP

ignore

Define handling of JNDI referrals (see javax.naming.Context.REFERRAL for more information).
Valid values are:

  • ignore
  • follow
  • throw

Microsoft Active Directory often returns referrals. Set this parameter to follow If your installation is required to follow them.

Caution: if your DNS is not part of AD, the LDAP client lib might try to resolve your domain name in DNS to find another LDAP server.

LDAP User Search BaseLDAPLocation of user objects in the LDAP treeLDAP User Search FilterLDAPThe LDAP filter (using LDAP filter syntax) to search for usera user by its name, Use {0} as a placeholder for the user name entered in the login page

LDAP User Name Attribute Name

LDAP

The user attribute name that contains the name of that user (as entered in the login page)

LDAP Group Search BaseLDAPLocation of group objects in the LDAP treeLDAP Group Membership Search FilterLDAPSee LDAP Configuration Script
LDAP User Search BaseLDAP
See LDAP Configuration Script
LDAP User Search FilterLDAP
See LDAP Configuration Script

LDAP User Name Attribute Name

LDAP


See LDAP Configuration Script

LDAP Group Search BaseLDAP
See LDAP Configuration Script
LDAP Group Membership Search FilterLDAP
See LDAP Configuration Script

LDAP Group Membership Search Nested

LDAP

trueSearch for nested group membership (groups within groups)Search nested group members

See LDAP Configuration Script

LDAP Group Name Search FilterLDAP

The LDAP filter (using LDAP filter syntax) to search for a group by its name, usually by the "cn" attribute, Use {0} as a placeholder for the group nameSee LDAP Configuration Script

LDAP Group Name Attribute Name

LDAP

cn

The group attribute name that contains the name of that group

...

Monitored Devices Authentication

...

ParameterCategoryDefaultDescription
Internal Alerts - Check Agents Interval in SecondsHealth300How often to check whether DPOD's syslog and WS-M agents are up and working
Internal Alerts - Check Derby Interval in SecondsHealth300How often to check whether DPOD's internal database is up and working
Internal Alerts - Check Dropped Syslogs Interval in SecondsHealth600How often to check whether DPOD's syslog agents lost incoming messages
Internal Alerts - Check Dropped WS-M Messages Interval in SecondsHealth600How often to check whether DPOD's WS-M agents lost incoming payloads
Internal Alerts - Check ES Interval in SecondsHealth300How often to check whether DPOD's big data component is up and working
Internal Alerts - Check File System Interval in SecondsHealth300How often to check whether DPOD's filesystem is out of space
Internal Alerts - Check Retention Interval in SecondsHealth300How often to check whether DPOD's internal big data retention process is working
Internal Alerts - Check Log Targets Misconfig Interval in SecondsHealth43200How often to check whether the monitored gateways for misconfigured DPOD log targets
Internal Alerts - Send Email on AlertHealthfalseWhether or not to send an Email when a problem was detected by the internal health monitoring
Internal Alerts - Email Destination Address for AlertsHealthNo DefaultDestination Email address for sending internal health alerts
Internal Alerts - Send Syslog on AlertHealthfalseWhether or not to send a Syslog message when a problem was detected by the internal health monitoring
Interval in Seconds to Sample Logging TargetsHealth300How often to sample DPOD's log targets in the monitored devices
Interval in Seconds to Sample Nodes Health StatisticsHealth300How often to collect statistics on DPOD's big data nodes
Interval in Seconds to Monitor Objects StatusHealth300How often to monitor enabled but down objects in the monitored devices
Object Status Monitor Class List (All, Default or a Custom List)HealthDefault

By default, the Failed Objects dashboard (under the "explore" menu) displays only common object classes,
set this option to All to make it sample all object classes in the monitored gateways, or enter a custom list of comma separated classes

Interval in Seconds to Sample WSM Agents StatisticsHealth300How often to sample WS-M Agents in the monitored devices
Internal Alerts REST API Service HostHealthlocalhostHost name / IP address of the maintenance housekeeping server to save and publish internal alerts.
Internal Alerts REST API Service PortHealth8084Port of the maintenance housekeeping service to save and publish internal alerts.

...