Installing DD Portal

Legacy Portal Customers (14.x & 15.x)
We highly recommend uninstalling any legacy versions before installing newer versions of the Portal.

Requirements

  • Windows 7 or later
  • NET Framework v4.5+ (auto-updating installer only)

 Overview of Installers

The Portal and all installers are 32-bit applications.
The Program Files directory or Registry locations are always their 32-bit version.

We provide two types of installer for Windows, each with different pros/cons.

  • An auto-updating installer which will install into each users %AppData% directory
  • An regular installer which will install machine wide into Program Files

If you are installing onto a Citrix/Terminal Server then you need to use the non auto-updating installer described later in the article.

User Local Installation (auto-updating)

Do not use the auto-updating installer in Citrix/Terminal Server environments.
Each user will have their own copy of the Portal installed to their %AppData% directory which can use considerable resources.
Use the non auto-updating installer described later in this article instead.

There are two installers available for the auto-updating Portal.

MSI Installer

Use the MSI  to install onto the machine. DeskDirector will install and start-up for each user that successfully logs in from that time on.

Use the MSI to distribute the application to your users.

EXE Installer

Use the EXE to install for just the current user. DeskDirector will be running in the system tray when the EXE completes.

You can use the EXE if you wish to take a quick look on your own computer first.

Machine Wide Installation (Non auto-updating)

Use this version if you are installing in a Citrix/Terminal Server environment or simply want more control over updates to the product.
This installer is also much simpler to install and manage.
EXE Installer

This EXE will install the Portal onto the machine inside Program Files. It will create a Desktop shortcut visible to all users. It will automatically start to the system tray when a user logs in.

Using the Installers

User Local Installers (auto-updating)

The EXE Installer:

  • Use the EXE to install a single copy for a specific user. This is useful for testing out the Portal yourself.
  • A small animated image will display on installation. You can stop this from displaying by using the silent flag -s.
  • Will launch minimized to the system tray after installation.

The .MSI Installer:

  • Use the MSI to distribute the application to your users.
  • The MSI installs machine-wide.
  • The MSI simply copies the EXE to a folder in %ProgramFiles(x86)% on the target machine.
    The folder will be named after your product name, followed by “Installer”. e.g. If your MSI was named My+Help+Desk.msi, the folder will be “My Help Desk Installer”
  •  A registry entry is created which runs this EXE on startup (which ultimately installs the application to the users %AppData%).
    Location: `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run\`
    Value: `%ProgramFiles%\DeskDirector Portal Windows Installer\deskdirectorportal.exe --checkinstall`
  • This EXE will run for your users on next login with the silent flag enabled. This means when a new user logs into a machine where the application has been deployed, it will automatically be installed for them.
  • In order to have the application install immediately for any logged in users, simply execute the .EXE in this folder, under the context of the current user, with no elevated permissions. Please ensure you execute it with the silent flag (-s), so that it will not disturb the user.
  • Alternatively, you can simply log out and then log back in to trigger the installation process for a user.

Steps to deploy:

  1. Uninstall old versions of the DeskDirector client.
  2. Execute the MSI on the target machine(s) with any privileges you require.
  3. The application will install for each user on this machine, when they next login. If you wish to have it install immediately for logged in users, proceed to step 4.
  4. (optional) Execute the EXE inside the Program Files Installer folder that was created, with the silent flag (-s) for any logged in users, who wish to have it installed immediately.  

Machine Wide Installer(Non auto-updating)

 The EXE Installer:

  • Use this installer when installing to a Citrix/Terminal Server environment
  • This EXE will install the Portal directly into %ProgramFiles(x86)%
  • Desktop shortcuts will be made available for all users.

This installer is built using InnoSetup.

You can find full documentation for Installation Command Line Parameters and Uninstaller Command Line Parameters inside their documentation.

Common command line parameters

Silent Installation

/silent or /verysilent

Disabling/Enabling AutoStart on User Login Feature

Enabling AutoStart: /tasks="autostart"

Disabling AutoStart: /tasks="!autostart"

Steps to deploy:

  1. Uninstall old versions of the DeskDirector client.
  2. Execute the EXE on the target machine(s) with any privileges you require.

How did we do?

Getting Started with DD Portal

Troubleshooting your DeskDirector Portal installation

Contact