Central Dogma Server Upgrade Guide

[minwoox]

Central Dogma Server Upgrade Guide

This guide outlines the steps required to upgrade Central Dogma servers through specific versions to ensure compatibility and proper functionality.

Before you begin any upgrade, it is imperative to consult the Central Dogma community.

---

Prerequisites

• Backup your Central Dogma data before starting the upgrade process.

---

Upgrade Path

Step 1: Upgrade to Version 0.64.0

Required For: Using UpdateServerStatusCommand in later versions.

Step 2: Upgrade to Version 0.67.0

Required For: Migrating mirroring configuration.

• Verify the upgrade by ensuring the migrated mirroring format.

Step 3: Upgrade to Version 0.67.1

Required For: Changing the mirroring configuration.

• Update the mirroring configuration according to the documentation.

Step 4: Upgrade to Version 0.70.0

Required For: Removing hostname patterns in mirroring configuration.

Step 5: Upgrade to Version 0.71.0

Required For: Preparing to rename admin to system admin.

Step 6: Upgrade to Version 0.72.0

Required For: Changing the authentication.administrators to systemAdministrators in dogma.json

Step 7: Upgrade to Version 0.73.1

Required For: Using role-based system instead of permission-based authentication.

Step 8: Upgrade to Version 0.74.0

Required For: Removing GUEST write role and moving mirroring configurations to repositories.

Step 9: Upgrade to Version 0.75.1

Required For: Removing meta repository metadata of all projects.

---

Troubleshooting

If you encounter any issues during the upgrade, consider the following:

• Check the server logs for error messages.
• Review the release notes for potential breaking changes.
• Consult the Central Dogma community for assistance.