topic Re: Notification rules, are they exportable ? in Qlik Replicate

Notification rules, are they exportable ?

Ole_Dufour — Fri, 20 Oct 2023 07:40:43 GMT

We wish to apply the same notification rules on different Qlik Replicate servers.

Can I export and import them ?

Thank you,

Ole

Re: Notification rules, are they exportable ?

OritA — Fri, 20 Oct 2023 07:47:39 GMT

Hi,

Yes, it is possible to export notification rules by indicating the include_server_settings option in the export command like in the following example:

[Replicate home]\Replicate\bin\repctl.exe exportrepository task=TASK_NAME include_server_settings=TRUE

Regards,

Orit

Re: Notification rules, are they exportable ?

SushilKumar — Sat, 21 Oct 2023 05:24:41 GMT

Hello team,

If our response has been helpful, please consider clicking "Accept as Solution". This will assist other users in easily finding the answer.

Regards,

Sushil Kumar

Re: Notification rules, are they exportable ?

Ole_Dufour — Mon, 23 Oct 2023 13:57:01 GMT

I can't find repctl.exe on the windows server. We are also using a Linux server, could the executable be found on that one ?
This is our Attunity directory :

Re: Notification rules, are they exportable ?

Dana_Baldwin — Wed, 25 Oct 2023 00:52:53 GMT

repctl.exe is part of a Replicate installation but your screen capture is for an installation of Enterprise Manager. There are API calls you can use to export tasks in Enterprise Manager: Qlik Enterprise Manager API guide | Qlik Enterprise Manager Help

Hope this helps!

Dana

Re: Notification rules, are they exportable ?

Ole_Dufour — Wed, 25 Oct 2023 13:46:24 GMT

Hi @Dana_Baldwin ,

I have exported a task via the API, according to the following doc :
https://help.qlik.com/en-US/enterprise-manager/May2023/Content/EnterpriseManager/EnterpriseManager_APIGuide/CurlAPI/api_exportTask.htm

Unfortunately the exported file does not include a Notification Rules section.
Does the repctl command on the Linux server include Notification Rules or is the format when exporting via the API? If the repctl command includes these Notification Rules, how should I run it ? The doc :
https://help.qlik.com/en-US/replicate/May2023/Content/Global_Common/Content/SharedEMReplicate/Design%20Tasks/Export_Tasks.htm
only mentions exporting via the user interface / Windows

Thank you,

Ole

Re: Notification rules, are they exportable ?

Dana_Baldwin — Thu, 26 Oct 2023 01:03:30 GMT

Hi @Ole_Dufour

I'm not sure if the API can use the "include_server_settings" parameter, but you can run the command directly on your Linux Replicate server.

Run the following command in the Replicate bin directory:

source ./arep_login.sh

Then run:

repctl -d data-directory exportrepository task=TASK_NAME include_server_settings=TRUE

If the <product_dir>\data folder was installed in a non-default location during the installation - OR - if it was later moved to a non-default location, you need to tell Replicate where the folder is located.

This is done by including the -d <data_folder> parameter in the command.

Example:

repctl -d D:\Data exportrepository task=mytask

Hope this helps!

Dana

Re: Notification rules, are they exportable ?

Heinvandenheuvel — Thu, 26 Oct 2023 21:09:18 GMT

Notifications are managed at server level, defined/filtered by task.

You need to used the ExportAll API and parse the output JSON for the Notification settings and select in there.

