Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3... Technical manual

Novell®
www.novell.com
novdocx (en) 16 April 2010
AUTHORIZED DOCUMENTATION
Novell ZENworks 10 Configuration Management Adaptive Agent Guide
ZENworks 10 Configuration Management SP3
10.3
March 30, 2010
ZENworks Adaptive Agent Guide

novdocx (en) 16 April 2010
Legal Notices
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc.
reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to
notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export or import deliverables. You agree not to export or re-export to entities on
the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws.
You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See the
Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
Copyright © 2007-2010 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied,
stored on a retrieval system, or transmitted without the express written consent of the publisher.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the latest online documentation for this and other Novell products, see the Novell
Documentation Web page (http://www.novell.com/documentation).

novdocx (en) 16 April 2010
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/
trademarks/tmlist.html).
Third-Party Materials
All third-party trademarks are the property of their respective owners.

4Novell ZENworks 10 Configuration Management Adaptive Agent Guide
novdocx (en) 16 April 2010

Contents 5
Contents
novdocx (en) 16 April 2010
About This Guide 7
1Overview 9
2 Status 11
2.1 Viewing the Agent’s Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2 Registering with a Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3 Policies 13
3.1 User-Assigned Versus Device-Assigned Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.2 Viewing Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4 Bundles 15
4.1 Bundles Versus Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.2 User-Assigned Versus Device-Assigned Bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.3 Accessing Bundles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.1 ZENworks Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.2 ZENworks Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.3 ZENworks Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.4 Understanding Bundle Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.5 Launching a Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.6 Postponing a Bundle Download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7 Verifying a Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.8 Viewing a Bundle’s Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.9 Uninstalling a Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5Inventory 23
5.1 What Is Inventory Information Used For? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.2 Scanning the Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.3 Viewing Inventory Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.4 Completing a Collection Data Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6 Remote Management 25
6.1 Remote Management Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.2 Requesting a Remote Management Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.3 Viewing Currently Connected Remote Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.4 Viewing the Remote Management Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.5 Using the Security Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7 Logging 29
7.1 Changing the Message Log Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7.2 Clearing the Message Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6Novell ZENworks 10 Configuration Management Adaptive Agent Guide
novdocx (en) 16 April 2010
7.3 Viewing the Message Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.4 Accessing the Backup Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8 Satellite Roles 31
8.1 General Satellite Role Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.2 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.3 Imaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.4 Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
8.5 Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.5.1 Viewing Distribution Point Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.5.2 Exporting the Recent Access History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
8.5.3 Clearing the Recent Access History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9WindowsProxy 37
9.1 Viewing the Discovery Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.2 Viewing the Deployment Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
10 ZENworks Terminology 39

About This Guide 7
novdocx (en) 16 April 2010
About This Guide
This guide provides information about the Novell®ZENworks®Adaptive Agent, a component of
Novell ZENworks 10 Configuration Management SP3. For additional information about ZENworks
and other Novell products, visit www.novell.com (http://www.novell.com/products/zenworks).
The information in this guide is organized as follows:
Chapter 1, “Overview,” on page 9
Chapter 2, “Status,” on page 11
Chapter 3, “Policies,” on page 13
Chapter 4, “Bundles,” on page 15
Chapter 5, “Inventory,” on page 23
Chapter 6, “Remote Management,” on page 25
Chapter 7, “Logging,” on page 29
Chapter 8, “Satellite Roles,” on page 31
Chapter 9, “Windows Proxy,” on page 37
Chapter 10, “ZENworks Terminology,” on page 39
Audience
This guide is intended for ZENworks 10 Configuration Management end users (those with the
ZENworks Adaptive Agent on their devices).
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to Novell Documentation Feedback site (http://www.novell.com/
documentation/feedback.html) and enter your comments there.
Additional Documentation
ZENworks 10 Configuration Management is supported by other documentation (in both PDF and
HTML formats) that you can use to learn about and implement the product. For additional
documentation, see the ZENworks 10 Configuration Management documentation (http://
www.novell.com/documentation/zcm10/).
Documentation Conventions
In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and
items in a cross-reference path.
A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party
trademark.

8Novell ZENworks 10 Configuration Management Adaptive Agent Guide
novdocx (en) 16 April 2010
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux or UNIX, should use forward slashes as required by your software.

Overview
1
9
novdocx (en) 16 April 2010
1
Overview
The ZENworks®Adaptive Agent is a part of the Novell®ZENworks 10 Configuration Management
software that lets your administrator manage devices over the network. The ZENworks Adaptive
Agent, commonly referred to as the Adaptive Agent, provides services that help the administrator do
the following without visiting your device:
Manage policies that determine the behavior of your device.
Deliver software, patches, and other files to your device.
Take inventory of your device’s hardware and software.
Access your device from a remote location to troubleshoot and fix problems with hardware and
software.
The administrator can also choose to use your device as:
A satellite, which performs certain ZENworks Primary Server roles, to minimize WAN traffic
in your ZENworks system. These roles include Authentication, Collection, Content, and
Imaging.
A Windows Proxy, which performs discovery and deployment tasks that are Windows-based
and cannot be performed by a ZENworks Linux Primary Server.
Each of these services is provided through the use of modules that plug in to the Adaptive Agent.
The default modules included with the Adaptive Agent are the Policies, Bundles, Inventory, Remote
Management, Windows Proxy, and Satellite.
Depending on the services implemented by the administrator, one or more of these modules might
not be active on your device. For example, if your administrator does not intend to remotely access
your workstation, the Remote Management module might not be installed on the device.
Consequently, the Remote Management tab is not displayed in the ZENworks Adaptive Agent page
on the device.
To view which modules are active on your device, see Chapter 2, “Status,” on page 11.

10 Novell ZENworks 10 Configuration Management Adaptive Agent Guide
novdocx (en) 16 April 2010