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
Configuration of the base Workspace (the Desktop used as a base for the custom image) can be done by any user assigned to the Desktop.
Only the Admin user and Org Managers and Room 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.
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 Windows Desktop
- Connect to your base Workspace.
- Configure it as desired for your users. Install applications, add resources, etc.
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.
- Locate your base Workspace in the Tehama Web UI:
Option A: this option restricts you to Desktops that you are assigned to- Log in to the Tehama Web UI.
- Click on the ROOMS tab.
- Click on the name of the Room that has your base Workspace. You will see the user interface for the Room.
- 1. Click on the Room's WORK tab.
- Click on the MY DESKTOPS sidebar item.
- Locate the entry for the Workspace Desktop you configured, (your base Workspace).
- Log in to the Tehama Web UI.
- Click on the DESKTOPS tab.
- Locate the entry for the Workspace Desktop you configured, (your base Workspace).
- Request the custom specification:
- Click on the three vertical dots under the Actions column for the entry and select "Request image". A dialog will appear entitled "Custom Specification".
- Enter a name, for example "Project ACME Custom Spec 1", and a description for your custom specification.
- Click on REQUEST. A popup will appear that lets you know your request is in progress.
- Click on the three vertical dots under the Actions column for the entry and select "Request image". A dialog will appear entitled "Custom Specification".
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
A custom specification is available to anyone who can add or request a Desktop template of type 'Workspace' in a Room belonging to the organization that owns the custom specification.
The Admin user and Org Managers and Room Managers (who are members of the Room) of a Room's owner organization (owner+connected or user+owner) can add a new Desktop template of type 'Workspace', using a custom specification, to the Room directly. (See Add a Desktop Template in the Desktops User Guide.)
The Admin users and Org Managers and Room Managers (who are members of the Room) 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 of type 'Workspace', using a custom specification, be added to the Room. (See Request a Desktop Template in the Desktops User Guide.)
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).
- Log in to the Tehama Web UI.
- Click on the ROOMS tab.
- Click on the name of the Room you want to access. You will see the page for the Room.
- Click the CONFIGURE tab.
- Click the WINDOWS DESKTOPS sidebar item.
- Click the ADD WINDOWS DESKTOP TEMPLATE at the top right of the page. This will display the ADD WINDOWS DESKTOP TEMPLATE dialog:
- If you see two choices at the top of the dialog, 'Tehama Windows Desktop BETA' and ' Workspace', choose 'Workspace'.
- Enter all the information as you normally would except for the Specification.
- 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".
- 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".
- Select your custom specification.
- Click on the NEXT: ASSIGN MEMBER(S) AND REVIEW button to 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.