Desktops User Guide

  • Updated
Follow

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

There are two types of Tehama Desktops:

NOTE: Tehama currently offers two Linux Desktop features - the (recommended) Linux Desktop feature and the legacy Linux Desktop feature.

It is possible for a Room to support both the legacy Linux Desktop feature and the Linux Desktop feature simultaneously, or one or the other individually.

If your Room has either or both of these features enabled, the admin and managers of the Room's owner organization will see the LINUX DESKTOPS sidebar menu item on the Room's CONFIGURE tab.

Contact Tehama Support to enable or disable the Linux Desktops feature in your Room.

Support for enabling the legacy Linux Desktops feature in Tehama Rooms has been suspended. Rooms that already have the legacy Linux Desktops feature enabled will continue to have access to legacy Linux Desktops. Rooms that do not have the feature enabled will be unable to get it enabled. Rooms that get the feature disabled will be unable to get it re-enabled. Contact Tehama Support if you have any questions.

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.

  • Windows Desktops

    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.

    IMPORTANT NOTE: Tehama supports multi-monitor Windows Desktops ONLY in the case where the Desktop's Room has session recording disabled. For Tehama Windows Desktops in Rooms that have session recording enabled (this is the default behaviour) in which you enable full-screen and your full-screen setting spans multiple monitors, the Desktop will be disconnected in 15 seconds. To toggle off full-screen in your Tehama Windows Desktop, use the AWS Workspace hotkey Ctrl-Alt-Enter.

    Contact Tehama Support to discuss enabling/disabling the Room session recording option.

     

  • Linux Desktops
    • 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 'legacy Linux 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 legacy Linux 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 legacy Linux 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 legacy Linux 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.


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

       

You can configure and work with your Desktops as follows:

Privileged user actions: Non-privileged user actions:
View list of your assigned Desktop templates in your Organization View list of your Desktop templates in your Organization
View list of your assigned Desktop templates in a Room View list of your assigned Desktop templates in a Room
View all Desktop templates in a Room View all Desktop templates in a Room
Add a Desktop template  
  Request a Desktop template
Approve or reject a pending Desktop template request  
Edit a Desktop template  
Edit a pending Desktop template request Edit a pending Desktop template request
Delete a Desktop template  
Delete a pending Desktop template request Delete a pending Desktop template request
Connect to a Desktop Connect to a Desktop
Force logout of a Shared Windows Desktop Force logout of a Shared Windows Desktop
Request a custom image of a Windows Desktop  
Restart a Desktop Restart a Desktop
Change the resolution of a Linux Desktop Change the resolution of a Linux Desktop
View a Linux Desktop in fullscreen mode View a Linux Desktop in fullscreen mode
Start Desktop Agent Start Desktop Agent
View a Desktop's status View a Desktop's status

where ...

Privileged user:
The admin user or manager 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 managers of this organization have the privilege of deciding whether or not a Desktop is created.

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

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

These actions are performed from the CONFIGURE and WORK tabs in your Room's interface.

The WINDOWS DESKTOPS page under CONFIGURE tab for privileged users:

Configure Windows Desktops Page for Privileged Users Note that the Windows Desktop list is filterable on the Mode and Status columns and can be sorted on all columns except for Status.

The LINUX DESKTOPS page under CONFIGURE tab for privileged users:

Configure Linux Desktops Page for Privileged Users

Note that the Linux Desktop list can be sorted on all columns except for Status and Actions.

The MY DESKTOPS page under the WORK tab for the privileged users:

Work My Desktops Page for Privileged Users

Note that the "My Desktop" list can be sorted on all columns except for Actions.

The MY DESKTOPS page under the WORK tab for non-privileged users:

Work My Desktops Page for the Non-privileged Users

Note that the "My Desktop" list can be sorted on all columns except for Actions.

The PENDING DESKTOPS page under the WORK tab for non-privileged users:

Work Pending Desktops Page for the Non-privileged Users

Note that the "Pending Desktop" list can be sorted on all columns except for Status.

Note that an entry whose text overruns the column can be expanded by clicking within the text field in the entry. (Avoid clicking on the text itself if it is a link.) See below where the third entry in the above example of the WINDOWS DESKTOPS page under the CONFIGURE has been expanded:

Configure Windows Desktops Page for Privileged Users

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.

View list of your assigned Desktop templates in your Organization

