v4.0.0 Migration Guide

* * * IMPORTANT! * * *

Overview

With the release of v4.0.0, the Azure Naming Tool has been migrated to a .NET 8 Blazor Web App. This change modernizes the tool's architecture and ensures long-term support for the codebase. Due to the upgrade to .NET 8, the hosting environment will need to be updated to ensure proper functionality and the site configuration will need to be BACKED UP / RESTORED.

NOTE:

• After deployment, you may be prompted to set the Admin Password. Enter your desired password and confirm the site is running properly, then complete the configuration RESTORE process.
  
  
  

Instructions

1. BACKUP your current Azure Naming Tool installation

2. Backup code modifications/customizations

3. Review the Installation process for your environment

4. Update your hosting environment to .NET 8

5. Deploy the tool using your desired Installation process

6. Confirm the site is running properly

7. RESTORE your configuration

The Details

1. BACKUP your current Azure Naming Tool installation.

For v4.0.0, you are required to create a BACKUP of your configuration prior to the migration. Because the site will be running in .NET 8 framework, all previous configuration updates will need to be re-applied.

2. Backup code modifications/customizations

The v4.0.0 migration process requires a re-deployment of the code and an update to underlying hosting configuration to .NET 8.

To prepare for these changes, it is recommended that you create a backup of any customizations you have made to codebase for the tool (if any). These changes will need to be manually migrated to the your repository once it is updated.

3. Review your installation process

It is recommended that users review the Installation process for their desired environment prior to the migration.

4. Update your hosting environment to .NET 8

You will need to install/configure the .NET version in your hosting environment to ensure the Azure Naming Tool functions properly.

• If hosting in an Azure App Service, this setting can be changed in the App Service / Configuration / General Settings utility.

5. Deploy the new version

After selecting an Installation process, deploy the tool to your desired environment.

6. Confirm the site is running properly

After deployment, you will be prompted to set the Admin Password. Enter your desired password and confirm the site is running properly.

NOTE:

• If running in an Azure App Service, you may need stop/start the App Service for the site to load properly.
  
  
  

7. RESTORE your configuration

After confirming the site is functioning properly, Restore your configuration.

• If hosting in a container with a volume attached, the configuration should be loaded automatically. If not, RESTORE your configuration.