Any setup.exe or any other executable that installs updates and launches the MSI installer is a bootstrapper. The Acrobat-Reader bootstrapper is provided as part of the Reader bundle on the CD and the web download. It is also provided for some releases on the FTP download site. It provides a streamlined way to chain installs without the need for administrative install points. The bootstrapper provides the following benefits:
Beginning with 9.3.3, Reader downloads on the Reader Download Center where the second number is incremented (e.g. are delivered with a bootstrapper that automatically detects, chains, and installs patches and updates in the correct sequence. Also, the product known as “Bootstrapper Big” used for Acrobat 3D 9.x is now deprecated. If you need information about this product, contact technical support.
Common bootstrapper workflows can include any of the following:
Using Setup.ini and batch files allows you to keep a record of modifications for future troubleshooting. Always archive your original download and modify a copy rather than the original.
Modifying the installer with the Customization Wizard
The bootstrapper uses Setup.ini as a configuration file. Administrators typically modify this file via the Customization Wizard, manually, or both as needed.
Setup.ini: Default for 11.x mui Acrobat
[Startup] RequireOS=Windows XP RequireMSI=3.1 RequireIE=7.0.0000.0 Require64BitVC10RT=1 [Product] msi=AcroPro.msi vcrtMsi=vc_red.msi vcrtDir=VC10RT_x64 Languages=2052;1028;1029;1030;1043;1033;1035;1036;1031;1038;1040;1041;1042;1044;1045;1046;1049;1051;1060;1034;1053;1055;1058;1025;1037;6156 2052=Chinese Simplified 1028=Chinese Traditional 1029=Czech 1030=Danish ------------------ snip: continue lang list ------------------------ [Windows XP] PlatformID=2 MajorVersion=5 MinorVersion=1 ServicePackMajor=3 [MSI Updater] Path=WindowsInstaller-KB893803-v2-x86.exe
|RequireMSI||The minimum version of MSI service that requires. 9.x requires 3.0. 10.x requires 3.1.|
|RequireIE||The minimum supported version of Internet Explorer. Refer to the release notes.|
|RequireOS||A semicolon-separated list of operation systems. You need only specify the minimum required OS(s). Each OS name from the list must have corresponding INI section with OS specification. While there is no restriction on the string name, these names are used in any error messages. Therefore, real names are more user friendly.|
11.0 and later and Acrobat 64-bit machines only: Specifies whether to install the Visual C++ x64 2010 SP1 Runtime is required when the following functionality IS needed: 1) Acrobat PDF Creation add-on (PDFMaker plugin) for Microsoft Office 64-bit applications (viz. Word, Excel, PowerPoint & Outlook) and 2) sending emails or resolving addresses via 64-bit Microsoft Outlook. Values include:
|[OS name]||A list of required OS names which matches those in RequireOS. The key values are always numbers. The default is 0 if any key or value is missing except that there is no default value for Architecture. It is possible to add recognition of the other operating systems such as Server/Client/Workstation and Professional/Home/Web/Enterprise editions.|
|PlatformID||Identifies the OS.|
|MajorVersion||Identifies the OS.|
|MinorVersion||Identifies the OS.|
|The keys below identify the service pack. Use CSDVersion to identify any OS prior of NT4-service pack 6, and use ServicePackMajor-ServicePackMinor for OS NT4-service pack 6 and higher. CSDVersion and ServicePackMajor-ServicePackMinor are mutually exclusive.|
|CSDVersion||Use CSDVersion to identify any OS prior of NT4-Service Pack 6. CSDVersion and pair of ServicePackMajor-ServicePackMinor are mutually exclusive. If you specify CSDVersion, then ServicePackMajor-ServicePackMinor are ignored. Use ServicePackMajor-ServicePackMinor for OS NT4-Service Pack 6 and higher.|
|ServicePackMajor||Identifies the major service pack. See also CSDVersion.|
|ServicePackMinor||Identifies the minor service pack. See also CSDVersion.|
If specified, the value must match:
|msi||Name of the msi file to sub-launch.|
|CmdLine||Any msiexec command. Note if [Startup]-CmdLine contains /msi, [Product]-CmdLine is ignored.|
|Languages||For multilingual installers only, a semicolon-separated list of languages in LANG_ID format.|
|PATCH||Full or relative path to the msp file to apply with MSI sub-launch. Do not use quotes.|
|LANG_ID||Language Description key, one for each language.|
|[MSI Updater]||The bootstrapper can download and install the required MSI version if needed. Adobe provides the default data. See RequireMSI.|
|Path||The absolute or relative path to the required MSI updater file starting with starting from http:// or ftp://. When a fully-qualified URL path os specified, the bootstrapper downloads the new Microsoft Installer first.|
|Timeout||The time in minutes after which if downloading is not complete it will be aborted. The default is 15 minutes.|
|0||Win32 on Windows 3.1|
|2||0||Windows NT 4.0|
|2||Windows Server 2003|
Arguments can be passed to the Setup.exe bootstrap installer to control its operation. The general form of the command is:
<path to>\Setup.exe [<switches>...]
All parameters are case insensitive. There is no parameter merging; if any parameter passed as app argument all parameters from INI file will be ignored.
|/sAll||Run installer in silent mode.|
|/sPB||Silent mode with minimum UI: show the progress bar only.|
|/rs||Reboot Suppress. Setup.exe will not initiate reboot even if it is required.|
|/rps||Reboot Prompt Suppress. If reboot is required, the system restarts without warning.|
|/ini “PATH”||Relative or absolute path to an alternative (different) Bootstrapper INI file. The CmdLine of alternative INI will be ignored.|
|/l||Enable Error Logging. Log file Bootstrap.log will be generated in a temp directory.|
|/sl “LANG_ID”||Set Language, where LANG_ID is the decimal code of the destination installation language. Use it only for the multilingual installer, and make sure that the corresponding language transform file exist in the setup directory. If /sl “LANG_ID” is not set and you are running the multilingual installer interactively (not silently), ‘Choose Setup Language’ dialog will be displayed.|
|/msi[Command line]||Identifies the portion of CmdLine for additional MSIEXEC command line parameters. Everything following /msi is passed to MSIEXEC without analyzing and without any changes.|
During installation, both the bootstrapper and the Select Language dialog behavior is determined by two items: the specified Lang_ID key in the setup.ini file and the existence of the language package in the file to be installed. There are three possible scenarios:
When the OS user default locale matches one of the package languages:
- The language dialog is invoked with strings in the OS locale language.
- Language descriptions in the drop-down list are populated with OS locale strings from system registry. If this fails, then the drop-down list populates with the string from the INI Language Description keys.
- The OS locale Language is pre-selected in the drop-down list.
When the OS user default locale is one of the 15 supported languages but doesn’t match any of the package languages:
- The dialog labels appear in OS locale language.
- Language descriptions in the drop-down list are populated with OS locale strings from the system registry. If this fails, then the drop-down list populates with the string from the INI Language Description keys.
- The Package Default Language value of ‘ProductLanguage’ from the installer Property table is pre-selected in the drop-down list.
Create a folder to store the original installation files and the MSP update files to apply.
Download the needed base install and requisite patches.
Add the following line to setup.ini file, under the [Product] section:
- Acrobat 9.x: [Product]PATCH=AcroProStdUpd910_T1T2_incr.msp;AcrobatUpd912_all_incr.msp;AcrobatUpd913_all_incr.msp
- Acrobat 10.x: [Product]PATCH=AcrobatUpd1011.msp
It is not necessary to use path statements or quotes.
Except for the PATCH= line and the addition of the ADDLOCAL=ALL property, setup.ini file changes are written to the file by the Adobe Customization Wizard.
[Startup] RequireMSI=3.0 [Product] msi=AcroRead.msi PATCH=AdbeRdrUpd1014.msp [MSI Updater] Path=http://ardownload.adobe.com/pub/adobe/reader/win/8.x/8.0/misc/WindowsInstaller-KB893803-v2-x86.exe
A customized chained installed in for Acrobat 9 Pro in English, French and German might look like this:
[Startup] RequireOS=Windows XP RequireMSI=3.0 RequireIE=6.0.2600.0 CmdLine=/sl"1033" /sPB [Product] msi=AcroPro.msi Languages=1033;1031;1036 1033=English (United States) 1031=German (Germany) 1036=French (France) CmdLine=TRANSFORMS="AcroPro.mst" ADDLOCAL=ALL PATCH=AcroProStdUpd910_T1T2_incr.msp;AcrobatUpd912_all_incr.msp;AcrobatUpd913_all_incr.msp [Windows XP] PlatformID=2 MajorVersion=5 MinorVersion=1 ServicePackMajor=2 [Windows XP] PlatformID=2 MajorVersion=5 MinorVersion=1 ServicePackMajor=2 [MSI Updater] Path=WindowsInstaller-KB893803-v2-x86.exe
RequireOS=Windows NT RequireMSI=3.0 RequireIE=6.0 [Windows NT] PlatformID=2 MajorVersion=4 CSDVersion=5 [Windows NT] PlatformID=2 MajorVersion=4 ServicePackMajor=6
This example shows a 7.0 install customized with an MST that silently installs the product in German.
[Startup] CmdLine=/sAll /sl "1031" RequireOS=Windows 2000 [Product] CmdLine=TRANSFORMS="AcroPro.mst" msi=AcroPro.msi Languages=1033;1031;1036 1033=English (United States) 1031=German (Germany) 1036=French (France) [Windows 2000] PlatformID=2 MajorVersion=5 ServicePackMajor=2