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. 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

Tehama Desktops are interchangeably referred to as Tehama Workspaces. To keep things simple the documentation will refer to them as Tehama Desktops, but be aware that you will find references to the term 'workspaces' here and there in the product.

The reason for the two terms is straightforward. Conventionally,

• the term workspace refers to a virtual computer; and
• the term desktop is used as shorthand for a 'graphical desktop' interface, that is, an interface with a 'windows-like' interface, with icons etc.

All current workspace (virtual computer) configurations offered by Tehama, whether Windows or Linux based, have desktop ('graphical desktop') interfaces, leading to the use of the term 'desktop' to refer to all of Tehama's workspace offerings.

Note that in the future, Tehama may offer Linux 'consoles' (AKA 'terminals') that have a command line user interface.

Windows Desktops Types

Tehama currently offers two Windows-based desktop types (AKA Room features) - the Tehama Windows Desktops (Beta) feature (not yet generally available) and the Workspaces feature. A Tehama Room may have just the Workspaces feature enabled or both it and the Tehama Windows Desktops (Beta) 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 type(s) are enabled, that is) from the WINDOWS DESKTOPS sidebar menu item on the Room's CONFIGURE tab.

• Tehama Windows Desktops (Beta) (not generally available at this time)
  ~~~~~~~~~~~~~~~~~~~
  DISCLAIMER: The Windows desktop BETA is still undergoing final testing before its official release. It is provided 'as-is', without any warranties or support, and Tehama will not be liable for any loss of data.
  ~~~~~~~~~~~~~~~~~~~
  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 (Beta) 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 two Linux-based desktop types (AKA Room features) - the Tehama Linux Desktops feature (recommended) and the Linux Legacy Desktops feature. A Tehama Room may have one or both of these features 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 type(s) are enabled, that is) from the LINUX DESKTOPS sidebar menu item on the Room's CONFIGURE tab. If neither type is enabled, then this sidebar menu will not be available.

• Linux Desktops
  This is Tehama's latest and recommended 'Linux Desktops' feature. This 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.

   

• Legacy Linux Desktops
  Tehama's 'Linux Legacy Desktops' feature provides virtual Desktop environments connected via the RDP protocol to Linux-based servers, offered with a range of hardware and software options similar to the Windows Desktops. For Linux Legacy Desktops, the upper range of options provides a fixed CPU performance level, 'non-burstable', while the lower range of options provides a baseline CPU performance level that is 'burstable'. The currently available Operating System is Ubuntu Server 18.04.
  
  
  NOTE: 'burstable' vs 'non-burstable' legacy Linux Desktops Tehama's Linux Legacy Desktops are built on host machines of varying types and sizes. You pick the host machine type/size used for your Desktop through the Specification field when you add or request a Desktop.
  
  The larger two specification options for Linux Legacy Desktops, 'Professional' and 'High Performance Computing', both use host machines that provide a traditional fixed level of CPU performance, non-burstable.
  
  

  Note: Older 'Professional' and 'High Performance Computing' Desktops may have been created as 'burstable'. If you have concerns about the CPU performance of your Desktop, contact Tehama Support for assistance.

  
  The smaller two options, 'Personal' and 'Standard', both use host machines that provide a baseline level of CPU performance with the ability to burst above that baseline level based on CPU credits that are accrued over time by the Desktop, burstable.
  
  

  A good description of CPU credits and burstable performance in AWS EC2 hosts can be found at this link:
  CPU Credits and Baseline Performance for Burstable Performance Instances
  https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-credits-baseline-concepts.html

  
  Contact Tehama Support to discuss which specification option is best for your Linux Legacy Desktop needs.

Multi-monitor Support

Multi-monitor support applies only to Desktops of types 'Tehama Linux Desktops', Tehama Windows Desktops (Beta)', 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 Desktop template's name (or the CONNECT button next to it) 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.

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 Desktop instances can be in use within a Room concurrently.

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 template name in the Desktop Template column 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 (Beta)', 'Tehama Linux Desktops', 'Workspaces' or 'Linux Legacy Desktops'), 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 (Beta) Template
• Add a Workspace Template
• Add a Tehama Linux Desktop Template
• Add a Linux Legacy 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 Wnds Beta

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

Note, 'Tehama Windows Desktops (Beta)' is not generally available at this time. It may not be enabled for your Room.

DISCLAIMER: The Windows desktop BETA is still undergoing final testing before its official release. It is provided 'as-is', without any warranties or support, and Tehama will not be liable for any loss of data.

