About MSI Configurator

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 Agent.

If you only have few remote PCs OR each Host needs to have unique settings you do not need MSI configuration. Simply install the original ("vanilla") Host and manually change the Host settings on each remote PC.

Opening MSI Configurator tool

To open 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. 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 Agent with your logo and welcome text.


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 Host upon installation.
      • Send Internet-ID to email — when enabled, this option will make Host send an email with access credentials to a specified email address.
        • Configure SMTP... — specify your SMTP server details with which to send emails. See "Configure SMTP dialog" section below.
        • Ask the user to identify themselves — 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.
      • When updating existing Hosts, overwrite their Internet-ID code with the generated code — if you enable this check box and use the installer to update an existing Host installation, the current Internet-ID code on that Host will be replaced with a newly generated one.
    • Use default (public) Internet-ID server — use our company's servers for Internet-ID connection.
    • Specify custom Internet-ID server — if you use RU Server, specify it here. See "Server dialog" section below.
    • When updating existing Hosts, overwrite their Internet-ID server address with the specified address — if you enable this check box and use the installer to update an existing Host installation, the current Internet-ID server address on that Host will be replaced with your selected option.

"Configure SMTP..." dialog

Specify your SMTP server settings in this dialog. In the Destination email field specify your email address where you want to receive Internet-ID notification emails. You can edit your message template and adjust it for your needs in the message box:

Configure SMTP

When finished, click Send test email to verify your SMTP configuration and receive a test email message.

"Server..." dialog

This is where you specify the address of your self-hosted server, if used.

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

"Other" tab

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.
  • 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 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 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.

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.

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

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.