This section describes Apinizer backup tasks. It is recommended that you periodically create a backup of Apinizer components, ie configuration and data, and ensure that recovery is performed in case of system failure. Backup and restore procedures allow you to restore the entire system (including all components) without affecting other parts of the system.

Apinizer keeps all configurations in MongoDB database. All other components do not need to be backed up as they run on kubernetes architecture. At any time, you can configure Apinizer's components by pulling them from the Image Repository.

In an on-premise distribution of Apinizer, you only need to back up the configuration database (MongoDB):

Apinizer works with Replicate Set MongoDB database. This should be taken into account when making a backup over the MongoDB server.

Make a Backup

A. From the Command Line

mongodump --host=yourMongodbIp --port=yourPort --authenticationDatabase admin --username apinizer --password Apinizer.1 --db apinizerdb --gzip --archive=/tmp/dump/apinizer-backup-2020-12-31-01.archive
POWERSHELL

If you don't want to include parts that may take up a lot of space, such as application logs or audit logs, they can be separated with the command: "–excludeCollection"

 --excludeCollection apinizer_log --excludeCollection audit_event

For detailed usage, MongoDB documents can be viewed at this address.

B. Via Apinizer

Instant backup can be made with the Start Backup button, or a recurring backup can be scheduled with the Create Job Schedule button.

This operation completely backs up MongoDB.

The picture below shows the MongoDB Backup settings:

The MongoDB Backup settings fields are shown in the table below.

Field

Description

Active

It must be activated in order to make a backup.

IP Address

The IP Address of the server where the MongoDB database is running.

SSH Port

The SSH Port of the server where the MongoDB database is running.

Username

The SSH username of the server where the MongoDB database is running.

Password

The SSH password of the server where the MongoDB database is running.

MongoDB Port

The port on which the MongoDB database is running.

MongoDB Username

The username of the MongoDB database.

MongoDB Password

The password for the MongoDB database.

Database

Database name where Apinizer configurations on MongoDB are kept. Default value: apinizerdb.

Backup Directory

Directory where Apinizer backups will be taken. Make sure that the SSH user has permission to write to the directory given here.

Backup Format

It is the information in which format the backups will be kept. It cannot be changed. Its default value is apinizer-backup-yyyy-MM-dd-HH.archive.

Action

  • Start Backup: When clicked, it starts the backup process according to the entered settings. Appears when there is no job schedule set. If there is a set job schedule, it is started over the job schedule.
  • Create Trigger Every: Used to create a job schedule. In this way, the backup process can be triggered by itself at desired intervals.
Tables to exclude from backupCollections selected from the list of all MongoDb collections owned by Apinizer are not backed up.