About MSI Configurator

MSI configuration is a process of modifying the default (vanilla) Host installer using a special built-in tool called MSI Configurator. At the end of the configuration process you can save the output file and then use it for installation.

Important!

You must run the Viewer as administrator in order to use the built-in MSI Configurator:

Run as administrator

When to use

MSI configuration normally precedes remote installation whenever you need to install Hosts with identical settings across a great number of remote PCs (e.g. in a local network). Thus, MSI configuration saves you a lot of time — instead of configuring each and every Host after installation you simply pre-configure the Host installer and then mass-deploy it on as many computers as you need.

MSI configuration is an advanced feature mostly used in a network environment where large-scale routine operations are common. If you only have a 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 vanilla Host and then manually change the Host settings on each remote PC.

MSI Configurator tool

To launch the tool, run the Viewer as an administrator, select the Tools tab and click MSI Configurator.

MSI Configurator button on the Viewer toolbar

The configuration steps and options are explained below.

Step 1: Selecting Host package

In this step you need to specify the path to the latest vanilla Host installer file.

Specify the path to the Host installer

Step 2: Selecting output package type

The type of package you select depends on your purpose:

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 this check box to specify Internet-ID code and Internet-ID server settings below.
    • Generate a new internet-ID code — When enabled, a new Internet-ID code is generated on the Host upon installation.
      • Send Internet-ID to email — Select this check box and specify the destination email address if you want the remote Host to automatically send you connection credentials via email upon installation.
        • Ask the user to identify themselves — When enabled, the Host will prompt the user to provide their name which will be sent in the email message along with access credentials.
        • Automatically generate Host password — When enabled, a unique access password will be generated and sent to you along with the Internet-ID code.
        • 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 — Use to label/tag the Hosts installed from this specific package. This text is included in the email message.
      • 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 you custom Internet-ID server
      • Address and port — specify the IP address/DNS name and port of your self-hosted Internet-ID 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
  • 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 Self-explanatory.
  • Do not install virtual printer When this option is selected, installing of the virtual printer will be skipped.
  • Do not install monitor driver Installing Remote Utilities monitor driver is necessary if you want to use the blank remote screen feature.
  • Show disclaimer at startup This option is only available when you select the "Agent" type of package in Step 2. When it is selected, the program will show an "Accept/Reject" message with a disclaimer text that you can customize. The remote user will have to click "Accept" 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 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.

Note that all Internet-ID settings are now configured separately from other Host settings. So regardless of what you selected in this step, the Internet-ID settings will be taken from the 3rd step of the configuration process.

Step 4a: Host settings

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.

© 2010 - 2017 Remote Utilities LLC. Remote Utilities and Remote Utilities logo are either registered trademarks or trademarks of Remote Utilities LLC in the United States and/or other countries. All rights reserved.