Adobe Acrobat 7.0 for IBM Tivoli Software Distribution · form:...

User DocumentAdobe Acrobat 7.0 for

IBM Tivoli Software Distribution

ii

User Guide


Contents Product Name ................................................................................................... 1

Document Overview ...................................................................................... 1

References .......................................................................................................... 1

Overview of Product ...................................................................................... 1

Distribution and Installation Overview.................................................. 2

Customizing the Installation...................................................................... 3

Creating Adobe Software Profile Managers......................................... 6

Creating the Distribution Profiles ............................................................ 7

Importing the SPD Files............................................................................... 8

Adding Subscribers....................................................................................... 8

Distributing and installing Adobe Software ........................................ 9

Verifying installation................................................................................... 10

Uninstalling Adobe Software ................................................................... 11

Removing Adobe Software from the Distribution Database....... 12

Troubleshooting........................................................................................... 13

Known Issues.................................................................................................. 17

Adobe, the Adobe logo, and Acrobat Reader and Distiller are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. IBM and the READY FOR TIVOLI EMBLEM are trademarks of IBM Corporation in the U.S. and other countries and are used under license from IBM. IBM does not warrant and is not responsible for products or services bearing this mark. For IBM Ready for Tivoli Emblem meaning and disclaimers, visit http://www.ibm.com/software/tivoli/products/tivoliready/. ©2005 Adobe Systems Incorporated. All rights reserved.

1ADOBE ACROBAT 7.0IBM Tivoli Software Distribution

User Guide

Adobe Acrobat 7.0


Product Name Adobe® Acrobat® 7.0 for IBM® Tivoli Software Distribution. The supported Adobe products include Acrobat 7.0 Professional, Acrobat 7.0 Standard, Acrobat 7.0 Elements and Adobe Reader® 7.0. These products have been validated “Ready for IBM Tivoli.”

Document Overview This document covers installing and uninstalling Adobe Acrobat 7.0 products using IBM Tivoli Configuration Manager Software Distribution component. It also provides information for troubleshooting problems you might encounter.

References • Refer to these references for more information:

• Configuration Manager 4.2.2 User’s Guide

• Tivoli Enterprise Installation Guide, Version 4.1.1

• Tivoli Management Framework 4.1.1 User’s Guide

• Tivoli Management Framework for Planning Deployment Guide, Version 4.1.1

• Configuration Manager 4.2.2 Release Notes

• Framework 4.1.1 Release Notes

• www.tivoli.com

• www.adobe.com

In addition, Adobe has the following websites, targeted to IT managers:

• Acrobat IT Solutions website contains the most current information about Adobe Acrobat products: www.adobe.com/products/acrobat/deployment.html

• Adobe documentation regarding enterprise installations of Acrobat products: http://partners.adobe.com/public/developer/acrobat/index_advanced.html

Overview of Product Adobe Acrobat for Tivoli is a software distribution solution for remotely distributing Adobe Acrobat to Windows® platforms in a Tivoli environment. Using Tivoli Framework and Tivoli Software Distribution, you can distribute and install the following Adobe Acrobat software:

• Adobe Acrobat 7.0 Professional

• Adobe Acrobat 7.0 Standard

• Adobe Reader 7.0

• Adobe Acrobat 7.0 Elements


User Guide

Adobe has validated the deployment of Acrobat 7.0 products with Tivoli Framework 4.1.1 and Configuration Manager 4.2.2 from a Microsoft® Windows® 2000 SP4 Server.

Adobe has validated the deployment of Acrobat 7.0 to desktop client systems running Windows 2000 Professional SP4 and Windows XP Professional SP2. Target Systems must be Tivoli endpoints.

The localized versions tested are English and Japanese. Adobe tested deploying the localized version of the application (for example, Adobe Acrobat 7.0 Professional Japanese) to the localized version of the operating system (for example, Windows XP Professional SP2 Japanese).