A user assigned to a Desktop template can see that Desktop template in the DESKTOPS tab for the organization.

The admin user and managers of an organization can view lists of Desktop templates in the organization as follows:

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

The admin user and managers of an organization can view a list of all Desktops templates in Rooms that they are members of (Rooms within the organization).

The admin users and managers of a Room's owner organization (user+owner or owner+connected) can view the lists of all Desktop templates for each Room in the organization individually. (See View All Desktop Templates in a Room.)

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

The admin user and managers of an organization can view a list of the Desktop templates that are in-use that are in Rooms that they are members of (Rooms within the 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

Only a user assigned to a Desktop template can see that Desktop template in the Room's list of "My Desktops".

The admin users and managers of a Room's owner organization (user+owner or owner+connected) can view the lists of all Desktop templates for the Room. (See View All 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 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

Only the admin user and managers of a Room's owner organization (owner+connected or user+owner) can see the lists of the Desktops templates in the 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

Only the admin user and managers of a Room's owner organization (owner+connected or user+owner) can add a new Desktop template to the Room directly.

The admin users and managers of a Room's non-owner organizations (user_only and connected_only) and members of the Room that are staff members in their organizations can instead request a new Desktop template be added to the Room. (See Request a Desktop Template.)

Desktop templates define the type (operating system: Windows or Linux), 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 an instance (in some cases shared) of the Desktop template to connect to.

Steps to add a Desktop template vary by type:

NOTE: You can also add a Windows or Linux Desktop template from the Room's members tab. See section Assign members to Desktop Template in the Room Membership User Guide.

Add a Windows Desktop Template:

To add a new Windows 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 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:

    Add Windows Desktop Template Dialog

  7. In the dialog:
    • Enter the name for your Desktop Template.
    • 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.)
    • 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.
    • 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.
    • In the Always On field, select
      EITHER
      Power Save Mode, – 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. (Always On is not available for the GPU specification for Windows Desktops.)
  8. Click NEXT: ASSIGN TO MEMBERS. The ASSIGN WINDOWS DESKTOP TEMPLATE dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)

    Add Windows Desktop Template Dialog - Assign Members
  9. Click on the Users field to open the list of Room members that you can assign to this Desktop template.
  10. 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.
  11. Click SAVE TEMPLATE AND ASSIGN TO MEMBERS. The SUCCESS dialog will appear.
  12. Click CLOSE to dismiss the SUCCESS dialog.

    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 instances built from this template for them from the MY DESKTOPS page under the WORK tab in the Room.

A Note on Shared Windows Desktops

An individual Windows Desktop instance is accessed through a unique username for that Desktop. The username is NOT unique to the individual user (the user logging in to the instance). Multiple users who wish to access the same Windows Desktop instance will do so using a shared/common username. This will impose the following risks in the Windows environment:

  1. There is no user level local file space on the Desktop. All files, application settings and personalization configured within the windows host will be accessible to ALL individuals who access that Desktop. For Example:
    1. Application Specific Configuration, Including:
      1. Saved hosts/password settings entered into PuTTY or WinSCP
      2. Personal Details
      3. Browsing Data (Cookies, Cache, History)
    2. Saved usernames and passwords stored in the browser (e.g. Internet Explorer or Google Chrome)
    3. Windows Personalizations
    4. Files added/created
  2. No individual user logging/traceability. Windows log files will be unable to identify a specific individual logged into Windows when searching for a specific event. All user logs will appear from the shared username (unique to the Windows VM).

The Tehama platform DOES however offer the following individual user level feature:

  • Session Recordings. Stored session recordings are stored and associated to an individual Tehama user. For ease of playback, the recordings are marked with the individual usernames.

If a per-user Desktop experience is required, it is recommended to instantiate an Individual Desktop.

Add a Linux Desktop Template:

To add a new Linux Desktop template, click on the CONFIGURE tab, select the LINUX DESKTOPS sidebar item and click on the ADD LINUX DESKTOP TEMPLATE button at the top right of the page.

In order to see the LINUX DESKTOPS sidebar item, your Room must have the legacy Linux Desktop feature enabled (note support for enabling this feature is suspended) or your room must have the Linux Desktop feature enabled.

