Validating Devices

Whenever you add a new Device, or make a change to an existing Device, you should validate that the Device is configured correctly. xMatters includes a testing and validation tool to make sure that all of your Devices are configured properly and working as expected.

Testing your Devices in xMatters is a three-step process:

  1. Send a test message to the Device.
  2. Retrieve a validation code from the test message on the Device.
  3. Enter the validation code into xMatters to confirm that the test message was received.
Note: With two-way Devices, such as phones, you can combine the last two steps by replying to the validation message on your Device.

The current validating status of your Devices is indicted in the Valid column of the Device table on your home page, and on your My Devices page. The following table lists and explains the symbols used to represent the status of each Device.

Device requires validating.

Device is currently being tested; requires validation code.

Device has been validated.

To send a test message:
  1. Sign in to xMatters.
  2. On your home page, in the menu on the left side of the browser window, click Validate Devices.
    1. xMatters displays the Validate Devices page, with your Devices divided into those that have not been tested, those that are currently being tested, and those that have already been validated.
  1. On the Validate Devices page, in the Untested Devices table, select the check box next to the Device you want to test.
  2. Click Test Selected Devices.
    1. xMatters sends test messages containing validation codes to each of the selected Devices, and lists the Devices in the Devices Pending Validation table.
To retrieve a validation code:
  1. Retrieve the test message from your Device.
    1. In the case of an email Device, for example, you will receive a message containing the validation code, which is part of the initial message at the beginning of the email. If two-way email has been configured on your system, you can just reply to the email as defined in the message in order to validate the Device.
  2. Remember the validation number; you will need it to validate your one-way Devices as shown below.
Note: For more information about how to retrieve messages from a Device, see About Alerts.
To enter the validation code:
  1. On the Validate Devices page, in the Devices Pending Validation table, select the check box for the Device you want to validate.
  2. Type the validation code you retrieved from the text message into the field in the Validation Code column.
  3. Click Validate Selected Devices.
    1. If the code is correct, the Device is moved to the Validated Devices table, and its status is updated on your My Devices page.

Resetting a Device

If you have modified a Device's details and want to re-validate it, you can cancel a completed or pending validation.

To return a Device to a non-validated state, select its check box and then click Reset Selected Devices.