Teablog72

The Adobe Acrobat User Community is a global resource for users of Acrobat and PDF, with free eseminars, tips, tutorials, videos and discussion forums.

Installation scenarios¶

1. Adobe Acrobat Reader 2021 for Windows & Mac. To read PDF documents & increase reading experience with Adobe Acrobat Reader latest edition.
2. Download the Adobe Flash Player uninstaller: Mac OS X, version 10.6 and later: uninstallflashplayerosx.dmg; Mac OS X, version 10.4 and 10.5: uninstallflashplayerosx.dmg; The uninstaller is downloaded to the Downloads folder of your browser by default. Adobe Acrobat DC helps you PDF like a boss in the office and on the go. Explore Acrobat.

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 https://www.apple.com/remotedesktop/.

• GUI: User interface installations manage the install on a per user basis. These are seldom used in enterprise settings.

Installer details¶

Product versioning¶

Track release schedules and their respective versions will be different, but both the Continuous and Classic tracks share an identical methodology. The new strategy is designed to provide better granularity, support more frequent releases, and aid in troubleshooting by providing build information. In it’s generic form, the version number will appear as major.minor.minor_minor.

* The year-based version number is not the same as the Classic track name. While the Classic track versions begins with 15|17|20 and the current track version is 2015|2017|2020|2020, the track name only changes at each major release–not every year. The version number increments every year.

Two tracks¶

The Acrobat product family provides two tracks for both Acrobat and Reader:

• The Continuous track provides service-based tools as well as new features, security and platform enhancements, and bug fixes as part of frequent (and most often) silent updates. Over time, the Continuous track’s update cadence will be more frequent than the Classic track. Classic license program customers do not have access to this track for Acrobat.

• The Classic track is similar to the 11.x model and provides few (if any) new features in updates. Free services are available, but optional. Like previous releases, a quarterly update cadence delivers security and platform enhancements as well as bug fixes.

Note

For up-to-date details about new features on the Continuous track, see https://helpx.adobe.com/acrobat/using/whats-new.html.

Example release schedules:

Acrobat DC tracks¶

* What services are visible in the user interface varies by the purchased track and license type. Use the Customization Wizard or registry/plist configuration to remove unwanted items from the user interface.

• For the Continuous track, all services are visible and functional. Note that some features, such as Create PDF and Export PDF, are part of the desktop offering and don’t use a DC service.

• For the Classic track, paid for service-based tools are unavailable. Features such as Export PDF are part of the desktop product and don’t require a service to function. Free services which don’t duplicate existing functionality are on by default.

* What services are visible in the user interface varies by the purchased track and license type. Use the Customization Wizard or registry/plist configuration to remove unwanted items from the user interface.

• For the Continuous track, all services are visible. Free services are functional by default, and paid-for services require an upgrade or purchase to access.

• For the Classic track, most service-based tools are hidden. Basic, paid-for services such as Create PDF and Export PDF are visible but must be enabled with a purchase.

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.

Install locations¶

Default GUI installations of Acrobat and Reader options are as follows:

• Acrobat: /Applications/AdobeAcrobat(version)Pro/AdobeAcrobat(trackname).app

• Reader: /Applications/AdobeReader.app (Not customizable)

Note

Customization is not supported in OSX 10.5 and the application installs in the default location at /Applications/AdobeAcrobat<version>Pro.

Installing special fonts¶

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

Note

Acrobat ships with font packs and a spelling dictionary. Reader requires a separate download. Adobe provides both Asian and Extended Language font packs as well as a spelling dictionary as downloads:

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:

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.

Language¶

The system (OS) language determines the product 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 ReadMes, the Mac OS X system installer simply offers the user to view the Read Me in the system language.

Installer customization¶

Adobe installers can be deployed over the network using standard deployment tools. As described elsewhere, you can modify the installer via the Wizard and/or manual plist configuration.

Install location¶

Customize the install location by choosing a custom location during a GUI install or by modifying the installer package manually. The 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. When the Updater is disabled and/or non-default install locations are needed, set the AppPath preferences as follows:

1. Navigate (or create) to Users/<username>/Library/ApplicationSupport/Adobe/<product>/(version)/. For example, the Acrobat (version) path would be Users/<username>/Library/ApplicationSupport/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.

4. Set the key value to the application’s path. For example, for Reader it could be /Applications/MyCustomFolder/AdobeReader.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.

• 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.

Choosing components to install¶

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:

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.

Verifying what will be installed

To verify which components will be installed, run:

Applying choices.xml

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

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 --expandpkg-pathdir-path. For example:

Note

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

2. Open the distribution file in a text editor.

3. Navigate to choices-outline and note the list of choices (From the tables above).

4. Add a start_selected attribute to each choice node and set it to true or false as desired:

Note

For additional distribution file details, see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/DistributionDefinitionRef/DistributionDefinitionRef.pdf.

5. Save the distribution file.

6. Flatten the expanded package:

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

Chained installs (DC and later)¶

The script and examples here leverage the new installer packaging tools that Apple currently uses. You can also watch the tutorial.

Build cmd line¶

For more information, see the Apple manpage.

The build script uses the following properties:

• --root: Path to folder containing full/patch installer zip files

• --scripts: Path to the folder containing postinstall script

• --identifier: com.adobe.acrobat.chainedInstaller

• --install-location: /private/tmp/chainedinstallerpackagepath

Postinstall.sh¶

Note that the following shell script is slightly different than those provided previously (and from those in previous videos).

Apple Remote Desktop¶

Administrators can remotely deploy Acrobat/Reader to multiple Macintosh systems running Mac OS 10.13 or later 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 with APTEE (Adobe provisioning tool enterprise edition) or the Customization Wizard for Mac.

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.

Adobe Acrobat Reader X

Installing with Remote Desktop¶

These instructions provide only an overview. If you are not familiar with Apple Remote Desktop, refer to Apple’s documentation https://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.

Deploy the Adobe Provisioning Tool¶

10.x and later.

The APT 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 1-N users (pre-serializes the keys).

• Suppressing the end user license agreement (EULA).

• Suppressing the Adobe ID dialog.

To use the provisioning tool:

Adobe Acrobat Pro 11 Install

1. Download the provisioning tool.

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.

Customizing installs with APT¶

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:

5. Run the command as the user “root.”

6. Choose Send.

Uninstalling¶

Uninstall and deactivate Acrobat via the Mac terminal: