About MSI Configurator

Show me content for:

About MSI Configuration

MSI Configuration is a process of building a custom version of Host or Agent using the built-in MSI Configurator tool. At the end of the configuration process you can save the output file and use it for deployment or distribution.

MSI configuration saves you time manually configuring each and every Host after installation. Instead, you simply pre-configure the Host installer and then mass-deploy it on as many computers as you need.

When to use

You should configure your custom Host/Agent in the following scenarios:

  • Deploying Host across multiple computers in a domain, e.g. Active Directory network;
  • Distributing Host among multiple remote customers whom you support over the Internet;
  • Integrating your logo and welcome text in the Agent module.

If you only have few remote PCs (like 1-10) OR each Host needs to have unique settings, then you probably do not need MSI configuration. Simply install the original Host downloaded from the site and then manually change the Host settings on each remote PC.

Opening MSI Configurator tool

To open the MSI Configurator:

  1. Run Viewer as an administrator: Run as administrator
  2. Select ToolsMSI Configurator: MSI Configurator button on the Viewer toolbar

The configuration steps and options are explained below.

Step 1: Specifying how the configuration process should proceed

In this step you need to choose between Online and Offline (Legacy) configurator:

Online vs. Legacy
  • Online configurator. Your choices are sent to our configuration server which builds a digitally signed output file. The MSI configurator then downloads the file onto your Viewer PC. This is the simplest option and is recommended in most cases.
  • Legacy configurator. The configuration process will be executed offline on the Viewer PC. The output file will NOT be digitally signed. Use the Legacy option if you cannot use the Online option for some reason — for example, your corporate security policy doesn't allow using third-party servers for configuration or you simply want to sign the file with your own digital signature or use it without a signature.

If you choose to select the Legacy option, you must click Browse and specify the path to the original (vanilla) Host installer downloaded from our website.

Step 2: Selecting output package type

The type of package you select depends on your deployment and usage scenario:

Select type of package
  • Standard MSI package — for manual installation or remote deployment through Active Directory.
  • One-click installer — for silent installation in one click.
  • Agent — for customizing the Agent with your logo and welcome text.

Tip

See examples of Standard MSI package, One-click package and Agent package configuration.

Step 3: Advanced options

"Internet-ID" tab

Select Internet-ID options
  • Set or update Internet-ID connection settings — enable Internet-ID connection for this Host.
    • Generate a new internet-ID code — when selected, a new Internet-ID code is generated on the Host upon installation.
      • Send Internet-ID to email — specify the email address where the Host should send its Internet-ID connection credentials after it has been installed.
        • Ask the user to identify themselves — the Host will prompt the user to provide their name which will be sent in the same email message as the access credentials.
        • Automatically generate Host password — when enabled, a unique access password for each Host will be generated and sent to you in the encrypted email message.
        • Custom text for email — if you create multiple Host packages you can use this field to uniquely identify them and tell which Host was installed from which package.
      • Also generate the Internet-ID code for existing Hosts — enable this check box, if you want to update the Internet-ID code on existing Host installations.
    • Use default (public) Internet-ID server — use our company's servers for Internet-ID connection.
    • Specify custom Internet-ID server — use the self-hosted RU Server: Self-hosted server settings
      • Use IPv6 — enable Ipv6 support
      • Custom server — specify the IP address/DNS name of your self-hosted server
      • Port — specify the communication port used by your server
      • PIN code - if you use PIN code protection on your server, specify the PIN code here
    • Also update existing Hosts with the selected server — enable this check box, if you want to update the Internet-ID server settings on existing Host installations.
Select Internet-ID options
  • Set or update Internet-ID connection settings — enable Internet-ID connection for this Host.
    • Generate a new internet-ID code — when selected, a new Internet-ID code is generated on the Host upon installation.
      • Send Internet-ID to email — specify the email address where the Host should send its Internet-ID connection credentials after it has been installed
        • Ask the user to identify themselves — the Host will prompt the user to provide their name which will be sent in the same email message as the access credentials.
        • Automatically generate Host password — when enabled, a unique access password for each Host will be generated and sent to you in the encrypted email message.
        • Encrypt password — A password sent via email is always encrypted. Use the Add using code feature to decrypt the encrypted access credentials and add them to your Viewer.
        • Custom text for email — if you create multiple Host packages you can use this field to uniquely identify them and tell which Host was installed from which package.
      • Also generate the Internet-ID code for existing Hosts — enable this check box, if you want to update the Internet-ID code on existing Host installations.
    • Use default (public) Internet-ID server — use our company's servers for Internet-ID connection.
    • Specify custom Internet-ID server — use the self-hosted RU Server:
      • Address and port — specify the IP address/DNS name and port of your self-hosted server
      • Use IPv6 — enable Ipv6 support
    • Also update existing Hosts with the selected server — Enable this check box, if you want to update the Internet-ID server settings on existing Host installations.