(and yes, in the example I happened to pick the notification name does not match the action 🙂

Hein.

Re: Notification rules, are they exportable ?

Ole_Dufour — Fri, 27 Oct 2023 14:18:14 GMT

Hi @Heinvandenheuvel

I have called the Export All api and confirm that the json file holds a notification section as a described in your answer.

I have some questions.

* Is it possible to export the current Notification rules ? The notification section in the downloaded json file only includes an example.

* How can this notification section be imported on other Replicate servers?
Can this be done using
https://help.qlik.com/en-US/enterprise-manager/May2021/Content/EnterpriseManager/EnterpriseManager_APIGuide/CurlAPI/api_importAll.htm ?

thank you, bon weekend,

Ole

Re: Notification rules, are they exportable ?

Heinvandenheuvel — Fri, 27 Oct 2023 14:25:33 GMT

You can trim down the JSON to just have the notifications in their normal downward path and ImportAll.

I just tested using REPCTL IMPORTREPOSITORY with the following JSON and it works for me, without restart

Hein.

// notification test. { "name": "Replication_Definition", "cmd.replication_definition": { "notifications": { "notifications_list": [{ "name": "Diskutilization_Over_150_GB", "on_condition": "$DISK_USAGE > 150000", "off_condition": "$DISK_USAGE < 100000", "audit_on_message": "[{{SERVER_NAME}}\\{{NOTIFICATION_NAME}}]{{TASK_NAME}} high disk usage {{DISK_USAGE}} MB.", "audit_off_message": "[{{SERVER_NAME}}\\{{NOTIFICATION_NAME}}]{{TASK_NAME}} normal disk usage {{DISK_USAGE}} MB.", "delivery_methods": [{ "on_message": "high disk usage{{TASK_NAME}} is {{MEMORY_USAGE}} MB.", "off_message": "normal disk usage {{TASK_NAME}} is {{MEMORY_USAGE}} MB.", "on_subject": "[{{SERVER_NAME}}\\{{NOTIFICATION_NAME}}] {{TASK_NAME}} high disk utilization", "off_subject": "[{{SERVER_NAME}}\\{{NOTIFICATION_NAME}}] {{TASK_NAME}} disk utilization back to normal" }], "ui_id": "NOTIFICATION_UI_ID_DISK_USAGE" }] } } }

Re: Notification rules, are they exportable ?

Ole_Dufour — Tue, 31 Oct 2023 14:17:24 GMT

Hi Hein,

can you please detail how to include "Servers" and "Tasks" in the json ?

Thank you,

Ole

Re: Notification rules, are they exportable ?

Heinvandenheuvel — Tue, 31 Oct 2023 14:31:10 GMT

Ah ok, you are talking AEM now (and Before, but I ignored that)

I'm not sure, I think the server vs tasks is in fact implied by the notification as such.

I think you can create an example, possibly in Replicate, on given server. Export that, and import (using AEM) to all servers. Of course you'd check for server specific details before blasting it out.

Hein.

Re: Notification rules, are they exportable ?

Ole_Dufour — Wed, 08 Nov 2023 11:20:12 GMT

Hi Hein,

I understand from your answer that it is impossible to use the Replicate API's listed here : https://help.qlik.com/en-US/enterprise-manager/May2023/Content/EnterpriseManager/EnterpriseManager_APIGuide/CurlAPI/aem_rest_api_intro.htm

According to previous posts in this thread, we'll need to go with the repctl command.
Since our installation path is not the default one, we'll need to include the data folder as a parameter when running repctl.

I'm having a hard time finding the data folder.

The below command :

find ~ -type d -name "*data*" -print

only returns directories names containing 'metadata' in their names.

Can you point me in the right direction?

Thanks for your time and your patience,

Ole

Re: Notification rules, are they exportable ?

Heinvandenheuvel — Wed, 08 Nov 2023 14:56:34 GMT

I expect you to be able to import notification rules using AEM ImportAll. - Did you try?

The data folder is a concept, not a name. The actual name used should be on the repctl commandline and in the startup scripts. Did you try ps -ef | grep repctl ?

Perhaps you started your find too low in the data folder itself?

Anyway, you may want to find mk.dat (file), databases (directory), imports (directory) or GlobalRepo.sqlite (file) as entities which will be in the data folder.

Check the file dates to make sure you are not looking at some stale copy.

Hein.