DEPLOYMENT-NOTES.rst

Deployment notes

• 2021-12-20

  `https://whetstone.privatestorage.io/privatestorage/privatestorageops/-/issues/399`_ requires moving the PaymentServer database on the payments host onto a new dedicated filesystem.

  Follow these steps before deploying this version of PrivateStorageio:

  0. Deploy the PrivateStorageOps change that creates a new dedicated volume.

  1. Put a disk label on the new dedicated volume

     nix-shell -p parted --run 'parted /dev/nvme1n1 mklabel msdos'

  2. Put a properly aligned partition in the new disk label

     nix-shell -p parted --run 'parted /dev/nvme1n1 mkpart primary ext2 4096s 4G'

  3. Create a labeled filesystem on the partition

     mkfs.ext4 -L zkapissuer-data /dev/nvme1n1p1

  4. Deploy the PrivateStorageio update.

  5. Move the database file to the new location

     mv -iv /var/lib/zkapissuer/vouchers.sqlite3 /var/lib/zkapissuer-v2

  6. Clean up the old state directory

     rm -ir /var/lib/zkapissuer

  7. Start the PaymentServer service (not running because its path assertions were not met earlier)

     systemctl start zkapissuer

• 2021-10-12 The secret in private-keys/grafana-slack-url needs to be changed to remove the SLACKURL= prefix.

• 2021-09-30 Enable alerting needs a secret in private-keys/grafana-slack-url looking like the template in morph/grid/local/private-keys/grafana-slack-url and pointing to the secret API endpoint URL saved in this 1Password entry (or create a new secret URL at https://www.slack.com/apps/A0F7XDUAZ).

• 2021-09-07 Manage access to payment metrics requires moving and chown'ing the PaymentServer database on the payments host:

  mkdir /var/lib/zkapissuer
  
  mv /var/db/vouchers.sqlite3 /var/lib/zkapissuer/vouchers.sqlite3
  
  chown -R zkapissuer:zkapissuer /var/lib/zkapissuer
  
  chmod 750 /var/lib/zkapissuer
  chmod 640 /var/lib/zkapissuer/vouchers.sqlite3