Novell ZENWORKS PATCH MANAGEMENT 6.4 - AGENT User manual

Agent Installation Guide
ZENworks Patch Management Server v6.4

- ii -
02_017N_6.4.2.14
Novell, Inc.
1800 South Novell Place
Provo, UT 84606
Phone: [phone]
www.novell.com
Copyright © 1997-2007 PatchLink® Corporation. ALL RIGHTS RESERVED. U.S. Patent
No. 6,990,660, Other Patents Pending. This manual, as well as the software described in it, is
furnished under license. No part of this manual may be reproduced, stored in a retrieval system, or
transmitted in any form—electronic, mechanical, recording, or otherwise—except as permitted by
such license.
Trademarks:
PatchLink™, PatchLink.com™, securing the enterprise™, WebConsole™, PatchLink
Update™, PatchLink Quarantine™, PatchLink Enterprise Reporting Services™, PatchLink
Scanner Integration Module™, PatchLink Developers Kit™, and their associated logos are
registered trademarks or trademarks of PatchLink® Corporation.
Novell, Novell ZENworks®, Novell ZENworks® Patch Management Server, and Novell Agent
are registered trademarks or trademarks of Novell, Inc.
RSA Secured® is a registered trademark of RSA Security Inc.
Apache is a trademark of the Apache Software Foundation
In addition, other companies' names and products mentioned in this document, if any, may be
either registered trademarks or trademarks of their respective owners.
Feedback:
Your feedback lets us know if we are meeting your documentation needs. E-mail the Novell
Technical Publications department at [email protected] to tell us what you like best,
what you like least, and to report any inaccuracies.
LIMIT OF LIABILITY/DISCLAIMER OF WARRANTY: PATCHLINK® CORPORATION
MAKES NO REPRESENTATIONS OR WARRANTIES IN REGARDS TO THE ACCURACY
OR COMPLETENESS OF THE INFORMATION PROVIDED IN THIS MANUAL.
PATCHLINK® CORPORATION RESERVES THE RIGHT TO MAKE CHANGES TO THE
INFORMATION DESCRIBED IN THIS MANUAL AT ANY TIME WITHOUT NOTICE AND
WITHOUT OBLIGATION TO NOTIFY ANY PERSON OF SUCH CHANGES. THE
INFORMATION PROVIDED IN THE MANUAL IS NOT GUARANTEED OR WARRANTED
TO PRODUCE ANY PARTICULAR RESULT, AND THE ADVICE AND STRATEGIES
CONTAINED MAY NOT BE SUITABLE FOR EVERY ORGANIZATION. NO WARRANTY
MAY BE CREATED OR EXTENDED WITH RESPECT TO THIS MANUAL BY SALES
REPRESENTATIVES OR WRITTEN SALES MATERIALS. PATCHLINK® CORPORATION
SHALL NOT BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER DAMAGES
ARISING FROM THE USE OF THIS MANUAL, INCLUDING BUT NOT LIMITED TO
SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR OTHER DAMAGES

- iii -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
Table of Contents
Table of Contents ___________________________________________ iii
Preface ___________________________________________________ v
About This Guide ...................................................................................................v
Document Conventions ......................................................................................... vi
Chapter 1: Preparing for Agent Installation _______________________ 1
Installation Methods ..............................................................................................1
Supported Operating Systems (ZENworks Patch Management Agent) ...........................2
Supported Languages ............................................................................................2
Requirements .......................................................................................................3
Agent for Windows ............................................................................................3
Agent for Linux, UNIX, Mac, and Netware .............................................................4
Chapter 2: Installing Agents ___________________________________ 5
Downloading the Installer .......................................................................................5
Installing the Single Agent for Windows (32 or 64 bit) ................................................6
Installing the Agent for Windows Vista (32 and 64 bit) ............................................. 12
Installing the Agent for Linux, UNIX, Mac, and Netware ............................................ 18
Chapter 3: Automating the Agent Installation ____________________ 21
Automating the Windows MSI Installer ................................................................... 21
Creating a Network Share ................................................................................ 21
Modifying the MSI File ..................................................................................... 25
Creating an Organizational Unit ........................................................................ 30
Performing a Silent Install from a Command Prompt ................................................ 34
Installing the Windows Agent ........................................................................... 34
Installing the Linux/UNIX/Mac/Netware Agent .................................................... 35
Appendix A: Index __________________________________________ 37

