1 HOME


© 2013 Adobe Systems, Inc. All rights reserved.

Updated Aug 12, 2014.

8   Administrative Installation Points

Administrative installations via administrative install points (AIPs) create an uncompressed source so the application can be installed from a network location. AIPs allow you to create a canonical set of pre-configured files in one location that can be distributed across your organization from one location.

Updates and patches also often leverage administrative installations because they require uncompressed images of the installed product versions in order to compute file differences. These points also act as an archive of what you installed. Note that when an MSI is released for Reader, it is usually not accompanied by an MSP, so you should start over with a new AIP.

Note

Prior to 11.x, AIP workflows are subject to required uninstalls that do not affect Bootstrapper and SCCM workflows.

8.1   Best practices

The following recommendations will help you successfully deploy updates and patches:

  • Verify that no one else is using the network share.

  • Also adhere to the product’s 2   Administration Basics.

  • Copy and archive your AIPs both for future use and troubleshooting.

  • Always apply patches one-at-a-time.

  • Adhere to the required patching order. Note that AIP deployments have restrictions that bootstrapper and SCCM deployments do not:

    • For 8.x and 9.x, do not apply a quarterly updates to an AIP in which an out of cycle patch was the most recently applied update. Instead, create a new AIP.
    • For Adobe Reader 8.x and 9.x, create a new AIP when the release provides only an MSI. While the MSI may uninstall the existing product, creating and deploying a new AIP does not ensure uninstallation of the existing product. Therefore, manual uninstallation and unlinking of the prior AIP is necessary.
    • For Acrobat 10.x and later, quarterly updates are cumulative to the base release and security patches are cumulative to the last quarterly.
    • For Adobe Reader 10.x and later, quarterly updates are cumulative to the latest MSI (e.g. 10.1 replaces the base release of 10.0) and security patches are cumulative to the last quarterly. Thus, 10.0 > 10.1 is valid. 10.0 > 10.0.3 > 10.1 isn’t.
    • MUI updates are different from localized Reader updates. A localized Reader AIP for 10.1.3 would follow the below path 10.1.0 > 10.1.3 since 10.1.0 is the base release (last MSI) for a localized Reader) A MUI Reader AIP for 10.1.3 would follow the path 10.0.0 > 10.1.3 since 10.0.0 was the base release for MUI Reader.
    • When you have an existing product install that prevents an AIP update due to the order constraints, uninstall if first. For example, you could use msiexec.exe /x <guid> <switches>. It must be a clean uninstall.
  • Do not create the AIP directly on the root drive (e.g. C:). Use TARGETDIR on the command line or the AIP user interface to specify a different install location.

  • If you previously deployed using an AIP, then you must apply the successive patches using an AIP.

  • Know when you can reuse AIPs and when you have to create a new one. For example, Acrobat 10.x quarterlies are cumulative and cannot be installed on top of each other.

  • 11.x products do not require uninstalling existing products that were installed via an AIP. Update the product as described at http://www.adobe.com/devnet-docs/acrobatetk/tools/AdminGuide/gpo.html.

8.2   Valid update patterns

The patterns below list the acceptable AIP patch patterns for Windows and Macintosh deployments

8.2.1   11.x

8.2.1.1   Windows

Acrobat pattern formula: Base release + latest quarterly + latest out of cycle patch)

  • Acceptable: 11.0.0 > 11.0.01 (Q) > 11.0.02 (OOC)
  • Acceptable: 11.0.0 > 11.0.03 (Q)

Reader pattern formula: Last MSI + latest quarterly + latest out of cycle patch)

  • Acceptable: 11.0.0 > 11.0.01 (Q) > 11.0.02 (OOC)
  • Acceptable: 11.0.0 > 11.0.03 (Q)

8.3   AIP creation

Administrative installation Points (AIP) lay out the installer according to the directory table in the MSI database. Because the Customization Wizard allows users to customize which files are installed, you should verify that any files that were included with the transform are laid out properly in the AIP directory structure.

To create and update an AIP:

  1. Download the requisite installer. You’ll need to know the following:

    • Language and locale IDs.
    • Whether the installer is providing a quarterly update or an out-of-cycle patch.
    • What is already installed on the target machines.
    • A license number if installing Acrobat.
  2. Understand the and adhere to the AIP. Create the AIP accordingly:

  3. Backup the installer files (both the MSI and any needed MSP files) to a location where you will store the original downloads. For example, C:\Temp\Reader<version>\sources\.

  4. Create a distribution point folder where machines can install the uncompressed program files (e.g. \\<server>\Reader\AIP<version>\). The network share must provide authenticated users and Domain Computers with read access. This example calls the path <AIP distribution point dir path>.

  5. Copy the installer files you downloaded to <AIP distribution point dir path>.

  6. Verify no one is using the share. If a file is in use, the new file version will not copied to the AIP.

  7. Change directories to the AIP directory and run the commands from there.

  8. At a command prompt, run:

msiexec /a <AIP distribution point dir path>\<ProductName>.msi
TARGETDIR=<AIP distribution point dir path>

Or

msiexec /a <AIP distribution point dir path>\<ProductName>.msi
  1. Choose Next at the welcome dialog.

msiexec: Welcome screen

_images/msiexec_welcome.png
  1. When prompted, specify a network location for the AIP.

Note

Do not install the AIP at the root directory such as C:or D:as that often results in errors. You can use the AIP UI to specify a different location. Alternatively, when using the command line with the /qb or /qn switches, use the TARGETDIR property.

msiexec: Choose network location screen

_images/msiexec_chooselocation.png
  1. Choose Install.
  2. Choose Finish. A server image of the expanded product is now available for distribution.

AIP expanded server image

_images/msiexec_expanded.png
  1. If there are patches, apply the patches to the install point. For example:

