Configuring Applications for the Restorepoint SyncPack

Download this manual as a PDF file

This section describes how to configure SL1 and PowerFlow so you can use the PowerFlow applications in the "Restorepoint" SyncPack.

Workflow for Configuring SL1 and PowerFlow

The following workflows describe how to configure SL1 and PowerFlow to work with the "Restorepoint" SyncPack:

Configuring SL1

  1. Create an SSH credential for discovering devices
  2. Align the "Restorepoint Connectivity" Dynamic Application with the SL1 devices you want to add to Restorepoint

Configuring PowerFlow

  1. Use the "Restorepoint Base Config" file to create a configuration object
  2. Obtain the API Token in Restorepoint
  3. Configure the "Restorepoint: Sync Devices" application
  4. Configure the "Restorepoint: Get the List of Logs from Restorepoint" application
  5. Configure the "Restorepoint: Get list of credentials from SL1" application
  6. Schedule PowerFlow applications

Configuring SL1

The following topics cover how to set up your SL1 instance to work with the "Restorepoint" SyncPack.

Creating an SSH Credential for Discovering Devices

In SL1, you will need to create an SSH credential for the devices that you want to discover and add to Restorepoint. You will then need to use this credential to manually align the "Restorepoint Connectivity" Dynamic Application, which is used when you discover a device and add it to Restorepoint.

If needed, create a new organization in SL1 for the device you want to discover. For more information, see Creating and Editing Organizations.

To create an SSH/Key credential:

  1. Go to the Credentials page (Manage > Credentials or System > Manage > Credentials in the classic user interface).
  2. Click the Create New button and then select Create SSH/Key Credential. The Edit Credential modal page appears.

  1. Complete the following fields:
  • Name. Name of the credential. Can be any combination of alphanumeric characters.
  • All Organizations. Toggle on (blue) to align the credential to all organizations, or toggle off (gray) and then select one or more specific organizations from the What organization manages this service? drop-down field to align the credential with those specific organizations.
  • Timeout (ms). Time, in milliseconds, after which SL1 will stop trying to communicate with the device from which you want to retrieve data. The default is 1500.
  • Hostname/IP. Hostname or IP address of the device you want to discover.
    • You can include the variable %D in this field. SL1 will replace the variable with the IP address of the current device (device that is currently using the credential).
    • You can include the variable %N in this field. SL1 will replace the variable with hostname of the current device (device that is currently using the credential). If SL1 cannot determine the hostname, SL1 will replace the variable with the primary, management IP address for the current device.
  • Port. Port number associated with the data you want to retrieve. The default TCP port for SSH servers is 22. The protocol attribute of your device in Restorepointis set based on the port specified in this credential. If the port is 23, the attribute is set to telnet/tftp. For all other ports, the attribute is set to ssh/tftp.
  • Username. Username for an SSH or user account on the device to be monitored. Make sure that this user has the permissions necessary to query the credentials from SL1.
  • Password. Password for an SSH or user account on the device to be monitored.
  • Private Key (PEM Format). Leave this field blank.
  1. Click Save. You will use this new credential in the following procedure, when you align the "Restorepoint Connectivity" Dynamic Application with the SL1 device.

Align the "Restorepoint Connectivity" Dynamic Application with SL1 Devices

You will use your new credential to manually align the "Restorepoint Connectivity" Dynamic Application to one or more SL1 devices so you can add (or "onboard") those devices to Restorepoint.

To align the "Restorepoint Connectivity" Dynamic Application:

  1. Go to the Devices page in SL1 and select the device you want to add to Restorepoint. The Device Investigator page appears.
  2. On the Collections tab, click Edit and then click Align Dynamic Application. The Align Dynamic Application window appears.
  3. Click Choose Dynamic Application. The Choose Dynamic Application window appears.
  4. Search for the "Restorepoint Connectivity" Dynamic Application, select it, and click Select. The Dynamic Application now appears in the Align Dynamic Application window.
  5. Uncheck the box next to Use Device SNMP Credential and click Choose Credential. The Choose Credential window appears.
  6. Select the credential for that device (from the previous procedure) and click Select . The name of the selected credential now appears in the Align Dynamic Application window.
  7. Click Align Dynamic App. When the Dynamic Application is successfully aligned, it is added to the Collections tab, and a confirmation message appears at the bottom of the tab.
  8. Repeat these steps for every device you want to add to Restorepoint.

