Start and stop Azure Stack Hub

Article
03/24/2023

Follow the procedures in this article to properly shut down and restart Azure Stack Hub services. Stop physically shuts down and powers off the entire Azure Stack Hub environment. Start powers on all infrastructure roles and returns tenant resources to the power state they were in before shutdown.

Note

The maximum supported time an Azure Stack Hub system can be turned off is 180 days. If it's turned off for a longer period of time, a re-deployment is required. Please contact your hardware solution partner.

Stop Azure Stack Hub

Stop or shut down Azure Stack Hub with the following steps:

Prepare all workloads running on your Azure Stack Hub environment's tenant resources for the upcoming shutdown.
Open a privileged endpoint session (PEP) from a machine with network access to the Azure Stack Hub ERCS VMs. For instructions, see Using the privileged endpoint in Azure Stack Hub.
From the PEP, run:
```
  Stop-AzureStack
```
Wait for all physical Azure Stack Hub nodes to power off.

Note

You can verify the power status of a physical node by following the instructions from the original equipment manufacturer (OEM) who supplied your Azure Stack Hub hardware.
(Optional) If the stop operation times out, you can monitor its progress using the following PowerShell cmdlet:
```
Get-ActionStatus Stop-AzureStack
```

Start Azure Stack Hub

Start Azure Stack Hub with the following steps. Follow these steps regardless of how Azure Stack Hub stopped.

Power on each of the physical nodes in your Azure Stack Hub environment. Verify the power on instructions for the physical nodes by following the instructions from the OEM who supplied the hardware for your Azure Stack Hub.
Wait until the Azure Stack Hub infrastructure services starts. Azure Stack Hub infrastructure services can require two hours to finish the start process. You can verify the start status of Azure Stack Hub with the Get-ActionStatus cmdlet.
Ensure that all of your tenant resources have returned to the state they were in before shutdown. Workloads running on tenant resources may need to be reconfigured after startup by the workload manager.

Get the startup status for Azure Stack Hub

Get the startup for the Azure Stack Hub startup routine with the following steps:

Open a privileged endpoint session from a machine with network access to the Azure Stack Hub ERCS VMs.
From the PEP, run:
```
  Get-ActionStatus Start-AzureStack
```

Troubleshoot startup and shutdown of Azure Stack Hub

Take the following steps if the infrastructure and tenant services don't successfully start two hours after you power on your Azure Stack Hub environment.

Open a privileged endpoint session from a machine with network access to the Azure Stack Hub ERCS VMs.
Run:
```
  Test-AzureStack
```
Review the output and resolve any health errors. For more information, see Run a validation test of Azure Stack Hub.
Run:
```
  Start-AzureStack
```
If running Start-AzureStack results in a failure, contact Azure Support.

Next steps

Learn more about Azure Stack Hub diagnostic tools