For most installation needs, Jet Reports provides the consolidated installer - a self-contained .EXE file that handles the installation of all components of Jet Reports. Some organizations have specialized needs and utilize their own installation processes. Jet Reports makes an MSI installer available for these organizations.
Below are the steps (both required and optional) for using the MSI installer to install the Jet Excel add-in.
MSI Installation Considerations
Your first step in performing a command-line install of the Jet add-in is to download the MSI installers.
You will need to extract the files contained in the zip file before they can be used.
Once you have downloaded and extracted the MSI files, your next step is to choose the correct installer for your system(s). Based upon your edition of Microsoft Excel, you'll need to select either the 32-bit or 64-bit installer.Please note that your choice is determined by the bit-level of Excel, not the bit level of your version of Windows. It is common (and sometimes recommended*) to run 32-bit Excel on 64-bit Windows.
The examples below denote the 32-bit installer (Jet.Setup.ExcelAddin_x86.msi). If you have 64-bit Excel, you'll want to use the 64-bit installer (Jet.Setup.ExcelAddin_x64.msi)
Silent installation is a feature that installs the Jet Excel add-in with no user interaction at all. This feature is primarily useful when creating automated installation scripts.
In order to perform a silent installation of the Jet Excel add-in, you must use the Windows Installer database file Jet.Setup.ExcelAddin_x86.msi with the /qn command-line option:
C:\> Jet.Setup.ExcelAddin_x86.msi /qn
The language of the installer is set automatically based on the Operating System language. This determines the language of the Start Menu shortcuts, but the Jet Excel add-in will still be able to support all languages that are currently available.
Properties can be set on the command-line to be passed to the MSI. These are specified using the following syntax:
|C:\> Jet.Setup.ExcelAddin_x86.msi PROPERTYNAME=PropertyValue|
The name of the property is case-sensitive and must be in all CAPS. Below is a list of the supported properties and their functions:
C:\> Jet.Setup.ExcelAddin_x86.msi ACTIVATIONCODE=ABCDEF01-2345-6789-ABCD-EF0123456789
The ACTIVATIONCODE property specifies the activation code that will be used to activate the Jet license the first time the Jet add-In is enabled in Excel.
NOTE: The activation code is not validated at the time of installation. If the activation code is invalid for any reason, each individual user will still be prompted to activate.
SERVICEHOST and SERVICEPORT
The SERVICEHOST property specifies the host name of the Jet Service Tier.
The SERVICEPORT property specifies the port on which the Jet Service Tier is listening.
C:\> Jet.Setup.ExcelAddin_x86.msi SERVICEHOST=MyServer SERVICEPORT=7090
When specified, the Jet add-in will attempt to connect to this server/port in order to receive shared data source and license activation information from the Jet Service Tier.
The DISABLELOCAL property specifies whether to disable local data source settings, only allowing the user to connect to the Jet Service Tier for data source information.
C:\> Jet.Setup.ExcelAddin_x86.msi SERVICEHOST=MyServer SERVICEPORT=7090 DISABLELOCAL=1
The options for this property are 0 (the default) or 1. A value of 1 indicates that local data source settings will be disabled.
The EXCELPLATFORM property specifies the platform of Microsoft Excel.
C:\> Jet.Setup.ExcelAddin_x86.msi EXCELPLATFORM=x86
The Jet add-in MSI will attempt to automatically detect the platform of Excel, and perform a validation check that it matches the platform of the current installation. In some cases the platform of Excel cannot be detected, in which case specifying this property will override the validation check and allow the installation to continue.
Note: The use of this property is not recommended unless the Excel platform cannot be detected automatically.
The Jet MSI installers and the information in this article are provided to assist our customers who are already familiar with using MSI installers in their organization.