The next time you discover a device in SL1 and run the "Restorepoint: Sync Devices" application in PowerFlow, any devices you discovered in SL1 that are aligned with the "RestorepointConnectivity" Dynamic Application get added to Restorepoint. Those devices are also part of the Restorepoint Device Group.

Configuring PowerFlow

The following topics cover how to set up your PowerFlow instance to work with the "Restorepoint" SyncPack.

Creating a Configuration Object in PowerFlow

For this SyncPack, you can make a copy of the "Restorepoint Base Config" configuration object, which is the sample configuration file that was installed with the "Restorepoint" SyncPack.

The "Restorepoint Base Config" configuration object contains all of the required variables. Simply update the variables from that object to match your SL1 and Restorepoint settings.

To create a configuration object based on the "Restorepoint Base Config" configuration object:

  1. In the PowerFlow user interface, go to the Configurations page ().
  2. Click the Actions button () for the "Restorepoint Base Config" configuration object and select Edit. The Configuration pane appears.
  1. Click Copy as. The Create Configuration pane appears.
  2. Complete the following fields:
    • Friendly Name. Name of the configuration object that will display on the Configurations page.
    • Description. A brief description of the configuration object.
    • Author. User or organization that created the configuration object.
    • Version. Version of the configuration object.
  1. In the Configuration Data field, update the default variable definitions to match your PowerFlow configuration:
    • sl1_url. Type the URL for your associated SL1 system.
    • sl1_user. Type the username for your SL1 system. Make sure this user has the permissions necessary to query the credentials from SL1.
    • sl1_password. Type the password for your SL1 system.
    • sl1_db_host. Type the URL for your associated SL1 database.
    • sl1_db_user. Type the username for your SL1 database.
    • sl1_db_password.Type the password for your SL1 database.
    • restorepoint_url. Type the URL for your associated Restorepoint system.
    • restorepoint_api_token. Type the API token for your Restorepoint system. See the Obtaining the API Token in Restorepoint section for steps on getting the token.
    • default_restorepoint_device_type. Type the default device type for your Restorepoint system.
    • default_backup_interval. Type the default time for the Backup Interval for your Restorepoint device. The value for the default_backup_interval field uses the following format: second minute hour * * * * @0@@0@0. The default value for version 2.1.0 is 0 15 * * * * *
    • create_custom_link. Type a value to create an optional custom link from SL1 to Restorepoint. If you are running SL1 platform version 10.2.0 or later and have custom links enabled, you can set the value to 1 to automatically add the custom link definition for Restorepoint. The default value is False/0.
    • restorepoint_ui_url. Type an optional user access URL that is different than the Restorepoint URL that is used to integrate with PowerFlow.
    • restorepoint_config. Type Enable or Disable to allow device change detection. The restorepoint_config feature requires SL1 platform version 11.2.0 or later. If you are using an earlier version of SL1, this field should always be set to its default value: Disable.
    • timestamp. The "Restorepoint: Get List of Credentials" application queries SL1 for updated credentials and stores the last time that SL1 was queried. Type a value that specifies the number of hours for the application to query SL1 for updated credentials, if no previous time stamp is available (e.g. the first execution of the application). The application will update the credentials in Restorepoint that have been updated in SL1 within the specified number of hours.
    • default_monitoring_monitor_device. Type True or False to enable or disable device monitoring. The default value is True.
    • default_monitoring_fail_after. Type how many failed attempts to onboard a device before PowerFlow will stop attempting to discover the device.
    • default_monitoring_is_ping_type. Type True or False to enable or disable ICMP ping rather than TCP connection. The default value is True.
    • default_monitoring_email_when_down. Type True or False to enable or disable sending an email when the device is down. The default value is False.
    • default_monitoring_email_when_up. Type True or False to enable or disable sending an email when the device is back up. The default value is True.

  2. The other optional values in the Configuration Data field require JSON code to edit their values. Click Toggle JSON Editor to show the JSON code.

  3. In the Configuration Data field, be sure to include the required block of code to ensure that the applications aligned to this configuration object do not fail:

    {
   "encrypted": false,
   "name": "<sl1_db_host>",
   "value": "${<config.sl1_host>}"
}

    For example:

    {
   "encrypted": false,
   "name": "sl1_db_host",
   "value": "10.2.11.42"
}
  1. To create a configuration variable, define the following keys:
    1. encrypted. Specifies whether the value will appear in plain text or encrypted in the JSON file. If you set this to "true", when the value is uploaded, PowerFlow encrypts the value of the variable. The plain text value cannot be retrieved again by an end user. The encryption key is unique to each PowerFlow system. The value is followed by a comma.
    2. name. Specifies the name of the configuration file, without the JSON suffix. This value appears in the user interface. The value is surrounded by double-quotes and followed by a comma.
    3. value. Specifies the value to assign to the variable. The value is surrounded by double-quotes and followed by a comma.
  1. Click Save. You can now align this configuration object with one or more applications.

