Virtual-machine desktops that are managed by vCenter Server can be in various states of operation and availability. In View Administrator, you can track the status of desktops in the right-hand column of the desktop-list page.

Status of Virtual-Machine Desktops That Are Managed by vCenter Server shows the operational state of virtual-machine desktops that are displayed in View Administrator. A desktop can be in only one state at a time.

Status of Virtual-Machine Desktops That Are Managed by vCenter Server

Status

Type of State

Description

Provisioning

Provisioning

The virtual machine is being provisioned.

Provisioning error

Provisioning

An error occurred during provisioning.

Customizing

Provisioning

The virtual machine in an automated pool is being customized.

Deleting

Provisioning

The virtual machine is marked for deletion. View Manager will delete the virtual machine soon.

Maintenance mode

Provisioning

The virtual machine is in maintenance mode. Users cannot log in or use the virtual machine.

Waiting for Agent

Agent state

View Connection Server is waiting to establish communication with View Agent on a virtual machine in a manual pool.

Note

This state is the same as the Customizing state for a virtual machine in an automated pool.

Startup

Agent state

View Agent has started on the virtual machine, but other required services such as the display protocol are still starting. For example, View Agent cannot establish an RDP connection with client computers until RDP has finished starting. The View Agent startup period allows other processes such as protocol services to start up as well.

Agent unreachable

Agent state

View Connection Server cannot establish communication with View Agent on a virtual machine.

Configuration error

Agent state

The display protocol such as RDP or PCoIP is not enabled.

Agent disabled

Agent state

This state can occur in two cases. First, in a desktop pool with the Delete or refresh desktop on logoff or Delete desktop after logoff setting enabled, a desktop session is logged out, but the virtual machine is not yet refreshed or deleted. Second, View Connection Server disables View Agent just before sending a request to power off the virtual machine.

This state ensures that a new desktop session cannot be started on the virtual machine.

Invalid IP

Agent state

The subnet mask registry setting is configured on the virtual machine, and no active network adapters have an IP address within the configured range.

Agent needs reboot

Agent state

A View component was upgraded, and the virtual machine must be restarted to allow View Agent to operate with the upgraded component.

Protocol failure

Agent state

A display protocol did not start before the View Agent startup period expired.

Note

View Administrator can display desktops in a Protocol failure state when one protocol failed but other protocols started successfully. For example, the Protocol failure state might be displayed when HTML Access failed but PCoIP and RDP are working. In this case, the desktops are available and View Client devices can access them through PCoIP or RDP.

Domain failure

Agent state

The virtual machine encountered a problem reaching the domain. The domain server was not accessible, or the domain authentication failed.

Provisioned

Availability

The virtual machine is powered off or suspended.

Available

Availability

The virtual machine is powered on and ready for an active connection. In a dedicated pool, the virtual machine is assigned to a user and will start when the user logs in.

Checked out

Session state

The virtual machine for a local desktop is checked out.

Connected

Session state

The virtual machine is in an active session and has an active remote connection to a View client.

Disconnected

Session state

The virtual machine is in an active session, but it is disconnected from the View client.

Unassigned user connected

Session state

A user other than the assigned user is logged in to a virtual machine in a dedicated pool.

For example, this state can occur if an administrator starts vSphere Client, opens a console on the virtual machine, and logs in.

Unassigned user disconnected

Session state

A user other than the assigned user is logged in and disconnected from a virtual machine in a dedicated pool.

Already used

Session state

In a desktop pool with the Delete or refresh desktop on logoff or Delete desktop after logoff setting enabled, there is no active session on the virtual machine, but the session was not logged off.

This condition might occur if a virtual machine shuts down unexpectedly or the user resets the desktop during an active session. By default, when a virtual machine is in this state, View prevents any other View Client devices from accessing the desktop.

Checked out

Local mode

The virtual machine is checked out for use in local mode.

Checking out

Local mode

The virtual machine is being checked out for use in local mode.

Checked in

Local mode

A virtual machine that was checked out for use in local mode is now checked in again.

Checking in

Local mode

A virtual machine that is checked out for use in local mode is being checked in to the vCenter Server virtual machine in the datacenter.

Replicating

Local mode

The virtual machine is checked out for use in local mode and is replicating data to the vCenter Server virtual machine in the datacenter.

Rolling back

Local mode

A virtual machine that is checked out for use in local mode is rolling back. The local desktop virtual machine is being discarded and the lock is being released on the vCenter Server version of the virtual machine.

In progress

Miscellaneous

The virtual machine is in a transitional state during a maintenance operation.

Unknown

Miscellaneous

The virtual machine is in an unknown state.

Error

Miscellaneous

An unknown error occurred in the virtual machine.

Miscellaneous

A failure occurred when the virtual machine was in any of the preceding states.

While a desktop is in a particular state, it can be subject to further conditions. View Administrator displays these conditions as suffixes to the desktop state. For example, View Administrator might display the Customizing (missing) state.

Desktop-Status Conditions shows these additional conditions.

Desktop-Status Conditions

Condition

Description

Missing

The virtual machine is missing in vCenter Server.

Typically, the virtual machine was deleted in vCenter Server, but the View LDAP configuration still has a record of the desktop.

Task halted

A View Composer operation such as refresh, recompose, or rebalance was stopped.

For details about troubleshooting a recompose operation, see Correcting an Unsuccessful Recomposition.

For details about View Composer error states, see View Composer Provisioning Errors.

The Task halted condition applies to all virtual machines that were selected for the operation, but on which the operation has not yet started. Virtual machines in the pool that are not selected for the operation are not placed in the Task halted condition.

A desktop state can be subject to both conditions, (missing, task halted), if a View Composer task was stopped and the virtual machine is missing in vCenter Server.