Desktops User Guide

Overview

A Tehama Desktop is a shared or individual virtual computer hosted in a Room. It is a workspace from which you can securely work with assets of the connected organization for the Room. Tehama Desktop instances are generated from Desktop templates that are defined in a Room. A template describes both the configuration of the Desktop instances to be generated from it and the users that will be able to connect to them. A Room can have multiple Tehama Desktop templates defined. The maximum number of Desktops (Desktop instances) in a Room that can be in use concurrently is 75 when the Recordings Room feature is enabled and 200 when the Recordings Room feature is disabled. (See the Desktop Session Auditing/Recordings User Guide for more details.) The Room configures which assets are accessible from its Desktops through its encrypted secrets vault and firewall rules.

All work performed using a Tehama Desktop is recorded and auditable.

Tehama offers both Windows Desktops and Linux Desktops.

Note that, as a SaaS platform, all Tehama Windows and Linux Desktop license costs are built in to the cost of your Tehama Subscription Plan.

Desktop vs Workspace

The user may be confused by the use of the terms "Desktops" and "Workspaces" within Tehama.

Tehama offers three types of Desktops - "Tehama Windows Desktops" and "Tehama Linux Desktops", which are based on PCoIP infrastructure, and "Workspaces", which is based on AWS Workspace® bundles.

The documentation refers to all three types as Tehama Desktops.

All three types of Desktops contain Tehama's Desktop Agent, which is interchangeably referred to as the Workspace Agent.

Windows Desktops Types

Tehama currently offers two Windows-based desktop types. Each type is provided as a separate Room feature. They are the Tehama Windows Desktops feature and the Workspaces feature. A Tehama Room may have just the Workspaces feature enabled or both it and the Tehama Windows Desktops feature enabled. The Admin and Org Managers and Room Managers (who are members of the Room) of the Room's owner organization are able to create desktop templates of these types (whichever feature(s) are enabled, that is) from the WINDOWS DESKTOPS sidebar menu item on the Room's CONFIGURE tab.

• Tehama Windows Desktops
  This is Tehama's most recent Windows desktops type. This feature provides virtual Desktop environments connected via PCoIP to Windows-based servers. It also is offered with a range of hardware and software options similar to those offered by the 'Workspaces' feature. The Tehama Windows Desktops feature provides a fixed CPU performance level for all its options. The currently available Operating System is Windows Server 2019.

   

• Workspaces
  Tehama Windows Desktops are built on Amazon WorkSpaces® bundles, which offer a range of hardware and software options. You can choose from a range of a Windows 10 (powered by Windows Server 2016) Desktop experiences. See Amazon WorkSpaces® - Features for more details.
  
  

Linux Desktops Types

Tehama currently offers one Linux-based desktop type. This is provided as a Room feature - the Tehama Linux Desktop Room feature. (A previously available Room feature, the Linux Legacy Desktop, is no longer offered or supported. Contact Tehama Support if you have any questions about the end-of-life of this legacy feature.) A Tehama Room may have the Tehama Linux Desktop feature enabled or disabled. The Admin and Org Managers and Room Managers (who are members of the Room) of the Room's owner organization, when the feature is enabled, are able to create desktop templates of this type of desktop from the LINUX DESKTOPS sidebar menu item on the Room's CONFIGURE tab. If the feature is enabled, then this sidebar menu will not be available.

The Tehama Linux Desktop Room feature provides virtual Desktop environments connected via PCoIP to Linux-based servers. It also is offered with a range of hardware and software options similar to a Windows Desktop. The Linux Desktop provides a fixed CPU performance level for all its options. The currently available Operating System is Ubuntu Server 18.04.

Desktop Concurrency Limits

While a Room can contain as many as 500 Desktop instances and an unlimited number of Room members, to ensure optimum performance the maximum number of concurrent Desktop sessions per Room is limited to 75 when the Recordings Room feature is enabled and limited to 200 concurrent Desktop sessions when the Recordings Room feature is disabled. (See the Desktop Session Auditing/Recordings User Guide for more details.)

In other words, there can only be 75 (or 200 when Recordings are disabled) Desktop sessions active at one time, regardless of how many Desktop instances belong to the Room.

If, while looking at the entry for one of your Desktops, in either the DESKTOPS page or the My Desktops page in the Room's WORK tab, you see the word UNAVAILABLE next to the desktop's name instead of the CONNECT button, it means there are 75 sessions (or 200 sessions when Recordings are disabled) currently active in that Room and you will not be able to start another Desktop session until one of the currently active sessions ends.

If your organization requires more than the maximum concurrent active sessions (75 when Recordings are enabled and 200 when Recordings are disabled), you will need to create multiple Rooms. You are encouraged to contact Tehama Support if you would like assistance in optimizing your Room environment for performance and availability, taking your auditing/recording needs into consideration.

Multi-monitor Support

Multi-monitor support applies to all three available Desktop types: 'Tehama Linux Desktops', Tehama Windows Desktops', and 'Workspaces'.

Tehama supports multi-monitor Desktops, in which you enable full-screen and your full-screen setting spans multiple monitors, up to a maximum of two monitors for Desktops in Rooms that have session recording enabled (this is the default Room recording setting).

If three or more monitors are detected during a Desktop session that is being recorded, the Desktop user will be shown a warning to switch to two or one monitors within fifteen seconds, or their session will be terminated. If three or more monitors still remain after fifteen seconds has elapsed, the user will be logged out of their Desktop.

Three or more monitors are ONLY supported in the case where the Desktop's Room has session recording disabled.

NOTE: To toggle off full-screen in your 'Workspace' Desktop instance, use the AWS Workspace hotkey Ctrl-Alt-Enter.

Contact Tehama Support to discuss enabling/disabling the 'Session Recordings' Room feature, or you may enable/disable this feature through the Room Settings interface. See the Enable/Disable Recordings section in the Rooms User Guide.

Desktop Actions Overview

The actions you can perform on a Desktop Template or a Desktop Instance depend on your role in your organization and the role your organization has in the Room containing the Desktop.

Actions are roughly divided into those that can be done only by a privileged user and those that can be done by both a privileged user and a non-privileged user, where:

Privileged user:

The Admin user or Org Manager or Room Manager (who is a member of the Room) of a Room's owner organization (owner+connected or user+owner), that is, the organization that is paying the bills. Since each Desktop created incurs a cost to the organization that owns the Room, the Admin user and Org Managers and Room Managers (who are members of the Room) of this organization have the privilege of deciding whether or not a Desktop Template is created and how many instances of it there can be.