Obtaining the API Token in Restorepoint

The following procedure is relevant for Restorepoint 5.4.0 and later.

To obtain your API token for the restorepoint_api_token Configuration Data field:

  1. In Restorepoint, go to the Users page (Administration > Users) and click the API Tokens tab.
  2. Click Add Token and give the token a new description.
  3. Copy and paste the token into the restorepoint_api_token Configuration Data field for the Restorepoint configuration object.

Configuring the "Restorepoint: Sync Devices" Application

The next time you discover a device in SL1 and run the "Restorepoint: Sync Devices" application, any devices you discovered in SL1 that are aligned with the “Restorepoint Connectivity" Dynamic Application get added to Restorepoint. Those devices are also part of the Restorepoint Device Group.

If you include the SSH or telnet credential you created earlier in a discovery session, the "Restorepoint Connectivity" Dynamic Application is automatically aligned. Optionally, you can manually align the Dynamic Application with your devices using the credential. Based on the Dynamic Application alignment, the device is also automatically included in a Restorepoint Device Group. For more information about discovering a device in SL1, see  Discovery and Credentials.

To run the "Restorepoint: Sync Devices" application:

  1. Go to the Applications page and select the "Restorepoint: Sync Devices" application.
  2. Click the Configuration button. The Configuration pane appears.
  3. In the Configuration drop-down, select the configuration object you created earlier.
  4. In the restorepoint_config field, select Enable or Disable to allow device change detection. You should select the same value you entered in the selected configuration object. This option requires SL1 platform version 11.2.0 or later. If you are using an earlier version of SL1, this field should always be set to its default value: Disable
  5. Update the remaining fields as needed, and then click Save.
  6. Click the Run button. The following actions occur:
  • If the SL1 organization exists as a domain in Restorepoint, the device is added to that domain. Otherwise, a new domain is created in Restorepoint that maps to the SL1 organization.
  • If needed, a new credential is created in Restorepoint that maps to the new SL1 credential.
  • A new device is added in Restorepoint that maps to the new device in SL1 :
  • The device is associated with the appropriate domain and credential.
  • The device is associated with an agent that maps to the SL1 Data Collector monitoring that device, using a pre-defined mapping from the "Restorepoint Base Config" configuration object.
  • The device is configured with a plugin that maps to the SL1 Device Class for that device, using a pre-defined mapping from the "Restorepoint Base Config" configuration object.

