English Qlik Sense 3.2

Backing up a site manually

This section describes how to backup a Qlik Sense site in a default installation where a PostgreSQL database is used as the repository database.

The instructions in this section are only applicable to the central node of a Qlik Sense site.

See: Backing up and restoring a site

Items to backup

The following items need to be considered when backing up a site:

  • Repository database: The database contains all configuration data for the site.
  • Certificates for the Qlik Sense services: The certificates are used to encrypt the traffic between the services and the users. Make sure to backup the certificates in order not to lose any encrypted data (for example, passwords for data connections).
  • Log data
  • Application data: The data models in the Qlik Sense apps.
  • Any content that supports the apps (for example, QVD files)

See: Backing up and restoring certificates

Backing up a site with shared persistence

Proceed as follows to backup a Qlik Sense site with shared persistence:

  1. Make a backup of the certificates used to secure the Qlik Sense services. This only needs to be done once.
  2. See: Backing up certificates

  3. On all nodes of the site, stop all Qlik Sense services except the Qlik Sense Repository Database (QRD).
  4. Make a backup of the repository database. In a shared persistence deployment with the database on a dedicated machine, this needs to be performed on the database server, using the installation location that you selected.
    1. Open a Command Prompt with administrator privileges in Microsoft Windows.

    2. Produce a dumpfile for the repository database (that is, a single file for the entire database):
      1. Navigate to the installation location.

        Local database on the central node:

        cd "%ProgramFiles%\Qlik\Sense\Repository\PostgreSQL\<database version>\bin"

        Dedicated database server with default PostgreSQL install path:

        cd "%ProgramFiles%\PostgreSQL\9.3\data\bin"

      2. pg_dump.exe -h localhost -p 4432 -U postgres -b -F t -f "c:\QSR_backup.tar" QSR
      3. If you are prompted for the PostgreSQL super user password, enter the password that was given during the installation of Qlik Sense.

        To avoid being prompted for the password (for example, if you want to automate the Qlik Sense backup process), you can use the pgpass functionality in PostgreSQL. See the PostgreSQL documentation for more information.
      4. Make a backup of the dumpfile for the repository database.
  5. Make a backup of log and application data in the file share used for storage of log and application data.

  6. Make a backup of any locations where content that supports the Qlik Sense environment may be kept (for example, QVD files created by load scripts).
  7. Start the Qlik Sense services. If the services are started manually, start them in the following order:
    1. Qlik Sense Repository Service (QRS)

      If the user running Qlik Sense services is not local administrator on the machine, you need to start Repository.exe from an elevated command prompt using the -bootstrap parameter.

      See: Qlik Sense Repository Service

    2. Qlik Sense Proxy Service (QPS), Qlik Sense Engine Service (QES), Qlik Sense Scheduler Service (QSS), Qlik Sense Printing Service (QPR), and Qlik Sense Service Dispatcher (QSD) in no specific order

    The order is important because the QRS is dependent on the QRD and the rest of the services are dependent on the QRS.

Backing up a site with synchronized persistence

The procedure described in this section can also be performed using the Repository Snapshot Manager (RSM).

See: Using the Repository Snapshot Manager

See: Using the Repository Snapshot Manager

Proceed as follows to backup a Qlik Sense site:

  1. Make a backup of the certificates used to secure the Qlik Sense services. This only needs to be done once.
  2. See: Backing up certificates

  3. Stop all Qlik Sense services except the Qlik Sense Repository Database (QRD).
  4. Make a backup of the repository database.
    1. Open a Command Prompt with administrator privileges in Microsoft Windows.

    2. Produce a dumpfile for the repository database (that is, a single file for the entire database):
      1. Navigate to the installation location:
      2. cd "%ProgramFiles%\Qlik\Sense\Repository\PostgreSQL\<database version>\bin"

      3. pg_dump.exe -h localhost -p 4432 -U postgres -b -F t -f "c:\QSR_backup.tar" QSR
      4. If you are prompted for the PostgreSQL super user password, enter the password that was given during the installation of Qlik Sense.

        To avoid being prompted for the password (for example, if you want to automate the Qlik Sense backup process), you can use the pgpass functionality in PostgreSQL. See the PostgreSQL documentation for more information.
      5. Make a backup of the dumpfile for the repository database.
  5. Make a backup of log and application data in the following folders:

    • %ProgramData%\Qlik\Sense\Log
    • %ProgramData%\Qlik\Sense\Apps
    • %ProgramData%\Qlik\Sense\Repository\Content
    • %ProgramData%\Qlik\Sense\Repository\Extensions
    • %ProgramData%\Qlik\Sense\Repository\AppContent (if available)
  6. Make a backup of any locations where content that supports the Qlik Sense environment may be kept (for example, QVD files created by load scripts).
  7. Start the Qlik Sense services. If the services are started manually, start them in the following order:
    1. Qlik Sense Repository Service (QRS)

      If the user running Qlik Sense services is not local administrator on the machine, you need to start Repository.exe from an elevated command prompt using the -bootstrap parameter.

      See: Qlik Sense Repository Service

    2. Qlik Sense Proxy Service (QPS), Qlik Sense Engine Service (QES), Qlik Sense Scheduler Service (QSS), Qlik Sense Printing Service (QPR), and Qlik Sense Service Dispatcher (QSD) in no specific order

    The order is important because the QRS is dependent on the QRD and the rest of the services are dependent on the QRS.