Non-privileged user: Every other member of the Room.

(See the Roles User Guide for information about user and organization roles.)

Tehama Web UI Desktop action interfaces

Desktop template action interfaces:
Desktops templates are managed (added, approved, edited, etc.) by the Admin user and Org Managers and Room Managers (who are members of the Room) of the Room's owner organization from the WINDOWS DESKTOPS and LINUX DESKTOPS pages under the Room's CONFIGURE tab in the Tehama Web UI. Desktops templates can be requested (proposed) by other users from the MY DESKTOPS page and the PENDING DESKTOPS page in the Room's WORK tab.

Desktop instances action interfaces:
Users can connect to their Desktop instances, (and restart them etc) from the MY DESKTOPS page in the Room's WORK tab and also from the Tehama Web UI's DESKTOPS tab, which shows all the Desktops the user can access across all Rooms in the user's organization.

View list of your assigned Desktop templates in your Organization

To see the list of your assigned Desktops in your organization, do the following:

1. Log in to the Tehama Web UI.
2. Click on the DESKTOPS tab.
3. Click the My Desktops radio button at the top of the page. (NOTE: If you are a Staff member in the organization, you will not see this radio button. The list will be restricted to only your assigned Desktops by default.)

You will see a list of all the Desktop templates in the organization you are assigned to. Click on the CONNECT button next to the Desktop template's name to connect to your instance of the template (possibly a shared instance). (See Connect to a Desktop (single click) for more details.)

Note: If you see the word UNAVAILABLE next to the template's name instead of the CONNECT button, it means there are too many Desktop instances currently in use within the Room the template belongs to and you will not be able to connect. A maximum of 75 Desktops can be in use within a Room concurrently when the Room has the Recordings Room feature enabled and a maximum of 200 Desktops when the Room has the Recordings Room feature disabled. (See the Desktop Session Auditing/Recordings User Guide for more details.)

View list of all Desktop templates in your Organization

To see the list of all Desktops in your organization (in Rooms that you are a member of), do the following:

1. Log in to the Tehama Web UI.
2. Click on the DESKTOPS tab.
3. Click the All Desktops radio button at the top of the page. (NOTE: If you are a Staff member in the organization will not see this radio button. This feature is not available to you.)

You will see a list of all the Desktop templates in the organization.

View list of in-use Desktop templates in your Organization

To see the list of in-use Desktops in your organization (in Rooms that you are a member of), do the following:

1. Log in to the Tehama Web UI.
2. Click on the DESKTOPS tab.
3. Click the In use radio button at the top of the page. (NOTE: If you are a Staff member in the organization will not see this radio button. This feature is not available to you.)

You will see a list of in-use the Desktop templates in the organization.

View list of your assigned Desktop templates in a Room

To see the list of your assigned Desktop templates in a Room, do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click on the MY DESKTOPS sidebar item.

You will see a list of all the Desktop templates in the Room you are assigned to. Click on the CONNECT button in an entry to connect to your instance of the template (possibly a shared instance). (See Connect to a Desktop (single click) for more details.)

Note: If you see the word UNAVAILABLE next to the template's name instead of the CONNECT button, it means there are too many Desktop instances currently in use within the Room the template belongs to and you will not be able to connect. A maximum of 75 Desktops can be in use within a Room concurrently when the Room has the Recordings Room feature enabled and a maximum of 200 Desktops when the Room has the Recordings Room feature disabled. (See the Desktop Session Auditing/Recordings User Guide for more details.)

View all Desktop templates in a Room

To see a Room's Desktop templates:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. For a list of the Windows Desktop templates, click the WINDOWS DESKTOPS sidebar item.
6. For a list of the Linux Desktop templates, click the LINUX DESKTOPS sidebar item.

Click on the three vertical dots under the Actions column for an entry and select the "Edit" menu item to see the details for the template, including the list of Room members that are assigned to the template.

Add a Desktop template

Desktop templates represent a desktop configuration document from which Tehama Desktop instances are generated. They define the type ('Tehama Windows Desktops', 'Tehama Linux Desktops' or 'Workspaces'), specification (CPU/memory/apps: standard, pro, custom etc) and various other characteristics (multi-user etc). They also contain a list of assigned Room members. Each assigned Room member has a Desktop instance (in some cases shared) generated from the Desktop template to connect to.

add type:

• Add a Tehama Windows Desktop Template
• Add a Workspace Template
• Add a Tehama Linux Desktop Template

NOTE: You can also add Desktop templates to your Room from the Room's MEMBERS tab. See section Assign members to Desktop Template in the Room Membership User Guide.

 • add Tehama Windows

The 'Tehama Windows Desktops' desktop type is one Tehama's Windows-based desktop offerings.

Note, 'Tehama Windows Desktops' may not be enabled for your Room. Contact Tehama Support to enable or disable this feature in your Room, or you may enable/disable this feature through the Room Settings interface. See the Enable/Disable Windows Desktop section in the Rooms User Guide.

To add a new Desktop template of type 'Tehama Windows Desktops', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click the WINDOWS DESKTOPS sidebar item.
6. Click the ADD WINDOWS DESKTOP TEMPLATE button at the top right of the page. This will display the ADD WINDOWS DESKTOP TEMPLATE dialog.
7. You may see two choices at the top of the dialog.
   ◯ Tehama Windows Desktop
   ◯ Workspace
   Select 'Tehama Windows Desktop'.
   • Note: If there are no choices, then your Room only supports the 'Workspaces' type of Windows-based desktop. Desktops of the type 'Tehama Windows Desktops' are not enabled for your Room.
8. Enter the name for your Desktop Template.
9. In the Specification field, choose one of the supported CPU and memory configurations for your virtual machine.
   • Note also that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
10. Click on the CREATE DESKTOPS FOR MEMBERS button. The CREATE DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
11. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
12. Select the name(s) of the Room members that you wish to assign to this Desktop template. A separate Desktop instance will be created for each user. (Tehama can create up to five Desktop instances at one time. You can edit the Desktop template after creation in order to add more. There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.)
13. Click CHOOSE DESKTOP OPTIONS. The ENABLE DESKTOP ADMIN RIGHTS dialog will appear. (Note, if your Room is a domain joined Room, then this dialog is skipped - your Tehama Windows Desktop will inherit its privileges from the domain.)
14. Place a checkmark in the checkbox beside the sentence "Give desktop admin rights to desktop(s)" if you wish to allow the members the ability to install apps and modify system settings. Leave it unchecked otherwise.
15. Click REVIEW. The REVIEW dialog will appear.
16. Read the disclaimer (if any) and review the specification details. (Note, you may be required to accept terms and conditions.)
17. Click CREATE. The SUCCESS dialog will appear.
18. Click CLOSE. An entry for the new Desktop template will appear in the list of Desktop templates on the page. Room members that are assigned to the Desktop template will be able to connect to the Desktop instance built from this template for them from the MY DESKTOPS page under the WORK tab in the Room.

 • add Workspace