9.x patching on Windows

msiexec /a <AIP distribution point dir path>\<ProductName>.msi /p
<AIP distribution point dir path>\AdbeRdr910_en_US.msp
msiexec /a <AIP distribution point dir path>\<ProductName>.msi /p
<AIP distribution point dir path>\AdbeRdr912_en_US.msp

10.x patching on Windows

msiexec /a <AIP distribution point dir path>\<ProductName>.msi /p
<AIP distribution point dir path>\AdbeRdrUpd1011.msp
  1. Optional: If you wish to customize the MSI (disable and enable client features), create a transform (MST) file with the Customization Wizard.
  2. Apply the mst transform file to the expanded MSI in the AIP (note the use of the /i switch rather than /a or /p).
msiexec /i <AIP distribution point dir path>\<ProductName>.msi
TRANSFORMS=<AIP distribution point dir path>\<ProductName>.mst
  1. Configure licensing if you have not already provided the license information in the Wizard when you created the MST.

8.4   AIP Examples

Note

Quarterlies are cumulative to the last MSI (for MUI and non-MUI installers this is different), and patches are cumulative to the last quarterly. Use msiexec.exe /x <product GUID> <switches> to uninstall versions which impair your ability to adhere to the installation. For a list of 7x, 8.x, and 9.x installers and acceptable patch orders, see http://helpx.adobe.com/acrobat/kb/update-patch-acrobat-reader-7.html.

8.4.1   Acrobat quarterly update

Creating an AIP for any version should not be more than two steps process except when there is also an out of cycle (security) patch.

  1. Create AIP for Acrobat Pro 10.0:
msiexec /a <Path to 10.0 AcroPro.msi> TARGETDIR="AIP_dir"
  1. Patch with Acrobat 10.x.x patch
msiexec /a <AIP_dir\AcroPro.msi> /p <Path to Acrobat 10.x.x patch>

8.4.2   Acrobat security patch

  1. Create AIP for Acrobat Std 10.0
msiexec /a <Path to 10.0 AcroStd.msi> TARGETDIR="AIP_dir"
  1. Create the AIP for the previous quarterly patch
msiexec /a <AIP_dir\AcroStd.msi> /p <Path to Acrobat 10.x.x patch>
  1. Create the AIP for the security patch
msiexec /a <AIP_dir\AcroStd.msi> /p <Path to Acrobat 10.x.y patch>

8.4.3   non-MUI Reader quarterly

For Reader create an AIP from the latest available MSI. For example, as of September 13, 2011, you can start with 10.1 (a full MSI installer) rather than the 10.0 MSI.

  1. Create AIP for Reader 10.1:
msiexec /a <Path to 10.1 MSI> TARGETDIR="AIP_dir"
  1. Create the AIP for the current quarterly patch:
msiexec /a <AIP_dir\AcroRead.msi> /p <Path to Reader 10.1.1 patch>

8.4.4   MUI Reader quarterly

MUI updates are different from localized Reader updates since the last released MSI is 10.0. Thus, a MUI Reader AIP for 10.1.3 would follow the path 10.0.0 > 10.1.3 since 10.0.0 was the base release for MUI Reader.

  1. Create AIP for Reader 10.0:
msiexec /a <Path to 10.0 MSI> TARGETDIR="AIP_dir"
  1. Create the AIP for the current quarterly patch:
msiexec /a <AIP_dir\AcroRead.msi> /p <Path to Reader 10.1.1 patch>

8.4.5   8.x & 9.x security updates

This information only applies to 9.x products and earlier and does not apply to 10.x and later products. Ideally, you will update in the required order and uninstall intermediate updates and patches as required to adhere to that order with msiexec.exe /x <guid> <switches>.

When you can’t create a new AIP and start over and the last update was an out of cycle patch, you can update user machines with the following:

msiexec /i <path to the AIP's msi> REINSTALL=ALL REINSTALLMODE=vomus

The above command line updates user machines, not the AIP itself. At this point you’ve abandoned the use of AIPs for deployments. Future AIP usage will require uninstalling the product and starting over with a new AIP.

Note

When you patch an AIP image, the Windows Installer performs a re-cache and reinstallation of the original product version, thereby replacing the previously cached MSI file and overwriting any old files with the newer version. By installing complete files the administrative update can correctly replace any modified files on the server.

8.5   AIP troubleshooting

Verify the following:

  • You have complied with the best practices.
  • You have copied all files to the AIP directory and then have changed directories so that you are running the commands from the AIP directory.
  • Do not install the AIP at the root directory such as C:or D:as that often results in errors. You can use the AIP UI to specify a different location. Alternatively, when using the command line with the /qb or /qn switches, use the TARGETDIR property.
  • Your patch sequence is correct: 10.x installers are cumulative. For Reader, patch to the latest MSI. For Acrobat, any quarterly can be applied to the base release.

Why does my AIP install result in an “Upgrade can’t be applied error”?

Patching of AIP is failing because you are trying to apply a quarterly update over an out of cycle security patch. To fix the problem:

  1. Discard your AIP.
  2. Create a new AIP to the most recent quarterly.
  3. Patch that AIP with the latest out of cycle patch.

Windows installer error

_images/win_installer_error.png

Why do I get an ``<license number>.error`` when installing Acrobat from my AIP?

Patching of AIP is failing because you may be trying to apply a quarterly update over an out of cycle security patch.

Why do I see a “another version is already installed” error?

Verify no previous product has been installed. If it has uninstall it. If you’ve already uninstalled, try Microsoft’s or Adobe’s cleaner tool.

This error can also appear if you are patching an AIP in an unsupported order.

Some related information might be found here: http://forums.adobe.com/message/4329735#4329735.