Pre deployment planning should include the following steps:
All of these items can be configured with the Customization Wizard for Windows. Mac users can use the new Mac Wizard, though that tool is new and not as feature rich. In practice, configuration usually leverages a mix of command line properties, Wizard, manual registry/plist manipulation, and post-deployment methodologies such as GPO and scripting techniques.
Note
The following sections only describe a small subset of the available options.
Installs and uninstalls may require closing conflicting processes to avoid “files in use” errors. Conflicting processes (and therefore potential conflicts) are governed by the installer tables AppsInUse (Acrobat) and AppsinUseEx (Reader). However, there is internal logic, so simply reviewing the tables does not provide a discrete list of items that must be closed in silent and manual workflows. Moreover, the Windows Installer may also invoke a Files In Use dialog modules when the installer tries to replace or uninstall certain modules.
As a best practice, close everything. If this is not possible in your environment, here are some items to explicitly look out for:
All versions:
9.x products are usually forcefully closed during product updates. 10.x-11.x products are not always subject to this limitation, thereby allowing silent installs anytime. However, it is generally a good idea to close product processes if possible.
- Acrobat (Acrobat.dll): Loaded when Acrobat is open, a PDF is running in a browser, or it is used for thumbnails, property sheets, IEFilter, and the preview handler.
- Reader (Acrord32.dll): Loaded when Reader is open, a PDF is running in a browser (e.g. iexplore/Acrord32.exe), or it is used for thumbnails, property sheets, and the preview handler.
10.0 and earlier:
- Close browsers, including FireFox, Chrome (for Acrobat products 10.1 and later), and Netscape.
- MS Office applications including: Powerpoint, Access, Excel, Outlook, Word, Autocad, Project, and Visio.
11.0:
- Adobe Application Manager
- Adobe Application Manager Setup
- Adobe Application Manager Setup Launcher
- Acrobat.dll and Acrord32.dll
Some users have reported conflicts with security software (such as Mcafee’s on-access scan v.8.8) where installation fails with error 1321. If you experience this error, try testing the install with your security software disabled.
Silent install with an ignorable process running: Installation succeeds, but after installation must close and restart the ignorable application to get the dlls loaded from the higher version application installed.
Silent install with a non-ignorable process running:
- Example 1: Installing 10.0 over 9.0 with Excel running. Excel is non-ignorable and a silent installation of 10.0 fails.
- Example 2: Installing 10.0 over 9.0 with a PDF open in IE. Acrord32.dll is loaded and non-ignorable and a silent installation of 10.0 fails.
- Example 3: Uninstalling Acrobat where excel launched (and select “Preferences” from the Acrobat ribbon) and uninstall will fail.
Note
In the case of failure, there is likely to be an error in the MSI log containing Setup terminated because critical files are in use or applications that interfere with files installed by setup are running. Review the preceding entries in the log file and close the applications listed before retrying setup.
LiveCycle Designer (LD) is installed by default with all Acrobat versions up to 10.0. With 11.0, LD is not installed, and any existing versions of LD are uninstalled. If you are installing 11.0 and need to maintain access to LD, do the following:
Some components use separate installers. These should be downloaded and run at deployment time. The following items require running an additional installer:
Most application settings are not automatically migrated. If you inspect the TransferRegistry table via the Wizard, Orca, etc, you can see what gets migrated. When deploying, keep in mind the following:
Note that Adobe implemented cumulative updates with 10.0, thereby greatly simplifying keeping the product up to date. The intention is to provide MSI installers rarely and only when required due to the extensive nature of changed features or fixes.
With 10.x products it is possible to for different products and versions to coexist on a single machine as follows:
Adobe Reader’s Multi-User Reader Desktop (MURD) feature hosted on LABs allows enterprise users to install multiple Reader versions and define which version should open PDFs with a certain file extension. For details, see 15 Multi-User Reader Desktops.
Reader X does not include the AIR runtime, but 9.x English language versions provided from the Reader Download Center do install the AIR™ runtime. There are several ways to avoid AIR installation:
Configure preferences via the Wizard, installer tables, or the command line. For example, common tasks include turning off the EULA, disabling the updater, and disabling acrobat.com integration. There are hundreds of other preferences that you can use to control workflows, certificate processing, data handling, communications with others servers, and so on. Documented preferences reside in the Preference Reference.
Note
Only a few of the available options are described below. Use the Wizard and Preference Reference to learn about the full range of options.
The Adobe Customization Wizard enables tuning the Windows installer for Adobe products prior to mass deployments. The Wizard is a free, downloadable utility designed to help IT professionals take greater control of enterprise-wide deployments of any of the Acrobat family of products.
The Wizard enables IT to:
Although many tools such as Orca and Admin Studio can be used to customize Microsoft transform (MST) files, Adobe only supports the Adobe Customization Wizard.
To download the Wizard, go to:
The Wizard’s user interface (UI) only provides basic options for feature configuration. Moreover, using the Wizard’s UI to set preferences will result in overwriting existing registry settings that you could otherwise drag and drop from a template application. In other words, you can leverage existing settings from 10.x or an IT-configured 11.0 install.
A rich customization workflow includes the following:
11.0 introduced a Wizard for tuning the Mac installer. For details, refer to the Customization Wizard for Macintosh documentation.
Prior to 10.x, Adobe did not recommend or support having both applications installed on the same system. If you do deploy both applications, the installer sets Acrobat as the default PDF viewer by default since it is the more functional of the two applications. In general, Acrobat is more capable and Reader is more secure, although these products are rapidly reaching parity in their security features.
The default handler can be set in the following ways:
All versions of Acrobat and Reader after 9.0 provide some level of acrobat.com integration by default. Disable Acrobat.com integration by setting preferences via one of the following methods:
With 11.0, all Acrobat installers are MUI installers. Before starting, verify you have the correct installer. There are several installer types:
Note
In addition to the filename, you can also check the setup file directory which includes the language specific .mst files as well as the Acrobat msi file. These are identified by language ID codes.
11.0 only.
When a MUI installer is opened in the Wizard, MUI configuration options appear in the Installation Options panel. Select one of the following options:
By default, if the user does not change any option in the MUI Languages pane, an All Language Serial number will install Acrobat in the language of the operating system.
Serial number attributes are not validated in the Wizard so these settings will be applied only if applicable. For example, if a user provides a language value in this option which are not supported by the serial number then installation will fail with an error message.
Note
The Wizard writes /sl <language ID code> in the setup.ini file.
If you’re not using the Wizard, you can specify a language-specific MST on the command line. For example, to deploy a Dutch version of the product, use:
msiexec /i AcroStan.msi TRANSFORMS="1043.mst;<other MSTs if needed>" /qf
The LANG_LIST property can be used on the command line to install one or more languages as described in 7 Adobe Properties.
Note that there are 3 language variations that map to a base MST install as follows:
You can configure machines with MUI installs that have installed all languages to use a specific language as follows:
8.x > 10.x
11.x
Note
For 10.1 and later, you can also create a machine-level setting at HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\(product name)\(version)\Language\UseMUI. End users cannot change this setting without administrator privileges. For more detail about Language and other preferences, see the Preference Reference.
On Windows XP machines, the OS’s regional settings may need to be changed to enable non-Latin language selection during a MUI install. Regional switching is not an Acrobat feature but how Windows XP works with codepages.
To change the OS settings:
Control Panel > Regional and Language Options.
Selected Advanced tab.
In Language for non-Unicode programs, select the Language.
For Japanese, Chinese, and Korean:
- Choose the Languages tab.
- Choose Install files for East Asian Languages.
- Reboot if you don’t immediately see these languages available under Language for non-Unicode programs.
Codepages
XP uses codepages to enable certain character support. Codepages are the way Windows enabled non-Latin language character encodings before Unicode was supported. For an overview, see http://en.wikipedia.org/wiki/Windows_code_page.
Selecting a codepage activates all the languages associated with that code page. For example, changing the regional settings and selecting a codepage for Czech also makes Polish, Hungarian, etc. available, but not Turkish.
| Codepage | Language |
|---|---|
| 932 | Japanese |
| 949 | Korean |
| 936 | Chinese Simplified |
| 950 | Chinese Traditional |
| 1250 | Czech, Polish, Hungarian, Croatian, Slovenian, Romanian, Slovak |
| 1252 | English, French, German, Italian, Spanish, Swedish, Dutch, Danish, Finnish, Norwegian, Brazilian Portuguese, Catalan(2), Basque(2) |
| 1254 | Turkish |
| 1251 | Russian, Bulgarian(1), Ukrainian |
| 1257 | Estonian(1), Latvian(1), Lithuanian(1) |
Custom files are one of the primary ways an enterprise can improve business efficiency and lower the Acrobat’s total cost of ownership. This feature is often under utilized, and workflow owners may find it beneficial to review the list below as well as the directories under the product’s root install location. Some of the customizable files include:
IT can deploy custom files before or after product installation.
Deploy files with initial installation
Prior to product deployment, IT typically uses the Customization Wizard to add files to any requisite directory or to set configure the registry to scan custom, shared directories. To do so:
Deploy files using Group Policy Objects
Admins that use GPO and Active Directory deployments can use their standard methodologies for deploying files and custom registry settings. At a high level, the steps include:
Do one of the following:
- Create a Group Policy which runs a file copy script at system log on or log off or at a scheduled time.
- Place the files on the target machines via User Configuration\Preferences\Windows Settings\Files or User Configuration\Preferences\Windows Settings\Folder.
Verify the files are copied to the standard product or user directory so that Acrobat can find the files.
Platform considerations
Most files are applicable to both Windows and Macintosh. Except for the root path, file locations are identical under the product install directories. Where registry or plist preferences provide file-related configuration options, corresponding registry preferences can typically be used on Macintosh by specifying equivalent plist settings in /Library/Preferences/com.adobe.Acrobat.
Refer to the Preference Reference for registry and plist details.
Many organizations use plug-ins to customize workflows for particular needs. The Customization Wizard allows you to specify custom plug-ins for automatic installation. You can use plug-ins from third-party suppliers or develop your own using the Acrobat Software Developers Kit (SDK). For more information, see the Acrobat Developer Center: http://www.adobe.com/devnet/acrobat/.
JavaScript can be used to add and remove items from menus, automate Actions, and perform an almost limitless variety of other tasks that can improved workflow efficiency. You can use scripts from third-party suppliers or develop your own using the Acrobat Software Developers Kit (SDK). For more information, see the Acrobat Developer Center: http://www.adobe.com/devnet/acrobat/.
10.1.1 introduced changes that affect the use of global variables and user scripts. If you are migrating to a newer version, refer to the Application Security Guide for details.
Acrobat 11.0 introduces a streamlined way to create and manage custom tool sets across the enterprise. A Customize button in the upper right-hand area of the toolbar allows users to create new tool sets, manage existing tool sets, and choose any existing tool set.
This feature helps organizations standardize task-specific tool views, reduce training costs, and improve employee efficiency by grouping related tools into a common view. This feature allows:
Tool set files reside in two locations:
A local user directory (full access): Files which are stored and imported by the current user are placed in the default current user’s directory. For example:
C:\Users\<username>\AppData\Roaming\Adobe\Acrobat\11.0\UICustomization\<anyname>.aaui
A local, product directory (read only): Files in this directory are visible to any user on the machine. For example:
C:\Program Files (x86)\Adobe\Acrobat 11.0\Acrobat\UICustomization\<language>\<anyname>.aaui
To work with tool sets:
Note
When creating a new Tool Set, you can choose any available tool in any desired order.
Managing tool sets
Actions provide a way to reduce repetition, automate common tasks, and enable batch processing on one or more PDFs. Actions are similar to macros in other popular software applications and lower Acrobat’s total cost of ownership by increasing business efficiency.
Actions in 11.0 have been improved in the following ways:
These changes help organizations standardize document preparation, minimize errors, reduce training costs, and improve employee efficiency by combining repetitive multi-steps tasks into guided Actions. Actions provide a way for the enterprise to:
With 11.0, Actions are integrated with PDFMakers so that they can be invoked from other applications. For example, when saving a file as a PDF in Microsoft Word, the PDF tool bar now displays a Create PDF and Run Action button. The drop down list of Actions show all the available Actions that the product can find. The list is populated from these directories:
Action files can be stored in three locations:
With 10.x products, the Reader Help system is only available online. If the product does not have online access, configure the installations to point to a local version on your Intranet.
Note
For alternative solutions as well as solutions for 9.x, see http://kb2.adobe.com/cps/865/cpsid_86505.html.
To configure local access to Help for 10.x products:
Note
The easiest way to place this file prior to deployment is by using the Customization Wizard’s Files and Folders feature. The Wizard allows you to create an MST file that will modify the installer with any of your customizations.
Help menu JavaScript
/************************* Hide Menu ********************************/
//Hide the default Help menu
app.hideMenuItem("HelpReader");
/****************************** Menu Execution items **********************/
app.addMenuItem({ cName: "Adobe Reader Help PDF", cParent: "Help", cExec: "fTDocs1()", nPos: 0});
/***************************** Functions ************************************/
// Note: The "/C/Program Files/Adobe/" convention was used to conform to the
// Adobe SDK format but the installer does not do this so you may need to
// edit the path for your system.
function fTDocs1()
{app.openDoc("/C/Program Files/Adobe/Reader 10.0/Help/reader_X_help.pdf");};
The online help system can be made accessible when users are behind an authenticating proxy by setting the following preferences:
You can set any printing options via joboptions files. This example shows how to set corporate fonts.
Open the PDFMaker’s settings panel (method varies by the software product you are using to access it.
Choose Advanced Settings.
Add your font to the Always Embed list.
Save the settings as a new joboptions file.
Distribute the file:
- Predeployment: Use the Customization Wizard’s distiller feature: http://www.adobe.com/devnet-docs/acrobatetk/tools/Wizard/distiller.html
- Post deployment: Distribute the file to C:Users<username>AppDataRoamingAdobeAdobe PDFSettings and set the default joboptions file to use for the PDF printer and Distiller in the Registry. You will need to set the JobOptions registry entry for each PDFMaker used by specific software as well as for Distiller. For example:
[HKEY_CURRENT_USER\Software\Adobe\Acrobat\PDFMaker\11.0\Visio\Settings]
"JobOptions"="Standard"
[HKEY_CURRENT_USER\Software\Adobe\Acrobat\PDFMaker\11.0\Word\Settings]
"JobOptions"="High Quality Print"
[HKEY_CURRENT_USER\Software\Adobe\Acrobat\PDFMaker\11.0\Word\Settings\PrePDFA]
"JobOptions"="High Quality Print"
[HKEY_CURRENT_USER\Software\Adobe\Acrobat Distiller\11.0]
"JobOptions"="Standard"
The standalone product also ships with a browser plugin that enables viewing online and offline PDF files in a browser. Prior to 11.0, admins could enable integration with the browser by setting Originals/bBrowserIntegration to 1. However, due to different PDF viewing implementations across browsers as well as user settings, behavior is not always consistent.
It is also true that browsers and OS’s are becoming more restrictive with respect to plugins. For this reason, bBrowserIntegration is deprecated with 11.0. End users and admins should configure their browsers to view PDFs with Adobe’s plugin as described in http://www.adobe.com/go/pdfinbrowser.
11.0 introduces support for WebMail accounts in PDF workflows. Features include support for:
For configuration details, see the Preference Reference or the Wizard Guide.
The product can be configured to scan existing LDAP servers for information about contacts and certificates that should be available in signature workflows. For details, refer to the digital signatures documentation.
The job of integrating Acrobat products with a new or existing Public Key Infrastructure should fall to an experienced PKI administrator. For details about PKI integration and digital signature workflows, refer to the digital signatures documentation.
The Adobe PDF iFilter is designed for end users or administrators who wish to index Adobe PDF documents using Microsoft indexing clients. This allows the user to easily search for text within Adobe PDF documents. The key benefits include:
32-bit Acrobat 9.x and later products bundle a 32-bit PDF iFilter. It uses the Microsoft iFilter interface and allows third-party indexing tools to extract text from Adobe PDF files. 64-bit versions are available as an add-on from http://www.adobe.com/support/downloads/product.jsp?product=1&platform=Windows.
64-bit product installs require that the add-on be installed separately. If you already have the iFilter plugin on the machine left over from a previous install, reinstall it.
| Version | 32-bit | 64-bit | iFilter version and notes |
|---|---|---|---|
| Reader 8.x | bundled | None | Version 6. |
| Acrobat 8.x | bundled | bundled | Version 6. |
| All 9.x | bundled | Add on | Version 9. First added in 10.1. 32 bit not in 10.0-10.0.3 |
| 10.x | bundled | Add on | Version 9. Security improved with 10.1 |
| 11.x | bundled | Add on | Version 11. Updated for 11.x products and its supported platforms. |
Installation and configuration instructions
Searching attachments and portfolios
By default, attachments are not searchable inside Windows desktop search because iFilters for Windows Desktop Search (WDS) run in a filter isolation process (SearchFilterHost.exe). The process runs under the Local System security context with restricted rights which doesn’t permit creating temporary files. Since searching attachments requires creating a temp file, attachment searches fail.
The workaround is to make WDS allow the PDF iFilter to write a temp file so that it can extract contents out of PDF file attachments. To do so:
|
© Copyright 2012-2013 Adobe Systems, Inc. Updated May 14, 2013. |
|