To add a new Linux 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 the LINUX DESKTOPS sidebar item.
  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 (Legacy)     ◯ Linux Desktop

    The "Linux (Legacy)" selection is for the desktop provided by Tehama's legacy Linux Desktops feature.

    The "Linux Desktop" selection is for the desktop provided by Tehama's Linux Desktops feature (recommended).

    Select the type of Linux Desktop you desire.

    If there are no choices, then your Room only supports one type of Linux Desktop, most likely from the recommended Linux Desktops feature.

    A quick way to differentiate between the two types of Linux desktops is on the next dialog where you assign members to the desktop. Legacy desktops allow you to specify multiple users while the other does not.

  8. Enter the requested information:

    • Name of Desktop (friendly name used to identify the Desktop function or owner)
    • Operating System - choose one of the supported operating systems.
    • Specification (Hardware specifications) - choose one of the supported specifications. Once a value has been selected, values for it will appear in the dialog..
      • Note that for legacy Linux 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.
  9. Click on the NEXT: ASSIGN MEMBERS button. The ASSIGN MEMBERS dialog will appear.

    (Click on the arrow to the left of the dialog title to return to the previous dialog.)

    For Linux Desktop templates only:
    • Click on the Users field to open the list of Room members that you can assign to this Desktop template.
    • 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.

    For legacy Linux Desktop templates only:
    • If you want this to be a multi-user Desktop, select the Multi User Desktop checkbox. WARNING: Once the Desktop is created it is not possible to convert a single user Desktop to multi-user.
      If selected, the User field changes to Users and a new field, Sudo Users appears. New fields for multi-user Linux request Desktop
    • If single user:
      • 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.)
      • 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.
    • If multi user:
      • 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.
      • 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.
  10. Click NEXT: REVIEW. The REVIEW dialog will appear.
  11. Read the disclaimer (if any) and review the specification details.
  12. 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

Only the admin users and managers of a Room's non-owner organizations (connected_only and user+only) and members of the Room that are staff members in their organizations can request a new Desktop template be added to the Room.

The admin user and managers of a Room's owner organization (connected+owner or user+owner) can instead directly add new Desktop templates to the Room.

You can request a new Desktop template. The request is sent to the admin user and the managers of the Room's owner organization (sometimes called the billing organization), that is the privileged users, who can either approve or reject your request.

Desktop templates define the type (operating system: Windows or Linux), 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 an instance (in some cases shared) of the Desktop template to connect to.

Steps to request a Desktop template vary by type:

NOTE: You can also request a Windows or Linux Desktop template from the Room's members tab. See section Assign members to Desktop in the Room Membership User Guide.

Request a Windows Desktop template:

To request a new Windows 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 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:
    Request Desktop 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.

    Request Windows Desktop Template Dialog

  9. In the dialog:
    • Enter the name for your Desktop Template.
    • 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.)
    • 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.
    • 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.
    • In the Always On field, select
      EITHER
      Power Save Mode, – 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. (Always On is not available for the GPU specification for Windows Desktops.)
  10. Click NEXT: REQUEST TEMPLATE AND ASSIGN MEMBERS. The ASSIGN WINDOWS DESKTOP TEMPLATE dialog will appear. (Click on the arrow to the left of the dialog title to return to the previous dialog.)

    Request Windows Desktop Template Dialog - Assign Members
  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. Click SAVE TEMPLATE AND ASSIGN TO MEMBERS. The SUCCESS dialog will appear.
  14. Click CLOSE to dismiss the SUCCESS dialog.

    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 WORK tab. If you are not a member of the Room's owner organization, it will appear under the PENDING DESKTOPS page in the WORK tab of the admin user and managers of your organization. It will appear to the admin user and the managers of the Room's owner organization on the WINDOWS DESKTOPS page in the CONFIGURE tab, marked as a proposed Desktop template, awaiting review.

    If approved, Room members that are assigned to the Desktop template will be able to connect to the Desktop instances built from this template for them from the MY DESKTOPS page under the WORK tab in the Room.

    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 a Linux Desktop Template:

In order to see the "Linux" type of Desktop in the Operating System dropdown field in the REQUEST DESKTOP TEMPLATE dialog in step seven, your Room must have the legacy Linux Desktop feature enabled (note support for enabling this feature is suspended) or your room must have the Linux Desktop feature enabled.