Table of Contents
- iv -

- v -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
Preface
This ZENworks® Patch Management Agent Installation Guide is a resource written for all users of
ZENworks Patch Management. This guide defines the concepts and procedures for installing and
implementing a successful installation of ZENworks Patch Management.
About This Guide
This guide contains the following chapters:
•Chapter 1, “Preparing for Agent Installation”
•Chapter 2, “Installing Agents”
•Chapter 3, “Automating the Agent Installation”
Tip: This document is updated on a regular basis. To acquire the latest version of this
document please refer to the Novell Support Web site (www.novell.com/support)

Preface
- vi -
Document Conventions
The following conventions are used throughout this document to help you identify various
information types:
The icons used throughout this document identify the following types of information:
Table 0.1 Document Conventions
Convention Usage
bold Command names, database names, options, wizard names, window and
screen objects (i.e. Click the
OK button)
italics New terms, variables, and window and page names
UPPERCASE SQL commands and keyboard keys
monospace File names, path names, programs, executables, command syntax, and
property names
Table 0.2 Icons Used
Icon Alert Label Description
Note:
Identifies paragraphs that contain notes or
recommendations.
Tip:
Identifies paragraphs that contain tips, shortcuts, or other
helpful product information.
Warning:
Identifies paragraphs that contain vital instructions,
cautions or critical information.

- 1 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
1Preparing for Agent Installation
Having successfully installed your ZENworks Patch Management Server (Patch Management
Server), you can now proceed to the installation of your ZENworks Patch Management Agents.
Following installation the agent is monitored and maintained by the Patch Management Server
requiring no additional maintenance.
Installation Methods
ZENworks Patch Management Agents can be deployed using any one (or combination) of the
following methods:
Table 1.1 Installation Options
Installation Type Description
Single Agent Windows
MSI Installer
Allows you to run the installer, entering the information as prompted. Also,
you can modify the Microsoft Software Installer (MSI) file, using an MSI
editor, to include your organization’s configuration. The
.msi file can be
delivered by using a login script, Active Directory Group Policy Object (GPO),
or other remote software installation method. The method eliminates the
need to physically visit each target computer.
Single Agent Windows
x64 MSI Installer
Allows you to run the installer, entering the information as prompted. Also,
you can modify the Microsoft Software Installer (MSI) file, using an MSI
editor, to include your organization’s configuration. The
.msi file can be
delivered by using a login script, Active Directory Group Policy Object (GPO),
or other remote software installation method.
Single Agent Installer for
Linux/Unix/Mac/Netware
Allows you to run the installer, entering the information as prompted. You
can also perform a silent installation using
rsh or ssh .
Single Agent Installer for
Windows Vista
Allows you to run the installer, entering the information as prompted. Also,
you can modify the Microsoft Software Installer (MSI) file, using an MSI
editor, to include your organization’s configuration. The
.msi file can be
delivered by using a login script, Active Directory Group Policy Object (GPO),
or other remote software installation method.
Warning: Regardless of the installation method it is vital that, when installing agents,
you enter the same serial number used to install your server. Failure to do so could lock
out the PLUS_AGENT user account disabling ALL agent communication.