"Other" tab

Select other options
Select other options
  • Do not ask for confirmation before installation — this option is only available for the "One-Click" package. When selected, the program will NOT ask the remote user to confirm installation.
  • Do not create shortcuts in the Start menu — this is self-explanatory.
  • Do not install virtual printer — when this option is selected, a virtual printer driver will NOT be installed.
  • Do not install monitor driver — Remote Utilities monitor driver is used for the blank remote screen feature. If you do not use this feature, you can select this check box to disable driver installation.
  • Show disclaimer at startup — this option becomes selectable if you choose the "Agent" package option in Step 2. Here you can add a disclaimer message to show to the remote user. The remote user will have to click "Accept" in the disclaimer window for the Agent to start.

"Integrate your logo" tab

This tab is only available when you select the "Agent" type of package in Step 2.

Integrate your logo and welcome text
  • Customize "Agent" - enable Agent customization options below and specify the path to a logo that you want the Agent window to display.
  • Do not stretch logo - the logo is stretched or shrunk automatically to fill the available area. This option disables stretching/shrinking. If you want the image to display without stretching or shrinking and fill the whole available area, make it 410px x 100px.
  • Title - the text entered here will be shown in the Agent window title.
  • Text - text of the custom message.
  • Select text color - set text color for the custom message.
  • Select background color - set background color of the customized area of the Agent window.
  • Preview - click to see how the customized portion of your Agent window looks like.

Step 4: Settings update

In this step you can pre-configure Host settings or skip Host settings configuration.

Host settings update step

The options in this step work differently depending on whether it's the first time you install the Host on this computer or if you are updating an existing Host installation. The table below explains what happens in each possible case:

First installation Updating existing Host
Pre-configure "General and network" settings Host will install with the General and Network settings you specified. "General" and "Network" settings will be overwritten with the settings you specified.
Pre-configure "Security" settings Host will install with the Security settings you specified. "Security" settings will be overwritten with the settings you specified.
Skip settings configuration Host will install with the default settings. Security settings (including access password) will be empty/not set. Nothing will change. The settings will remain the same as they were prior to the update.
Host settings update step

The options in this step work differently depending on whether it's the first time you install the Host on this computer or you are just updating an existing Host installation. The table below explains what happens in each possible case:

First installation Updating existing Host
Pre-configure Host settings Host will install with the settings you specified. ALL settings, including the security settings, will be overwritten and replaced with new ones.
Pre-configure Host settings, do not change security settings Host will install with the settings you specified. Security settings, including access password will be empty/not set. The existing Host settings will be overwritten with new ones, except for the security settings which won't be affected.
Skip Host settings configuration Host will install with the default settings. Security settings (including access password) will be empty/not set. Nothing will change. The settings will remain the same as they were prior to the update.

The Internet-ID settings such as Internet-ID code and Internet-ID server are configured in step 3 of the configuration process on the Internet-ID tab.

Step 4a: Host settings

If you have selected Pre-configure and enabled the two check boxes in step 4 above, the Host configuration window will open and look like this:

Host settings update step

Note how the General, Network and Security sections are all shown and available for configuration. Refer to Host settings for more information on available settings.

Set desired options and click OK. The configuration process will begin.

If you selected Pre-configure Host settings or Pre-configure Host settings, do not change security settings above, the Host settings window will open. Refer to the Host settings section for more information on available settings.

Host settings update step

Set desired options and click Close (the X button). The configuration process will begin.

Building the output file

Depending on the choice made in Step 1 — Online configurator or Legacy configurator — the output file will either be downloaded from our configuration server or built offline on the Viewer machine.

When the Online option is selected in step 1, the file is downloaded at the end of the configuration process:

Downloading output file
Downloading output file

You will be prompted to save the output file to a directory on your computer. If the Legacy option has been selected in Step 1, you will be prompted to save the file to a destination folder right away.

This website uses cookies to improve user experience. By using this website you agree to our Terms of Service and Privacy Policy.