Skip to content

Commit 434f620

Browse files
apwestgarthapwestgarth
authored
Update to cover single method for updating App Service on Azure Stack Hub
1 parent 19409c4 commit 434f620

File tree

1 file changed

+8
-213
lines changed

1 file changed

+8
-213
lines changed

‎azure-stack/operator/azure-stack-app-service-update.md

Lines changed: 8 additions & 213 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ description: Learn how to update Azure App Service on Azure Stack Hub.
44
author: sethmanheim
55

66
ms.topic: article
7-
ms.date: 10/2/2022
8-
ms.author: sethm
7+
ms.date: 06/25/2025
8+
ms.author: anwestg
99
ms.reviewer: anwestg
1010
ms.lastreviewed: 10/28/2020
11-
zone_pivot_groups: state-connected-disconnected
11+
zone_pivot_groups:
1212
# Intent: As an Azure Stack operator, I want to update my App Service so I'm up to date.
1313
# Keyword: update app service azure stack
1414

@@ -18,155 +18,17 @@ zone_pivot_groups: state-connected-disconnected
1818

1919
[!INCLUDE [Azure Stack Hub update reminder](../includes/app-service-hub-update-banner.md)]
2020

21-
::: zone pivot="state-connected"
22-
In this article, you learn how to upgrade the [Azure App Service resource provider](azure-stack-app-service-overview.md) deployed in an internet-connected Azure Stack Hub environment.
21+
In this article, you learn how to upgrade the [Azure App Service resource provider](azure-stack-app-service-overview.md) deployed in an Azure Stack Hub environment that is connected or disconnected from the Internet and, secured by Entra ID or Active Directory Federation Services (AD FS).
2322