Preparing for Agent Installation
- 2 -
Supported Operating Systems (ZENworks Patch Management
Agent)
The following table lists the supported platforms on which the ZENworks Patch Management Agent
6.4 is supported.
Supported Languages
ZENworks Patch Management Agent 6.4 is supported on the following languages:
en-AU: English (Australia)
en-BZ: English (Belize)
Table 1.2ZENworks Patch Management Agent 6.4 Supported Platforms
Operating
System
OS
Versions OS Edition OS Data Width
Processor
Family
Processor
Data
Width
Min.
JRE
Apple Mac OS X 10.2.8 -
10.4.10
All 32/64 bit x86(Intel)/
PowerPC
32/64 bit 1.4.0+
HP-UX 11.00 -
11.23
All 64 bit PA-RISC 64 bit 1.4.0+
IBM AIX 5.1 - 5.3 All 32/64 bit PowerPC 32/64 bit 1.4.0+
Microsoft
Windows 9x
98 Second
Edition
All 32 bit x86 32 bit N/A
Microsoft
Windows NT
4.0 SP6A -
2003 R2
All
(1)
32/64 bit x86 32/64 bit N/A
Microsoft
Windows XP
All Professional
(2)
32/64 bit x86 32/64 bit N/A
Microsoft
Windows Vista
(3)
All All 32/64 bit x86 32/64 bit N/A
Novell Netware 6.5 All 32 bit x86 32 bit 1.3.0+
Novell SUSE
Linux
9 - 10 Enterprise 32/64 bit x86 32/64 bit 1.4.0+
Red Hat Linux 2.1 - 4 Enterprise AS,
ES, WS
32/64 bit x86 32/64 bit 1.4.0+
Sun Solaris 2.6 - 10 All 32/64 bit SPARC/x86 32/64 bit 1.4.0+
(1) Datacenter edition is not supported
(2) Home, Media Center and Tablet PC editions are not supported
(3) Windows Vista support requires .NET 3.0

- 3 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
en-CA: English (Canada)
en-JM: English (Jamaica)
en-NZ: English (New Zealand)
en-ZA: English (South Africa)
en-GB: English (United Kingdom)
en-US: English (United States)
es-ES: Spanish (Spain)
fi-FI: Finnish (Finland)
fr-FR: French (France)
de-DE: German (Germany)
it-IT: Italian (Italy)
ja-JP: Japanese (Japan)
ko-KR: Korean (Korea)
nl-NL: Dutch (Netherlands)
pt-BE: Portuguese (Brazil)
sv-SE: Swedish (Sweden)
zh-CN: Chinese (Simplified)
zh-CHS: Chinese (Simplified)
zh-TW: Chinese (Traditional)
zh-CHT: Chinese (Traditional)
Requirements
The following section lists the hardware and software requirements for the Agent.
Agent for Windows
•Local or Domain Administrator or Administrator equivalent
•500 MHz Processor or higher
•256 MB RAM
Note: You must disable any virus-scanning software prior to the installation of the
Novell ZENworks Patch Management Agent for Windows. Failure to do so may result in
an unsuccessful agent installation.
Warning: The install (and uninstall) must be done by a Administrator or Administrator
equivalent.

Preparing for Agent Installation
- 4 -
•20 MB of free disk space for agent installation
•A single 10 Mbps network connection (with access to the Update Server)
•Sufficient free disk space to download and install patches (varies dependent upon size of patch)
•Windows Installer 2.0 or higher
•Microsoft Internet Explorer 5.01 or higher (Internet Explorer 5.5 or higher if using SSL)
•Network connectivity to your ZENworks Patch Management Server (6.4 or higher)
Agent for Linux, UNIX, Mac, and Netware
•Superuser privileges on the target machine
•2 MB of free disk space for agent installation
•500 MHz or greater processor
•256 MB RAM
•10 Mbps network connection (with access to the Update Server)
•Sufficient free disk space to download and install patches
•Network connectivity to your ZENworks Patch Management Server
•Presence of /tmp directory ( /var/tmp directory on Solaris) for temporary file storage and
processing.
Note: Windows 2000 computers require Service Pack 1
Windows NT 4.0 computers require Service Pack 6a
Warning: The install (and uninstall) must be done by the root user (superuser).
Warning: There must be no whitespaces (such as a space, tab, or newline character) in
the absolute path of the installation directory.

- 5 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
2Installing Agents
The following section includes instructions for installing the ZENworks Patch Management Agent.
In this chapter
“Installing the Single Agent for Windows (32 or 64 bit)”
“Installing the Agent for Windows Vista (32 and 64 bit)”
“Installing the Agent for Linux, UNIX, Mac, and Netware”
Downloading the Installer
The standard agent install requires logging into the Patch Management Server administration
console from the target computer then downloading the installer to that computer.
To Download an Installer
1. Log on to the target computer as the local administrator (or a member of the
LOCAL_ADMINS group).
2. Launch your web browser.
3. Type your ZENworks Patch Management Server URL in your web browser’s Address field.
Press Enter.
4. Type your User Name in the User name field. Press TAB.
5. Type your password in the Password field.
6. Click OK.
The ZENworks Patch Management Server Home screen opens.
7. Select Devices.