To request a new Linux 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 WORK tab.
  5. Click on either the MY DESKTOPS sidebar item or the PENDING DESKTOPS sidebar item.
  6. Click on the NEW DESKTOP TEMPLATE button at the top right of the page. This will display the REQUEST DESKTOP TEMPLATE dialog:
    Request Desktop Dialog
  7. In the REQUEST DESKTOP TEMPLATE dialog, select the "Linux" type of Desktop from the Operating System dropdown field.
  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 (Legacy)     ◯ Linux Desktop

    The "Linux (Legacy)" selection is for the desktop provided by Tehama's legacy Linux Desktops feature.

    The "Linux Desktop" selection is for the desktop provided by Tehama's Linux Desktops feature (recommended).

    Select the type of Linux Desktop you desire.

    If there are no choices, then your Room only supports one type of Linux Desktop, most likely from the recommended Linux Desktops feature.

    A quick way to differentiate between the two types of Linux desktops is on the next dialog where you can assign members to the desktop. Legacy desktops allow you to specify multiple users while the other does not.

  10. Enter the requested information:

    • Name of Desktop (friendly name used to identify the Desktop function or owner)
    • Operating System - choose one of the supported operating systems.
    • Specification (Hardware specifications) - choose one of the supported specifications. Once a value has been selected, values for it will appear in the dialog..
      • Note that for legacy Linux 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 MEMBERS button. The ASSIGN MEMBERS dialog will appear.

    (Click on the arrow to the left of the dialog title to return to the previous dialog.)

    For Linux Desktop templates only:
    • Click on the Users field to open the list of Room members that you can assign to this Desktop template.
    • 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.

    For legacy Linux Desktop templates only:
    • If you want this to be a multi-user Desktop, select the Multi User Desktop checkbox. WARNING: Once the Desktop is created it is not possible to convert a single user Desktop to multi-user.
      If selected, the User field changes to Users and a new field, Sudo Users appears. New fields for multi-user Linux request Desktop
    • If single user:
      • 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.)
      • 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.
    • If multi user:
      • 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.
      • 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.
  12. Click NEXT: REVIEW. The REVIEW dialog will appear.
  13. Read the disclaimer (if any) and review the specification details.
  14. 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 WORK tab. If you are not a member of the Room's owner organization, it will appear under the PENDING DESKTOPS page in the WORK tab of the admin user and managers of your organization. It will appear to the admin user and the managers of the Room's owner organization on the LINUX DESKTOPS page in the CONFIGURE tab, marked as a proposed Desktop template, awaiting review.

    If approved, instances of your requested Desktop template will appear in the lists of Desktops under the MY DESKTOPS page of the users assigned to the Desktop. 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

Only the admin user and managers of a Room's owner organization (owner+connected or user+owner) can approve or reject a pending Desktop template request in the Room.

