Upgrading Oqtane in an Azure App Service

A checklist when auto-upgrade fails

Oqtane has a nice System Update admin function. It will check if there’s a new version of Oqtane online a perform an auto-upgrade. I’m sure it works fine for most folks, but it’s never worked for me. I suspect it’s because I deploy to Azure App Services (Linux). Looking at the Oqtane.Updater project I could derive this list:

1. Take the app off-line

2. upzip the *.Update.zip contents

3. make a backup of the existing files

4. apply the content of the zip over your existing files

5. (if something goes wrong) revert to the backup

6. restart app

I’ve never investigated why the auto-upgrade fails for me, I’m comfortable using and have access to Azure. So I’m just going to do this bruit force using the Azure console and FTP.

1. Get *Upgrade.Zip from Oqtane Releases and unzip it locally

2. Get your FTP credentials from the Configuration section of your App service.

   

3. Launch your FTP client of choice and attach to your site

4. Stop the site from the Web App Azure portal

5. make a backup

6. upload the new files

   

7. Start you site from the Web App Azure portal