Troubleshoot App Service errors after upgrading to Nerdio Manager v6.3 or v6.4

Nerdio Manager versions 6.3 and 6.4 include changes related to the .NET framework, ensuring the application is properly updated prior to the .NET 6 retirement in November 2024. For details, see Extended support for .NET 6 (LTS) ends on 12 November 2024.

Nerdio Manager v6.3 includes some preparatory changes, while v6.4 upgrades .NET from version 6 to version 8.

In rare cases, when updating to versions 6.3 and 6.4, the Azure App Service may not perform the .NET upgrade properly. Specifically, the old .NET 6 files may not be deleted as part of the new deployment. Typically, the App Service should remove all old files from the existing version and replace them with the new files from the update package. However, in some cases, the older files remain, which causes conflict with the new file versions.

To resolve this conflict, you need to manually clear the old app package files from the App Service, and then redeploy the App Service.

To troubleshoot the App Service errors, complete the following steps:

• Step 1: Download the Nerdio Manager update package

• Step 2: Clear the App Service

• Step 3: Redeploy the app update package

Step 1: Download the Nerdio Manager update package

First, you need to download the Nerdio Manager standalone update package.

To download the standalone update package:

1. In Nerdio Manager, navigate to Updates.

2. Locate the needed version of the Nerdio Manager app, and then from the Deploy drop-down menu, select Download Installer.

   The installer is downloaded as a .zip file to your browser's default download folder. Ensure you save this package to a safe location.

3. Expand the package file and retrieve the file named site.zip or app.zip. Only one file is included.

   Warning: Do not unzip or expand the site.zip or app.zip file.

Step 2: Clear the App Service

Prior to redeploying the new package, clear the existing application from the App Service. You can do this using the Kudu service portal or the Advanced Tools Console.

To clear the existing application from the App Service:

1. In the Azure portal, navigate to App Services > Nerdio Manager App Service.

   Note: The Nerdio Manager App Service name is typically prefixed with nmw-app. Make sure you don't confuse it with the App Service named nmw-ccl-app, which is used for Cost Attribution.

2. In the left menu, navigate to Development Tools > Advanced Tools, and then select Go to launch the Kudu console.

3. In the top toolbar, select Debug Console > PowerShell.

   

4. Change location to the site\wwwroot directory. Use one of the following paths:

   • cd C:\home\site\wwwroot

   • Set-Location C:\home\site\wwwroot

5. Run one of the following commands to clear all files from the directory:

   • del *.*

   • Remove-Item *.*

     Note: The folders can remain in the directory.

     

Step 3: Redeploy the app update package

You can now redeploy the new Nerdio Manager update package to the App Service.

To redeploy the app package:

1. In the Azure portal, navigate to App Services > Nerdio Manager App Service.

2. In the left menu, in the Development Tools section, select Advanced Tools, and then select Go to launch the Kudu console.

3. In the top toolbar, select Tools > Zip Push Deploy.

   

4. In the file explorer dialog box, drag the site.zip or app.zip file that you retrieved from the package file downloaded in Step 1: Download the Nerdio Manager update package.

   Warning:

   • Make sure you drag only the site.zip or app.zip file, rather than the package.standalone*.zip, which prevents Nerdio Manager from running successfully.

   • Ensure the file's extension is .zip.

   The lower section of the page updates to reflect the package uploading and deploying. Wait until the final task displays Deployment successful.

5. In the Azure portal, navigate to App Service > Settings > WebJobs.

6. Select the provision job and make sure that its status is Running. If it's Stopped, in the Run column, select the play button, and then select Start.

   Note: If the WebJob named provision is missing, the wrong zip file was uploaded to Nerdio Manager's App Service. Verify and re-upload the site.zip file only (do not upload the full package.standalone*.zip file).

7. Return to the Nerdio Manager app and refresh your browser to confirm the app is online and accessible.