Question

Is it expected that end customer's staff members receive notifications in form of emails on successful failover of virtual environments (and other OACI-related notifications)? How can it be disabled?


Answer

This behaviour is considered by designed. Modification of such message is described in Configuring VPS Notifications part of OACI guide. However, it is not possible to disable/enable OACI notifications from Control Panel. The procedure is described below.

How to disable an OACI notification template:

  1. Log in to the Management Node
  2. Get APS resource of MessengerManager:
    # curl -X GET -k -E /usr/local/pem/APS/certificates/poa.pem 'https://127.0.0.1:6308/aps/2/resources?implementing(http://www.parallels.com/pa/pa-core-services/messenger-manager)' | python -m json.tool
[
    {
        "aps": {
            "id": "53943bcb-5256-42e4-b688-2fedc011ca67",
            "modified": "2019-11-25T04:48:26Z",
            "revision": 41,
            "status": "aps:ready",
            "type": "http://www.parallels.com/pa/pa-core-services/1.2"
        }
    }
]
  3. Get all email notification templates and find the necessary one ("Server failover succeeded" in this case):
    # curl -X GET -k -E /usr/local/pem/APS/certificates/poa.pem 'https://127.0.0.1:6308/aps/2/resources/53943bcb-5256-42e4-b688-2fedc011ca67/messenger/messagetypes' | python -m json.tool
[
...
    {
        "description": "Server failover within the cluster succeeded",
        "id": 72,
        "name": "Server failover succeeded",
        "subscribeByDefault": false
    },
...
]
  4. Delete the template using the "id" value from the previous step:
    curl -X DELETE -k -E /usr/local/pem/APS/certificates/poa.pem 'https://127.0.0.1:6308/aps/2/resources/53943bcb-5256-42e4-b688-2fedc011ca67/messenger/messagetypes/72'


How to enable an OACI notification template:

  1. Log in to the Management Node
  2. Create a .json file with the following content:
    {
  "name" : "Server failover succeeded",
  "description" : "Server failover within the cluster succeeded",
  "templates" : [ {
    "subject" : "\"${veName}\" server failover succeeded",
    "body" : "\n\t\t\t\t\tDear ${recipient_first_name} ${recipient_last_name},\n\n                    \"${veName}\" server failover within the cluster of the subscription #${sub
scriptionId} is completed successfully.\n\t\t\t\t"
  } ],
  "subscribeByDefault" : false
}
  3. Re-create the message type deleted by "How to disable an OACI notification template" instructions using the same APS resource ID:
    curl -X POST  -k -E /usr/local/share/PACI-aps/paci.pem -H "Content-Type: application/json" 'https://127.0.0.1:6308/aps/2/resources/53943bcb-5256-42e4-b688-2fedc011ca67/messenger/messagetypes' -d @msg.json


To learn more on MessengerManager, check this piece of documentation.