16   Macintosh Deployments

The Acrobat 10.0 introduced an installer for the Macintosh platform and support for the Apple Remote Desktop (ARD) which supports product installation and configuration in enterprise deployments.

16.1   What’s new for 11.x

The following new features are available:

  • Feature lockdown is supported in a way that has parity with Windows. Admins can set and lock many features.
  • A new update mode: Notify the user but don’t download the udpates.
  • A new scan preference ScanProtocol that allows selecting a scan driver.
  • Customization Wizard for Mac.
  • A single extended font pack installer for all additional languages.

16.2   Installation scenarios

The Acrobat installer for Apple platforms can leverage either the command-line (CLI) or graphical (GUI) interfaces provided by the Apple installer. Support for Apple’s installer format and conventions allow customers install the product to managed systems via their preferred methods, including:

  • CLI: Supports any custom installation solutions required in the enterprise. Acrobat products support the Apple Remote Desktop (ARD) which provides built-in support for pushing Apple installer packages to groups of machines. For ARD details, see http://www.apple.com/remotedesktop/.
  • GUI: User interface installations manage the install on a per user basis. These are seldom used in enterprise settings.

16.2.1   Chained installs with XI

As shown in the video tutorial, the Macintosh chained installation process has been greatly simplified. The Adobe Customization Wizard manages licensing, offline exception activation, and the EULA and registration.

After using the Wizard:

  1. Add the zipped Acrobat custom pkg file, the zipped updater file and the PostInstall ShellScript to PackageMaker.
  2. Set the /private/tmp/ location.
  3. Reference the PostInstallShellScript.sh file.
  4. Build.

Note

The new PostInstall Shellscript is equally simple in that it just copies zipped installer pkg to /private/tmp/, unzips the pkg installer pkg, and runs the install.

#!/bin/bash
unzipPkg()

{
rm -rf "/private/tmp/Adobe Acrobat XI Pro Installer.pkg"
unzip "/private/tmp/AcroProXI.pkg.zip" -d "/private/tmp";
}

{
rm -rf "/private/tmp/AcrobatUpd1101.pkg"
unzip "/private/tmp/AcrobatUpd1001.pkg.zip" -d "/private/tmp";
}

installAcrobat()

{
installer -pkg "/private/tmp/Adobe Acrobat XI Pro Installer.pkg" -target /
  rm -rf "/private/tmp/Adobe Acrobat XI Pro Installer.pkg"
  if (test $? = 0) then
  echo "Acrobat XI installed."
  else
  echo "ERROR: Acrobat XI installation failed."
  exit 1
  fi
}

installAcrobat11001()
{
installer -pkg "/private/tmp/AcrobatUpd11001.pkg" -target /
  rm -rf "/private/tmp/AcrobatUpd11001.pkg"
  if (test $? = 0) then
  echo "Acrobat 11.0.0.1 installed."
  else
  echo "ERROR: Acrobat 11.0.0.1 installation failed."
  exit 1
  fi
}

unzipPkg
installAcrobat
installAcrobat1001
installAcrobat1010
serializeAcrobat
suppressAcrobatEULA
suppressAdobeIDDialog
copyHideJStoAcroJSfolder
movepupdateplugintooptional

16.2.2   Standalone products vs CS bundles

10.0: Installation workflows vary depending on whether you are installing Acrobat as a standalone application or as part of a Create Suite (CS) bundle. Standalone Acrobat deployments use a standard installer and should adhere to the instructions in this document.

Note

For Acrobat bundled and installed with Creative Suite, use the tools and methodologies described in the CS documentation available at http://www.adobe.com/devnet/creativesuite/enterprisedeployment.html.

16.2.3   11.0 and AAMEE