When a device is synced between SL1 and Restorepoint, you can click the Tools button on the Device Investigator page in SL1 for that synced device and click a custom "Restorepoint" link. That link takes you to the Device Details page for that device in Restorepoint. You can also view automation actions for an event on a synced device in SL1 to view detailed logs about the event.

Configuring the "Restorepoint: Get the List of Logs from Restorepoint" Application

The "Restorepoint: Get the List of Logs from Restorepoint" application queries the Restorepoint API to collect backup success and failure logs from Restorepoint. These logs are also synced to SL1. You can use PowerFlow to compare the logs to make sure the backups ran successfully in Restorepoint.

To run the "Restorepoint: Get the List of Logs from Restorepoint" application:

  1. Go to the Applications page and select the "Restorepoint: Get the List of Logs from Restorepoint" application.
  2. Click the Configuration button. The Configuration pane appears.
  3. In the Configuration drop-down, select the configuration object you created earlier.
  4. In the restorepoint_config field, select Enable or Disable to allow device change detection. You should select the same value you entered in the selected configuration object. This option requires SL1 platform version 11.2.0 or later. If you are using an earlier version of SL1, this field should always be set to its default value: Disable
  5. Update the remaining fields as needed, and then click Save.
  6. Click the Run button.

You should configure this application to run on a schedule, such as once a week or more if you frequently back up devices in Restorepoint. For more information, see Scheduling PowerFlow Applications.

Configuring the "Restorepoint: Get list of credentials from SL1" Application

The "Restorepoint: Get list of credentials from SL1" application queries SL1 for existing credentials and matches them against credentials in Restorepoint. If there is a change to the credential in SL1 and the credential exists in Restorepoint, the credential is updated with the new information.

To run the "Restorepoint: Get list of credentials from SL1" application:

  1. Go to the Applications page and select the "Restorepoint: Get list of credentials from SL1" application.
  2. Click the Configuration button. The Configuration pane appears.
  3. In the Configuration drop-down, select the configuration object you created earlier.
  4. Update the remaining fields as needed, and then click Save.
  5. Click the Run button.

You should configure this application to run on a schedule, such as once a week. For more information, see Scheduling PowerFlow Applications.

Scheduling PowerFlow Applications

You can create one or more schedules for a single application in the PowerFlow user interface. When creating each schedule, you can specify the queue and the configuration file for that application.

To schedule an application:

  1. On the Applications page (), click the Schedule button for the application you want to schedule. The Scheduler window appears.

  2. In the Schedule List pane, click the down arrow icon () next to an existing schedule to view the details for that schedule.

  3. In the Schedule Creator pane, complete the following fields for the default Frequency setting:

  • Schedule Name. Type a name for the schedule.
  • Frequency in seconds. Type the number of seconds per interval that you want to run the application.
  • Custom Parameters. Type any JSON parameters you want to use for this schedule, such as information about a configuration file or mappings.

  1. To use a cron expression, click the Switch to Cron Expression toggle to turn it blue. If you select this option, you can create complicated schedules based on minutes, hours, the day of the month, the month, and the day of the week:

    As you update the cron expression, the Schedule window displays the results of the expression in more readable language, such as Runs app: "Every 0 and 30th minute past every hour on Sat", based on 0,30 in the Minutes field and 6 in the Day of Week field.

  1. Click Save Schedule. The schedule is added to the Schedule List pane. Also, on the Applications page, the Schedule button now displays with a dark blue background:

After you create a schedule, it continues to run until you delete it. Also, you cannot edit an existing schedule, but you can delete it and create a similar schedule if needed.

To view or delete an existing schedule:

  1. On the Applications page, click the Schedule button for the application that contains a schedule you want to delete. The Scheduler window appears.
  2. Click the down arrow icon () to view the details of an existing schedule.
  3. To delete the selected schedule, click the Actions icon () and select Delete.

On the Scheduler window for a PowerFlow application, you can click the Copy as button from the Schedule List pane to make a copy of an existing schedule.