PSOciBootBackup Boot Volume Backup

PS> Get-PSOciBootVolume

1. gpg is used to decrypt the ssh keys needed to start a ssh session with myhost1

2. Next a new terminal instance is created and a ssh session is opened to myhost1

3. The presented commands are then executed to shutdown BTCPAY server.

4. The Enter key is pressed to continue the backup process.

1. The boot volume backup process is performed.

2. The decrypted files are removed.

3. If the -keep option is not specified, the prior boot volume backup is removed.

4. BTCPAY server docker processes are started on myhost1

BTCPay ListChannels can be executed to validate that the BTCPAY server processes are running.

PS> Get-PSOciBootVolume -listonly

Existing boot volume backups are listed with the option to remove each as desired.

PS> Get-Help Get-PSOciBootBackup

PS> Get-Help Get-PSOciBootBackup -Full

PS> Get-Help Get-PSOciBootBackup -Examples

Click this link for download and install instructions

Oracle Cloud Infrastructure(OCI) Modules for PowerShell is a set of cmdlet modules that can be used with PowerShell Core to manage Oracle Cloud Infrastructure resources. You can invoke these cmdlets from the PowerShell command-line and with the associated PowerShell scripting language.

The project is open source and maintained by Oracle Corp.

Instructions for installing OCI.PSModule.Core

The directory $HOME/.oci should now exist and the file config should be configured with the correct details.

Configuration file example $HOME/.oci/config
            
[DEFAULT]
user        = [your ocid1.user.oc1...]
fingerprint = [your fingerprint]
tenancy     = [your ocid1.tenancy.oc1...]
region      = [your region]
key_file    = [your private key $HOME/.oci/oci_api_key.pem]
pass_phrase = [your private key pass phrase]

Click this link to download the script

Copy the script to a directory named, $HOME/ps for instance and ensure this system path environment variable references this path.

The other option is to cd directly to the path and execute the script.

PS> cd <to script location>
PS> ./Get-PSOciBootVolume

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OCIinstances>
<instance displayname="myhost1">
    <compartmentId>ocid1.tenancy.oc1..dddddddd6xdoxrnz6fd7ef2ieiwx7wglkcufxml263kjptrc57bqp3bxyhyq</compartmentId>
</instance>
<instance displayname="myhost2">
    <compartmentId>ocid1.tenancy.oc1..bbbbbbbb6xdoxrnz6fd7ef2ieiwx7wgltxxxxbm263kjptrc57bqp3b12345</compartmentId>
</instance>
</OCIinstances>

The purpose for installing Keybase and the PSKeyBase Module is to encrypt the contents of the $HOME/.oci directory.

The installation of these components is optional, if you don't want the $HOME/.oci directory contents encrypted.

Install GnuPG

KeyBase uses public key cryptography to protect your chats, files, git repositories, and key-value store from prying eyes.

Install Keybase

The PSKeyBase module automates the usage of the key-value store feature implemented in the KeyBase application.

See PSKeyBase Module for download and installation instructions.

Add-PSKEncryption -FolderPath $HOME/.oci

The psConsole script is a launch utility and installation is optional, but without it an automatic opening of an ssh session to your OCI VM won't be possible. You'll need to manually open an ssh session to shutdown the desired services on the VM.

If a crash consistent boot volume backup is not required, then the backup can just be taken without shutting down any services.

See psConsole for download and installation instructions.