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.
Status color | Template status | Agent status | Description |
---|---|---|---|
Status color | Template status | Agent status | Description |
---|---|---|---|
Status color | Template status | Agent status | Description |
---|---|---|---|
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.
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.
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.
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.