Skip to main content

Tehama DIA: Agent Deployment and Installation for Windows

  • Updated

About Tehama DIA

DIA is a systems and device management SaaS for Tehama Desktop devices, with features for
monitoring, troubleshooting, and gathering intelligence across remote devices

 

DIA Agent Deployment and Installation

Note:  As of 2022, this installation method has been replaced by the DIA Room Feature now available in the Tehama UI for Room/Org Managers and Organization Administrators.  It allows the DIA feature to be enabled and installed room wide  Please follow this link for more information on the DIA Room Feature

 

Customers may continue to install DIA following this guide if they choose.  The below methods will allow tighter controls on which desktop(s) receive the DIA Agent.  

 

To deploy DIA, administrators and users in your organization will require:

  • The Tenant name (for example):  acme.dia.tehama.io
  • The Device Registration Code (example):  1234567890abcdef1234567890abcdef12345678
    • The device registration Code is available on the Downloads page of the DIA Web Console

Downloads Page



Automated DIA Setup Utility

Our Technical Support Team has created a script to simplify and automate Tehama DIA installation, as well as staging DIA for the Custom Image process. The DIA Setup Utility can be downloaded here.

 

Introduction

After installing the DIA Setup Utility, a Configure DIA icon will appear on your desktop, clicking on that icon will start the DIA setup process.

 

When the DIA Configuration Utility launches, a selection menu will appear:

Tehama DIA Configuration Utility Tool

  1. Enter your DIA Tenant and Device Registration Code
    • This is the initial step, and must be completed on your first run. The utility will keep this information for future custom imaging needs.
    • The Tenant is the first part of the DIA URL: (for example) ACME.dia.tehama.io
    • The Device Registration Code is located in the Downloads section of the DIA console
  2. Install Tehama DIA on this computer
    • This will install and activate Tehama DIA.  Once complete, your Windows host will appear (typically within 2minutes) on the DIA Console.
  3. Prepare DIA for a Custom Image
    • Use this option if planning on creating a custom image used to create multiple
      desktops.
  4. Uninstall Tehama DIA
    • This will remove all components of DIA and remove all files and folders
    • The DIA Configuration will retain your Tenant and Device Registration Code in
      memory for a future installation
  5. Remove DIA Tenant Registration Information and start over
    • Removes the DIA Tenant and Device Registration Code from memory
    • This does not uninstall or remove DIA from your system
  6. Exit
    • Exits the Configuration Utility

 

Typical Usage

Install and activate DIA

  • Press 1 to enter your tenant and Device Registration Code (if not already present)
  • Press 2 to Install and Activate Tehama DIA
  • Press 6 to Exit

Prepare DIA for a Custom Image*

  • Press 1 to enter your tenant and Device Registration Code (if not already present)
  • Press 3 to Prepare DIA for Custom Imaging (this only takes a second)
  • Press 6 to Exit

*DIA will not be activated until the next Tehama Desktop session has started. Once prepared for imaging, please log out of the Tehama desktop and request the custom image following the instructions here

 

Remove DIA**

  • Press 4 to uninstall DIA and remove all files/folders

**When updating a custom image, DIA must be fully uninstalled and re-staged prior to creating a new custom image.  Creating a custom image with DIA fully installed and activated will result in activation failures.

 

Command Line Installation

 

Just in Time Installation

The DIA Agent Manager can be installed and registered instantly from the command line (below), replacing your device registration code and tenant name in the command below:

 

  msiexec /i https://downloads.dia.tehama.io/agentmanagersetup.msi /qn DEVREGCODE=<registration code> TENANT=<tenant>.dia.tehama.io ALLUSERS=1

Note that the device registration code and tenant name are not checked and will be stored as-is.  The DIA Agent will fail to connect if they are not correct.

 

Prepare DIA for Custom Imaging

The DIA Agent Manager can be prepared for imaging from the command line, replacing your device registration code and tenant name in the command below:

 

  msiexec /i https://downloads.dia.tehama.io/agentmanagersetup.msi /qn DEVREGCODE=<registration code> TENANT=<tenant>.dia.tehama.io ONLYSTARTONBOOT=1 ALLUSERS=1

Note that the device registration code and tenant name are not checked and will be stored as-is.  The DIA Agent will fail to connect if they are not correct.

 

DIA will not be activated until the next Tehama Desktop session has started. Once prepared for imaging, please log out of the Tehama desktop and request the custom image following the instructions here

 

A Word on Device Registration

To successfully connect a DIA Agent to the DIA Console, the following information is required:

  • Tenant name:
    • the Automated DIA Setup Utility requires only the Tenant Name (not the full web URL)
      • eg:  acme
    • Command Line DIA installation requires the full URL
      • eg: acme.dia.tehama.io
  • Device registration code
    • Unique to each tenant (found on the Downloads page)

 

The tenant name and device registration code are stored in:

  • Windows Registry at HKLM:\Software\Avacee\SIP

In addition, a Unique Identifier (UID) is  automatically generated upon your initial DIA connection.  This UID identifies the host on the DIA console.   The UID is stored in

  • C:\ProgramData\Avacee\sip_agent\cachefiles

Related articles