2423
> [!IMPORTANT]
25-
> Prior to running the upgrade, you must complete [deployment of Azure App Service on Azure Stack Hub](azure-stack-app-service-deploy.md).
26-
27-
## Run the Azure App Service resource provider installer
28-
29-
During this process, the upgrade will:
30-
31-
* Detect prior deployment of Azure App Service.
32-
* Prepare all update packages and new versions of all OSS Libraries to be deployed.
33-
* Upload to storage.
34-
* Upgrade all Azure App Service roles (Controllers, Management, Front-End, Publisher, and Worker roles).
35-
* Update Azure App Service scale set definitions.
36-
* Update Azure App Service resource provider manifest.
37-
38-
> [!IMPORTANT]
39-
> The Azure App Service installer must be run on a machine which can reach the Azure Stack Hub admin Azure Resource Manager endpoint.
40-
41-
To upgrade your deployment of Azure App Service on Azure Stack Hub, follow these steps:
42-
43-
# [Azure App Service on Azure Stack 2022 H1](#tab/22h1)
44-
45-
1. Download the [Azure App Service Installer](https://aka.ms/appsvcupdate21q1installer).
46-
47-
2. Run appservice.exe as an admin.
48-
49-
![Screenshot that shows how to start the deployment or upgrade process in the App Service installer.][1]
50-
51-
3. Select **Deploy Azure App Service or upgrade to the latest version.**
52-
53-
4. Review and accept the Microsoft Software License Terms and then select **Next**.
54-
55-
5. Review and accept the third-party license terms and then select **Next**.
56-
57-
6. Make sure that the Azure Stack Hub Azure Resource Manager endpoint and Active Directory Tenant info is correct. If you used the default settings during ASDK deployment, you can accept the default values here. However, if you customized the options when you deployed Azure Stack Hub, you must edit the values in this window. For example, if you use the domain suffix *mycloud.com*, your Azure Stack Hub Azure Resource Manager endpoint must change to *management.region.mycloud.com*. After you confirm your info, select **Next**.
58-
59-
![Screenshot that shows where to configure the ARM endpoints in the App Service installer.][2]
60-
61-
7. On the next page:
62-
63-
1. Select the connection method you wish to use - **Credential** or **Service Principal**
64-
- **Credential**
65-
- If you're using Microsoft Entra ID, enter the Microsoft Entra admin account, and password that you provided when you deployed Azure Stack Hub. Select **Connect**.
66-
- If you're using Active Directory Federation Services (AD FS), provide your admin account. For example, [email protected]. Enter your password, and then select **Connect**.
67-
- **Service Principal**
68-
- The service principal that you use **must** have **Owner** rights on the **Default Provider Subscription**
69-
- Provide the **Service Principal ID**, **Certificate File**, and **Password** and select **Connect**.
70-
71-
1. In **Azure Stack Hub Subscriptions**, select the **Default Provider Subscription**. Azure App Service on Azure Stack Hub **must** be deployed in the **Default Provider Subscription**.
72-
73-
1. In the **Azure Stack Hub Locations**, select the location that corresponds to the region you're deploying to. For example, select **local** if you're deploying to the ASDK.
74-
75-
1. If an existing Azure App Service deployment is detected, then the resource group and storage account are populated and unavailable.
76-
77-
1. **NEW**: Administrators can specify a three character **Deployment Prefix** for the individual instances in each Virtual Machine Scale Set that are deployed. This is useful if managing multiple Azure Stack Hub instances.
78-
79-
![Screenshot showing Azure App Service on Azure Stack Hub installation detected.][9]
80-
81-
1. In the next screen, you'll see the results of a status check performed against the App Service Resource Provider. This status check has been added to verify the deployment is in the correct state to be upgraded. The status check verifies that all roles are ready, all worker tiers are valid, all virtual machine scale sets are healthy and verifies access to the App Service secrets.
82-
83-
![Screenshot showing Azure App Service on Azure Stack Hub pre-upgrade status check.][10]
84-
85-
1. The Platform Image and SKU screen gives Administrators the opportunity to choose the correct [Windows 2022 Platform](azure-stack-app-service-before-you-get-started.md#download-items-from-the-azure-marketplace) image to be used to deploy the new role instances.
86-
1. **Select** the correct Platform Image
87-
1. Over time the minimum recommended spec of VM/VM Scale Set instance SKUs has changed and here you see the details of what is currently deployed and the new recommended SKU.
88-
89-
90-
8. On the summary page:
91-
1. Verify the selections you made. To make changes, use the **Previous** buttons to visit previous pages.
92-
2. If the configurations are correct, select the check box.
93-
3. To start the upgrade, select **Next**.
94-
95-
![Screenshot that shows the App Service upgrade summary in the installer.][4]
96-
97-
9. Upgrade progress page:
98-
1. Track the upgrade progress. The duration of the upgrade of Azure App Service on Azure Stack Hub varies depending on the number of role instances deployed.
99-
2. After the upgrade successfully completes, select **Exit**.
100-
101-
![Screenshot that shows the deployment progress in the App Service installer.][5]
102-
103-
> [!NOTE]
104-
> Upgrading to 2022.H1 can take a considerable amount of time dependent on the number of role instances deployed within the App Service on Azure Stack Hub Resource Provider deployment.
105-
>
106-
107-
# [Previous Versions](#tab/previous)
108-
109-
1. Download the [Azure App Service Installer](https://aka.ms/appsvcupdate21q1installer).
110-
111-
2. Run appservice.exe as an admin.
112-
113-
![Screenshot that shows how to start the deployment or upgrade process in the App Service installer.][1]
114-
115-
3. Select **Deploy Azure App Service or upgrade to the latest version.**
116-
117-
4. Review and accept the Microsoft Software License Terms and then select **Next**.
118-
119-
5. Review and accept the third-party license terms and then select **Next**.
120-
121-
6. Make sure that the Azure Stack Hub Azure Resource Manager endpoint and Active Directory Tenant info is correct. If you used the default settings during ASDK deployment, you can accept the default values here. However, if you customized the options when you deployed Azure Stack Hub, you must edit the values in this window. For example, if you use the domain suffix *mycloud.com*, your Azure Stack Hub Azure Resource Manager endpoint must change to *management.region.mycloud.com*. After you confirm your info, select **Next**.
122-
123-
![Screenshot that shows where to configure the ARM endpoints in the App Service installer.][2]
124-
125-
7. On the next page:
126-
127-
1. Select the connection method you wish to use - **Credential** or **Service Principal**
128-
- **Credential**
129-
- If you're using Microsoft Entra ID, enter the Microsoft Entra admin account, and password that you provided when you deployed Azure Stack Hub. Select **Connect**.
130-
- If you're using Active Directory Federation Services (AD FS), provide your admin account. For example, [email protected]. Enter your password, and then select **Connect**.
131-
- **Service Principal**
132-
- The service principal that you use **must** have **Owner** rights on the **Default Provider Subscription**
133-
- Provide the **Service Principal ID**, **Certificate File**, and **Password** and select **Connect**.
134-
135-
1. In **Azure Stack Hub Subscriptions**, select the **Default Provider Subscription**. Azure App Service on Azure Stack Hub **must** be deployed in the **Default Provider Subscription**.
136-
137-
1. In the **Azure Stack Hub Locations**, select the location that corresponds to the region you're deploying to. For example, select **local** if you're deploying to the ASDK.
138-
139-
1. If an existing Azure App Service deployment is detected, then the resource group and storage account are populated and unavailable.
140-
141-
![Screenshot that shows where you specify the Azure Stack Hub subscription information in the App Service installer.][3]
142-
143-
8. On the summary page:
144-
1. Verify the selections you made. To make changes, use the **Previous** buttons to visit previous pages.
145-
2. If the configurations are correct, select the check box.
146-
3. To start the upgrade, select **Next**.
147-
148-
![Screenshot that shows the App Service upgrade summary in the installer.][4]
149-
150-
9. Upgrade progress page:
151-
1. Track the upgrade progress. The duration of the upgrade of Azure App Service on Azure Stack Hub varies depending on the number of role instances deployed.
152-
2. After the upgrade successfully completes, select **Exit**.
153-
154-
![Screenshot that shows the deployment progress in the App Service installer.][5]
155-
156-
::: zone-end
157-
158-
::: zone pivot="state-disconnected"
159-
In this article, you learn how to upgrade the [Azure App Service resource provider](azure-stack-app-service-overview.md) deployed in an Azure Stack Hub environment that is **disconnected** from the Internet and secured by **Active Directory Federation Services (AD FS)**.
160-
161-
> [!IMPORTANT]
162-
> Prior to running the upgrade, you must complete [deployment of Azure App Service on Azure Stack Hub in an disconnected environment](./azure-stack-app-service-deploy.md?pivots=state-disconnected).
24+
> Prior to running the upgrade, you must complete [deployment of Azure App Service on Azure Stack Hub](./azure-stack-app-service-deploy.md).
16325
16426
## Run the App Service resource provider installer
16527

16628
To upgrade the App Service resource provider in an Azure Stack Hub environment, you must complete these tasks:
16729

168-
1. Download the [Azure App Service Installer](https://aka.ms/appsvcupdate21q1installer).
169-
2. Create an offline upgrade package.
30+
1. Download the Azure App Service Installer
31+
2. Download the Azure App Service Installer Offline Package
17032
3. Run the App Service installer (appservice.exe) and complete the upgrade.
17133

17234
During this process, the upgrade will:
@@ -177,22 +39,6 @@ During this process, the upgrade will:
17739
* Update App Service scale set definitions
17840
* Update App Service Resource Provider Manifest
17941

180-
## Create an offline upgrade package
181-
182-
To upgrade App Service in a disconnected environment, you must first create an offline upgrade package on a machine that's connected to the Internet.
183-
184-
1. Run appservice.exe as an administrator
185-
186-
![Screenshot that shows the Azure App Service on Azure Stack Hub installer.][6]
187-
188-
2. Select **Advanced** > **Create offline package**
189-
190-
![Screenshot showing the Azure App Service on Azure Stack Hub installer advanced options.][7]
191-
192-
3. The Azure App Service installer creates an offline upgrade package and displays the path to it. You can select **Open folder** to open the folder in your file explorer.
193-
194-
4. Copy the installer (AppService.exe) and the offline installation package to a machine that has connectivity to your Azure Stack Hub.
195-
19642
## Complete the upgrade of App Service on Azure Stack Hub
19743

19844
> [!IMPORTANT]
@@ -208,7 +54,7 @@ To upgrade App Service in a disconnected environment, you must first create an o
20854

20955
![Screenshot showing the Azure App Service on Azure Stack Hub installer advanced options.][7]
21056

211-
1. Browse to the location of the offline upgrade package you previously created and then select **Next**.
57+
1. Browse to the location of the offline upgrade package you previously dopwnloaded and then select **Next**.
21258

21359
1. Review and accept the Microsoft Software License Terms and then select **Next**.
21460

@@ -263,57 +109,6 @@ To upgrade App Service in a disconnected environment, you must first create an o
263109

264110
![Screenshot showing Azure App Service on Azure Stack Hub upgrade progress.][5]
265111

266-
# [Previous Versions](#tab/previous)
267-
268-
1. Run appservice.exe as an administrator.
269-
270-
![Screenshot showing the Azure App Service on Azure Stack Hub installer.][6]
271-
272-
2. Select **Advanced** > **Complete offline installation or upgrade**.
273-
274-
![Screenshot showing the Azure App Service on Azure Stack Hub installer advanced options.][7]
275-
276-
3. Browse to the location of the offline upgrade package you previously created and then select **Next**.
277-
278-
4. Review and accept the Microsoft Software License Terms and then select **Next**.
279-
280-
5. Review and accept the third-party license terms and then select **Next**.
281-
282-
6. Make sure that the Azure Stack Hub Azure Resource Manager endpoint and Active Directory Tenant information is correct. If you used the default settings during Azure Stack Development Kit deployment, you can accept the default values here. However, if you customized the options when you deployed Azure Stack Hub, you must edit the values in this window. For example, if you use the domain suffix *mycloud.com*, your Azure Stack Hub Azure Resource Manager endpoint must change to *management.region.mycloud.com*. After you confirm your information, select **Next**.
283-
284-
![Screenshot showing the Azure Stack Hub Cloud information.][2]
285-
286-
7. On the next page:
287-
288-
1. Select the connection method you wish to use - **Credential** or **Service Principal**
289-
- **Credential**
290-
- If you're using Microsoft Entra ID, enter the Microsoft Entra admin account, and password that you provided when you deployed Azure Stack Hub. Select **Connect**.
291-
- If you're using Active Directory Federation Services (AD FS), provide your admin account. For example, [email protected]. Enter your password, and then select **Connect**.
292-
- **Service Principal**
293-
- The service principal that you use **must** have **Owner** rights on the **Default Provider Subscription**
294-
- Provide the **Service Principal ID**, **Certificate File**, and **Password** and select **Connect**.
295-
296-
1. In **Azure Stack Hub Subscriptions**, select the **Default Provider Subscription**. Azure App Service on Azure Stack Hub **must** be deployed in the **Default Provider Subscription**.
297-
298-
1. In the **Azure Stack Hub Locations**, select the location that corresponds to the region you're deploying to. For example, select **local** if you're deploying to the ASDK.
299-
300-
1. If an existing App Service deployment is detected, then the resource group and storage account will be populated and greyed out.
301-
302-
!Screenshot showing details of detected installation of Azure App Service on Azure Stack Hub.][3]
303-
8. On the summary page:
304-
1. Verify the selections you made. To make changes, use the **Previous** buttons to visit previous pages.
305-
2. If the configurations are correct, select the check box.
306-
3. To start the upgrade, select **Next**.
307-
308-
![Screenshot showing Azure App Service on Azure Stack Hub upgrade summary.][4]
309-
310-
9. Upgrade progress page:
311-
1. Track the upgrade progress. The duration of the upgrade of App Service on Azure Stack Hub varies dependent on number of role instances deployed.
312-
2. After the upgrade successfully completes, select **Exit**.
313-
314-
![Screenshot of installer showing Azure App Service on Azure Stack Hub upgrade progress.][5]
315-
::: zone-end
316-
317112
## Next steps
318113

319114
Prepare for other admin operations for Azure App Service on Azure Stack Hub:

0 commit comments

Comments
 (0)