You, as the admin user or a manager 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.

    For pending Windows Desktop templates:
    Review Desktop Windows Dialog

    For pending Linux Desktop templates (left for single-user, right for multi-user):
    Review Desktop Linux Dialog

  8. Browse the Desktop details in the request, including the the description field containing the reason for the request. (Note that the name and user fields are editable (and sudo users for pending Linux multi-user Desktop templates), 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:
      Reject Desktop Dialog
      Enter the reason you want to reject the pending Desktop template request into the dialog, then click REJECT.

Edit a Desktop template

Only the admin user and managers of a Room's owner organization (owner+connected or user+owner) can edit an already approved Desktop template in the Room.

The admin users and managers of a Room's non-owner organizations (user_only and connected_only) can only edit Desktop templates in the Room made by their organizations that have not already been approved (pending Desktop templates). Room members who are staff members of their organizations can similarly only edit those pending Desktop requests that they themselves have made that have not yet been approved. (See Edit a pending Desktop request.)

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

To edit an existing Desktop template, click on the name of the Desktop template that you wish to edit.

  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 Desktop templates:
    Edit Windows Desktop Dialog

    Or the EDIT LINUX DESKTOP TEMPLATE dialog for Linux Desktop templates (left for single-user, right for multi-user):
    Edit Linux Desktop Dialog
  9. Make your changes in the dialog.
  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 Desktop template and change the value in the Sudo Users field, then you will see the Restart Linux Desktop dialog after clicking SAVE:

Restart Linux Desktop Dialog

This dialog advises you that changes to sudo privileges will not take effect until the Linux Desktop is restarted. Restarting the Linux 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

The admin users and managers of a Room's non-owner organizations (user-only and connected-only) can fully edit pending Desktop template requests in the Room made by their organizations. Room members who are staff members of their organizations can edit those pending Desktops template requests that they themselves have made.

The admin user and managers of a Room's owner organization (owner+connected or user+owner) can edit a restricted set of fields in pending Desktop template requests in the Room while reviewing them for approval. (See Approve or reject a pending Desktop template request.)

To edit a pending Desktop template request - as an admin user or manager of a non-Room owner organizations:

  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 EDIT DESKTOP TEMPLATE REQUEST dialog for Windows Desktops templates:
    Edit Windows Desktop Request Dialog
    Note: When editing the specification field for Windows Desktops, be aware that the Always On option is not available for the GPU specification.

    Or the EDIT DESKTOP TEMPLATE REQUEST dialog for Linux Desktop templates (left for single-user, right for multi-user):
    Edit Linux Desktop Request Dialog

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

The admin users and managers of a Room's owner organizations (owner+connected or user+owner) can delete already approved Desktop templates in the Room.

The admin users and managers of a Room's non-owner organizations (user-only and connected-only) can only delete Desktop templates in the Room made by their organizations that have not already been approved (pending Desktop templates). Room members who are staff members of their organizations can similarly only delete those pending Desktop templates requests that they themselves have made that have not yet been approved. (See Delete a pending Desktop template request.)

  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.
  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 appear1.
    • For Windows Desktop templates (where the name of the Desktop template to be deleted is "JeffreyWindowsDesktop"):
      Delete Windows Desktop Dialog
    • For Linux Desktop templates (where the name of the Desktop template to be deleted is "JeffreyLinuxDesktop"):
      Delete Linux Desktop Dialog
  8. Type the name of the Desktop template to confirm deletion (case sensitive).
  9. Click DELETE.
  1. If the Desktop template you intend to delete is in a pending state, you will see the REJECT TEMPLATE dialog. Enter a reason to reject the pending Desktop template and click REJECT. ↩

Delete a pending Desktop template request

The admin users and managers of a Room's non-owner organizations (user-only and connected-only) can delete pending Desktop template requests in the Room made by their organizations. Room members who are staff members of their organizations can delete those pending Desktop template requests that they themselves have made.

The admin user and managers of a Room's owner organization (owner+connected or user+owner) can delete any pending Desktop template requests in the Room.

To delete a pending Desktop template - as an admin user or manager 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 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.
    Reject Desktop Dialog
  8. Enter the reason you want to delete the pending Desktop template request (which is actually a rejection of the request) into the dialog.
  9. Click REJECT.

To delete a pending Desktop template - as an admin user or manager of one of the Room's non-owner organizations, or as a member of the Room who is a staff member of their organization:

  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 clicking in the checkbox to the left of the Desktop's name.
    selected Desktop row in Rooms configure Desktop page
  9. At the bottom of the page, click the Trash Can Delete icon. You will see the DELETE DESKTOP REQUEST dialog.
    Delete Request Dialog
  10. Click DELETE.

Connect to a Desktop

All members of a Room that have been assigned to a Desktop template in the Room can connect to their instance of the Desktop template (possibly a shared instance).

Connect to, that is launch and log in 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'.

The steps to connect to a Desktop vary by type:

Connect to a Windows Desktop

  1. Locate the interface for the Desktop to which you want to connect. (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. Locate the entry for the Desktop to which you want to connect.
    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 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.
    6. Locate the entry for the Desktop to which you want to connect.
  2. Click on either the name of the Desktop or on 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.

    This will launch your Windows 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. This is a one time action per device.

    Configure your device for connection:

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

    2. Click the icon for your device's operating system (Linux, Windows or MacOS) to download the desktop clients onto your device.

    3. Follow any installation/configuration instructions that are provided in the downloaded artifact(s).

    4. Return to the Launching your Desktop dialog from the Download Tehama Client dialog by clicking on the back arrow in the top left corner.
    Once your device is configured, click on the Retry link in the Launching your Desktop dialog to launch your Windows Desktop instance as a standalone application. (This is identical to returning to the table entry for your desktop and clicking on the CONNECT button there.)

Important Notes about possible issues connecting your Windows Desktop session:

  • Your Desktop may be restarting or rebooting. If so, wait a few minutes and try again.
  • For Windows users, if prompted to allow firewall access, click Allow Access.
    The connection can take a minute to be fully established.
  • Upon launch, your Desktop will begin initializing/starting. The Workspace Agent application (also known as the Desktop Agent) will start up in the background, but will not be shown. You can show the Workspace Agent by clicking on its icon in the tray or on the desktop. If the Workspace Agent detects an update, the update will be downloaded automatically and the Workspace Agent will restart. If it detects an update while the Desktop is restarting/rebooting, it will delay performing the update for two minutes.

Note: When logging off your Windows Desktop, use the Start menu's "Log off" instead of X'ing out of the Desktop. This ensures that the virtual Desktop is properly logged out of and is available in a timely manner for re-login. This is particularly important in shared Windows Desktops.

Windows Desktop Manual Connection Alternative:

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, the manual connect with credentials option also requires that you first configure your device for connection.)

  1. Locate the interface (table entry) for the Desktop to which you want to connect (as in the first step of Connect to a Windows Desktop).
  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 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 ACCESS YOUR DESKTOP dialog into the "Username" field in the desktop client.
  8. Copy the Password field value from the ACCESS YOUR DESKTOP dialog into the "Password" field in the desktop client.
  9. Click LOGIN in the desktop client. This will launch your Windows Desktop instance as a standalone application.

 

Windows Desktop Web Client Connection Alternative:

You can opt to launch your Windows Desktop instance using Amazon WorkSpaces® Web Client with manually entered credentials:

  1. Locate the interface (table entry) for the Desktop to which you want to connect (as in the first step of Connect to a Windows Desktop).
    Note: Desktop credentials are dynamic. The password is automatically rotated every five minutes.
  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: 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.

 

Connect to a Linux Desktop

  1. Locate the interface for the Desktop to which you want to connect. (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. Locate the entry for the Desktop to which you want to connect.
    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 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.
    6. Locate the entry for the Desktop to which you want to connect.
  2. Click on 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.

    For legacy Linux Desktop instances:

    This will launch your legacy Linux 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 Linux Desktop instances:

    This will launch your Linux 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 Linux Desktop will fail to launch unless you have downloaded the Tehama Desktop Client ('Tehama App') and the Teradici PCoIP Desktop Client to your device. This is a one time action per device.

    Configure your device for connection:

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

    2. Click the icon for your device's operating system (Linux, Windows or MacOS) to download the desktop clients onto your device.

    3. Follow any installation/configuration instructions that are provided in the downloaded artifact(s).

    4. Return to the Launching your Desktop dialog from the Download Tehama Client dialog by clicking on the back arrow in the top left corner.
    Once your device is configured, click on the Retry link in the Launching your Desktop dialog to launch your Linux Desktop instance as a standalone application. (This is identical to returning to the table entry for your desktop and clicking on the CONNECT button there.)

 

Linux Desktop Manual Connection Alternative:

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, the manual connect with credentials option also requires that you first configure your device for connection.)

  1. Locate the interface (table entry) for the Desktop to which you want to connect (as in the first step of Connect to a Linux Desktop).
  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 Linux Desktop instance as a standalone application.

 

Force Logout of a Shared Windows Desktop

All members of a Room that have been assigned to a shared Windows Desktop instance in the Room can force the logout of that Desktop.

Occasionally a shared Windows Desktop 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 Windows Desktop application window instead of explicitly logging out. To free up a desktop so it can be used again, follow these steps:

  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.
  6. Locate the entry for the Desktop to which you want to connect.
  7. Click on the Log out current user ... button in the entry. The LOG OUT warning dialog will appear.
  8. Place a checkmark in the checkbox next to the "I understand" statement.
  9. Click LOG OUT.

Request a custom image of a Windows Desktop

Only the admin user and managers of a Room's owner organization (owner+connected or user+owner) can request a custom image and they must be a member of the Room and be assigned to the Desktop template whose instance the custom image is to be based off of.

Note that members of the Room who are staff members of the Room's owner organization can see the option to request a custom image from Desktop templates they are assigned to, and they can attempt to do so, but will be denied permission when they attempt to make the request by clicking the request button.

This is available for "Windows Desktops" 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

All members of a Room that have been assigned to a Desktop template in the Room, Windows or Linux, can restart their Desktop instance from the work tab or from the top navigation bar Desktops tab.

Also, all Room members can restart a Linux Desktop to which they are assigned from a connected session.

In addition, the admin user and managers of a Room's owner organization (owner+connected or user+owner) can restart a Linux Desktop to which they are not assigned from the configure tab, as long as they are members of the Room.

Finally, the admin user and managers of a Room's owner organization (owner+connected or user+owner) and of a Room's connected organization (owner+connected or connected-only) can restart a Linux Desktop to which they are not assigned from the top navigation bar Desktops tab, again, as long as they are members or the Room.

The steps to restart a Desktop vary by type:

Restart a Windows Desktop or a Linux Desktop from the top navigation bar's Desktops tab

Restart a Desktop from the Tehama Web UI top navigation bar 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 for the Desktop which you want to restart.
  5. Click on the three vertical dots under the Actions column in the Desktop's entry.
  6. Select "Restart Desktop". This will display the confirmation dialog.
    Desktop Restart Confirmation Dialog
  7. 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 Windows Desktop or a Linux Desktop from the Room's work tab

Restart a Desktop from the Tehama Web UI Room work tab.

  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.
  6. Locate the entry for 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 confirmation dialog.
    Desktop Restart Confirmation Dialog
  9. 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 Desktop from the Room's configure tab

Restart a Linux Desktop from the Tehama Web UI Room configure tab.

Only available for the admin user and managers 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 you want to access. 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 for 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 confirmation dialog.
    Linux Desktop Restart Confirmation Dialog
  9. If you wish to proceed with the restart of the Desktop, select YES. Otherwise select NO.

Restart a Linux Desktop from the connected Desktop session

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

(See instructions to connect to a Linux Desktop here: Connect to a "Linux Desktop" Desktop.)

From a connected session:

  1. Click on the menu icon menu icon in the top right corner of the display to open the options menu.
    Linux Desktop Options Menu
  2. Click on your name, then select "Disconnect" from the dropdown menu.
    You will see the following screen:
    Linux Disconnect Options Dialog
  3. Click RESTART. This will display the following screen:
    Linux Restart Dialog
  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:
    Linux Restarting 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 Desktop

All members of a Room that have been assigned a legacy Linux Desktop in the Room can change the resolution of that legacy Linux Desktop from a connected session.

Applicable to legacy Linux Desktops only.

Change the resolution of a Linux 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 Desktop here: Connect to a "Linux Desktop" Desktop.)

