User Document
i User Document Table of Contents Product Name....................................................1 Document Overview............................................. 1 References.......................................................1 Overview of Product............................................. 1 Distribution and Installation Overview............................ 2 Tivoli Requirements........................................ 2 System Requirements...................................... 2 Setting up the Adobe Acrobat binaries............................ 2 Customizing Installation.......................................... 3 Using AEIT.................................................3 Creating an Adobe region........................................ 4 Creating Adobe Software Profile Managers....................... 5 Creating the profile manager............................... 5 Creating the Adobe Subscribers profile manager............ 5 Creating the distribution profiles.................................. 6 Importing the SPD Files........................................... 9 Adding subscribers..............................................11 Verifying installation.............................................12 Distributing and installing the Adobe Acrobat software...........13 Distributing and installing Adobe Acrobat 5.0.5............13 Distributing and installing the Adobe Acrobat 5.0.5 patch..15 Distributing and uninstalling Adobe Acrobat...............16 Removing the binaries....................................17 Removing Adobe Acrobat software from the distribution database.........................18 Troubleshooting................................................19 Modifying source and destination directories..............19 Modifying execution objects..............................21 Modifying the location of software distribution logs........22 Distributing Acrobat 5.x to a system with 4.x already installed.........................23 When Software Package Distribution Fails.................23
1 1. Product Name Package for Adobe Acrobat 5.0.5 Tivoli Software Distribution 2. Document Overview This document covers installing and uninstalling Adobe Acrobat products using Tivoli Software Distribution. It also provides information for troubleshoot problems you may encounter. 3. References Software Distribution 4.1 User s Guide Tivoli Enterprise Installation Guide, Version 3.7 Tivoli Management Framework 3.7.1 User s Guide Tivoli Management Framework for Planning Deployment Guide, Version 3.7.1 Software Distribution 4.1 Release Notes Framework 3.7.1 Release Notes http://www.tivoli.com http://www.adobe.com 4. Overview of Product Adobe Acrobat for Tivoli is a software distribution solution that allows a Tivoli administrator to remotely distribute Adobe Acrobat to Windows platforms in a Tivoli environment. Using Tivoli Framework 3.7.1 and Tivoli Software Distribution 4.1, you can distribute and install the following the following Adobe Acrobat software: Adobe Acrobat 5.0.5 Adobe Acrobat 5.0.5 patch upgrade Uninstall Adobe Acrobat 5.0.5 Note: If your organization has not yet purchased and licensed Adobe Acrobat 5.0.5, you may do so from the Adobe Web site: http://www.adobe.com/store/general/openoptions/main.jhtml. You can distribute Acrobat to computers running the following operating systems: Windows 2000 Windows NT 4.0 Windows XP Windows 98 Target systems must be Tivoli endpoints.
2 5. Distribution and Installation Overview The Adobe Acrobat products are packaged as SPD files. There are several steps to working with the SPD files. The steps are: Setting up the Adobe Acrobat binaries. Customizing Installation. Creating an Adobe Region. Creating Adobe Software Profile Managers. Creating the distribution profiles. Importing the SPD files. Adding subscribers. Distributing and installing the Adobe Acrobat software. Verifying installation. Removing Adobe Acrobat software from the distribution database. 5. 1. Tivoli Requirements Before applying any patches or updates to your TME, it is recommended that you consult with Tivoli to verify the current patch recommendations for your current environments. Framework 3.7.1 patch 32 and patch 33 are needed for distributions to Windows 2000 and XP. 5. 2. System Requirements System Component TMR Requirements Approximately 100 Mbytes for images Endpoints Approximately 275 Mbytes for the installation of Adobe Acrobat 5.0.5 Patch Installation Approximately 50 Mbytes 6. Setting up the Adobe Acrobat binaries You need to create directories on the Tivoli server for the following: \Adobe\Acrobat5 \Adobe\AdobeInstall \Adobe\AdobeUninstall \Adobe\Adobe5.0.5Patch Once the directories are created, move the Acrobat binaries to the directories. The software distribution profiles will look for the files in these locations to copy them to the target machines. If the files do not exist in these locations, then the distribution will fail.
3 To set up the binaries: 1 Place the installation files for Adobe Acrobat 5.0.5 in \Adobe\Acrobat 5. 2 Place the setup.iss, InstallCheck.exe, Acrobat5IsInstall.reg, and abcpy.ini files in the \Adobe\AdobeInstall directory. 3 Put the Uninstall.exe file in \Adobe\AdobeUninstall. 4 Place the binaries for the Acrobat 5.0.5 patch, RebtWin.exe, and RunOnce.reg in \Adobe\Adobe5.0.5Patch. 7. Customizing Installation You need to modify abcpy.ini file in the Adobe install directory so that the installation runs without user interaction. You can modify the file by opening and edit it directly or by running the Acrobat Enterprise Installation Tool (AEIT). To edit the ABCPY.INI file: 1 Locate the abcpy.ini file in the \Adobe\AdobeInstall directory. 2 Save a copy of the file for backup. 3 Set the properties on the abcpy.ini file to Read-Write. 4 Open the file in an ASCII text editor. 5 Enter a User Name, Company Name, and Serial Number. 6 Turn off all of the installer dialogs so that the program runs without user interface. 7. 1. Using AEIT Acrobat Enterprise Installation Tool (AEIT) is designed for administrators who manage or implement software for their users. AEIT customizes the Acrobat Installer, allowing IT professionals greater control over installation in the enterprise environment. With AEIT, you can: Save time and reduce the amount of editing needed to customize the Installer. Take advantage of a more intuitive user interface to customize the Installer. Manage and control the enterprise environment. AEIT is an editing tool that customizes the Adobe Acrobat Installer. This tool specifically edits the ABCPY.INI file, which is referenced by SETUP.EXE during installation. AEIT will work with all Acrobat products version 5.0 or higher that contain an ABCPY.INI file. Some Installer features that can be customized with AEIT include: Adding additional files during installation. Customizing installed shortcuts. Setting default preferences. Sub-launching other applications from the installer. For additional information on AEIT and instructions on how to get the tool, go to the Adobe Web site: http://www.adobe.com/products/acrobat/deployment.html.
4 8. 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 software profiles. 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. 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, as shown in the example below. 7 Choose Properties>Managed Resources.
5 8 In the Set Managed Resources dialog window move Profile Manager and Software Package from the Available Resources (right-hand window) to the Current Resources (left-hand window) by selecting them and using the left arrow control. 9 Click Set and Close. 9. Creating Adobe Software Profile Managers Profile managers contain the information needed to distribute the Adobe Acrobat programs. The profile managers you are creating are: The Profile Manager The Subscribers Profile Manager 9. 1. Creating the profile manager The profile manager holds the distribution profiles for the Adobe Acrobat software. To create the profile manager: 1 In the TME Desktop for Administrator window, open the Adobe region. 2 Choose Create>Profile Manager. 3 Enter Adobe Software for the profile name. 4 Click Create and Close. The Adobe region now contains the Adobe Software profile manager. 9. 2. Creating the Adobe Subscribers profile manager The subscribers profile manager contains all of the systems that will be targeted with the Adobe product. Since both managed nodes and endpoints (target systems) are being targeted, the subscribers profile has to 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.
6 4 To enter endpoints systems into this profile manager, select Dataless Endpoint. (If you are adding other profile managers as subscribers to this profile manager, deselect Dataless Endpoint.) 5 Click Create and Close. The Adobe region now contains the Adobe Subscribers profile. 10. Creating the distribution profiles You are populating the profile manager with distribution profiles for Adobe Acrobat 5.0.5, Adobe Acrobat 5.0.5 patch, and Uninstall Adobe Acrobat 5.0.5 program. These profiles are going to contain the information needed to distribute the Adobe Acrobat software. Once you create the profiles, you are going to import the Adobe SPD files into the respective profiles. Note: Enter the Adobe product names exactly as they appear in the instructions. The period (.) separates the major and minor version numbers and is required by Tivoli. To the Adobe Acrobat 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 Distribution. 4 Enter Adobe Acrobat 5.0.5 for the profile name.
7 5 Click Create and Close. To create Adobe Acrobat Patch 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 Distribution. 4 Enter Adobe Acrobat Patch 5.0.5 for the profile name.
8 5 Click Create and Close. To create the Uninstall Adobe Acrobat 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 Distribution. 4 Enter Uninstall Adobe Acrobat 5.0.5 for the profile name.
9 5 Click Create and Close. 11. Importing the SPD Files When you created the profiles, they started out as empty containers. To activate the profiles, you are going to 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. The tasks for this section are: Import the Adobe Acrobat 5.0.5 patch SPD file. Import the Adobe Acrobat 5.0.5 SPD file. Import the Uninstall Adobe Acrobat 5.0.5 SPD file. Backup the database containing the distribution specifications and Adobe Acrobat files. To import the Adobe Acrobat 5.0.5 patch SPD file: 1 In the Profile Manger window, right click the Adobe Acrobat Patch 5.0.5 profile icon and select Import. 2 In the new window, click 3 Navigate to the Tivoli location containing the adobepatch.spd file. The path is similar to: \Adobe\AdobePatchInstall\adobePatch.spd. 4 Click Import and Close. To import the Adobe Acrobat 5.0.5 SPD file: 1 In the Profile Manger window, right click the Adobe Acrobat 5.0.5 profile icon and select Import. 2 In the new window, click
10 3 Navigate to the Tivoli location containing the Acrobat50.spd file. The path is similar to: \Adobe\AdobePatchInstall\Acrobat50.spd. 4 Click Import and Close. The Adobe Acrobat 5.0.5 profile icon now contains a CD. To import the Uninstall Adobe Acrobat 5.0.5 SPD file: 1 In the Profile Manger window, right click the Uninstall Adobe Acrobat 5.0.5 icon and select Import. 2 In the new window, click 3 Navigate to the Tivoli location containing the UninstallAdobe5.spd file. The path is similar to: \Adobe\AdobePatchInstall\UninstallAdobe5.spd. 4 Click Import and Close.
11 The Uninstall Adobe Acrobat 5.0.5 icon now contains a CD. It 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. 12. Adding subscribers Before you distribute the software, you need to add the subscribers who are receiving the software. To add subscribers: 1 In the Profile Manager window, choose Profile Manager>Subscribers. 2 Move Adobe Subscribers to the left-hand column. 3 Select Add and Close.
12 The Adobe Subscribers icon is added to the Subscribers panel. 13. Verifying installation After deploying Acrobat to the target systems you may want to verify that the installations were successful. The following steps describe how to create and execute a script to execute the Adobe InstallCheck executable supplied with the Acrobat software. To verify installation: 1 Open the Tivoli Desktop. 2 In the Adobe Policy Region select Properties > Managed Resources. 3 Move TaskLibrary to Current Resources. 4 Click Set & Close. 5 Choose Create>TaskLibrary>Acrobat Tasks and open the Acrobat Tasks library.
13 6 Choose Create>Task>Check Acrobat Installs. 7 On a Tivoli server, create the following batch file: @echo off c: cd \tmp\acrobat5 InstallCheck if errorlevel 1 goto not echo Acrobat was deployed successfully goto quit :not echo Acrobat deployment not performed, distributed files removed, or not successfully completed :quit 8 Choose Windows NT as the supported platform supported. 9 Choose host and path to the batch file. 10 Click Set & Close. 11 Choose Windows 95 as the supported platform supported and accept the previous entries. 12 Click Set & Close. 13 Select the roles required to execute task, such as: user. 14 Click Create & Close. 15 Click Execute Task, choose target(s) and select Display on Desktop. If the deployment was successful, the message Acrobat was deployed successfully is displayed. If not, the message Acrobat deployment not performed, distributed files removed, or not successfully completed is displayed. One or more of the following standard error messages may also be displayed if Acrobat was not deployed: The system cannot find the path specified. The name specified is not recognized as an internal or external command, operable program or batch file. Note: This sample script assumes the default target location as provided in the software package definition file. Any modifications to the software package may require modifications to InstallCheckScript.bat. The script also assumes that the distribution is still present on the target desktops at c:\tmp\acrobat5. If the files were removed after distribution, the InstallCheck executable will not be present and cannot be used to validate a successful deployment. Alternatively, a distribution path c:\tmp\acrobat\installcheck.exe may be created before running InstallCheckScript.bat. 14. Distributing and installing the Adobe Acrobat software When you distribute the software to the subscribers, Tivoli distributes the software to the target computers and executes the setup program to install the programs without disturbing the user. 14. 1. Distributing and installing Adobe Acrobat 5.0.5 Tivoli distributes the Adobe Acrobat binaries to the target systems then executes the setup file to install the software.
14 To distribute and install Adobe Acrobat 5.0.5: 1 In the TME Desktop for Administrators window, open the Adobe region. 2 Open the Adobe Software profile manager. 3 Right click the Adobe Acrobat 5.0.5 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-hand window. Expand the Adobe Subscribers profile and individually move the desired computers to the left-hand window. 6 Click Install and Close. After installation is done, users can review installation status in the following logs: Target machine:/tmp/adobesoftwarepackages/installoutput.log Target machine:/tmp/adobesoftwarepackages/installerror.log Target machine:/tmp/adobesoftwarepackages/acrobat^5.0.log Target machine:/tmp/adobesoftwarepackages/swdis.log Tivoli machine:/tmp/adobesoftwarepackages/acrobat^5.0.log Users needs to reboot before running Adobe Acrobat 5.0.5. Users may also want to review the installation status. To view status, open a set of log files. The log files are described in each Acrobat component s installation instructions.
15 14. 2. Distributing and installing the Adobe Acrobat 5.0.5 patch Tivoli distributes the Adobe Acrobat patch binaries, along with a helper executable and a registry file, to the target systems. When the files are on the target systems, Software Distribution places an entry in the RunOnce registry key that runs the patch installation after a reboot/relogin. Next, it runs the helper executable (RebtWin.exe) and reboot the machine. Once rebooted, the target system automatically runs the patch executable interactively to upgrade Adobe Acrobat 5.0.5 to version 5.0.5. User interaction is required to complete the installation. There is no silent installation for the patch. Note: The next user logging into the target machine must have local administrator rights to complete the installation.if the next user that logs in does not have administrative rights, the patch installation will abort and Acrobat will not be upgraded.the administrator directs the target system to run the patch executable at the next login, initiated by causing a reboot. User interaction is required to login as an Administrator and complete the patch. Sufficient warning to the end users may be necessary to complete the upgrade to the satisfaction of users and administrators. To distribute and install Adobe Acrobat 5.0.5 patch: 1 In the TME Desktop for Administrators window, open the Adobe region. 2 Open the Adobe Software profile manager. 3 Right click the Adobe Acrobat Patch 5.0.5 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-hand window. Expand the Adobe Subscribers profile and individually move the desired computers to the left-hand window.
16 6 Click Install and Close. After installation, the following log files can be checked for the status of the distribution: Target machine:/tmp/adobesoftwarepackages/installoutput.log }Target machine:/tmp/adobesoftwarepackages/installerror.log Target machine:/tmp/adobesoftwarepackages/adobeacrobatpatch^5.0.5..log Tivoli machine:/tmp/adobesoftwarepackages/adobeacrobatpatch^5.0.5.log After the distribution of Acrobat 5.0.5 patch and installation are completed successfully, it is recommended that a reboot take place on the target machines. Important Note: After installation of the patch completes, the installation program will ask the user to reboot. It is advisable that you do not reboot the machine at this time. The patch installation is taking place during the boot process of the target machine. You should allow the machine to finish the boot process and then reboot. 14. 3. Distributing and uninstalling Adobe Acrobat Only distribute Uninstall Adobe Acrobat when you intend to uninstall Adobe Acrobat from one or more target systems. Run uninstall only when Acrobat is not in use on the target systems. Notify users when you intend to uninstall Acrobat, giving them time to close the program. If Acrobat is in use, the uninstall will fail. When you distribute the uninstall package, Tivoli distributes a small executable to the target systems. On the target system, the executable invokes the uninstall command for Adobe Acrobat. To uninstall Adobe Acrobat: 1 In the TME Desktop for Administrators window, open the Adobe region. 2 Open the Adobe Software profile manager. 3 Right click the Uninstall Adobe Acrobat 5.0.5 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-hand window.
17 Expand the Adobe Subscribers profile and individually move target systems to the left-hand window. 6 Click Install and Close. After uninstalling, you can check the status of the operation in the following log files: Target machine:/tmp/adobesoftwarepackages/installoutput.log Target machine:/tmp/adobesoftwarepackages/installerror.log Target machine:/tmp/adobesoftwarepackages/uninstalladobe^5.0.log Tivoli machine:/tmp/adobesoftwarepackages/uninstalladobe^5.0.log Reboot the target systems after the uninstall has completed successfully. 14. 4. Removing the binaries When a software package is installed a the target systems, the binaries remain on that system, occupying approximately 100 Mbytes. In the event the software needs to be redistributed, the presence of binaries on a target system causes Tivoli to skip that system. You need to remove the binaries to allow future redistribution. This is not the same as uninstalling Adobe Acrobat from a target machine it is a clean up procedure. Use the Tivoli Remove option to remove the binaries. To remove binaries: 1 In the Profile Manager window, right click on the relevant software package and choose Remove. 2 Keep all defaults.
18 3 You can remove the binaries from all systems or selected systems. Choose one of the following: Move the Adobe Subscribers profile to the left-hand window. Expand the Adobe Subscribers profile and individually move target systems to the left-hand window. 4 Click Remove and Close. 15. Removing Adobe Acrobat software from the distribution database In order to delete the software packages from Tivoli, remove them from the Tivoli database using the Tivoli Desktop UI. To remove Adobe Acrobat from the database: 1 Delete the software profiles from the Adobe Software profile manager. Complete the following: In the Profile Manager window, select Adobe Acrobat Patch 5.0.5. 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 instances in the left-hand column to the right-hand column. Click Set Subscriptions and Close. Click Unsubscribe. 3 Close the Adobe Software window.
19 4 Delete the Adobe Software Profile Manager as follows: Open the Adobe region. 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 all instances in the left-hand column to the right-hand column. Click Set Subscriptions and Close. Click Unsubscribe. 6 Delete the Adobe Subscribers Profile Manager as follows: Select the Adobe Subscribers Profile Manager. Choose Edit>Delete. Click Delete. 7 Delete the Adobe Region as follows: Close the Adobe Region, then highlight the icon. Choose Edit>Delete. Click Yes. 16. Troubleshooting 16. 1. Modifying source and destination directories The Acrobat 5.0.5 software package is designed so that files are distributed to C:\tmp\Acrobat5 on endpoint systems. 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. To modify the source and destination directories do the following: 1 Right click the Adobe region. 2 Select Open. 3 Right click the Adobe Software profile manager. 4 Select Open. 5 Right click on the profile to modify. 6 Select Properties.
20 7 Click Launch Software Package Editor. 8 Right click on the directory to be modified. 9 Select Properties. 10 Change the Source and Destination as desired. 11 Click OK. 12 Select the File menu item. 13 Click Save. 14 Select the File menu item 15 Click Return. 16 Click Yes when prompted.
21 16. 2. Modifying execution objects If the source and destination directories are modified, execution objects must also be modified to match the new destination directories. Be careful to place the correct files in the new source directories. Be aware that when a source directory is modified, it also modifies the corresponding destination directory. 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: 1 In the Adobe Region window, right click the Adobe Region icon and select Open. 2 Right click the Adobe Software Profile Manager and select Open. 3 Right click on the profile to be modified and select Properties. 4 Click Launch Software Package Editor. Note: Tivoli Desktop & Software Package Editor is required. This can be performed on a managed node or an endpoint with the appropriate Tivoli Software Package Editor installed.right click on the object to be modified and select Properties. 5 Verify that the information in the path text box is correct. 6 Click Advanced. 7 In the Advanced dialog, do the following: Verify that the information in the Arguments text box is correct. Verify that the information in the Error file text box is correct.
22 Verify that the information in the Output file text box is correct. 8 Click OK to exit the Advanced dialog. 9 Click OK to exit the Execute Program Properties window. 10 Choose File>Save. 11 Choose File>Return. 12 Click Yes when prompted. 16. 3. Modifying the location of software distribution logs You can also change the directories for the distribution logs. To modify the distribution log directory: 1 Right click Adobe Region and select Open. 2 Right click Adobe Software Profile Manager and select Open. 3 Right click on the profile to modify and select Properties. 4 Click Launch Software Package Editor. 5 In the left-hand window, right click the package name and select properties.
23 6 Choose the Log File tab. 7 Modify all paths as desired. 8 Click OK. 9 Choose File>Save. 10 Choose File>Return. 11 Click Yes when prompted. 16. 4. Distributing Acrobat 5.x to a system with 4.x already installed Remove Acrobat 4.x from all platforms (Windows 9x, NT, 2000, XP) before distributing 5.0.5. If 5.0.5 is distributed to a system that already has 4.x, you will have a system with both versions of Acrobat. It is strongly advised that you manually remove 4.x, reboot the machine, and then distribute Acrobat 5.0.5. For information about manually removing Acrobat 4.x, see http://www.adobe.com/support/techdocs/1e9d6.htm. 16. 5. When Software Package Distribution Fails If a distribution fails for a software package profile, delete and recreate the profile. Distribute the new profile.