11.0 bundled and standalone products support the use of the Adobe Application Manager Enterprise Edition 3.1(AAMEE). AAMEE allows for the customization and packaging of the CS6 applications (including Acrobat) with their updates as MSI or PKG installers for enterprise deployment and imaging. CS6 style deployment support means that admins can use the Adobe Provisioning Toolkit Enterprise Edition (APTEE) command line tool. This tool is provided as part of the AAMEE download. It is particularly usef for configuring installs as well as the serialization of Adobe products. Download the tools and documentation from http://www.adobe.com/devnet/creativesuite/enterprisedeployment.html.

16.3   Installer details

16.3.1   Installer behavior for existing installations

When installing the application on a system where it already exists in the installation location, several factors may affect the installation workflow:

  • Installing over an earlier version (Reader only): When an earlier version already exists in the target install location, then:

    • For GUI installations, a prompt informs the user that the product already exists and asks whether the installation should proceed. If YES, the existing <application>.app is moved to Trash and the new Reader is installed. If NO, then the existing Reader is not touched and the installer returns with an error.
    • For CLI installations, then the installer silently moves <application>.app to Trash and installs the newer one without further input. The old application is moved to Trash so that if installation fails then the user can restore old application.
  • Installing over the same base version: If the existing application has the same base version as the new one, then both GUI and CLI installations proceed as normal upgrades.

  • Installing over a new version: If the existing application has a higher version than the installing one, then the installation fails.

    • For GUI installations, an alert informs the user that a new version is already present.
    • For CLI installations, a log entry in the system’s installer log (/var/log/install.log) indicates that a new version is already present.

16.3.2   Install locations

For command line installations, the default locations are configurable. Default GUI installations of Acrobat and Reader options are as follows:

  • Reader: Reader is always installed in /Applications of the root volume. The location is not customizable.
  • Acrobat: Acrobat can be installed to any custom folder on 10.6 and later.

Note

Customization is not supported in OSX 10.5 (10.0 supports 10.5 but 11.0 does not)and the application installs in the default location at /Applications/Adobe Acrobat <version> Pro.

16.3.3   Components

Adobe’s Mac installer is a flat package installer. The .pkg can be expanded using the system’s pkgutil command so that you can see distribution file and its constituent components.

Note

The Application check box that allows selection of specific components does not appear in 10.5 due to an Apple bug.

Acrobat distribution file
Component Description
acropreinstall Required: Validates if the installation should proceed or not.
aam Required: Installs Adobe’s licensing module in the Users/<user name>/Library/Application Support/Adobe/OOBE folder.
coreapp Required: Installs Acrobat.app and Distiller.app. The default location is /Applications/Adobe Acrobat X Pro/.
appsupport Required: Installs various support files in the Users/<user name>/Library/Application Support/Adobe/ folder.
prefs Required: Installs files in the Users/<user name>/Library/Preferences area.
browserplugin Optional: Installs the Internet plug-in which integrates Acrobat with Safari.
printerworkflow Optional: Deprecated with 11.0. Installs the Automator Print workflow called Save as Adobe PDF.
Reader distribution file
Component Description
coreapp Required: Installs Acrobat.app and Distiller.app. The default location is /Applications/Adobe Acrobat (version) Pro.app/Adobe Acrobat Pro.app and /Applications/Adobe Reader.app
browserplugin Optional: Installs the Internet plug-in which integrates Acrobat with Safari.
appsupport Required: Installs various support files in the Users/<user name>/Library/Application Support/Adobe/ folder.

16.3.4   Language

Language is determined by the system OS language.

Adobe ships strings, a Read Me, custom installer plugins, and related resources in all locales with the installer. The installer GUI itself is provided by the built-in Mac OS X system installer, with the application localized by Apple and using the current system language. For Adobe files like ReadMe’s, the Mac OS X system installer simply offers the user to view the Read Me in the system language.

16.4   Installer customization

Adobe installers can be deployed over the network using standard deployment tools. As described below, some installation and application customization is available by creating and configuring com.adobe.Acrobat.InstallerOverrides.plist.

16.4.1   Install location

