Template status
To verify that a template is functioning as intended, you can examine its status in the main template list in the RAS Console (the Status column). When a template is functioning properly, the Status column displays "Ready", which means that hosts can be created from it as needed. When a template is being created or when it's in maintenance, or when it's being removed, the status will change accordingly.
Note that one of the other columns in the table is Agent status, which is the status of the RAS Guest Agent installed in a template. Compared to servers in the RAS infrastructure (Connection Broker, Gateways, RD Session Hosts, etc), the agent status is not as important in a template as the template status. This is because a template is not a regular virtual machine and is not normally running, so checking the agent status in a stopped VM doesn't make much sense. This is why the agent status for a template in the RAS Console is usually Not Available, which is perfectly normal. The only situation when the Agent status displays a meaningful value is when the template is in Maintenance and running like a regular VM, in which case.the agent is also running an its status can be verified.
The tables below describe what the Status and Agent status columns will show for various template states or transitions.
Template creation
Status color | Template status | Agent status | Description |
---|---|---|---|
Gray | Not available | Not available | When a provider is disabled or Provider Agent is disconnected or the template does not exist. |
Gray | Not applied | Not applied | Awaiting admin to click Apply in the RAS Console after the wizard completion. |
Orange | Creating | Not available | When using Azure Gallery as a source (no pre-created host available). |
Orange | Agent installation | Not available then OK | Deploying the agent to a newly created or available VM to be used as a template. |
Orange | Deployment in progress | Optimization pending | When the optimization is waiting to be applied. The admin can stop the optimization at this point. |
Optimization in progress | When the optimization is in progress. The admin can still stop the optimization at this point. | ||
OK then Not available | Internal procedure when converting a VM to a template. Once the conversion is completed, the template status changes to "Ready". | ||
Red | Creation failed | Not available | A problem has occurred. For example, a quota hit or a resource creation issue in Azure. The admin can retry the action by clicking Tasks > Retry last action. |
Red | Agent installation failed | Not available | Possible network issues, file share limitations, or an issue with admin rights. The admin can try Tasks > Retry last action. |
Red | Deployment failed | The actual status (OK, Not available, etc.) | A problem has occurred. For example, a quota hit, storage space, or snapshot creation from provider issue. The admin can try Tasks > Retry last action. |
FSLogix not available | FSLogix agent not found. | ||
FSLogix not updated | FSLogix agent needs updating. |
Template in production
Status color | Template status | Agent status | Description |
---|---|---|---|
Green | Ready | The actual status (OK, Not available, etc.) | Template is ready. |
Green | Cloning | The actual status (OK, Not available, etc.) | A host is being cloned from the template. |
Orange | Needs update | Needs update | RAS Guest Agent needs updating. |
Template in maintenance
Status color | Template status | Agent status | Description |
---|---|---|---|
Orange | Maintenance | The actual status (OK, Not verified, etc.) | Host used as the template is up and running, |
Optimization pending | When the optimization is waiting to be applied. The admin can stop the optimization at this point. | ||
Optimization in progress | When the optimization is in progress. The admin can still stop the optimization at this point. | ||
Needs update | Host used as the template is up and running but RAS Guest Agent needs updating. |
Template removal
Status color | Template status | Agent status | Description |
---|---|---|---|
Gray | Marked for deletion | The actual status while the host used as the template is still running (OK, Not verified, etc.) | The template is in the process of being deleted. |