From a connected session:

  1. Click on the menu icon menu icon in the top right corner of the display to open the options menu.
    Linux Desktop Options Menu
  2. Click on the Change Desktop Resolution button in the options menu.
    This will display the change resolution dialog.
    Desktop 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:
    Linux Disconnect Options Dialog
  6. Click on RECONNECT to change your Desktop's resolution and reconnect.

View a Linux Desktop in fullscreen mode

All members of a Room that have been assigned a legacy Linux Desktop in the Room can view a connected session for that legacy Linux Desktop in fullscreen mode.

Applicable to legacy Linux Desktops only.

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

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

(See instructions to connect to a Linux Desktop here: Connect to a "Linux Desktop" Desktop.)

From a connected session:

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

Your Desktop will now fill the screen.

Click on ESC to leave fullscreen mode.

Start Desktop Agent

All members of a Room that have been assigned a Desktop in the Room can start the Desktop Agent from the menu of a connected session for that Desktop.

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.

From Windows Desktops:

(See instructions to connect to a Windows Desktop here: Connect to a "Windows Desktop" Desktop.)

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.)
    desktop agent icon
    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.

From Linux Desktops:

(See instructions to connect to a Linux Desktop here: Connect to a "Linux Desktop" Desktop.)

From a connected session:

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

View a Desktop's status

All members of a Room that have been assigned a Desktop in the Room can view the status of that Desktop.

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

  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.
  6. Locate the entry for the Desktop for which you wish to see the status.
  7. Look for the status icon for the entry under the Status column.

For Windows Desktops:

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

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

For Linux Desktops:

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

  • building: building status icon
    indicates the Desktop has not yet completed building
  • available: available status icon
    indicates you can connect to the Desktop
  • in use: in use status icon
    for shared Desktops only, indicates someone is connected to the Desktop, the tooltip displays the user name(s)
  • restarting: restarting status icon
    indicates the Desktop is restarting - note that if you are viewing the work tab in the Tehama Web UI 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: error status icon
    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

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

Regions that offer the GPU memory configuration for Windows 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 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 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 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.

 

Related articles