- Overview
- Requirements
- Installation
- Prerequisite checks
- Downloading the installation packages
- uipathctl cluster
- uipathctl cluster maintenance
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- uipathctl cluster upgrade
- uipathctl config
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- uipathctl config alerts
- uipathctl config alerts add-email
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- uipathctl config orchestrator
- uipathctl config orchestrator get-config
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- uipathctl health
- uipathctl health bundle
- uipathctl health check
- uipathctl health diagnose
- uipathctl health test
- uipathctl manifest
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- uipathctl manifest list-applications
- uipathctl manifest list-revisions
- uipathctl manifest render
- uipathctl prereq
- uipathctl prereq create
- uipathctl prereq run
- uipathctl resource
- uipathctl resource report
- uipathctl snapshot
- uipathctl snapshot backup
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- uipathctl version
- Post-installation
- Migration and upgrade
- Upgrading Automation Suite on EKS/AKS
- Step 1: Moving the Identity organization data from standalone to Automation Suite
- Step 2: Restoring the standalone product database
- Step 3: Backing up the platform database in Automation Suite
- Step 4: Merging organizations in Automation Suite
- Step 5: Updating the migrated product connection strings
- Step 6: Migrating standalone Orchestrator
- Step 7: Migrating standalone Insights
- Step 8: Deleting the default tenant
- B) Single tenant migration
- Migrating from Automation Suite on Linux to Automation Suite on EKS/AKS
- Monitoring and alerting
- Cluster administration
- Product-specific configuration
- Troubleshooting
Backing up the cluster
Before taking a backup, you must provide the objectstore configuration to store the backup. For this, see Configuring the backup store.
--schedule
and --retention
flags. By default, Automation Suite takes a backup every 45 minutes after starting and retains the last seven days of snapshots.
To enable the backup at the scheduled time, run the following command:
./uipathctl snapshot backup enable --schedule "*/45 * * * *" --retention 168h --prefix "mysnapshot"
./uipathctl snapshot backup enable --schedule "*/45 * * * *" --retention 168h --prefix "mysnapshot"
Running this command ensure that backups are taken in scheduled time intervals.
Flag |
Description |
---|---|
|
UNIX cron expression for schedule. This is only required if you want to enable a schedule backup. Default value is
"*/45 * * * *" , which means a backup is taken every 45 minutes.
|
|
Retention policy in the following duration format:
Hh:Mm:Ss . For example, 8h5m1s .
|
|
This will prefix the snapshot backups' names with the given string. This is only used if you want to enable a scheduled backup. The default value is a
snapshot. |
--schedule
parameter matches the time of the cluster node. We recommend syncing the cron expression with the scheduled backup of your
external data stores (such as SQL database and objectstore).
Note 2: Automation Suite stores only the snapshot backed up during the defined retention policy. If your retention policy has a shorter duration, you may lose essential snapshots once the retention policy applies. Similarly, if the retention policy is longer, more snapshots are stored, which may take up space on your objectstore.
Note 3: Carefully consider the schedule setup. Taking snapshots at small intervals (for example, every 30 minutes) implies frequent backup operations, forcing you to store the last 30 minutes' data. Similarly, taking snapshots once a week can cause data loss if a disaster occurs much later than the previous backup. Therefore, we strongly recommend synchronizing the backup schedule and the retention duration with your Recovery Point Objective (RPO) requirements.
To disable the scheduled backup, run the following command:
./uipathctl snapshot disable --prefix <prefix_name>
./uipathctl snapshot disable --prefix <prefix_name>
--prefix
parameter; however, if you did not configure any prefix while allowing the backup, provide a snapshot
as a prefix value.
To take an on-demand snapshot backup, run the following command:
./uipathctl snapshot backup create <snapshot_name>
./uipathctl snapshot backup create <snapshot_name>
The aforementioned command takes an optional flag:
Flag |
Description |
---|---|
|
Wait until the backup completes |
--wait
command, the command executes in the background. To view the status of your backup, check the snapshot list as described
in the following section.
To list all the present snapshots, their status, and the time at which they were taken, run the following command:
./uipathctl snapshot list
./uipathctl snapshot list
Sample output:
NAME STATUS CREATION EXPIRATION
manualbackup1 Completed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC
manualbackup2 PartiallyFailed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC
NAME STATUS CREATION EXPIRATION
manualbackup1 Completed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC
manualbackup2 PartiallyFailed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC
Deleting a backup consists of deleting the cluster metadata and the volume data from the backup storage server. This operation is irreversible.
To delete the snapshot backups from the backup store, run the following command:
./uipathctl snapshot delete <snapshot_name>
./uipathctl snapshot delete <snapshot_name>
You can retrieve the name of the snapshot that you want to delete by running the snapshot list command.
The command takes the following additional parameters:
Flag |
Description |
---|---|
|
Delete all snapshots. If selecting this option, then you do not need to provide the name of the snapshot. |
|
Forcibly delete the snapshot without confirmation. |