To add a new Desktop template of type 'Tehama Windows Desktops (Beta)', 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 BETA
   ◯ Workspace
   Select 'Tehama Windows Desktop BETA'.
   • 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 (Beta)' 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 NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) AND REVIEW 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. (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.
13. Read the disclaimer (if any) and review the specification details.
14. Click CREATE. The SUCCESS dialog will appear.
15. 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 BETA
   ◯ 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 NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) AND REVIEW 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.
16. Read the disclaimer (if any) and review the specification details.
17. Click CREATE. The SUCCESS dialog will appear.
18. 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.

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 either the Linux Legacy Desktops feature enabled (note support for enabling this feature is suspended) nor 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. You may see two choices at the top of the dialog.
   ◯ Linux Desktop
   ◯ Linux (Legacy)
   Select 'Linux Desktop'.
   • Note: If there are no choices, then your Room only supports one type of Linux-based Desktop. If it is the 'Linux Legacy Desktop', then Desktops of the type 'Tehama Linux Desktops' are not enabled for your Room.
     • How to tell the difference? The initial creation dialog looks the same for both types of Linux-based Desktop templates, but on the next dialog, where you assign members to the desktop, 'Linux Legacy Desktops' shows you a 'Multi User Desktop' checkbox, while the 'Tehama Linux Desktops' does not.
8. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
9. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
10. 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.
11. Click on the NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
12. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
13. 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.
    • Note that the user(s) assigned to this Desktop template will be given full sudo user capabilities on the Desktop instance built for them from the template.
14. Click NEXT: REVIEW. The REVIEW dialog will appear.
15. Review the specification details.
16. Click CREATE. 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 Linux Legacy

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

To add a new Desktop template of type 'Linux Legacy 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 either the Linux Legacy Desktops feature enabled (note support for enabling this feature is suspended) nor 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. You may see two choices at the top of the dialog.
   ◯ Linux Desktop
   ◯ Linux (Legacy)
   Select 'Linux (Legacy)'.
   • Note: If there are no choices, then your Room only supports one type of Linux-based Desktop. If it is the 'Tehama Linux Desktop', then Desktops of the type 'Linux Legacy Desktops' are not enabled for your Room.
     • How to tell the difference? The initial creation dialog looks the same for both types of Linux-based Desktop templates, but on the next dialog, where you assign members to the desktop, 'Linux Legacy Desktops' shows you a 'Multi User Desktop' checkbox, while the 'Tehama Linux Desktops' does not.
8. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
9. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
10. Choose the specification (Hardware specifications). Once a value has been selected, values for it will appear in the dialog..
    • Note that for Linux Legacy Desktop templates, the Specification field choices 'Personal', 'Standard' both have burstable CPU performance, while the choices 'Professional' and 'High Performance Computing' both have non-burstable performance.
    • 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.
11. Click on the NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
12. Opt for either a multi-user Desktop or single user Desktops and fill out the remaining fields:
    WARNING: Once the Desktop is created it is not possible to convert a single user Desktop to multi-user.
    1. To create single user Desktops (one for each User) from this template:
       1. Leave the Multi User Desktop checkbox unchecked.
       2. In the User field, enter the name of the Room member who will be assigned to this Desktop template. (The field cannot be left empty.)
       3. Note that the single user assigned to this Desktop template will be given full sudo user capabilities on the Desktop instance built from the template.
    2. To create a multi-user Desktop (one for all Users to share) from this template:
       1. Place a checkmark in the Multi User Desktop checkbox. The User field will change to Users and a new field, Sudo Users, will appear on the dialog.
       2. In the Users field, enter the names of those who will be assigned to this Desktop template. (There must be at least one name specified.) The users will share one Desktop instance.
       3. In the Sudo Users field, enter the name(s) of those users who will be given the ability to perform certain operations with elevated privileges, such as using the package manager, on the Desktop instance built from the template.
13. Click NEXT: REVIEW. The REVIEW dialog will appear.
14. Read the disclaimer (if any) and review the specification details.
15. Click CREATE. 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 (Beta)', 'Tehama Linux Desktops', 'Workspaces' or 'Linux Legacy Desktops'), 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 (Beta) Template
• Request a Workspace Template
• Request a Tehama Linux Desktop Template
• Request a Linux Legacy 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 Wnds Beta

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

Note, 'Tehama Windows Desktops (Beta)' is not generally available at this time. It may not be enabled for your Room.