The default install location for Acrobat products is:

  • Acrobat: /Applications/Adobe Acrobat (version) Pro/Adobe Acrobat Pro.app
  • Reader: /Applications/Adobe Reader.app

The default location can be customized by choosing a custom location during a GUI install or modifying the installer package manually. The standard Updater normally determines the application location on its own, if for some reason that search fails, the Updater looks at the AppPath preferences described below.

However, the Updater is rarely used in enterprise settings, and non-default install locations are sometimes needed. When either or both of those conditions are true, set the AppPath preferences as follows:

  1. Navigate (or create) to Users/<user name>/Library/Application Support/Adobe/<product>/(version)/. For example, the Acrobat (version) path would be Users/<user name>/Library/Application Support/Adobe/Acrobat/(version)/.
  2. Create a file called com.adobe.<Acrobat | Reader>.InstallerOverrides.plist if it doesn’t exist.
  3. Add a key called ReaderAppPath or AcrobatAppPath.

Note

Standalone installers consume only the ReaderAppPath. Updates and patches consume both ReaderAppPath and AcrobatAppPath.

  1. Set the key value to the application’s path. For example, for Reader it could be /Applications/MyCustomFolder/Adobe Reader.app (note the missing trailing /).

Location determination for Acrobat and Reader

  • Updater workflow: When invoked by Help > Check for Updates , the Updater checks its own files for an ID, version, and the application’s absolute path. The default installation path is:

    • Acrobat: /Applications/Adobe Acrobat Pro/Adobe Acrobat (version) Pro.app
    • Reader: /Applications/Adobe Reader.app
  • Installer workflow: The Updater is typically not used in enterprise settings so that IT can manage what versions are installed. When updates are invoked by using the installer command from the command line the installer looks for InstallerOverrides.plist to see if it exists (see above):

If the file is absent:

  • The machine is searched for all valid applications by OS calls.
  • The first valid application found is patched.
  • If no valid application is found the patch installation fails giving appropriate message.

If the file is present:

  • The installer checks for the presence of an AcrobatAppPath or ReaderAppPath key.
  • If no valid path is found, the Updater looks for key BreakIfAppPathInvalid.
  • If BreakIfAppPathInvalid is TRUE, the Updater stops.
  • If FALSE, it again tries to sniff the application path from the OS.
  • If no valid path can be found, the installation fails with an error.

16.4.2   Choosing components to install

16.4.2.1   Using the installer command

The installer command allows you to perform a number of installer-related actions. For example, you can select particular components for install during a command line installation via a choices file. To view a list of what can be installed, run:

installer -package <path/Acrobat X installer.pkg> -showChoicesXML -target / | grep -A 1 choiceIdentifier

Note

Every choiceIdentifier maps to one of the choices in the installer. The installer choices for Acrobat products are listed in the distribution file tables above.

Controlling what’s installed

The choices XML file is an array of choiceIdentifiers that toggles the installer to behave the opposite of its default. For example, since everything is installed by default, including any component de-selects that component for install. For example, to avoid installing the optional Acrobat components, include the two optional components browserplugin and printerworkflow and set their selected attribute to 0.

choices XML
<array>
    <string>browserplugin</string>
</array>
<array>
    <string>printerworkflow</string>
</array>

Verifying what will be installed

To verify which components will be installed, run:

installer -package <path/Acrobat product installer.pkg> -target
/ -showChoicesAfterApplyingChangesXML <path/choices.xml>

Applying choices.xml

To apply the choices.xml file during installation, run:

installer -package "path to Adobe Reader X Installer.pkg"  -target / -applyChoiceChangesXML  <path/choices.xml>

16.4.2.2   Modifying the distribution file

The Acrobat product installer pkg contains a customizable distribution file you can use to permanently update the installer. To do so:

  1. Expand the flat package distribution file at pkg-path into a new directory specified by dir-path with --expand pkg-path dir-path. For example:
