Running the Backup Utility on Windows or Linux

As a best practice, run the backup process on all machines with web protection components within a 30-minute time window. This may include:
  • Forcepoint appliances (see How do I back up and restore Forcepoint appliances?)
  • The Forcepoint management server

    Note that on the management server, you need to run both the Backup Utility for your web protection product, as described in this section, and the backup procedure for the management infrastructure components, as described in How do I back up and restore the Forcepoint management infrastructure?.

  • Content Gateway (see How do I back up and restore Content Gateway?).

When restoring a previous configuration, restore all machines using backup files created in the same 30-minute window.

To run the Backup Utility on your Windows or Linux servers (excluding machines that host Content Gateway):

Steps

  1. Make sure that all administrators are logged off of the Forcepoint Security Manager.
  2. Do one of the following:
    • (Windows) Navigate to the bin directory (C:\Program Files or Program Files (x86)\Websense\Web Security\bin\).
    • (Linux) Navigate to the bin directory (/opt/Websense/bin/) and enter the following command:
      export LD_LIBRARY_PATH=.
  3. To run an immediate backup, enter the appropriate command for your operating system.
    Windows:
    wsbackup -b -d <directory>
    Linux:
    ./wsbackup -b -d <directory>
    Here, <directory> indicates a local or remote destination directory for the backup archive.
    Warning:

    Do not store backup files in your product’s \bin directory.

    This directory is deleted if you uninstall your software.

  4. To schedule the backup process to run on a regular basis, use the following command.
    • Windows:
      wsbackup -s -t "<m> <h> <day_of_month> <month> <day_of_week>" -d <directory>
      Important: There is an additional, important step that must be completed for scheduled backups to be created properly on Windows servers. After completing this procedure, continue with Enabling scheduled backups on Windows servers.
    • Linux:
      ./wsbackup -b -s -t \"<m> <h> <day_of_month> <month>
      <day_of_week>\" -d <directory>
      For example, to schedule a backup to run at 10:10 a.m. on Sundays:
      ./wsbackup -s -t "10 10 * * 0"

      Here, the backup is scheduled to run at 10:10 a.m. on Sundays (regardless of the month or date).

      Scheduled backup commands use crontab format, and the quotation marks and spaces are required.

      In place of the variables shown in the example, provide the following information:
      Variable Information
      <m>

      0 - 59

      Specify the precise minute to start the backup.

      <h>

      0 - 23

      Specify the general hour of the day to start the backup.

      <day_of_month>

      1 - 31

      Specify the date to perform the backup. If you schedule a backup for days 29 - 31, the utility uses the standard substitution procedure for the operating system in months that do not include that date.

      <month>

      1 - 12

      Specify the month to perform the backup.

      <day_of_week>

      0 - 6

      Specify a day of the week. 0 represents Sunday.

      Each field can take a number, an asterisk, or a list of parameters. Refer to any crontab reference for details.

    After running an immediate backup, or after the scheduled backup process has completed successfully, the WebsenseBackup.cfg file is created in the backup directory. Use this file to configure how long backup files are retailed. See Configuring how long backup files are stored.