DISCLAIMER: The Windows desktop BETA is still undergoing final testing before its official release. It is provided 'as-is', without any warranties or support, and Tehama will not be liable for any loss of data.

To request a new Desktop template of type 'Tehama Windows Desktops (Beta)', 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 BETA
   ◯ Workspace
   Select 'Tehama Windows Desktop BETA'.
   • 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 (Beta)' 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 NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) AND REVIEW 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. (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.
15. Read the disclaimer (if any) and review the specification details.
16. Click REQUEST. The SUCCESS dialog will appear.
17. 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 BETA
   ◯ 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 NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) AND REVIEW 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.
18. Read the disclaimer (if any) and 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 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.

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 either the Linux Legacy Desktops feature enabled (note support for enabling this feature is suspended) nor the Tehama Linux Desktops feature enabled.
8. Click on CONTINUE. The REQUEST LINUX DESKTOP TEMPLATE dialog will appear.
9. You may see two choices at the top of the dialog.
   ◯ Linux Desktop
   ◯ Linux (Legacy)
   Select 'Linux Desktop'.
   • Note: If there are no choices, then your Room only supports one type of Linux-based Desktop. If it is the 'Linux Legacy Desktop', then Desktops of the type 'Tehama Linux Desktops' are not enabled for your Room.
     • How to tell the difference? The initial creation dialog looks the same for both types of Linux-based Desktop templates, but on the next dialog, where you assign members to the desktop, 'Linux Legacy Desktops' shows you a 'Multi User Desktop' checkbox, while the 'Tehama Linux Desktops' does not.
10. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
11. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
12. 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.
13. Click on the NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(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.
    • Note that the user(s) assigned to this Desktop template will be given full sudo user capabilities on the Desktop instance built for them from the template.
16. Click NEXT: REVIEW. The REVIEW dialog will appear.
17. Review the specification details.
18. Click REQUEST.
    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.

 • request Linux Legacy

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

To request a new Desktop template of type 'Linux Legacy 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 either the Linux Legacy Desktops feature enabled (note support for enabling this feature is suspended) nor the Tehama Linux Desktops feature enabled.
8. Click on CONTINUE. The REQUEST LINUX DESKTOP TEMPLATE dialog will appear.
9. You may see two choices at the top of the dialog.
   ◯ Linux Desktop
   ◯ Linux (Legacy)
   Select 'Linux (Legacy)'.
   • Note: If there are no choices, then your Room only supports one type of Linux-based Desktop. If it is the 'Tehama Linux Desktop', then Desktops of the type 'Linux Legacy Desktops' are not enabled for your Room.
     • How to tell the difference? The initial creation dialog looks the same for both types of Linux-based Desktop templates, but on the next dialog, where you assign members to the desktop, 'Linux Legacy Desktops' shows you a 'Multi User Desktop' checkbox, while the 'Tehama Linux Desktops' does not.
10. Enter the name of the Desktop (a friendly name used to identify the Desktop function or owner).
11. Choose the operating system. Currently the only supported choice is Ubuntu 18.04.
12. Choose the specification (Hardware specifications). Once a value has been selected, values for it will appear in the dialog..
    • Note that for Linux Legacy Desktop templates, the Specification field choices 'Personal', 'Standard' both have burstable CPU performance, while the choices 'Professional' and 'High Performance Computing' both have non-burstable performance.
    • 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.
13. Click on the NEXT: ASSIGN MEMBER(S) AND REVIEW button. The ASSIGN MEMBER(S) dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)
14. Opt for either a multi-user Desktop or a single user Desktop and fill out the remaining fields:
    WARNING: Once the Desktop is created it is not possible to convert a single user Desktop to multi-user.
    1. To create single user Desktops (one for each User) from this template:
       1. Leave the Multi User Desktop checkbox unchecked.
       2. In the User field, enter the name of the Room member who will be assigned to this Desktop template. (The field cannot be left empty.)
       3. Note that the single user assigned to this Desktop template will be given full sudo user capabilities on the Desktop instance built from the template.
    2. To create a multi-user Desktop (one for all Users to share) from this template:
       1. Place a checkmark in the Multi User Desktop checkbox. The User field will change to Users and a new field, Sudo Users, will appear on the dialog.
       2. In the Users field, enter the names of those who will be assigned to this Desktop template. (There must be at least one name specified.) The users will share one Desktop instance.
       3. In the Sudo Users field, enter the name(s) of those users who will be given the ability to perform certain operations with elevated privileges, such as using the package manager, on the Desktop instance built from the template.