--expand <path/Acrobat product installer.pkg>
<target install folder>

Note

The target install directory can’t exist on the machine (even in Trash).

  1. Open the distribution file in a text editor.
  2. Navigate to choices-outline and note the list of choices (From the tables above).
  3. Add a start_selected attribute to each choice node and set it to true or false as desired:
<choice
description="DESCRIPTION_BROWSER"
id="browserplugin"
start_selected="false"
title=""AcroBrowserPlugIn">
  1. Save the distribution file.
  2. Flatten the expanded package:
pkgutil --flatten <path/expanded folder>
<path/Acrobat product installer.pkg>

You can now deploy the new package via your preferred method.

16.4.3   Installing special fonts

Acrobat products ship with a number of fonts. However, you may need to install certain fonts manually or customize the installer to perform that task. For example, non-Japanese Reader installers do not come with Japanese fonts, but such fonts can be included at installation time.

Note

The font packs and spelling dictionary only need to be installed with Reader as they are already present in Acrobat. 10.0 provided language font packs. 11.0 provides a single font pack.

To enable the application to render non-default fonts do the following (this example uses the Japanese font pack):

  1. Install the application.
  2. Download the requisite font pack installers. For example, the Japanese package identifier is com.adobe.Reader.fontpack.10.ja_JP.pkg.
  3. Run the installer via the GUI or command line:
sudo installer -pkg <installer filename>.pkg -target /

16.5   Apple Remote Desktop

Administrators can remotely deploy Acrobat/Reader to multiple Macintosh systems running Mac OS 10.5 or later (10.x) and 10.6 or later (11.0) across their network. Using Apple Remote Desktop 3 (commonly referred to as ARD), an administrator can install Acrobat/Reader automatically, without user intervention, to one or more remote computers. ARD copies the package to the computers selected for installation, runs the installer with no visible window or user interaction required, and then erases the installer files on completion.

The Acrobat Macintosh installer will perform initialization work such as the Adobe Application Manager installation as well as components needed for the serialization of the application. While serialization happens at launch time by default, enterprises can preserialize as follows:

The locale of the launched installation depends upon the current locale set on the user’s machine. The Installer application picks up strings from within our installation package in the order of locales specified in the system locale preference panel.

16.5.1   Install Acrobat products using ARD

These instructions provide only an overview. If you are not familiar with Apple Remote Desktop, refer to Apple’s documentation http://www.apple.com/remotedesktop/.

To deploy the product via ARD:

  1. Open ARD.
  2. Verify Remote Management and Sharing is enabled for every target computer.
  3. Select one or more Macintosh computers on which you want to install Acrobat or Reader.
  4. Choose Install on the top of the Remote Desktop window.
  5. When the Install Packages window appears, choose the + button at the top left of the Install Packages window.
  6. Locate and select the Acrobat or Reader .pkg file.
  7. Choose Open to add it to the Install Packages List.
  8. Choose Install to perform a complete installation of Acrobat or Reader on the selected machines.

Note

Apple Remote Desktop shows a progress bar and task status of the installation for each of the machines selected for the installation.

16.5.2   Deploy the Adobe Provisioning Tool

10.0 only.

The Adobe Provisioning Tool was released in December, 2010. It is only for Acrobat deployments and does not work with Reader. The tool streamlines enterprise deployment by enabling control of installation workflows such as:

  • Configuring licenses for X number of users (pre-serializes the keys).
  • Suppressing the end user license agreement (EULA).
  • Suppressing the Adobe ID dialog.

To use the provisioning tool:

  1. Download the provisioning tool from

  2. Open ARD.

  3. Select one or more Macintosh computers on which you want to configure Acrobat products.

  4. Choose Copy.

  5. In the Copy Items screen’s Place Items drop down list, choose Applications Folder.

  6. Verify the Set Item ownership drop down list is selected to Inherit from destination folder.

  7. In the Items To Copy list, navigate to the .dmg that you downloaded.

  8. Select the Adobe provisioning tool.

  9. Choose Copy.

