...
| Field | Description | Restrictions |
|---|---|---|
| Type | This is the protocol to be validated. | |
| Details | ||
| Alarm Name (Auto-filled) | If the protocol validation fails, e.g. the service becomes unavailable, this will be the name of the alarm raised. | |
| Name | A description of the protocol validation, which will also be shown in the alarm details, and on the protocol validation availability page. | |
| Site | Free text used to identify the site. Can be blank | |
| Criteria | ||
| Address | The target address, can be a DNS name, or IP Address. For example: www.mywebsite.com:8080/firstpage/secondpage | For SIP OPTIONS, SIP URI is also supported |
| Port | The port the service runs on. If left blank, the default port for that protocol will be used. Default ports: 80 = HTTP 443 = HTTPS 25 = SMTP 22 = SSH 23 = Telnet Undefined = Raw TCP Socket | |
| Poll Frequency (mins) | The frequency of the protocol validation is tested, in minutes. Valid values are 1 – 1440. We recommend setting this to 2 minutes, for immediate results on failure. | |
| Validation | Specifies whether the address is accessed internally within the intranet, or externally via a public-facing IP Address. For public websites, this should be set to External. Note: It is not possible to test an external validation. | |
| Additional Configuration options | ||
| Ignore Certificate Errors | For HTTPS a security certificate needs to be installed on the target equipment. Sometimes, this cannot be verified, resulting in browsers displaying a warning instead of loading the page. If this is the expected response for the site, click 'Ignore Certificate Errors' | HTTPS only |
| Override Failed Responses | To customize the default behaviour and classify failure responses as a success, list the specific response codes as a comma separated input in the field below. For example, to ignore authentication errors, add: 401, 407. | SIP OPTIONS only |
| SIP Proxy Address | This is the SIP Proxy address and is an IP Address. SIP Proxy, sometimes also called SIP Server, or SIP Proxy server facilitates the communication between two SIP addresses. It is the go-between two SIP devices allowing them to set up communication, and drops out once established allowing point to point communication. | SIP OPTIONS only |
| SIP Proxy Port | This is the port used by the SIP proxy. It is typically 5060 for non-encrypted signalling traffic, or 5061 for encrypted traffic, encrypted with Transport Layer Security (TLS). If left blank, the default 5060 will be used. | SIP OPTIONS only |
| SIP Protocol | This is the protocol used by the target SIP client. SIP clients typically use TCP or UDP for encrypted SIP traffic to servers and other endpoints. If SIP Proxy Port is 5061, specify TLS. | SIP OPTIONS only |
| Username | The username to log on to the target address with. | SSH, Telnet and SIP Options |
| Password | The password to log on to the target address with | SSH, Telnet and SIP Options |
Test Configuration
To check that the Protocol Validation is working press the “Test” button when all mandatory fields have been entered.
Once the Protocol Validation test is working, click “Add” and the Protocol Validation Test will be saved in VSM. If not, troubleshoot by checking that all fields have been entered correctly.
Results
Once Configured protocol validation results typically start working after a few minutes. The following colour bars are used
- Green: A successful connection with successful Response Code
- Red: A failed response code was returned
- Red: A failed response code was returned, either because the target was unreachable, or the service running on that protocol was responding with an error. And alarm will be raised.
- Black: Internal error. Contact your system administrator