15. Click NEXT: REVIEW. The REVIEW dialog will appear.
16. Read the disclaimer (if any) and review the specification details.
17. Click REQUEST.
    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 (and also Sudo Users for pending multi-user Linux Legacy Desktop templates) 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.

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 "Desktop Template" field in the entry you wish to edit.
8. 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.
9. 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 (and also Sudo Users for pending multi-user Linux Legacy Desktop templates) are editable, but the specification details are not.
10. Click SAVE. Note that attempts to remove all users from a Desktop will result in an error.

Note: If you are editing a multi-user Linux Legacy Desktop template and change the value in the Sudo Users field, then you will see the Restart Linux Desktop dialog after clicking SAVE:

This dialog advises you that changes to sudo privileges will not take effect until the Linux Legacy Desktop instance is restarted. Restarting the Linux Legacy Desktop will end all current user sessions. It is a disruptive action and users should be informed that a restart is about to occur and they may lose data if they do not save their work. Click RESTART LATER if you want to restart the Desktop at a later time or click RESTART NOW to restart the Desktop immediately.

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 "Desktop Template" field in the entry you wish to 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.

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 "Desktop Template" field in the entry you wish to delete.
8. Select the pending Desktop you wish to delete by placing a checkmark in the checkbox to the left of the Desktop's name.
9. At the bottom of the page, click the Trash Can icon. You will see the DELETE DESKTOP REQUEST dialog.
10. 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, either with a single-click or with credentials.

Download and install the Tehama Desktop Client ('Tehama App') and the Teradici PCoIP Desktop Client on to your device before attempting to launch a Desktop (other than 'Linux Legacy Desktops') 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 page provides you with information about the Tehama Client.
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 (except for those of type Linux Legacy) in the DESKTOPS page. This will launch your Desktop instance as a standalone application.

Note that if you neglect to download and install the Tehama Client before attempting to connect to one of your Desktops via the single-click connect capability, you will be prompted to download it, as follows.

1. Click on the CONNECT button in the entry.
   • If your device ALREADY HAS THE TEHAMA CLIENT INSTALLED, this will launch your Desktop instance as a standalone application (except for 'Linux Legacy Desktops' which do not require the Tehama Client). The Launching your Desktop dialog will appear while your desktop is launching. Dismiss this dialog once your desktop launches successfully.
   • If your device does NOT ALREADY HAVE THE TEHAMA CLIENT INSTALLED - the most likely scenario if you are following these steps - the Launching your Desktop dialog will appear but your desktop will not launch. Proceed with downloading and installing the Tehama Client on your device.
2. Click on the words DOWNLOAD and INSTALL on the Launching your Desktop dialog. You will see the Download Tehama Client dialog appear. You can download the desktop clients from this dialog.
3. Click the icon for your device's operating system (Linux, Windows or MacOS) to download the desktop clients onto your device.
4. Follow any installation/configuration instructions that are provided in the downloaded artifact(s).
5. Return to the Launching your Desktop dialog from the Download Tehama Client dialog by clicking on the back arrow in the top left corner.
6. You can test the single-click connect capability by clicking on the Retry link in the Launching your Desktop 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 (of any type):

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 Desktop instances can be in use within a Room concurrently.
3. Click on the CONNECT button in the entry.
   
   
   • For 'Linux Legacy Desktops':
     • This will launch your 'Linux Legacy Desktop' instance in a new tab in your browser.
       Once the Desktop is visible, the first thing you will see is the options menu.
       Simply close the options menu to continue.
       
       
   • For all Desktop types except 'Linux Legacy Desktops':
     • This will launch your Desktop instance as a standalone application.
       
       The Launching your Desktop dialog will appear while your Desktop is launching. Dismiss this dialog once your Desktop launches successfully.
       
       
       IMPORTANT Your Desktop will fail to launch unless you have downloaded the Tehama Desktop Client ('Tehama App') and the Teradici PCoIP Desktop Client to your device.
       
       Follow the steps in section Download the Tehama Client onto Your Device. This is a one time action per device.
       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 Launching your Desktop dialog, you can manually connect to your desktop from the Teradici desktop client's user interface with credentials. See section 'Connect to a Desktop (with credentials)'.

Connect to a Desktop (with credentials)

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 Launching your Desktop dialog, you can manually connect to your desktop from the Teradici desktop client's user interface with credentials.

(Note, this is not available for Desktops of type 'Linux Legacy Desktops'.)