Distribution and Installation Overview You can obtain the Adobe Acrobat 7.0 Tivoli Software Distribution files from www.adobe.com/products/acrobat/deployment.html.

The Adobe Acrobat products are packaged as SPD files. To work with the SPD files, the following steps are involved:

1 Setting up the Adobe Acrobat binaries

2 Customizing installation

3 Creating an Adobe region

4 Creating Adobe software profile managers

5 Creating the distribution profiles

6 Importing the SPD files

7 Adding subscribers

8 Distributing and installing the Adobe Acrobat software

9 Verifying installation

10 Removing Adobe Acrobat software from the distribution database

Tivoli Requirements Before applying any patches or updates to your Tivoli Management Enterprise configuration, it is recommended that you consult with IBM to verify the current patch recommendations for your current environments.

System Requirements

System Component Requirements

TMR Approximately 590 MB for images

Endpoints (Professional) Approximately 950 MB for images + installation

Endpoints (Standard) Approximately 754 MB for images + installation

Endpoints (ReaderFull) Approximately 105 MB for images + installation

Endpoints (Elements) Approximately 275 MB for images + installation


User Guide

The system requirements for the Acrobat 7 products are located at:

• Acrobat 7.0 Professional www.adobe.com/products/acrobatpro/systemreqs.html

• Acrobat 7.0 Standard www.adobe.com/products/acrobatstd/systemreqs.html

• Adobe Reader 7.0 www.adobe.com/products/acrobat/acrrsystemreqs.html#70win

• Acrobat 7.0 Elements www.adobe.com/products/acrobatel/systemreqs.html

Setting up the Adobe Acrobat binaries You need to create directories on the local hard drive of the Tivoli server for the following:

\Adobe\AcrobatProfessional

\Adobe\AcrobatStandard

\Adobe\ReaderFull (full version has all Adobe Reader features)

\Adobe\AcrobatElements

Once the directories are created, move the Acrobat binaries to the appropriate directories. The software distribution profile looks for the files in these locations to copy them to the target machines. If the files do not exist in these locations, the distribution fails.

To set up the binaries:

1 Place the installation files for Adobe Acrobat 7.0 Professional in \Adobe\AcrobatProfessional.

2 Place the installation files for Adobe Acrobat 7.0 Standard in \Adobe\AcrobatStandard.

3 Place the extracted installation files for Adobe Reader 7.0 in \Adobe\ReaderFull. See instructions for extracting the setup.exe and related files from the web downloads in the InstallShield Tuner 7.0 for Adobe Acrobat user document at: www.adobe.com/products/acrobat/deployment.html.

4 Place the installation files for Adobe Acrobat Elements 7.0 in \Adobe\AcrobatElements.

Customizing the Installation You need to modify the Acrobat Installer so that the installation runs without user interaction. For example, you must add the Serial Number and /qn Silent Install Command Line parameter.

You can modify the Acrobat Installer either by modifying the file or by using InstallShield Tuner 7.0 for Adobe Acrobat.

To edit the setup.ini file:

1 Locate the setup.ini file in the appropriate Adobe binary directory.

2 Save a copy of the file for backup.

3 Set the properties of the setup.ini file to Read-Write.

4 Open the file in an ASCII text editor.

5 In the CmdLine parameter, enter the following:

ISX_SERIALNUMBER=xxxx-xxxx-xxxx-xxxx-xxxx-xxxx /qn

where the x’s are the serial number for the corresponding product.

Note: For Reader, just use /qn, since there is no serial number for this product.

6 Save and close the file.


User Guide

You should modify the following files with a serial number and /qn before importing into Tivoli:

C:\Adobe\AcrobatElements\Elements\setup.ini

C:\Adobe\AcrobatStandard\setup.ini

C:\Adobe\AcrobatProfessional\setup.ini

You should modify the following files with a CmdLine=/qn before importing into Tivoli:

