Backup and Restore Guide
This guide describes how to back up and restore Cogynt data.
Backing Up Data
Data backup methods are defined in the Cogynt cluster's environment manifest file (typically ia.env.yaml). For more information about the environment manifest file, refer to Configuring the Cogynt Delivery Tool in the Cogynt DevOps Guide.
Adding Backup Capabilities
Backup information is defined in the
backup section of the environment manifest file. This section is not included in the default ia.env.yaml that Cogility provides, and must be added manually.
To add backup capabilities, add the following lines to the environment manifest file:
eksRoleArnfor AWS deployments. Include
gcpServiceAccountfor GCP deployments. Do not use both fields at the same time.
backup fields are as follows:
enabled: Determines whether backup is enabled or not. For more information, see Enabling and Disabling Backup.
schedule: A cron expression that determines the frequency of backup operations. For more information, see Setting Backup Schedule.
backupBucket: Specifies the bucket where the data is backed up. For more information, see Setting Backup Buckets.
gcpServiceAccount: Determines the role that performs the backup. For more information, see Setting Backup Roles.
Enabling and Disabling Backup
After backup capabilites have been added, backup can be enabled or disabled by modifying the value of the
trueto enable backup.
falseto disable backup.
enabled is set to
true, backup proceeds according to the configuration defined by the remaining
backup fields. For more information, see Configuring Backup.
Configuring backup consists of defining three components:
- The backup schedule.
- The location (bucket) where the backup is stored.
- The cluster role that performs the backup.
The process to define each component is described in detail under the corresponding topic heading.
Setting Backup Schedule
schedule field determines the backup schedule. It accepts a cron expression between quotation marks (for example,
"30 3 * * 0").
Cron syntax consists of five fields, each indicating a specific time value. In Cogynt, the format is
"m H D M W", where:
mindicates the minute of the hour when backup occurs. The accepted range is
Hindicates the hour when backup occurs. The accepted range is
23, following 24-hour notation.
Dindicates the day of the month when backup occurs. The accepted range is
Mindicates the month when backup occurs. The accepted range is
Windicates the day of the week when backup occurs. The accepted range is
Do not leave any of the fields blank.
Standard cron operators, such as
*, may also be used.
For more information about cron syntax and operators, refer to the Linux Manual's crontab documentation.
Setting Backup Buckets
backupBucket field determines the location where backup data is stored.
The typical input follows the format
<CONNECTOR>indicates the type of connector to use. For AWS deployments,
s3is used. For GCP deployments,
<FOLDER>indicates the place in the Kubernetes cluster where the backup data should be saved (for example,
Setting Backup Roles
The backup role field (either
eksRoleArn for AWS deployments, or
gcpServiceAccount field for GCP deployments) determines the cluster role that performs the data backup.
eksRoleArn field input follows the syntax
arn:aws:iam::<ACCOUNT ID>:role/<NODE ROLE>, where:
<ACCOUNT ID>is a sequence of numerical digits indicating the AWS account ID. (This ID is used throughout the manifest file.)
<NODE ROLE>is the role that should perform data backup. Cogynt's Terraform scripts include a role that can be used for this purpose. However, any role or name can be used, including ones that customers make for themselves.
gcpServiceAccount field input is the service account name to use (for example,
The pod that performs the backup operations for the Cogynt cluster includes a restore script. The script can be manually run to restore the data from the backup bucket.
Since all Cogynt data is backed up in the bucket, individual pieces of data can be manually restored from it using the typical methods for Kubernetes cluster applications.
For assistance with restoring data, contact Cogility Support.