The 'Workspaces' desktop type is one Tehama's Windows-based desktop offerings.

To add a new Desktop template of type 'Workspaces', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click the WINDOWS DESKTOPS sidebar item.
6. Click the ADD WINDOWS DESKTOP TEMPLATE button at the top right of the page. This will display the ADD WINDOWS DESKTOP TEMPLATE dialog.
7. You may see two choices at the top of the dialog.
   ◯ Tehama Windows Desktop
   ◯ Workspace
   Select 'Workspace'.
   • Note: If there are no choices, then your Room only supports the 'Workspaces' type of Windows-based desktop. Continue to the next step.
8. Enter the name for your Desktop template.
9. The default mode for a new Desktop template is 'Individual'. If you see the Mode field, then you may opt to change the mode. If this field is visible, select
   EITHER
   Individual, – which gives each user Room access (a Desktop) that is uniquely available to them,
   OR
   Shared, – which requires you to specify the number of people who will have access to the Desktop, and provides Room access that can be pooled/shared among all users in the access list field, one at a time.
   (See "Note on Shared Desktops" below.)
10. In the Number of Desktops field which is visible only if you have chosen a Shared mode, enter the number of Desktop instances that will be shared.
11. In the Specification field, choose one of the supported CPU and memory configurations for your virtual machine.
    • Note also that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
12. Under Power Management, select
    EITHER
    On Demand, – which sets the behaviour of the Desktop instances built from this template such that they will be suspended when they are not in use.
    OR
    Always On, – which sets the behaviour of the Desktop instances built from this template such that they will not be suspended when they are not in use.
    (The Power Management selection is not available for the GPU specification for Workspaces.)
13. Click on the CREATE DESKTOPS FOR MEMBERS button. The CREATE DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
14. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
15. Select the name(s) of the Room members that you wish to assign to this Desktop template. (There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.) A separate Desktop instance will be created for each user unless you have opted to create 'Shared' desktop instances.
    • Note that the user(s) assigned to this Workspace Desktop template will be given desktop admin rights on the Desktop instance built for them from the template only if the Room was created with "Desktop Administrator privileges" for Workspaces enabled.
16. Click REVIEW. The REVIEW dialog will appear.
17. Read the disclaimer (if any) and review the specification details.
18. Click CREATE. The SUCCESS dialog will appear.
19. Click on CLOSE. An entry for the new Desktop template will appear in the list of Desktop templates on the page. Room members that are assigned to the Desktop template will be able to connect to the Desktop instance built from this template for them from the MY DESKTOPS page under the WORK tab in the Room.

 • add Tehama Linux

The 'Tehama Linux Desktops' desktop type is one Tehama's Linux-based desktop offerings.

Note, 'Tehama Linux Desktops' may not be enabled for your Room. Contact Tehama Support to enable or disable this feature in your Room, or you may enable/disable this feature through the Room Settings interface. See the Enable/Disable Linux Desktop section in the Rooms User Guide.

To add a new Desktop template of type 'Tehama Linux Desktops', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click the LINUX DESKTOPS sidebar item.
   • Note, you will not see the LINUX DESKTOPS sidebar item, if your Room does not have the Tehama Linux Desktops feature enabled.
6. Click on the ADD LINUX DESKTOP TEMPLATE button at the top right of the page. This will display the ADD LINUX DESKTOP TEMPLATE dialog.
7. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
8. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
9. Choose the specification (Hardware specifications). Once a value has been selected, values for it will appear in the dialog.
   • Note that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
10. Click on the CREATE DESKTOPS FOR MEMBERS button. The CREATE DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
11. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
12. Select the name(s) of the Room members that you wish to assign to this Desktop template. A separate Desktop instance will be created for each user. (Tehama can create up to five Desktop instances at one time. You can edit the Desktop template after creation in order to add more. There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.)
13. Click CHOOSE DESKTOP OPTIONS. The ENABLE DESKTOP ADMIN RIGHTS dialog will appear.
14. Place a checkmark in the checkbox beside the sentence "Give desktop admin rights to desktop(s)" if you wish to allow the members the ability to install apps and modify system settings. Leave it unchecked otherwise.
15. Click REVIEW. The REVIEW dialog will appear.
16. Review the specification details.
17. Click CREATE. The SUCCESS dialog will appear.
18. Click CLOSE. An entry for the new Desktop template will appear in the list of Desktop templates on the page. Room members that are assigned to the Desktop template will be able to connect to the Desktop instance built from this template for them from the MY DESKTOPS page under the WORK tab in the Room.

Request a Desktop template

Desktop templates represent a desktop configuration document from which Tehama Desktop instances are generated. They define the type ('Tehama Windows Desktops', 'Tehama Linux Desktops' or 'Workspaces'), specification (CPU/memory/apps: standard, pro, custom etc) and various other characteristics (multi-user etc). They also contain a list of assigned Room members. Each assigned Room member has a Desktop instance (in some cases shared) generated from the Desktop template to connect to.