1. Locate the entry for the Desktop to which you want to connect in the Tehama Web UI.
2. Select the "Connect with Credentials" menu item in the Actions menu for the entry. The Connect with Credentials dialog will appear. This dialog provides the credentials needed for manual connection.
3. Launch the Teradici PCoIP desktop 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 desktop 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 desktop client's "Connection Name" field.
6. Click NEXT in the desktop client.
7. Copy the User Name field value from the Connect with Credentials dialog into the "Username" field in the desktop client.
8. Copy the Password field value from the Connect with Credentials dialog into the "Password" field in the desktop client. (To view the Password value as plaintext, click on the 'eye' symbol in the field.)
9. Click LOGIN in the desktop client. This will launch your Desktop instance as a standalone application.

Connect to a Workspace with 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 with 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 Windows 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 Linux Legacy Desktop from the Room's CONFIGURE tab
• Restart a Linux Legacy Desktop from a connected session

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.

Restart a Linux Legacy Desktop from the Room's CONFIGURE tab

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

Restart a Linux Legacy Desktop from the Tehama Web UI Room's CONFIGURE tab.

Only available for the Admin user and Org Managers and Room Managers (who are members of the Room) of the Room's owner organization.

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 CONFIGURE tab.
5. Click on the LINUX 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 of the Desktop, select YES. Otherwise, select NO.

Restart a Linux Legacy Desktop from the connected Desktop session

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

Restart a Linux Legacy Desktop from the menu in a connected Desktop session.

(See instructions to connect to a Linux Legacy Desktop here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the menu icon in the top right corner of the display to open the options menu.
   
2. Click on your name, then select "Disconnect" from the dropdown menu.
   You will see the following screen:
   
3. Click RESTART. This will display the following screen:
   
4. Click on YES if you want to continue with the Desktop restart. Otherwise, click on NO.
5. If you clicked YES, you will see the following dialog:
   

Once the restart has completed successfully you will see a success message saying your Desktop is now available for you to use.

Change the resolution of your Linux Legacy Desktop

Applicable to Linux Legacy Desktops only.

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

Change the resolution of a Linux Legacy Desktop from the menu in a connected Desktop session.

WARNING: Note that changing the resolution of your Desktop will end your currently active session. If you are logged in you may lose unsaved work.

(See instructions to connect to a Linux Legacy Desktop here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the menu icon in the top right corner of the display to open the options menu.
   
2. Click on the Change Desktop Resolution button in the options menu.
   This will display the change resolution dialog.
   
   
   WARNING: Note that changing the resolution of your Desktop will end your currently active session. If you are logged in you may lose unsaved work.
   
   
3. If you wish to cancel the operation, select the X in the top right corner of the dialog to dismiss it.
4. If you wish to proceed, select your new resolution.
   
   Note the following two options among the preset resolutions you can choose from:
   
   
   • Fit to Screen: This option sets your resolution to match the total resolution of the monitor where your browser is currently placed. This option is useful with the full-screen option.
   • Fit to Browser: This option sets your resolution to match the resolution of your browser viewport. This is the default resolution for newer Linux Desktops.
     
     
5. Click UPDATE AND RESTART. You will see the following screen:
   
6. Click on RECONNECT to change your Desktop's resolution and reconnect.

View a Linux Legacy Desktop in fullscreen mode

Applicable to Linux Legacy Desktops only.

Note, fullscreen mode is not supported in Internet Explorer (IE). Please use a different browser if you wish to view your Linux Legacy Desktop in fullscreen mode.

Change the view of a Linux Legacy Desktop to fullscreen while in a connected Desktop session.

(See instructions to connect to a Linux Legacy Desktop here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the 'fullscreen' icon in the top right corner of the display, just beneath the menu icon, .

Your Linux Legacy Desktop will now fill the screen.

Click on ESC to leave fullscreen mode.

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 (Beta)':

(See instructions to connect to a Desktop of type 'Tehama Windows Desktop (Beta)' 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 'Linux Legacy Desktops':

(See instructions to connect to a Linux Legacy Desktop here: Connect to a Desktop (single click).)

From a connected session:

1. Click on the Mate menu icon , in the top left corner of the display.
2. Click on "Accessories".
   
3. Click on "workspace-agent". That will bring up the Desktop Agent application.

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 (Beta)' 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

For Desktops of type 'Linux Legacy 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
• in use:
  for shared Desktops only (multi-user), indicates someone is connected to the Desktop, the tooltip displays the user name(s)
• restarting:
  indicates the Desktop is restarting - note that if you are viewing 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

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.