Note

Once the Adobe provisioning tool is copied to the client machines, use a UNIX command to configure licensing and to suppress EULA and Adobe ID dialog.

16.5.3   Customizing Acrobat installs with APT

The APT is not for use with Adobe Reader. Acrobat installs can be customized with the APT as follows.

  1. Open ARD.
  2. Select one or more Macintosh computers on which you want to license an Acrobat product.
  3. Choose Manage > Send UNIX Command.
  4. Type the desired command or run the command from a script as follows:
sudo "<path>/adobe_provisioning_tool.app/Contents/MacOS/adobe_provisioning_tool"
<1 or more APT command line(s)>
  1. Run the command as the user “root.”
  2. Choose Send.
Acrobat provisioning tool commands
Feature Command
Configure enterprise licensing -C -a "Users/<user name>/Library/Application Support/Adobe/Acrobat 10 AMT/AMT" -s <serial number>
Suppress the end user license agreement (EULA) -S  -a "Users/<user name>/Library/Application Support/Adobe/Acrobat 10 AMT/AMT"
Suppress the Adobe ID (registration) dialog -R  -a "Users/<user name>/Library/Application Support/Adobe/Acrobat 10 AMT/AMT"

16.5.4   One step ARD deployments

16.5.4.1   Wizard and 11.0

Use the Customization Wizard for Mac.

16.5.4.2   APT and 10.0

It is also possible to deploy the product in one step via ARD using a script. To do create a wrapper installer and write a script to trigger the provisioning tool and ARD in the correct sequence.

For example:

  1. Compress the installer PKG file into a .zip file. For example: zip AcroPro<(version).pkg.zip "Adobe Acrobat (version) Pro Installer.pkg"

  2. Create a new package in PackageMaker.

  3. Add the zip file as a payload to the new package and set its destination to /private/tmp.

  4. Add the adobe_provisioning_tool.app application to the new package.

  5. Set its destination to /private/tmp.

  6. Verify relocation is off.

  7. Create a deployment sh file.

    postintall.sh

unzipPkg()
{
    rm -rf "/private/tmp/Adobe Acrobat (version) Pro Installer.pkg"
    unzip /private/tmp/AcroPro(version).pkg.zip -d /private/tmp }

installAcrobat()
{
    installer -pkg "/private/tmp/Adobe Acrobat (version) Pro Installer.pkg" -target /
    rm -rf "/private/tmp/Adobe Acrobat (version) Pro Installer.pkg"
    if (test $? = 0) then
        echo "Acrobat (version) installed."
    else
        echo "ERROR: Acrobat (version) installation failed."
        exit 1
    fi
}

serializeAcrobat()
{
    "/private/tmp/adobe_provisioning_tool.app/Contents/MacOS/adobe_provisioning_tool" -C -a "/Library/Application Support/Adobe/Acrobat (version) AMT/AMT" -s 1118-xxxx-xxxx-xxxx-xxxx-xxxx

    if (test $? = 0) then
        echo "Acrobat (verion) serialized."
    else
        echo "ERROR: Acrobat (version) serialization failed."
    fi
}

suppressAcrobatEULA()
{
    "/private/tmp/adobe_provisioning_tool.app/Contents/MacOS/adobe_provisioning_tool" -S -a "/Library/Application Support/Adobe/Acrobat 10 AMT/AMT"

    if (test $? = 0) then
        echo "Acrobat (version) EULA suppressed."
    else
        echo "ERROR: Acrobat (version) EULA suppression failed."
    fi
}

suppressAdobeIDDialog()
{
    "/private/tmp/adobe_provisioning_tool.app/Contents/MacOS/adobe_provisioning_tool" -R -a "/Library/Application Support/Adobe/Acrobat 10 AMT/AMT"

    if (test $? = 0) then
        echo "Acrobat (version) Adobe ID suppressed."
    else
        echo "ERROR: Acrobat (version) Adobe ID suppression failed."
    fi
}