If you are not a privileged user in your Room, (privileged users are the Admin user and Org Managers and Room Managers (who are members of the Room) of your Room's owner organization), you can request/propose a new Desktop template be added to the Room. The request is sent to the Room's privileged users, who can either approve or reject your request.

request type:

• Request a Tehama Windows Desktop Template
• Request a Workspace Template
• Request a Tehama Linux Desktop Template

NOTE: You can also request Desktop templates be added to your Room from the Room's MEMBERS tab. See section Assign members to Desktop Template in the Room Membership User Guide.

 • request Tehama Windows

The 'Tehama Windows Desktops' desktop type is one Tehama's Windows-based desktop offerings.

Note, 'Tehama Windows Desktops' may not be enabled for your Room. Contact Tehama Support to enable or disable this feature in your Room, or you may enable/disable this feature through the Room Settings interface. See the Enable/Disable Windows Desktop section in the Rooms User Guide.

To request a new Desktop template of type 'Tehama Windows Desktops', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click on either the MY DESKTOPS sidebar item or the PENDING DESKTOPS sidebar item.
6. Click the NEW DESKTOP TEMPLATE button at the top right of the page. This will display the REQUEST DESKTOP TEMPLATE dialog.
7. In the REQUEST DESKTOP TEMPLATE dialog, select the "Windows" type of Desktop from the Operating System dropdown field.
8. Click on CONTINUE. The REQUEST WINDOWS DESKTOP TEMPLATE dialog will appear.
9. You may see two choices at the top of the dialog.
   ◯ Tehama Windows Desktop
   ◯ Workspace
   Select 'Tehama Windows Desktop'.
   • Note: If there are no choices, then your Room only supports the 'Workspaces' type of Windows-based desktop. Desktops of the type 'Tehama Windows Desktops' are not enabled for your Room.
10. Enter the name for your Desktop Template.
11. In the Specification field, choose one of the supported CPU and memory configurations for your virtual machine.
    • Note also that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
12. Click on the REQUEST DESKTOPS FOR MEMBERS button. The REQUEST DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
13. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
14. Select the name(s) of the Room members that you wish to assign to this Desktop template. A separate Desktop instance will be requested for each user. (Tehama can create up to five Desktop instances at one time. The Room's owner organization can edit the Desktop template after your request has been approved and the Desktop template and the requested instances have been created in order to add more. There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.)
15. Click CHOOSE DESKTOP OPTIONS. The ENABLE DESKTOP ADMIN RIGHTS dialog will appear. (Note, if your Room is a domain joined Room, then this dialog is skipped - your Tehama Windows Desktop will inherit its privileges from the domain.)
16. Place a checkmark in the checkbox beside the sentence "Give desktop admin rights to desktop(s)" if you wish to allow the members the ability to install apps and modify system settings. Leave it unchecked otherwise.
17. Click REVIEW. The REVIEW dialog will appear.
18. Read the disclaimer (if any) and review the specification details. (Note, you may be required to accept terms and conditions.)
19. Click REQUEST. The SUCCESS dialog will appear.
20. Click CLOSE.
    Your newly requested Desktop template will appear to you, as the requesting user, in the list of pending Desktop templates under the PENDING DESKTOPS page in the Room's WORK tab. The Admin user and Org Managers and Room Managers (who are members of the Room) of your organization will also be able to see your request in the PENDING DESKTOPS page. It will appear to the Admin user and the Org Managers and the Room Managers (who are members of the Room) of the Room's owner organization, the Room's privileged users, on the WINDOWS DESKTOPS page in the Room's CONFIGURE tab, marked as a proposed Desktop template, awaiting review.

If approved, instances of your requested Desktop template will be generated and appear in the lists of Desktops under the MY DESKTOPS page of the users assigned to the Desktop template. The Desktop template entry in the PENDING DESKTOPS page will be removed from the list of pending requests.

If rejected, you will be sent a message with the reason for the rejection and the entry will be removed from the list of pending requests.

 • request Workspace

The 'Workspaces' desktop type is one Tehama's Windows-based desktop offerings.

To request a new Desktop template of type 'Workspaces', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click on either the MY DESKTOPS sidebar item or the PENDING DESKTOPS sidebar item.
6. Click the NEW DESKTOP TEMPLATE button at the top right of the page. This will display the REQUEST DESKTOP TEMPLATE dialog.
7. In the REQUEST DESKTOP TEMPLATE dialog, select the "Windows" type of Desktop from the Operating System dropdown field.
8. Click on CONTINUE. The REQUEST WINDOWS DESKTOP TEMPLATE dialog will appear.
9. You may see two choices at the top of the dialog.
   ◯ Tehama Windows Desktop
   ◯ Workspace
   Select 'Workspace'.
   • Note: If there are no choices, then your Room only supports the 'Workspaces' type of Windows-based desktop. Continue to the next step.
10. Enter the name for your Desktop template.
11. The default mode for a new Desktop template is 'Individual'. If you see the Mode field, then you may opt to change the mode. If this field is visible, select
    EITHER
    Individual, – which gives each user Room access (a Desktop) that is uniquely available to them,
    OR
    Shared, – which requires you to specify the number of people who will have access to the Desktop, and provides Room access that can be pooled/shared among all users in the access list field, one at a time.
    (See the "Note on Shared Desktops".)
12. In the Number of Desktops field which is visible only if you have chosen a Shared mode, enter the number of Desktop instances that will be shared.
13. In the Specification field, choose one of the supported CPU and memory configurations for your virtual machine.
    • Note also that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
14. Under Power Management field, select
    EITHER
    On Demand, – which sets the behaviour of the Desktop instances built from this template such that they will be suspended when they are not in use.
    OR
    Always On, – which sets the behaviour of the Desktop instances built from this template such that they will not be suspended when they are not in use.
    (The Power Management selection is not available for the GPU specification for Workspaces.)
15. Click on the REQUEST DESKTOPS FOR MEMBERS button. The REQUEST DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
16. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
17. Select the name(s) of the Room members that you wish to assign to this Desktop template. (There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.) A separate Desktop instance will be created for each user unless you have opted to create 'Shared' desktop instances.
    • Note that the user(s) assigned to this Workspace Desktop template will be given desktop admin rights on the Desktop instance built for them from the template only if the Room was created with "Desktop Administrator privileges" for Workspaces enabled.
18. Click REVIEW. The REVIEW dialog will appear.
19. Read the disclaimer (if any) and review the specification details.
20. Click REQUEST. The SUCCESS dialog will appear.
21. Click CLOSE.
    Your newly requested Desktop template will appear to you, as the requesting user, in the list of pending Desktop templates under the PENDING DESKTOPS page in the Room's WORK tab. The Admin user and Org Managers and Room Managers (who are members of the Room) of your organization will also be able to see your request in the PENDING DESKTOPS page. It will appear to the Admin user and the Org Managers and the Room Managers (who are members of the Room) of the Room's owner organization, the Room's privileged users, on the WINDOWS DESKTOPS page in the Room's CONFIGURE tab, marked as a proposed Desktop template, awaiting review.

If approved, instances of your requested Desktop template will be generated and appear in the lists of Desktops under the MY DESKTOPS page of the users assigned to the Desktop template. The Desktop template entry in the PENDING DESKTOPS page will be removed from the list of pending requests.

If rejected, you will be sent a message with the reason for the rejection and the entry will be removed from the list of pending requests.

 • request Tehama Linux

The 'Tehama Linux Desktops' desktop type is one Tehama's Linux-based desktop offerings.

Note, 'Tehama Linux Desktops' may not be enabled for your Room. Contact Tehama Support to enable or disable this feature in your Room, or you may enable/disable this feature through the Room Settings interface. See the Enable/Disable Linux Desktop section in the Rooms User Guide.

To request a new Desktop template of type 'Tehama Linux Desktops', do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click on either the MY DESKTOPS sidebar item or the PENDING DESKTOPS sidebar item.
6. Click the NEW DESKTOP TEMPLATE button at the top right of the page. This will display the REQUEST DESKTOP TEMPLATE dialog.
7. In the REQUEST DESKTOP TEMPLATE dialog, select the "Linux" type of Desktop from the Operating System dropdown field.
   • Note, you will not see the Linux type of Desktop in the dropdown field, if your Room does not have the Tehama Linux Desktops feature enabled.
8. Click on CONTINUE. The REQUEST LINUX DESKTOP TEMPLATE dialog will appear.
9. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
10. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
11. Choose the specification (Hardware specifications). Once a value has been selected, values for it will appear in the dialog.
    • Note that the GPU memory configuration may not be available in your Room's region. See the list of regions offering GPU at the end of this user guide.
12. Click on the REQUEST DESKTOPS FOR MEMBERS button. The REQUEST DESKTOP(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
13. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
14. Select the name(s) of the Room members that you wish to assign to this Desktop template. A separate Desktop instance will be requested for each user. (Tehama can create up to five Desktop instances at one time. The Room's owner organization can edit the Desktop template after your request has been approved and the Desktop template and the requested instances have been created in order to add more. There must be at least one name specified. At this time, a template cannot be created without at least one Room member assigned to it.)
15. Click CHOOSE DESKTOP OPTIONS. The ENABLE DESKTOP ADMIN RIGHTS dialog will appear.
16. Place a checkmark in the checkbox beside the sentence "Give desktop admin rights to desktop(s)" if you wish to allow the members the ability to install apps and modify system settings. Leave it unchecked otherwise.
17. Click REVIEW. The REVIEW dialog will appear.
18. Review the specification details.
19. Click REQUEST. The SUCCESS dialog will appear.
20. Click CLOSE.
    Your newly requested Desktop template will appear to you, as the requesting user, in the list of pending Desktop templates under the PENDING DESKTOPS page in the Room's WORK tab. The Admin user and Org Managers and Room Managers (who are members of the Room) of your organization will also be able to see your request in the PENDING DESKTOPS page. It will appear to the Admin user and the Org Managers and the Room Managers (who are members of the Room) of the Room's owner organization, the Room's privileged users, on the LINUX DESKTOPS page in the Room's CONFIGURE tab, marked as a proposed Desktop template, awaiting review.

If approved, instances of your requested Desktop template will be generated and appear in the lists of Desktops under the MY DESKTOPS page of the users assigned to the Desktop template. The Desktop template entry in the PENDING DESKTOPS page will be removed from the list of pending requests.

If rejected, you will be sent a message with the reason for the rejection and the entry will be removed from the list of pending requests.

Approve or reject a pending Desktop template request

You, as the Admin user or an Org Manager or a Room Manager (who is a member of the Room) of the Room's owner organization, will receive notification of each pending request.

Take note of the name of the requested Desktop template and of the user who requested it from the contents of the notification. You can use this information to find the request in the UI.

To approve or reject a requested (proposed) Desktop template, do the following:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click on either the WINDOWS DESKTOPS sidebar item or the LINUX DESKTOPS sidebar item, depending on the type of the requested Desktop template.
6. Locate the proposed Desktop template request you wish to deal with.
   
   Requested Desktop templates will show up in the list of Desktop templates with status "Pending" and the name of the Desktop template will be followed by the phrase "(Proposed request by <the name of the user that made the request>)".
   
   
7. Click on the three vertical dots under the Actions column in the entry for the proposed Desktop template, then select 'Review'. The REVIEW WINDOWS/LINUX DESKTOP TEMPLATE dialog will appear.
8. Browse the Desktop details in the request, including the description field containing the reason for the request.
   
   Note that the Desktop Template name field and the Users field are editable, but any changes will only take effect if you exit the dialog by clicking the APPROVE button.
   
   
9. Depending on what you decide:
   • EITHER:
     Click APPROVE to approve the Desktop template.
   • OR:
     Click REJECT to reject it. This will display the REJECT DESKTOP TEMPLATE dialog.
     Enter the reason you want to reject the pending Desktop template request in the dialog's Enter reason field, then click REJECT.

Note: Tehama can create up to five Desktop instances at one time, so restrict the number of members added to the Users field at the time of approval to five.

Edit a Desktop template

NOTE: You can also edit the users assigned to a Desktop template from the Room's MEMBERS tab. See section Assign members to Desktop in the Room Membership User Guide.

To edit an existing/approved Desktop template:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click on either the WINDOWS DESKTOPS sidebar item or the LINUX DESKTOPS sidebar item, depending on the type of Desktop template to be edited.
6. Locate the Desktop template you wish to edit.
7. Click on the three vertical dots under the Actions column in the entry you wish to edit, then select 'Edit'. This will display the EDIT WINDOWS DESKTOP TEMPLATE dialog for Windows-based Desktop templates, or the EDIT LINUX DESKTOP TEMPLATE dialog for Linux-based Desktop templates.
8. Make your changes in the dialog. Note that only a subset of the fields in the dialog are editable. The Desktop Template name field and the Users field are editable, but the specification details are not.
9. Click SAVE. Note that attempts to remove all users from a Desktop will result in an error.

Note: Tehama can create up to five Desktop instances at one time, so restrict the number of new members added to the Users field during each edit session to five.

Edit a pending Desktop template request

To edit a pending Desktop template request - as an Admin user or Org Manager or Room Manager (who is a member of the Room) of a non-Room owner organization (or as a Staff member of an organization editing pending templates they themselves have made)_:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click the PENDING DESKTOPS sidebar item.
6. Locate the pending Desktop template you wish to edit.
7. Click on the three vertical dots under the Actions column in the entry you wish to edit, then select 'Edit'. This will display the appropriate EDIT DESKTOP TEMPLATE REQUEST dialog, depending on the type of the pending Desktop template (Windows-based or Linux-based).
   • Note: When editing the specification field for a pending Workspace Desktop template, be aware that the Power Management selection is not available for the GPU specification.
8. Make your changes in the dialog.
9. Click SAVE. Note that attempts to remove all users from a Desktop template will result in an error.

To edit, restrictively, a pending Desktop template request - as an Admin user or Org Manager or Room Manager (who is a member of the Room) of the Room owner organization:

Changes to a pending Desktop template request are possible to a few fields (name and users) immediately prior to approving the request.

1. Follow the initial steps for approving/rejecting a pending Desktop template request until you see the REVIEW WINDOWS/LINUX DESKTOP TEMPLATE dialog.
2. Make your changes to the editable fields in the dialog (Desktop Template name, Users etc.).
3. Click APPROVE to approve the changed request. Not approving the request will cause the edits to revert. Note that attempts to remove all users from a Desktop template will result in an error.

Note: Tehama can create up to five Desktop instances at one time, so restrict the number of new members added to the Users field during each edit session to five.

Delete a Desktop template

To delete an existing/approved Desktop template:

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click on the WINDOWS DESKTOPS or LINUX DESKTOPS sidebar item, depending on what type of Desktop you want to delete (Windows-based or Linux-based).
6. Locate the Desktop template you wish to delete.
7. Click on the three vertical dots under the Actions column in the entry you wish to delete, then select 'Delete'. The DELETE DESKTOPS dialog will appear¹.
8. Read the warning message contained in the dialog. The warning will differ depending on the type of Desktop template you are deleting.
9. Type the name of the Desktop template into the dialog to confirm deletion (case sensitive).
10. Click DELETE.

Delete a pending Desktop template request

To delete a pending Desktop template - as an Admin user or Org Manager or Room Manager (who is a member of the Room) of the Room's owner organization (a privileged user):

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's CONFIGURE tab.
5. Click on the WINDOWS DESKTOPS or LINUX DESKTOPS sidebar item, depending on what type of Desktop template you want to delete.
6. Locate the Desktop template you wish to delete.
7. Click on the three vertical dots under the Actions column in the pending entry you wish to delete, then select 'Delete'. You will see the REJECT TEMPLATE dialog. (When a privileged user deletes a pending Desktop template, it is technically a rejection of the request, so using the REJECT TEMPLATE mechanism enables the user to give the requester some feedback.)
8. Enter the reason you want to delete the pending Desktop template request into the dialog.
9. Click REJECT.

To delete a pending Desktop template - as an Admin user or Org Manager or Room Manager (who is a member of the Room) of one of the Room's non-owner organizations, or as a member of the Room who is a Staff member of their organization (as a Staff member of an organization deleting pending templates they themselves have made):

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room you want to access. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click the PENDING DESKTOPS sidebar item.
6. Locate the pending Desktop template request you wish to delete.
7. Click on the three vertical dots under the Actions column in the pending entry you wish to delete, then select 'Delete'. You will see the DELETE DESKTOP REQUEST dialog.
8. Click DELETE.

Find Your Desktop in the Tehama Web UI

The Tehama Web UI provides lists of Desktop instances. You can perform actions on a Desktop from its list entry.

Desktops are identifiable by the combination of their names and the name of the Room they belong to.

Find your Desktop in the Tehama Web UI:

1. Choose A or B.
   A: find the Desktop in the list of all your Desktops in the organization
   1. Log in to the Tehama Web UI.
   2. Click on the DESKTOPS tab.
   3. Click the My Desktops radio button at the top of the page. (NOTE: If you are a Staff member in the organization, you will not see this radio button. The list will be restricted to only your assigned Desktops by default.)
   4. Look for the entry in the list with your Desktop's name and your Desktop's Room's name.
   B: find the Desktop in the list of your Desktops in the Room it belongs to
   1. Log in to the Tehama Web UI.
   2. Click on the ROOMS tab.
   3. Click on the name of the Room to which your Desktop belongs. You will see the Room's interface.
   4. Click the Room's WORK tab.
   5. Click on the MY DESKTOPS sidebar item.
   6. Look for the entry in the list with your Desktop's name.

Once you have located the entry for your Desktop, in either the DESKTOPS page or the MY DESKTOPS page, you can begin working with it.

Download the Tehama Client onto Your Device

The Tehama Client is required for launching a Desktop with a single-click. The Teradici PCoIP Client is used to launch a Desktop manually with credentials. (The Tehama Client uses Teradici PCoIP technology.)

Download and install the Tehama Client and the Teradici PCoIP Client on to your device before attempting to launch a Desktop from it.

This is a one time action per device.

Perform the download and installation as follows:

1. Log in to the Tehama Web UI.
2. Click on the DESKTOPS tab.
3. Click on the INSTALL CLIENT button in the top right of the page. This will display the TEHAMA CLIENT page. This page provides you with information about the Tehama Client and ways to download it.
4. Click the icon for your device's operating system (Linux, Windows or MacOS) to download the desktop clients onto your device.
5. Follow any installation/configuration instructions that are provided in the downloaded artifact(s).
6. Click on the X CLOSE button in the top right of the page to return to the DESKTOPS page.
7. You can test the single-click connect capability by clicking on the CONNECT button for any of your Desktops in the DESKTOPS page. This will launch your Desktop instance as a standalone application.

Other ways to get to the TEHAMA CLIENT page:

from the LAUNCH COMPLETE dialog:

From the CONNECT WITH CREDENTIALS dialog:

Connect to a Desktop (single click)

Connect (launch and log in to), with a single click, to a Desktop (an instance of a Desktop template to which you are assigned) in order to work with the assets of the connected organization for the Room. While you are connected to a Desktop, that Desktop is considered to be 'in use'.

To connect to a Desktop:

1. Locate the entry for the Desktop to which you want to connect in the Tehama Web UI.
   
   
2. Look for the CONNECT button in the entry.
   • Note: If you see the word UNAVAILABLE next to the template's name instead of the CONNECT button, it means there are too many Desktop instances currently in use within the Room the template belongs to and you will not be able to connect. A maximum of 75 Desktops can be in use within a Room concurrently when the Room has the Recordings Room feature enabled and a maximum of 200 Desktops when the Room has the Recordings Room feature disabled. (See the Desktop Session Auditing/Recordings User Guide for more details.)
     
     
3. Click on the CONNECT button in the entry.
   
   This will launch your Desktop instance as a standalone application.
   
   
   IMPORTANT Your Desktop will fail to launch unless you have downloaded the Tehama Client and the Teradici PCoIP Client to your device.
   
   Follow the steps in section Download the Tehama Client onto Your Device. This is a one time action per device.
   A sequence of dialogs will let you know the stage of your connection request.
   
   
   • Stage 1 - Desktop Preparation: The PREPARING YOUR DESKTOP... dialog will appear while your Desktop is preparing for launch (for example, your desktop may be starting or it may be coming out of hibernation). This dialog will remain visible until the Desktop is ready to launch.
     
     
     Note, if for some reason, your Desktop failed to prepare itself for the launch stage successfully, the PREPARATION FAILED dialog will appear. You can retry the connection through the "Retry" link found on this dialog.
   • Stage 2 - Desktop Launch: The LAUNCHING YOUR DESKTOP... dialog will appear. This dialog will remain visible for a number of minutes while your Desktop launches.
     
     
   • Stage 3 - Desktop Ready-for-use: The LAUNCH COMPLETE dialog will appear. At this point, your Desktop should be launched and ready for you to use.
     
     
     Note, if for some reason your Desktop failed to launch, you can retry the connection from the for your desktop in the table entry or through the "Retry" link on the LAUNCH COMPLETE dialog. Alternately, you can try to connect to your Desktop by entering the login credentials for your Desktop into the Teradici PCoIP Client. You can copy the necessary credentials from the CONNECT WITH CREDENTIALS dialog that appears when you click on the "connect with credentials" link on the LAUNCH COMPLETE dialog. credentials. See section 'Connect to a Desktop (with credentials) via Teradici PCoIP Client'.

Connect to a Desktop (with credentials) via Teradici PCoIP Client

If for some reason you have trouble connecting to your Desktop through the single-click CONNECT button for your desktop in the table entry or through the "Retry" link on the LAUNCH COMPLETE dialog, you can manually connect to your Desktop from the Teradici PCoIP Client's user interface with credentials.

1. Attempt to Connect to a Desktop (single-click).
2. When the LAUNCH COMPLETE dialog appears at the end of the launch sequence, click on the "connect with credentials" link. The CONNECT WITH CREDENTIALS dialog will appear. This dialog provides the credentials needed for manual connection.
3. Launch the Teradici PCoIP Client in your device. You should see its user interface appear.
4. Copy the Host Address/Registration Code field value from the CONNECT WITH CREDENTIALS dialog into the "Host Address or Code" field in the Teradici PCoIP Client.
   Note: For convenience, in Tehama, copy buttons are available that automatically place the Host Address/Registration Code, User Name or Password into the clipboard.
   Note: Desktop credentials are dynamic. The password is automatically rotated every five minutes.
5. Enter a name for this connection in the Teradici PCoIP Client's "Connection Name" field.
6. Click NEXT in the Teradici PCoIP Client.
7. Copy the User Name field value from the CONNECT WITH CREDENTIALS dialog into the "Username" field in the Teradici PCoIP Client.
8. Copy the Password field value from the CONNECT WITH CREDENTIALS dialog into the "Password" field in the Teradici PCoIP Client. (To view the Password value as plaintext, click on the 'eye' symbol in the field.)
9. Click LOGIN in the Teradici PCoIP Client. This will launch your Desktop instance as a standalone application.

Connect to a Workspace (with credentials) via AWS Web Client

Another option for connecting to Workspace Desktops is through the Amazon Workspaces® Web Client with manually entered credentials.

(Note, this is ONLY available for Desktops of type 'Workspaces'.)

1. Locate the entry for the Desktop (of type Workspace) to which you want to connect in the Tehama Web UI.
2. Select the "Connect via AWS web client" menu item in the Actions menu for the entry. The Amazon WorkSpaces® Web Access interface will appear in a new browser tab.
3. The CONNECT WITH CREDENTIALS dialog with credentials for your desktop will appear in the Tehama Web UI. Note the Host Address/Registration Code, the User Name and the Password values. (To view the Password value as plaintext, click on the 'eye' symbol in the field.)
   Note: Desktop credentials are dynamic. The password is automatically rotated every five minutes.
   Note: For convenience, in Tehama, copy buttons are available that automatically place the Host Address/Registration Code, User Name or Password into the clipboard.
4. Copy the host address/registration code and paste it into the Amazon WorkSpaces® Web Access interface as indicated.
5. Click Register.
6. Copy the User Name and Password and paste them into the Amazon WorkSpaces® Web Access interface as indicated.
7. Click Sign In. (If you are prompted with a Remember Me option, click No.) Your Workspace Desktop session will begin.

Connect to a Workspace (with credentials) via AWS Client

Another option for connecting to Workspace Desktops is through the Amazon Workspaces® Client with manually entered credentials.

(Note, this is ONLY available for Desktops of type 'Workspaces'.)

1. Locate the entry for the Desktop (of type Workspace) to which you want to connect in the Tehama Web UI.
2. Select the "Connect via AWS client" menu item in the Actions menu for the entry.
3. The CONNECT WITH CREDENTIALS dialog with credentials for your desktop will appear in the Tehama Web UI. Note the Host Address/Registration Code, the User Name and the Password values. (To view the Password value as plaintext, click on the 'eye' symbol in the field.)
   Note: Desktop credentials are dynamic. The password is automatically rotated every five minutes.
   Note: For convenience, in Tehama, copy buttons are available that automatically place the Host Address/Registration Code, User Name or Password into the clipboard.
4. Launch the Amazon WorkSpaces® Client in your device. You should see its user interface appear.
5. Copy the host address/registration code and paste it into the Amazon WorkSpaces® Client's Registration Code field, then click Register. (If there is no field visible for this value, you may need to click the "Change Registration Code" link in order to enter/update this value.)
6. Copy the User Name and Password and paste them into the Amazon WorkSpaces® Client's Username and Password fields, respectively.
7. Click Sign In. (If you are prompted with a Remember Me option, click No.) Your Workspace Desktop session will begin.

Force Logout of a Shared Workspace

The 'Workspaces' desktop type is one Tehama's Windows-based desktop offerings.

Occasionally a shared Workspace instance may remain in a logged-in state even though no user is actually using the Desktop. For example, a user may have neglected to log themselves out before leaving on vacation. Or a user may have closed the Workspace application window instead of explicitly logging out. To free up a desktop so it can be used again, follow these steps:

1. Locate the entry for the Desktop (of type Workspace - shared) to which you want to connect in the Tehama Web UI.
2. Click on the Log out current user ... button in the entry. The LOG OUT warning dialog will appear.
3. Place a checkmark in the checkbox next to the "I understand" statement.
4. Click LOG OUT.

Request a custom image of a Workspace

This is available for 'Workspaces' only.

Read the Custom Specifications User Guide to learn what a custom specification is and how to prepare your Desktop instance before requesting the creation of a custom image and specification.

See the 'Create a custom specification' section in the Custom Specifications User Guide for details on how to request a custom image.

Note, it will take up to the end of the next business day for your custom specification to become available. You will be notified once it is ready for use.

Restart a Desktop

The steps to restart a Desktop vary by type:

• Restart a Desktop from the top navigation bar's DESKTOPS tab
• Restart a Desktop from the Room's WORK tab

Restart a Desktop from the top navigation bar's DESKTOPS tab

Restart a Desktop from the Tehama Web UI top navigation bar's DESKTOPS tab.

1. Log in to the Tehama Web UI.
2. Click on the DESKTOPS tab.
3. Click the My Desktops radio button at the top of the page. (NOTE: If you are a Staff member in the organization, you will not see this radio button. The list will be restricted to only your assigned Desktops by default.)
4. Locate the entry with the name of the Desktop which you want to restart and the name of the Room to which it belongs.
5. Click on the three vertical dots under the Actions column in the Desktop's entry.
6. Select "Restart Desktop". This will display the RESTART DESKTOP dialog.
7. Read the warning in the dialog: "Any currently connected users will be disconnected, and all unsaved work will be lost."
8. If you wish to proceed with the restart (reboot) of your Desktop, select YES. Otherwise, select NO.

Note that the restart may take 5 - 10 minutes to complete.

Restart a Desktop from the Room's WORK tab

Restart a Desktop from the Tehama Web UI Room's WORK tab.

1. Log in to the Tehama Web UI.
2. Click on the ROOMS tab.
3. Click on the name of the Room to which the Desktop you want to restart belongs. You will see the Room's interface.
4. Click the Room's WORK tab.
5. Click on the MY DESKTOPS sidebar item.
6. Locate the entry with the name of the Desktop which you want to restart.
7. Click on the three vertical dots under the Actions column in the Desktop's entry.
8. Select "Restart Desktop". This will display the RESTART DESKTOP dialog.
9. Read the warning in the dialog: "Any currently connected users will be disconnected, and all unsaved work will be lost."
10. If you wish to proceed with the restart (reboot) of your Desktop, select YES. Otherwise, select NO.

Note that the restart may take 5 - 10 minutes to complete.

Start Desktop Agent

The Desktop Agent will normally start up automatically in a Desktop session. If it is not running, you can start it from the session menu.

For Desktops of type 'Tehama Windows Desktops':

(See instructions to connect to a Desktop of type 'Tehama Windows Desktop' here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the Desktop Agent's icon in the desktop. (The icon's name is 'Workspace Agent', which is another name for the 'Desktop Agent'. See the section 'Desktop vs Workspace' above.)
   
   That will bring up the Desktop Agent application.

Alternately:

1. Type workspace-agent.exe in the search bar in the task bar. You will be presented with the command to run.
2. Click on the command to run it.

For Desktops of type 'Workspaces':

(See instructions to connect to a Desktop of type 'Workspaces' here: Connect to a Desktop of type Workspace.)

From a connected session:

1. Click on the Desktop Agent's icon in the desktop. (The icon's name is 'Workspace Agent', which is another name for the 'Desktop Agent'. See the section 'Desktop vs Workspace' above.)
   
   That will bring up the Desktop Agent application.

Alternately:

1. Type workspace-agent.exe in the search bar in the task bar. You will be presented with the command to run.
2. Click on the command to run it.

For Desktops of type 'Tehama Linux Desktops':

(See instructions to connect to a Desktop of type 'Tehama Linux Desktop' here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the KDE menu icon (three dots of progressively larger size in a half-circle followed by a greater-than symbol) in the task bar to open the menu.
2. Type workspace-agent to start a search. You will be presented with the command for the Desktop Agent to run.
3. Click on the command to run it.

View a Desktop's status

You need to be assigned to a Desktop to see its status.

1. Locate the entry for the Desktop for which you want to view the status in the Tehama Web UI.
2. Look for the status icon for the entry under the Status column.

For Desktops of type 'Tehama Windows Desktops' and 'Tehama Linux Desktops':

You can see the status icon in the Desktop's entry:

• building:
  indicates the Desktop has not yet completed building
• available:
  indicates you can connect to the Desktop
• restarting:
  indicates the Desktop is restarting - note that if you are viewing the status at the time when the Desktop is restarted from a connected session, then you will need to reload the page in order to see the ‘restarting’ status
• Error:
  indicates an error in the Desktop, the tooltip provides more info

For Desktops of type 'Workspaces':

You can see the status icon in the Desktop's entry:

• in use:
  for shared Desktops only, indicates someone is connected to the Desktop, the tooltip displays the user name(s)
• available:
  indicates you can connect to the Desktop

Desktop Networking Requirements

VPN clients

Tehama does not provide support for third-party software running on a Tehama Desktop, such as VPN clients.

Each Tehama Desktop, under-the-hood, communicates to its Room infrastructure through a reserved subnet. (If you require specific details of this subnet, please contact Tehama Support).

Be aware that certain VPN configurations will interfere with this communication, interrupting Tehama communication and resulting in service degradation or worse.

If you have configured a VPN client, Tehama Support will only be given to Desktops in the state where the VPN client is not connected. All other VPN troubleshooting should be done between the users of the Tehama Desktop and the owner of the VPN endpoint.

Regions Offering the GPU Memory Configuration

Desktop specifications with the GPU memory configuration option are not available in all regions.

Regions that offer the GPU memory configuration for Windows-based Desktops:

• US East (N. Virginia)
• US West (Oregon)
• EU (Ireland)
• EU (Frankfurt)
• Asia Pacific (Sydney)
• Asia Pacific (Singapore)

Regions that offer the GPU memory configuration for Linux-based Desktops:

• US East (N. Virginia)
• US West (Oregon)
• EU (Ireland)
• Asia Pacific (Sydney)
• Asia Pacific (Singapore)

Regions that do NOT offer the GPU memory configuration for Windows-based Desktops:

• EU (London) - GPU not available for Windows Desktops here
• Canada (Montreal) - GPU not available for Windows Desktops here

Regions that do NOT offer the GPU memory configuration for Linux-based Desktops:

• EU (London) - GPU not available for Linux Desktops here
• Canada (Montreal) - GPU not available for Linux Desktops here
• EU (Frankfurt) - GPU not available for Linux Desktops here

You can view the region for a Room in the View a Room's region section of the Room Connection Status Monitoring/Management User Guide.