IBM Tivoli Composite Application Manager for Transactions, Version 7.4.0.0

Configuring HTTPS monitor service tests

Use the HTTPS monitor configuration parameters to define HTTPS service tests.

When you configure the monitor, default values are shown for the timeout and poll interval parameters. These defaults are 30 and 300 seconds respectively. Other defaults listed in the table are not shown during configuration but are applied when the configuration details are saved if no value has been specified.

Table 1. HTTPS monitor configuration

Field

Description

server

The host name of the server to be monitored.

page

The URL of the page to be monitored.

description

A text field for providing descriptive information on the element.

Active

Selects whether or not the profile element should be activated once it is created.

port

The port on the server to use.

Default: 443

localip

Specifies the IP address of the network interface that the monitor uses for the test. If this field is empty, the monitor uses the interface specified by the IpAddress property.

version

The HTTPS protocol version to be used:
  • 1.0
  • 1.1

Default: 1.0

command

The request type:

  • HEAD
  • GET
  • GETALL
  • POST

Default: GET

formname

When used in a transaction, the HTTPS monitor scans the specified form for default values. Any values found are automatically filled in the next HTTPS step in the transaction.

authenticationtype

Specifies the challenge -response authentication mechanism for authenticating network users:

  • NONE - No authentication
  • BASIC
  • NTLMv1 - Windows NTLM version 1 challenge/response authentication
  • NTLMv2 - Windows NTLM version 2

Default: NONE

username

The username (account name) for the monitor to use to log into the HTTPS server.

password

The password corresponding to the username for the monitor to use to log into the HTTPS server.

sslcertificatefile

The path and filename of the digital certificate file used in the monitor element. If the path is not absolute, the monitor interprets it relative to the working directory ($ISMHOME/platform/arch/bin).

If you do not specify a certificate file, the monitor uses the certificate specified by the monitor property SSLCertificateFile.

sslkeyfile

The path and filename of the file containing the SSL private key which is used to identify the server and sign the SSL messages.

sslkeypassword

The password used to encrypt the SSL private key.

timeout

The time, in seconds, to wait for the server to respond.

Default: 30

poll

The time, in seconds, between each poll.

Default: 300

failureretests

The number of times to retest before indicating a failure.

Default: 0

retestinterval

The time, in seconds, to wait between each failure retest.

Default: 10

Proxy details

server

The host name of the proxy server.

port

The port on the proxy server to use.

authenticationtype

The server authentication type for the proxy HTTPS server. See authenticationtype above for further information.

username

The username for the monitor to use to log into the proxy HTTPS server.

password

The password for the monitor to use to log into the proxy HTTPS server.

useproxy

Configures the monitor to perform the request using a proxy server.

  • proxy (use true in ismbatch)
  • noproxy (use false in ismbatch)

Default: noproxy

hostnamelookuppreference

Determines which IP version, IPv6 or IPv4, is applied to the supplied host name. The options are:
  • default sets the monitor to use monitor-wide properties settings. This is the default.
  • 4Then6 selects IPv4 and then IPv6. Uses IPv4 addresses if they are available. If no IPv4 addresses are found, IPv6 addresses are used.
  • 6Then4 selects IPv6 and then IPv4. Uses IPv6 addresses if they are available. If no IPv6 addresses are found, IPv4 addresses are used.
  • 4Only selects IPv4 only. Uses IPv4 addresses only. If there are no IPv4 addresses, the poll returns an error.
  • 6Only selects IPv6 only. Uses IPv6 addresses only. If there are no IPv6 addresses, the poll returns an error.
  • 6Or4 selects either IPv4 or IPv6. Uses the first address returned from the host name.


Last updated: September 2014