unzipPkg
installAcrobat
serializeAcrobat
suppressAcrobatEULA
suppressAdobeIDDialog
  1. Add the postInstall.sh script as the post install step for the created component package.
  2. Create a pkg from the new package.
  3. Deploy the new pkg using ARD.

16.6   Disabling updates

There are several ways to prevent automatic updates: Setting the update mode to manual and disabling the application’s ability to update altogether.

16.6.1   Disabling and locking the Updater

With version 10.1.1 and later, it is possible for IT to disable and lock the Updater settings so that 1) updates won’t happen and 2) users can’t change the setting.

To do so:

  1. Navigate to <machine root>/Library/Preferences.

  2. Create a new file called com.adobe.(Acrobat.Pro | Reader).plist This file does not exist by default.

  3. Open the plist with an editor.

  4. Add the entries shown below.

  5. Save and close the plist.

    Locking and disabling the Updater

<dict>
  <key>11</key>
    <dict>
      <key>FeatureLockdown</key>
        <dict>
          <key>bUpdater</key>
          <false/>
        </dict>
    </dict>
</dict>

Note

With 11.0, Admins can set and lock any Mac setting that is lockable on Windows.

16.6.2   Updater settings: 9.x-10.x

The update mode is set on a per user basis as follows:

  1. Go to Users/<user name>/Library/Preferences/.

  2. Open one of the following:

    • 10.0 and later: com.adobe.<app name>.plist
    • 9.x: com.adobe.<app name>_<ppc/i386>_<version>.plist
  3. Find CheckForUpdatesAtStartup, or create the preference if it does not exist.

  4. Set the data type to boolean (0) and value as follows:

    • False: Manual. Do not download or install updates automatically.
    • True: Semi-automatic. Automatically download updates, but let me choose when to install them.

16.6.3   Updater settings: 11.x

The update mode is set on a per user basis as follows:

  1. Go to Users/<user name>/Library/Preferences/.

  2. Open com.adobe.<app name>.plist.

  3. Find CheckForUpdatesModeAtStartup, or create the preference if it does not exist.

  4. Set the data type to int (1) and value as follows:

    • 0: Don’t check for updates.
    • 2: Check for updates.
    • 4: Notify the user that downloads are available but do not download them.

16.6.4   Removing the Updater.acroplugin

To disable the application’s ability to update altogether, use a post install script to move, rename, or delete the Updater.acroplugin file from <root>/Contents/Built-in/Plug-ins/Updater.acroplugin.

16.7   Cmd line uninstalls

Product installs also provide an uninstaller along with the application at Applications/<product name>. For example, the path might be Applications/Adobe Acrobat (version) Pro. End users will uninstall the product via the user interface. However, it’s also possible to uninstall via the command line.

Differences between the 9.x and 10.x uninstaller

The improved uninstaller for 10.x and later differs from the 9.x uninstaller as follows:

  • 9.x removes all application files except Acrobat Uninstaller.app and its folder. While it removes licensing files, it doesn’t remove the license, or uninstall the application files or Distiller. During uninstallation, the uninstaller displays detailed output about what it is doing.
  • 10.x and later removes all application files, the license, and provides a detailed output of what does and doesn’t get found and removed.

To uninstall from the Terminal in Mac OS X:

  1. Close any running Acrobat products.
  2. 9.x retail users only: By default, two machines can be licensed by a single retail serial number. If you need to install the application on a 3rd machine, deactivate the Acrobat application.

Note

For 9x users with a volume license, the serial number will continue to reside on another machine and the license usage count will be increased on the activation server, if tracked. There is no activation/deactivation for 10.x on Mac.

  1. Invoke the uninstaller as follows:

    • 9.x syntax: $ sudo <Remover tool path> <Uninstaller.app path> <Acrobat App path>:
