Enabling health check alerts for Email Notifications
Follow these steps to enable health check alerts from the IBM® MaaS360® Portal for the Cloud Extender® Email Notification module.
Before you begin
This feature is available for Cloud Extender MEG Module 2.86 or later only.
Procedure
- From the IBM MaaS360 Portal Home page, select Setup > Cloud Extender Settings.
- Select Health Check Configuration > Email Notifications. The Email Notification Service Alerting list is displayed.
- From the list, enable the alerts that apply to your environment.
If you set an alert subscription to Critical Only, the Cloud Extender sends an email message or a text message to the administrator for all alerts that are marked as Critical.The following table provides a description of each alert and the steps you take to remediate the alert:
Alert name Alert description Remediation steps Auto discovery failure The auto discovery process failed for a specific mailbox. The Cloud Extender uses the auto discovery process to evaluate the subscription URL for a specific mailbox. The Cloud Extender resubscribes users for email notifications once each day. This alert indicates that the resubscription process failed for the user %email%. - Check whether the EWS URL that is configured for the Cloud Extender is still valid and reachable from a browser on the Cloud Extender server.
- Check whether the user's mailbox is still active on your Exchange server.
- Check whether the user's mailbox is on a mailbox server that is configured in the Email
Notification settings. Note: If mailbox filtering is not set up on the Cloud Extender, you cannot use this option.
- Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to run a Test action on the Email Notification configuration for the affected mailbox.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Auto discovery time out The auto discovery process is taking more than 3 minutes to complete on a specific mailbox. The Cloud Extender resubscribes users for email notifications once each day. This alert indicates that the resubscription process did not complete within the expected timeframe. - Check whether the EWS URL that is configured for the Cloud Extender is still valid and reachable from a browser on theCloud Extender server.
- Verify that the EWS URL resolves to a regional server to minimize latency.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Unable to connect to server The Cloud Extender cannot connect to the EWS URL because of an SSL/TLS handshake error. - Verify that your EWS URL uses the correct SSL certificate.
- Install the EWS server certificate on the certificate store (machine store) for your Cloud Extender server.
- Access your EWS URL from a browser on theCloud Extender server to verify that you do not receive a server certificate validation error.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Unable to subscribe for a user Service account authentication failure The Cloud Extender cannot connect to the EWS URL because of an authentication failure with a connection to the configured service account. - Check whether all listener accounts that are configured on the Cloud Extender are enabled or use valid passwords.
- Reset passwords for one or more affected service accounts and reconfigure your Cloud Extender with the updated credentials.
- Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to run a Test action on the Email Notification configuration.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Unable to subscribe to mailboxes The email notification subscription failed for a specific user. The user cannot receive email notifications for iOS Secure Email. - Check whether the user's mailbox is still active on your Exchange server.
- Check whether the user's mailbox is on a mailbox server that is configured in the Email Notification settings. Note: If mailbox filtering is not set up on the Cloud Extender, you cannot use this option.
- Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to run a Test action on the Email Notification configuration for the affected mailbox.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Unable to receive notifications The Cloud Extender is experiencing mailbox subscription failure (more than 50% of the retry queue is full). The Cloud Extender is experiencing failures with email notification subscriptions for multiple mailboxes. - Verify that your Exchange environment is not undergoing maintenance.
- Check whether the EWS URL that is configured for the Cloud Extender is still valid and reachable from a browser on the Cloud Extender server.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Service account throttling timeout The service account is experiencing throttling, which is causing requests to take more than 20 minutes to complete. The Exchange server is repeatedly rejecting requests from a service account. One or more service accounts might be throttled. - Check whether your Exchange server is overloaded and unable to process notification requests.
- Check the throttling policies on your Exchange and evaluate whether to adjust limitations to accommodate Cloud Extender email notification requests.
- Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to add service accounts to distribute the load among all service accounts.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Subscription limit reached The Cloud Extender cannot add more mailboxes for subscription. The Cloud Extender reached the limit for email notification subscriptions. The Cloud Extender is subscribed to the maximum number of mailboxes for the configured service accounts. New users who enroll with Secure Mail cannot subscribe to email notifications. - Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to add service accounts to continue with subscriptions.
- If you reach the maximum number of configurable service accounts on one Cloud Extender, install a new Cloud Extender (requires Advanced configuration with mailbox server filtering) to continue with new subscriptions. Note: Use this option with the on-premises version of Exchange only.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
Server not reachable The Cloud Extender cannot connect to the EWS URL because the EWS URL is unavailable or issues with network connectivity. - Check whether the EWS URL that is configured for the Cloud Extender is still valid and reachable from a browser on the Cloud Extender server.
- Use the Cloud Extender Configuration Tool in the IBM MaaS360 Portal to run a Test action on the Email Notification configuration for the affected mailbox.
- If this issue continues, collect logs from the Cloud Extender, and then contact IBM Support for further assistance.
- Publish the Cloud Extender settings to activate the alerts.