Static build of the CLI tools

OADP-VMDP User Guide

Install oadp-vmdp CLI

Download pre-built static tool

# Choose one for your architecture

# X86
$ wget https://github.com/mpryc/kopia/releases/download/oadp-vmdp-static/oadp-vmdp-linux-amd64
$ chmod +x oadp-vmdp-linux-a??64
$ sudo mv oadp-vmdp-linux-amd64 /usr/local/bin/oadp-vmdp

# ARM64
$ wget https://github.com/mpryc/kopia/releases/download/oadp-vmdp-static/oadp-vmdp-linux-arm64
$ chmod +x oadp-vmdp-linux-a??64
$ sudo mv oadp-vmdp-linux-arm64 /usr/local/bin/oadp-vmdp

Prerequisites

Your administrator should have provided you with:

• S3 bucket name
• S3 endpoint URL
• Access key ID
• Secret access key

First-Time Setup: Connect to Your Backup Storage Location

Before creating backups, you need to connect to your backup storage location.
Run this command once:

oadp-vmdp bsl create s3 \
  --bucket=YOUR_BUCKET_NAME \
  --endpoint=YOUR_S3_ENDPOINT \
  --access-key=YOUR_ACCESS_KEY \
  --secret-access-key=YOUR_SECRET_KEY

You'll be prompted to set a password. Remember this password - you'll need it to restore your backups.

Creating a Backup

To backup a folder or file:

oadp-vmdp backup create /path/to/folder

Examples:

# Backup your home directory
oadp-vmdp backup create /home/myuser

# Backup specific folders
oadp-vmdp backup create /home/myuser/documents /home/myuser/photos

# Backup a single file
oadp-vmdp backup create /home/myuser/important-file.txt

Listing Your Backups

To see all your backups:

oadp-vmdp backup list

To see backups of a specific folder:

oadp-vmdp backup list /path/to/folder

Restoring Files from a Backup

To restore files to their original location:

oadp-vmdp backup restore /path/to/folder

To restore to a different location:

oadp-vmdp restore /path/to/folder --target=/path/to/restore/location

Examples:

# Restore your documents folder
oadp-vmdp backup restore /home/myuser/documents

# Restore to a different location
oadp-vmdp restore /home/myuser/documents --target=/tmp/restored-docs

# Restore a specific file
oadp-vmdp backup restore /home/myuser/important-file.txt

Connecting to an Existing Backup Storage Location

If you already created a backup storage and need to reconnect (e.g., after a reboot):

oadp-vmdp bsl connect s3 \
  --bucket=YOUR_BUCKET_NAME \
  --endpoint=YOUR_S3_ENDPOINT \
  --access-key=YOUR_ACCESS_KEY \
  --secret-access-key=YOUR_SECRET_KEY

Enter the password you set during repository creation.

Disconnecting from Backup Storage Location

When you're done:

oadp-vmdp bsl disconnect

Common Tips

• Backup regularly: Schedule regular backups of your important folders
• Test your restores: Occasionally test restoring to make sure your backups work
• Keep your password safe: Without it, you cannot restore your backups
• Check backup status: Use oadp-vmdp bsl status to verify your connection

Need Help?

For more options and advanced features:

oadp-vmdp --help
oadp-vmdp backup --help
oadp-vmdp restore --help

oadp-bsls-static-cli

Merge pull request #23 from Lyndon-Li/v0.19.0-velero-patch

refactor(general): Cherry pick Velero patch to 0.19.0

oadp-static-binary

Merge pull request #23 from Lyndon-Li/v0.19.0-velero-patch

refactor(general): Cherry pick Velero patch to 0.19.0