C:\Adobe\ReaderFull\setup.ini

C:\Adobe\AcrobatElements\Reader\setup.ini

Using InstallShield Tuner 7.0 for Acrobat Tuner provides a graphical interface to the Acrobat 7.0 Windows Installer that enables you to modify the installer to run without user interaction. In addition, you can cusomize the Acrobat installer and the look and feel of Acrobat prior to deployment. For example, the Updater in Reader and Acrobat is turned on by default. You might want to turn this off for enterprise deployments by using InstallShield Tuner 7.0 for Adobe Acrobat. For more information, see: www.adobe.com/products/acrobat/deployment.html.

Software package remove notesTo uninstall, the software package removal executes a command: msiexec /x {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} REBOOT=ReallySupress /qn where the GUID in {} is the product code of the Adobe product to be uninstalled. These product codes have been set for the Adobe Acrobat 7.0 (US English, Volume License) released products and might not be valid for other releases. The product code used for installation and uninstallation must match. Review the ProductCode={...} value in the installation setup.ini file and update the appropriate SPD so they match. Use a text editor to make the changes, or see “Modifying execution objects ” in the “Troubleshooting” section. For additional information see .“Uninstalling Adobe Software”

Completing these verification steps helps ensure that future attempts to remotely remove the software package from target systems can occur successfully. To update product codes in the SPD files using a text editor:

1 Open each .SPD file in an ASCII text editor. Find the “during_remove” section containing a line like the following:

/x {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} REBOOT= ReallySupress /qn

where the x’s are the product code.

2 Open the appropriate setup.ini file in an ASCII text editor. Find the line containing the productcode in the form:

