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 colorTemplate statusAgent statusDescription

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 colorTemplate statusAgent statusDescription

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 colorTemplate statusAgent statusDescription

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 colorTemplate statusAgent statusDescription

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.

Last updated

© 2024 Parallels International GmbH. All rights reserved.