Installing Agents
- 6 -
8. Click Install.
The Agent Installers page opens.
9. Select the download link corresponding with the installer you need to start the download.
The Download dialog box opens.
10. Click Save.
The installer downloads to the location you specify on your computer.
11. In the Agent Installers screen, click Close.
The Agent Installers screen closes.
Installing the Single Agent for Windows (32 or 64 bit)
The following steps apply to both the Single Agent Windows MSI Installer and the Single Agent
Windows x64 MSI Installer. To install the agent for Windows Vista, refer to __.
Figure 2.1 Agent Installers

- 7 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
To Install the Agent
1. From the downloaded location, select the updateagent.msi to extract the ZENworks Patch
Management Agent for Windows InstallShield Wizard.
The Agent Install Welcome screen opens.
2. Click Next.
The License Agreement page opens.
Figure 2.2 Agent Install Welcome Screen
Figure 2.3 License Agreement

Installing Agents
- 8 -
3. If you agree to the license terms select the I accept the terms option and click Next
The Destination Folder page opens.
4. To change the location of the Agent:
a. Click Change.
The Change Current Destination Folder window opens.
Figure 2.4 Agent Destination
Figure 2.5 Change Current Destination Folder

- 9 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
b. Change the installation to the location you need.
c. Click OK.
The Change Current Destination Folder closes and the Destination Folder window reflects
the new location.
5. Click Next.
The Agent Registration window opens.
6. Type the appropriate URL in the Update Server URL field including the protocol ( http://
serverAddress
or https://ServerAddress for a secure server).
7. Type your serial number in the ZENworks Patch Management Server Serial Number field.
Figure 2.6 Agent Registration
Note: Use the same serial number that was used for the installation of your ZENworks Patch
Management Server otherwise the agent will be unable to communicate with the server.

Installing Agents
- 10 -
8. If your LAN uses a proxy server:
a. Select Use a Proxy Server.
The Proxy Information window opens.
b. In the Proxy URL field, type the Proxy URL (and Port if required).
c. If you are using an Authenticated Proxy:
i. In the Username field, type the user name.
ii. In the Password field, type a new password for the proxy.
Figure 2.7 Proxy Information
Note: In many LAN environments, although a proxy is used for Internet access, a proxy
bypass is used to for all access within the corporate network. Therefore, only enter proxy
information if your agents will be required to use a proxy to access your ZENworks
Patch Management Server.

- 11 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
9. Click Next.
The Ready to Install the Program page opens.
10. Click Install to install the agent.
The agent is installed and the Installation Complete page displays.
11. Click Finish to exit the wizard.
Figure 2.8 Begin Installation
Figure 2.9 Installation Finish

Installing Agents
- 12 -
Installing the Agent for Windows Vista (32 and 64 bit)
The following steps apply to the Single Agent Windows Vista MSI Installer and the Single Agent
Windows Vista x64 MSI Installer.
1. From the downloaded location, select the ZENworks Patch ManagementAgentForVista.msi
to extract the ZENworks Patch Management Agent for Windows Vista InstallShield Wizard.
The Agent Install Welcome screen opens.
Figure 2.10 Agent Install Welcome Screen

- 13 -
ZENworks Patch Management Server v6.4 - Agent Installation Guide
2. Click Next.
The License Agreement page opens.
3. If you agree to the license terms select the I accept the terms option and click Next.
The Destination Folder page opens.
Figure 2.11 License Agreement
Figure 2.12 Agent Destination

Installing Agents
- 14 -
4. To change the location of the Agent:
a. Click Change.
The Change Current Destination Folder window opens.
b. Change the installation to the location you need.
c. Click OK.
The Change Current Destination Folder closes and the Destination Folder window reflects
the new location.
Figure 2.13 Change Current Destination Folder