$ sudo "/Applications/Adobe Acrobat 9 Pro/Acrobat Uninstaller.app/Contents/MacOS/RemoverTool"
"/Applications/Adobe Acrobat 9 Pro/Acrobat Uninstaller.app/Contents/MacOS/RemoverTool"
"/Users/myname/Desktop/Adobe Acrobat 9 Pro/Adobe Acrobat Pro.app"

* **10.x syntax**: $ sudo <Remover tool path> <Uninstaller.app path> <Acrobat App path>. For example:
$ sudo "/Applications/Adobe Acrobat X Pro/Adobe Acrobat Pro.app/Contents/Support/Acrobat
Uninstaller.app/Contents/MacOS/RemoverTool" "/Applications/Adobe Acrobat X Pro/Adobe Acrobat
Pro.app/Contents/Support/Acrobat Uninstaller.app/Contents/MacOS/RemoverTool"
"/Applications/Adobe Acrobat X Pro/Adobe Acrobat Pro.app"

Note

In Acrobat 10.x and later, the uninstaller application is located inside the Acrobat App.

Successful uninstalls should remove product files, licensing information (including the serial number, EULA acceptance status, and so on.

16.8   Macintosh troubleshooting

16.8.1   Logging

There are two primary logs: one for the installer application and one for the Updater which is responsible for detecting and downloading updates as well as invoking the installer.

16.8.1.1   Install log

Apple’s Installer.app creates an install log that should contain all basic success and failure details. The file is located at /private/var/log/install.log created by Apple’s Installer.app.

By default, the installer logs only necessary information in installer log. However, it is possible to configure the log to provide debug output for 10.x and later products.

To set this preference, do the following:

  1. Go to Users/<user name>/Library/Application Support/Adobe/Acrobat/(version) or create it if it doesn’t exist.
  2. Open com.adobe.acrobat.InstallerOverrides.plist or create it if it doesn’t exist.
  3. Create following key-value pair: AcroPatchLogLevel:debug

debug logging

<key>AcroPatchLogLevel</key>
<value>debug</value>
  1. Save and close the file.

16.8.1.2   Updater log

The Updater creates a log at Users/<user name>/Library/Logs/Adobe/{application name} Updater.log. By default, it provides non-verbose output. To change the default:

  1. Go to Users/<user name>/Library/Preferences.
  2. Open to com.adobe.ARM.plist.

Note

Create the file if it does not exist. The file will not exist unless the Updater has run at least once.

  1. Create a new key if it does not exist: LogLevel.

  2. Set LogLevel:

    • Brief: -int 0
    • Verbose: -int 1
  3. Save and close the file.

The log size limit is as follows: If an existing log is bigger than 1 MB, the Updater truncates the log. Old log files are backed up once as Adobe Acrobat/Reader Updater-old.log and overwrites any existing old.log.

16.8.2   Installation failures

Conflicting processes running

Installs should take place on machines where there are no instances of an Acrobat product or plugin running.

Why do I get “Error in converting the plist ``/Library/Preferences/com.adobe.PDFAdminSettings.plist`` to xml1 format”?

16.8.3   Licensing problems

Why does my serial number not validate?

If validation occurs through an authenticating proxy, the Adobe Provisioning Tool may fail to validate a serial number.

16.8.4   Plist settings issues

It’s always good to remember the following:

  • Plist files are binary files. Different editors display plist contents in different ways such as XML, structured text, etc.
  • Different editors may handle preference values in odd ways. For example, the 3rd party Preference Setter application will set Integer 0, Boolean False, but Number 0, Boolean No may not work. In XCode, the latter works fine.
  • Plist files are cached during the current session. If you find your recently set preferences are disappearing, note that Acrobat reads the cached copy rather than the edited files and that it then writes out the plist file on exit, thereby overwriting your edits. To sync the cached plist copy with the newly edited plist, type the following in your terminal:
defaults read <path to your plist file>