ProductCode={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

where the x’s are the product code.

3 If the product codes do not match, update the SPD file. Save and close the file.

Note: Do not alter the product code in the setup.ini file.

Creating an Adobe Region Creating a policy region for Adobe software provides a place to store all of the Adobe components, and gives you the ability to create a software profile. It is recommended that you make Tivoli database backups before and after significant changes to your Tivoli environments. Refer to your Tivoli documentation for instructions.


User Guide

To create an Adobe region:

1 Open the Tivoli Desktop.

2 In the Desktop for Administrator window, choose Create > Region.

3 Enter Adobe for the new region name.

4 Choose Create > Close.

5 In the Desktop for Administrator window, right-click the new Adobe region.

6 Select Open. The new region should be empty.

7 Choose Properties > Managed Resources.

8 In the Set Managed Resources dialog box, move Profile Manager and Software Package from the Available Resources column on the right to the Current Resources column on the left, by selecting them and clicking the left arrow.

9 Click Set & Close.


User Guide

Creating Adobe Software Profile Managers Profile managers contain the information needed to distribute the Acrobat programs. The profile manager holds the distribution profile for the Adobe Acrobat software.

To create a profile manager:

1 In the Tivoli Desktop for Administrator window, open the Adobe region.

2 Choose Create > Profile Manager.

3 Enter Adobe Software for the profile name.

4 Click Create & Close.

The Adobe region now contains the Adobe Software profile manager.

The subscribers profile manager contains all of the systems that are targeted with the Adobe product. Since endpoints (target systems) are being targeted, the subscribers profile must support dataless endpoints.

To create a subscribers’ profile manager:

1 Open the Adobe region.

2 Choose Create > Profile Manager.

3 Enter Adobe Subscribers for the profile name.

4 To enter endpoint systems into this profile manager, select Dataless Endpoint. (If you are adding other profile managers as subscribers to this profile manager, deselect Dataless Endpoint.)


The Adobe region now contains the Adobe Subscribers profile.


User Guide

Creating the Distribution Profiles You populate the profile manager with distribution profiles for the installation and uninstallation of Acrobat 7.0 Professional, Acrobat 7.0 Standard, Acrobat 7.0 Elements, and Reader 7.0. These profiles contain the information needed to distribute the Acrobat software.

Once you create the profile, you import the Adobe SPD files into the respective profile.

Note: Enter the Adobe product names exactly as they appear in the instructions. The period ( . ) is required by Tivoli. It is recommended to use the caret ( ^ ). The caret separates the major version from the name of the product. The period separates the minor version from the major version.

To create the Adobe Acrobat Professional software distribution profile:

1 In the Policy Region Adobe window, right-click the Adobe Software profile and select Open.

2 In the Profile Manager window, choose Create > Profile.

3 In the new window, select Software Package.

4 Enter AcrobatProfessional^7.0 for the profile name.


Repeat the steps for the other products, substituting the following names:

AcrobatProfessional^7.0 -> AcrobatStandard^7.0 AcrobatProfessional^7.0 -> ReaderFull^7.0 AcrobatProfessional^7.0 -> AcrobatElements^7.0


User Guide

Importing the SPD Files Note: You only have to follow the steps for the Acrobat products you want to install.

When you created the profiles, they started out as empty containers. To activate the profiles, you import the SPD files into the profiles. The SPD files contain instructions that tell the profile where to put the Adobe files on the target computers, what executable programs to run, and other information, such as where to write out log files. If you have not yet downloaded the SPD files from adobe.com, please refer to www.adobe.com/products/acrobat/ deployment.html.

To import the Acrobat Professional 7.0 SPD file:

1 In the Profile Manger window, right-click the Acrobat Professional 7.0 profiles icon and select Import.

2 In the Location of Input File box, browse to the SPD file you want, or type the path to the SPD file.

3 Navigate to the Tivoli location containing the AcrobatPro7.spd file.

4 Select Build and enter the Tivoli Source Host Name, and the full path and name of the SPB file to be created.

5 Click Import & Close.

The Acrobat Professional 7.0 profile icon changes from an open box to a sealed box with a CD inside.

Repeat the steps for the other products, substituting the corresponding SPD files:

AcrobatProfessional^7.0 -> AcrobatStandard^7.0 AcrobatProfessional^7.0 -> ReaderFull^7.0 AcrobatProfessional^7.0 -> AcrobatElements^7.0 AcrobatProfessional^7.0 -> AcrobatStandard7.spd AcrobatProfessional^7.0 -> ReaderFull7.spd AcrobatProfessional^7.0 -> AcrobatElements7.spd

Backing up the databaseIt is recommended that you back up the Tivoli database before and after significant changes to your Tivoli environments. Refer to your Tivoli documentation for instructions.

Adding Subscribers Before you distribute the software, you need to add the subscribers who are receiving the software.

To add subscribers:

1 In the Adobe Software Profile Manager window, choose Profile Manager > Subscribers.

2 Move Adobe Subscribers to the left column.

3 Select Set Subscriptions & Close.

4 Open Adobe Subscribers.

5 In the Adobe Subscribers window, choose Profile Manager > Subscribers.

6 Move all the endpoints to receive Adobe software to the left column.

7 Select Set Subscriptions & Close.

8 Close the Adobe Subscribers profile manager.


User Guide

The Adobe Subscribers icon is added to the Subscribers panel and contains the selected endpoints.

Distributing and Installing Adobe Software Tivoli distributes the software to the target computers and executes the setup program to install the programs without disturbing the user.

To distribute and install Acrobat Professional 7.0:

1 In the Tivoli Desktop for Administrators window, open the Adobe region.

2 Open the Adobe Software profile manager.

3 Right-click the Acrobat Professional 7.0 profile icon and select Install.

4 Keep all defaults.

5 To distribute to the subscribers, do one of the following:

• Move the Adobe Subscribers profile icon to the left column.

• Expand the Adobe Subscribers profile and individually move the desired computers to the left column.


User Guide

6 Click Install & Close.

7 After installation is complete, you can review the installation status in the following log:

${BIN}/swdis/work/AcrobatProfessional^7.0.log$ where {BIN} is the location of the Tivoli bin directory.

Any exit codes listed in the log file are Windows Installer exit codes. For example, 3010 means that a reboot is necessary before the install is complete.

The process is the same for the other products. The log files are as follows:

AcrobatStandard^7.0 -> AcrobatStandard^7.0.log

ReaderFull^7.0 -> ReaderFull^7.0.log

AcrobatElements^7.0 -> AcrobatElements^7.0.log

Verifying Installation After deploying Acrobat to the target systems, you can verify that the installations were successful.

To verify installation:

1 Open a file browser.

2 Navigate to the directory in which Tivoli was installed.

3 Navigate to \bin\swdis\work.


User Guide

4 Open the appropriate log files to check if the execution of setup.exe was successful for the target node:

• AcrobatProfessional^7.0.log

• AcrobatStandard^7.0.log ReaderFull^7.0.log

• ReadeMin^7.0.log

• AcrobatElements^7.0.log

Uninstalling Adobe SoftwareTivoli executes the uninstall command on the target systems.

To uninstall Acrobat Professional 7.0:

1 In the Tivoli Desktop for Administrators window, open the Adobe region.

2 Open the Adobe Software profile manager.

3 Right-click the Acrobat Professional 7.0 profile icon and select Remove.

4 Keep all defaults.

5 To remove subscribers, do one of the following:

• Move the Adobe Subscribers profile icon to the left column.

• Expand the Adobe Subscribers profile and individually move the computers you want to the left column.

6 Click Remove & Close.

7 After uninstallation is done, you can review the status in the following log file: ${BIN}/swdis/work/AcrobatProfessional^7.0.log, where ${BIN} is the location of the Tivoli bin directory.

Any exit codes listed in the log file are Windows Installer exit codes. For example, 3010 means that a reboot is necessary before the uninstall is complete.

The process is the same for the other products. The log files are as follows:


User Guide

AcrobatStandard^7.0 -> AcrobatStandard^7.0.log

ReaderFull^7.0 -> ReaderFull^7.0.log

AcrobatElements^7.0 -> AcrobatElements^7.0.log

The uninstallation was implemented to support removing the Acrobat 7.0 and Reader 7.0 US English Volume License releases. Other releases might be supported by reviewing and following the additional steps in the section “Software Package Removal Notes.” These steps should be followed prior to installation of Acrobat and Reader via Tivoli.

Removing Adobe Software from the Distribution Database To delete the software packages from Tivoli, remove them from the Tivoli database using the Tivoli Desktop UI.

To remove Acrobat from the database:

1 Delete the software profile from the Adobe Software profile manager. Complete the following:

• In the Profile Manager window, select Acrobat Professional 7.0.

• Choose Edit > Profiles > Delete.

• Repeat for all remaining profiles.

2 Remove all subscribers from the profile manager as follows:

• Choose Profile Manager > Subscribers.

• Move all profiles in the left column to the right column.

• Click Set Subscriptions & Close, and then click Unsubscribe.

3 Close the Adobe Software window.

4 Delete the Adobe Software Profile Manager as follows:

• Open the Adobe region.


User Guide

• Select the Adobe Software profile manager.

• Choose Edit > Delete.

5 Empty the Adobe Subscribers profile manager as follows:

• Right-click the Adobe Subscribers Profile Manager.

• Select subscribers.

• Move subscribers in the left column to the right column.

• Click Set Subscriptions & Close, and then click Unsubscribe. .

6 To delete the Adobe Subscribers profile manager,

• Select the Adobe Subscribers profile manager.

• Choose Edit > Delete, and then click Delete.

• Click Delete.

7 Delete the Adobe region as follows:

• Close the Adobe region, then highlight the icon.

• Choose Edit > Delete, and then click Yes.

Troubleshooting The following section addresses some common problems.

Modifying source and destination directories The Acrobat 7.0 software packages are designed so that files are distributed to c:\windows\temp\Adobe on endpoint systems (this path might vary depending on the setting of the target system temporary directory). The programs to be executed are expected to reside in this directory. If you modify the destination path for the software package, you need to use care in modifying the programs that are invoked by the software package.

Note: Software Package Editor is required. You can perform these steps on an endpoint that the Tivoli Software Package Editor installed.

To modify the source and destination directories:

1 Launch the Software Package Editor.

2 Select Open an Existing Software Package and browse to the location.

3 Change the Files of Type setting to Software Package Definition.

4 Browse to the desired SPD file and select Open.


User Guide

5 Right-click on the Directory object you want to modify.

6 Select Properties.

7 Change the Source and Destination as desired, and click OK.

8 Repeat as needed for the other Directory objects that have a red exclamation.

9 For Acrobat Professional, Standard, and Elements, validate the settings for the Acrobat icons:

• For each Windows shell folder object, double-click on the object to display the links.

• Right-click on each link, and select Properties to validate its settings

10 Select the File menu item.

11 Click Save.

12 Close the Software Package Editor.

13 Import the software package as described in “Importing the SPD Files.”


User Guide

Modifying execution objects If the source and destination directories are modified, you must also modify the execution objects to match the new destination directories. Be careful to place the correct files in the new source directories. Be aware that when you modify a source directory, the corresponding destination directory is also modified. Make sure the destination directory is in the correct location; otherwise, you need to modify the destination before modifying the execution objects. Make sure that the execution object paths match the new destination directories.


To modify an execution object:


2 Select Open an Existing Software Package and browse to the package you want.



5 Right-click on the Execute Program object and select properties.

6 Verify the path and update if necessary.

7 Verify the exit codes and update if necessary.

8 Click Advanced.

9 In the Advanced dialog box, verify the various settings and update if necessary.


User Guide

10 Click OK to exit the Advanced dialog.

11 Select the Remove tab, and validate the settings and advanced settings.

12 Click OK to exit the Execute Program Properties window.

13 Choose File > Save.



Modifying the location of software distribution logs You can also change the directories for the distribution logs.


To modify the distribution log directory:


2 Select Open an Existing Software Package and browse to the package you want.



5 In the left column, right-click the package name and select properties.

6 Choose the Log File tab.


User Guide

7 Modify the paths and settings as needed, and click OK.

8 Choose File > Save.



Distributing previous versions of Acrobat with TivoliRefer to the following resources for more details on working with Acrobat 5, Acrobat 6, and Tivoli:

http://partners.adobe.com/public/developer/acrobat/index_advanced.html

www.adobe.com/support/downloads/detail.jsp?ftpID=1538

www.adobe.com/support/downloads/detail.jsp?ftpID=2349

Known Issues

Known Issue #1179449: Distributing Acrobat products sometimes results in the Desktop and Start Menu shortcuts not being installed correctly on the Tivoli endpoint systems. This is caused when you are distributing your Tivoli package using the System log-in. The result is that shortcuts get incorrectly written to the C:\ root drive. Adobe has made edits to the Adobe-authored SPD file to address this issue. However, these edits do not create a shortcut for the Distiller® application (provided in Acrobat Standard and Professional). The workaround is to write a batch file that creates a Distiller shortcut from acrodist.exe or to manually create a shortcut from acrodist.exe.

Known Issue #1179450: Distributing Acrobat Professional, Acrobat Standard, and Acrobat Elements to Windows XP Tivoli endpoint systems prior to installing Windows XP SP2 can result in the Adobe PDF printer driver failing to be installed. For this reason, the Tivoli software package includes an extra dependency that when deployed to Windows XP, Service Pack 2 must be installed.

Date post:	10-Oct-2020
Category:	Documents
Upload:	others
View:	2 times
Download:	0 times

Adobe Acrobat 7.0 for IBM Tivoli Software Distribution · form:...

Documents