You can configure system event notifications on the Farm > Site > Settings > Notifications tab. Notifications are used to alert the administrator about system events via email. When you configure notifications, the settings apply to all servers in the Farm.
To configure notifications, you first need to configure notification handlers where you can specify threshold values (where available) and whether an administrator should be notified via email. You can also configure notification scripts, which will be automatically executed when an event occurs.
The Mailbox tab in the Administration category allows you to configure an SMTP server for outgoing emails. The SMTP server is required for the administrator to receive system event alerts (as described in the previous sections) and to send invitation emails to users.
To configure an SMTP server:
In the RAS Console, select the Administration category and then click the Mailbox tab.
In the Mail Server field, type your mail server FDQN or IP address.
In the TLS / SSL drop-down list, select whether to use it the protocol.
Select the SMTP server requires authentication option if required and then type the SMTP server username and password in the fields provided.
In the Sender information section, type the sender email address (e.g. your email).
The Test mailbox settings section can be used to test your SMTP server configuration. Enter one or more email addresses separated by a semicolon. Click Send Test Email to test the settings.
To configure notification scripts:
On the Notifications tab, click Tasks > New (or click the plus-sign icon) in the Notifications scripts section.
In the dialog that open, specify the following options:
Script name: Enter a friendly name for the script.
Command: The command to execute.
Arguments: Command line arguments to pass to the command. An argument can be one of the predefined variables, which Parallels RAS will automatically replace with an actual value. See the Command Line Variables table below (the ID column contains the values that can be used here).
Initial directory: The full path to the current directory for the process. The string can also specify a UNC path.
User name, Password: These are optional fields that you can specify if you would like to execute the command under a specific user account.
When done, click OK to save the notification script item.
To modify a notification script, right-click it and choose Properties.
To delete a script, right-click and choose Delete. Please note that if a script is used by a notification handler, you will see a warning message. If you choose to delete it anyway, the script association will be removed from all notification handlers where it is used and all affected handlers will be automatically configured to send an email alert.
The following table lists command line variables that you can use as arguments when executing a script (see the Arguments option description above):
The following table lists supported notification types (the ID column represents values that are passed to the ($NOTIFICATION-TYPE) command line variable):
($FARM-NAME)
Name of the RAS Farm which has raised the notification.
($SITE-NAME)
Name of the RAS Site which has raised the notification.
($SERVER-ADDRESS)
IP address or FQDN of the server which has raised the notification. It could be an RDSH server, the server hosting a RAS Connection Broker, RAS Secure Gateway, etc.
($TRIGGER-ADDRESS)
IP address or FQDN of the Connection Broker that has raised the notification.
($THRESHOLD-VALUE)
The threshold value that is assigned to the notification handler. If a notification type doesn't support thresholds, the argument should be replaced with an empty string.
($NOTIFICATION-TIME)
GMT time and date of when the event has occurred. String format shall use the "R" or "r" format specifier. Please see the following article from Microsoft for details:
https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings
Note: The time should represent the time when the notification has occurred, and not when the notification handler has been executed. The notification handler may be executed with a delay if a grace period is enabled.
($NOTIFICATION-TYPE)
A numeric value that is assigned to each particular notification type. Notification type values are listed in the Notification Types table below.
CPU utilization
1
This notification is triggered when CPU utilization rises above or decreases below a certain value.
Memory utilization
2
This notification is triggered when memory utilization rises above or reaches below a certain value.
Number of active session
3
This notification is triggered when the number of active sessions rises above or decreases below a certain value.
Number of disconnected sessions
4
This notification is triggered when the number of disconnected sessions rises above or decreases below a certain value.
RAS Agent reconnect
5
Agent reconnected.
RAS Agent disconnect
6
Agent disconnected.
VDI template is missing
7
This notification is triggered when an a VDI event occurs (e.g. a template is not found).
Published application limit exceeded
8
This notification is triggered when a published item event occurs (e.g. an application's instance limit is exceeded).
Multi CB communication error
9
Multiple CB communication error.
Authentication provider not reachable
10
This notification is triggered when a connection issue occurs with an authentication server.
% of RDSH session out of the maximum specified value
11
This notification is triggered when the number of RDSH sessions rises above or decreases below the specified percentage of the maximum number of sessions.
Gateway is tunneling X number of sessions
12
This notification is triggered when the number of gateway tunnelled sessions rises above or decreases below a certain value.
% of RDSH disconnected session out of the maximum specified value
13
This notification is triggered when the number of RDSH disconnected sessions rises above or decreases below the specified percentage of the maximum number of sessions.
Connection Broker auto promotion
20
Connection Broker auto promotion
Connection Broker auto promotion failed
21
Connection Broker auto promotion failed.
Connection Broker auto promotion failback
22
Connection Broker auto promotion failback.
CA not available
30
This notification is triggered when a connection issue occurs Certificate Authority.
License site switched to failed over mode
50
Connection Broker failover mode.
License site is offline
51
Licensing site is offline.
License site reconnected
52
Licensing site is back online.
IP of Licensing CB changed
53
Licensing Connection Broker IP change.
Hostname of Licensing CB changed
54
Licensing Connection Broker Hostname change.
IP of secondary CB changed
55
Non Licensing Connection Broker IP change.
Hostname of secondary CB changed
56
Non Licensing Connection Broker Hostname change.
Templates max guests reached
60
Template max guest limit reached.
Template max servers reached
61
Template maximum server limit reached
Templates cloning failed
62
Template cloning failed.
License activated
100
This notification is triggered when a licensing event occurs (e.g. a farm has been successfully activated).
License deactivated
101
License was deactivated.
License max usage
102
The maximum license usage has reached x%.
License about to expire
103
If license is about to expire, notify every day saying how many days left.
License expired
104
License expired.
License trial expired
105
Trial period expired
License grace period start
106
Grace period started.
License grace period end
107
Grace period ended.
License disabled
108
License was disabled.
License information changed
109
License information changed
License failed to communicate with server
110
Failed to communicate with licensing server.
License no file
111
Failed to load license file.
License invalid version
112
Invalid license file version.
License invalid signature
113
Invalid license signature.
License invalid license
114
System errors.
License invalid MAC address
115
Invalid MAC address (hardware change).
Licensing unsigned grace period
116
Migration grace period started.
Tenant enrolled
200
This notification is triggered when an event related to any registered tenant occurs (e.g. a new tenant was added to Tenant Broker or tenant becomes unavailable).
Tenant status changed
201
Tenant status changed
Broker status change
202
Tenant Broker status changed
Tenant disenrolled
203
A Tenant has unjoined the broker.
Standard Farm tunnel session failed
220
Standard tunnel session failed.
Broker Farm tunnel session failed
221
Tenant Broker tunnel session failed.
To configure notification handlers:
In the RAS Console, navigate to Farm > Site > Settings.
Select the Notifications tab.
Click Tasks > New (or click the plus-sign icon) and choose an event for which to create a handler. For the list of events and their descriptions, please see the System Events subsection below.
A dialog opens where you can specify the event handler setting.
On the General tab, specify the following options:
The threshold value (a number or percentage). Not available for some events (such as Licensing, Agent, and some other events).
The direction (whether the event should trigger when the value rises above or drops below the specified value). Not available for some event (same as above).
Whether to notify the administrator via email.
Additional emails (separated by commas or semi-colons) to which to send event messages.
Whether to execute a script when the event triggers. Here you need to select the Execute a notification script option and then choose a script from the drop-down list. Before you can use this option, you need to create one or more scripts as described in Configuring notification scripts.
On the Criteria tab, specify the following:
Type: Select the type of objects that trigger notifications.
All servers in site: Select this option to include all available servers.
Available: Select objects that trigger notifications.
On the Settings tab, specify the following:
Use default settings: Select this option to use default settings. To edit defaults, click the Edit Defaults link. To use custom settings, clear this option and specify the options as described below.
Notification handler grace period: Specify a time period (in minutes) to wait from the event occurrence until the notification is triggered. Some events may trigger but last for a very short period of time. For example, a CPU usage can sharply jump above the specified threshold but quickly return to normal. For such events, it would probably make sense not to trigger the notification right away. This option allows you to specify the delay.
Notification interval: Specify the minimum time interval (in minutes) between the last and the next notification. Allows to prevent multiple notifications to be emailed to administrators in rapid succession (i.e. prevents spamming).
Send one notification and suspend further notifications until recovered: When this setting is enabled, a notification will be raised only once, and after that it will be suspended until the values monitored by the notification have recovered. For example, if the CPU usage is above the threshold for the whole day, instead of executing the notification handler multiple times, RAS would execute it only once.
When done, click OK to save the notification handler.
Please note that the mailbox should be configured in the RAS Console for the outgoing email functionality to work. This mailbox is usually set up when you run the RAS Console for the first time and then use the Start category to set up your RAS environment. You can also set up a mailbox as described in Configuring SMTP server connection for event notifications.
To enable or disable an event handler, select or clear the checkbox in the first column, or right-click an event and choose Enable or Disable. To modify a handler, right-click it and choose Properties. To delete a handler right-click and choose Delete.
You can create notification handlers for the following system events:
CPU utilization. Triggers when CPU utilization rises above or drops below a specified value.
Memory utilization. Triggers when memory utilization rises above or drops below a specified value.
Number of RDSH sessions. Triggers when the number of active sessions rises above or drops below a specified value.
Number of disconnected RDSH sessions. Triggers when the number of disconnected sessions rises above or drops below a specified value.
RDSH session utilization. Triggers when the number of RDSH sessions rises above or drops below a specified percentage of the maximum number of sessions.
RDSH disconnected sessions utilization. Triggers when the number of RDSH disconnected sessions rises above or drops below a specified percentage of the maximum number of sessions.
AVD session utilization. Triggers when the number of AVD sessions rises above or drops below a specified percentage of the maximum number of sessions.
AVD disconnected sessions utilization. Triggers when the number of disconnected AVD sessions rises above or drops below a specified percentage of the maximum number of sessions.
Number of gateway tunneled sessions. Triggers when the number of gateway tunneled sessions rises above or drops below a specified value.
Failed gateway tunneled sessions. Triggers when a connection between a gateway and a resource object cannot be established.
RAS Agents events. Triggers when an agent event occurs (e.g. agent disconnects or reconnects).
Licensing events. Triggers when a licensing event occurs. One notable event here is the license usage reaching a predefined threshold. Specifically, when the license usage reaches 90% of all available licenses, you will receive an email, so you have time to decide whether you have enough licenses or need to add more. Other events include license activation/deactivation, license expiration, grace period starting/ending, license information changes, problem communicating with the licensing server.
Authentication server events. Triggers when a connection issues occurs with an authentication server.
Published items events. Triggers when a published item event occurs (e.g. the concurrent instance limit for an application is reached).
Template events. Triggers when a VDI event occurs (e.g. a template is not found).
Tenant events. Triggers when a Tenant event occurs. For more info, see RAS Multi-Tenant Architecture > Configuring notifications.
Please also see the Notification Types table in the Configuring notification scripts section.