Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Backup JSA Configurations and Data

 

By default, JSA creates a backup archive of your configuration information daily at midnight. The backup archive includes your configuration information, data, or both from the previous day. You can customize this nightly backup and create an on-demand configuration backup, as required.

Scheduling Nightly Backup

Use the Backup Recovery Configuration window to configure a night scheduled backup process.

By default, the nightly backup process includes only your configuration files. You can customize your nightly backup process to include data from your JSA Console and selected managed hosts. You can also customize your backup retention period, backup archive location, the time limit for a backup to process before timing out, and the backup priority in relation to other JSA processes.

Note

To ensure optimum performance, it is a good idea not to schedule your nightly backup to run at the same time as JSA automatic updates.

The Backup Recovery Configuration window provides the following parameters:

Table 1: Backup Recovery Configuration Parameters

Parameter

Description

General Backup Configuration

Backup Repository Path

Type the location where you want to store your backup file. The default location is /store/backup. This path must exist before the backup process is initiated. If this path does not exist, the backup process aborts.

If you modify this path, make sure the new path is valid on every system in your deployment.

  • Active data is stored on the /store directory. If you have both active data and backup archives stored in the same directory, data storage capacity might easily be reached and your scheduled backups might fail. We recommend you specify a storage location on another system or copy your backup archives to another system after the backup process is complete. You can use a Network File System (NFS) storage solution in your JSA deployment. For more information on using NFS, see the Configuring Offboard Storage Guide.

Backup Retention Period (days)

Type or select the length of time, in days, that you want to store backup files. The default is 2 days.

This period of time only affects backup files generated as a result of a scheduled process. On-demand backups or imported backup files are not affected by this value.

Nightly Backup Schedule

Select a backup option.

Select the managed hosts you would like to run data backups:

This option is only displayed if you select the Configuration and Data Backups option.

All hosts in your deployment are listed. The first host in the list is your Console; it is enabled for data backup by default, therefore no check box is displayed. If you have managed hosts in your deployment, the managed hosts are listed below the Console and each managed host includes a check box.

Select the check box for the managed hosts you want to run data backups on.

For each host (Console or managed hosts), you can optionally clear the data items you want to exclude from the backup archive.

Configuration Only Backup

Backup Time Limit (min)

Type or select the length of time, in minutes, that you want to allow the backup to run. The default is 180 minutes. If the backup process exceeds the configured time limit, the backup process is automatically canceled.

Backup Priority

From this list box, select the level of importance that you want the system to place on the configuration backup process compared to other processes.

A priority of medium or high have a greater impact on system performance.

Data Backup

Backup Time Limit (min)

Type or select the length of time, in minutes, that you want to allow the backup to run. The default is 1020 minutes. If the backup process exceeds the configured time limit, the backup is automatically canceled.

Backup Priority

From the list, select the level of importance you want the system to place on the data backup process compared to other processes.

A priority of medium or high have a greater impact on system performance.

  1. On the navigation menu (), click Admin to open the admin tab.
  2. In the System Configuration section, click Backup and Recovery.
  3. On the toolbar, click Configure.
  4. On the Backup Recovery Configuration window, customize your nightly backup.
  5. Click Save.
  6. Close the Backup Archives window.
  7. On the Admin tab menu, click Deploy Changes.

Creating an On-demand Configuration Backup Archive

If you must back up your configuration files at a time other than your nightly scheduled backup, you can create an on-demand backup archive. On-demand backup archives include only configuration information.

You initiate an on-demand backup archive during a period when JSA has low processing load, such as after normal office hours. During the backup process, system performance is affected.

  1. On the navigation menu (), click Admin to open the admin tab.
  2. In the System Configuration section, click Backup and Recovery.
  3. From the toolbar, click On Demand Backup.
  4. Enter values for the following parameters:

    Option

    Description

    Name

    Type a unique name that you want to assign to this backup archive. The name can be up to 100 alphanumeric characters in length. The name can contain following characters: underscore (_), dash (-), or period (.).

    Description

    Type a description for this configuration backup archive. The description can be up to 255 characters in length.

  5. Click Run Backup.

    You can start a new backup or restore processes only after the on-demand backup is complete. You can monitor the backup archive process in the Backup Archives window.

Creating an Email Notification for a Failed Backup

To receive a notification by email about a backup failure on the JSA Console or a JSA Event Processor, create a rule that is based on the system notification message.

You must configure an email server to distribute system notifications in JSA. For more information, see Configuring your local firewallUse the local firewall to manage access to the JSA managed host from specific devices that are outside the network. When the firewall list is empty, access to the managed host is disabled, except through the ports that are opened by default..

If a backup fails, you see one of the following backup failure system notifications:

  • Backup: requires more disk space

  • Backup: last Backup exceeded execution threshold

  • Backup: unable to execute request

  1. Click the Offenses tab.
  2. In the Offenses pane, click Rules.
  3. Click Actions >New Event Rule.
  4. In the Rule Wizard, check the Skip this page when running this rules wizard box and click Next.
  5. In the filter box, type the following search query:

    when the event QID is one of the following QIDs

  6. Click the green add (+) icon.
  7. In the Rule pane, click the QIDs link.
  8. In the QID/Name field, type Backup:
  9. Select the following QIDs and click Add +:
    • Backup requires more disk space

    • Backup: last backup exceeded execution threshold

    • Backup unable to execute request

  10. Click Submit.
  11. In the Rule pane, type the following name for your rule test and click Next:

    Backup Failure

  12. In the Rule Response section, check the Email box and type the email addresses you want to notify.