Custom Specifications User Guide

What is a custom specification?

Often, you, as the Admin user or an Org Manager or a Room Manager of your organization, will need to customize the 'Workspaces' type of Desktop in your Rooms in order to provide your users with the tools they need to do their tasks.

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

The custom specification functionality allows you to

• configure the base Workspace (a Windows-based Desktop) specification your users need once,
• request the creation of a Workspace image (a custom specification) from that base Workspace, and
• create many other Workspaces with the same configuration, using that specification.

Once created, a custom specification belongs to your organization and is available from every Room in your organization.

---

Create a custom specification

Requirements:

• A base Workspace: This Desktop is used as the base for the custom image/specification. It must belong to the Room used to request the creation of the custom specification. Before requesting the custom specification, configure this Desktop with desired applications and resources.
  
  For security, it might be best to create a base Workspace in a separate Room belonging to your organization, where that Room has been created with Desktop settings granting admin access to the Desktops in the Room. The admin access will be required to install/configure applications in the Desktop. Limit the members of this Room to users who will configure the base Workspace. Once the custom spec has been created, the Room can be removed.
  
  See the Rooms User Guide and the Desktops User Guide for information on how to create a Room and a Desktop of type 'Workspace' and how to connect to an 'Workspace' Desktop instance.

Configure your base Workspace Desktop

1. Connect to your base Workspace.
2. Configure it as desired for your users. Install applications, add resources, etc.
3. Delete or, if you plan to reuse this Workspace, temporarily move the following files to your D: drive:
   • C:\Tehama\tehama-info.txt
   • C:\Tehama\config.json
   If you opt to move these files to your D: drive, remember to move these files back to C:\Tehama after the custom specification has been created.

This is the custom configuration you want all Desktops created from your custom specification to have.

Request the creation of a custom specification

The user who performs the creation of the custom specification does not need to be the same user who configured the base Workspace used in the creation. Note that if the user who performs this step is not assigned to the base Workspace, they must follow Option B in step 1. below.

1. Locate your base Workspace in the Tehama Web UI:
   
   Option A: this option restricts you to Desktops that you are assigned to
   1. Log in to the Tehama Web UI.
   2. Click on the ROOMS tab.
   3. Click on the name of the Room that has your base Workspace. You will see the user interface for the Room.
   4. Click on the Room's WORK tab.
   5. Click on the MY DESKTOPS sidebar item.
      
   6. Locate the entry for the Workspace Desktop you configured, (your base Workspace).
   Option B: this option allows you to find Desktops that you are not assigned to
   1. Log in to the Tehama Web UI.
   2. Click on the DESKTOPS tab.
   3. Locate the entry for the Workspace Desktop you configured, (your base Workspace).
2. Request the custom specification:
   
   
   1. Click on the three vertical dots under the Actions column for the entry and select "Request image". The CUSTOM SPECIFICATION dialog will appear.
      
   2. Enter a name, for example "Project ACME Custom Spec 1", and a description for your custom specification.
   3. Check the box beside the text "I have deleted the files", referring to the deletion in your base Workspace of the files "C:\Tehama\tehama-info.txt" and "C:\Tehama\config.json". (See the Configure your base Workspace Desktop steps above for more details.) The REQUEST button will remain greyed out until this box is checked.
   4. Click on REQUEST. A popup will appear that lets you know your request is in progress.

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.

Once created, the custom specification belongs to the Room's owner organization.

Behind the scenes, your request will be forwarded to Tehama Support. Tehama Support will create an image from your customized base Workspace. This can take up to two hours. You will not be able to use your base Workspace while the image is being created. Tehama Support will reach out to you to coordinate a time that is convenient for you.

---

Use a custom specification

Requirements:

The user must have access to an existing Room.

Note the Room can be any Room belonging to the organization that created the custom specification. Though, for security, it is suggested that this be a Room where the users do not have desktop admin rights and/or the Room has no internet access. Since the custom specification will have all required applications installed and configured, the users of the Desktops created from it may not need admin rights or internet access.

Notification must have received by the organization that created the custom specification that it is now available.

Create a Desktop template of type 'Workspace' with your custom specification

Follow the same steps as you would normally follow to create a Desktop template of type 'Workspace' (see Add a Desktop Template in the Desktops User Guide).

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 page for the Room.
4. Click the CONFIGURE tab.
5. Click the WINDOWS DESKTOPS sidebar item.
6. Click the ADD WINDOWS DESKTOP TEMPLATE at the top right of the page. This will display the ADD WINDOWS DESKTOP TEMPLATE dialog:
7. If you see two choices at the top of the dialog, 'Tehama Windows Desktop' and ' Workspace', choose 'Workspace'.
8. Enter all the information as you normally would except for the Specification.
9. Open the Specification dropdown.
   • Your custom specification, the name you entered above, for example "Project ACME Custom Spec 1", will be in the list, under the heading "Custom Specifications".
     
10. Select your custom specification.
11. Continue the creation of the Workspace as usual.
    
    Once completed, an entry for the new Desktop template of type 'Workspace' will appear in the list of Desktop templates on the page.
    
    The resulting new Desktop template of type 'Workspace' will be constructed from the image created by Tehama Support for your custom specification.

---

Edit a custom specification

Currently, it is not possible to edit an existing custom specification.

But it is possible to create a new custom specification from an existing one.

Create a Desktop template of type 'Workspace' from the custom specification you want to 'edit'. Using an instance of this as your base Workspace, repeat the create custom specification steps.

---

Remove a custom specification

If you wish to remove a custom specification from your organization, please send a support request to Tehama Support.