Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3... Quick reference guide

Novell®
www.novell.com
novdocx (en) 16 April 2010
AUTHORIZED DOCUMENTATION
ZENworks 10 Configuration Management Discovery, Deployment, and Retirement Reference
ZENworks ® 10 Configuration Management SP3
10.3
March 30, 2010
Discovery, Deployment, and Retirement Reference

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.

4ZENworks 10 Configuration Management Discovery, Deployment, and Retirement Reference
novdocx (en) 16 April 2010

Contents 5
Contents
novdocx (en) 16 April 2010
About This Guide 9
Part I Device Discovery 11
1 Basic Concepts 13
1.1 Discovery Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2 IP and LDAP Discovery Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.3 IP Discovery Technologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4 LDAP Discovery Technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.5 Advertised Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.6 Discovered Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.7 Deployable Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2 Discovering Devices By Using IP Addresses 23
2.1 Configuring Discovery Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.2 Designating a Discovery and Deployment Proxy Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.3 Creating an IP Discovery Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3 Discovering Devices in LDAP Directories 35
4 Importing Devices from CSV Files 41
5 Advertised Discovery 43
5.1 Configuring the Advertised Discovery Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2 Discovering Advertised Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6 Viewing or Updating Device Details 47
Part II ZENworks Adaptive Agent Deployment 49
7 Basic Concepts 51
7.1 Deployment Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.2 Deployment Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.3 Adaptive Agent Versus Inventory-Only Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
8 Managing Deployment Packages 55
8.1 Package Types and Architectures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
8.2 Default System Packages Versus Custom Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
8.3 Customizing Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
8.4 Rebuilding Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
8.4.1 Rebuilding the Default Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6ZENworks 10 Configuration Management Discovery, Deployment, and Retirement Reference
novdocx (en) 16 April 2010
8.4.2 Rebuilding the Custom Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
9 Registering Devices 61
9.1 What Happens During Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
9.2 Creating Registration Keys and Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
9.2.1 Creating a Registration Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
9.2.2 Creating a Registration Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
9.3 Modifying the Device Naming Template Used During Registration . . . . . . . . . . . . . . . . . . . . . 69
9.4 Enabling Dynamic Renaming of Devices During Registration . . . . . . . . . . . . . . . . . . . . . . . . . 70
9.4.1 Enabling the Setting at the Management Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
9.4.2 Enabling the Setting for a Device Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
9.5 Disabling the Use of Registration Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
9.6 Manually Registering a Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9.6.1 Performing an Initial Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9.6.2 Reregistering a Device with an Additional Registration Key . . . . . . . . . . . . . . . . . . . 74
9.7 Unregistering a Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
10 Deploying the ZENworks Adaptive Agent 77
10.1 Coexisting with the ZENworks Desktop Management Agent . . . . . . . . . . . . . . . . . . . . . . . . . 77
10.2 Customizing the Agent Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
10.2.1 Customizing Features before Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
10.2.2 Customizing Features after Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
10.3 Changing the Target Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
10.4 Using a Task to Deploy the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
10.4.1 Prerequisites for Deploying to a Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
10.4.2 Deploying to a Discovered Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
10.4.3 Deploying to a Non-Discovered Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
10.5 Manually Deploying the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
10.6 Tasks to be Performed After Deploying the Agent on Citrix Servers . . . . . . . . . . . . . . . . . . . . 97
10.7 Uninstalling the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
11 Deploying the ZENworks Adaptive Agent to Linux Devices 99
12 Deploying the Inventory-Only Module 101
12.1 Downloading the Module from a ZENworks Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
12.2 Installing on Linux/UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
12.3 Installing on NetWare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.4 Installing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.5 Installing on Macintosh OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Contents 7
novdocx (en) 16 April 2010
Part III Device Removal and Retirement 107
13 Deleting Devices from Your ZENworks System 109
14 Retiring or Unretiring Devices 111
Part IV Appendixes 115
A Viewing the Predefined Reports 117
B Schedules 119
B.1 Now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.2 No Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.3 Date Specific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.3.1 Start Dates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.3.2 Run Event Every Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.3.3 Select When Schedule Execution Should Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
B.3.4 Use Coordinated Universal Time (UTC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
B.4 Recurring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
B.4.1 Days of the Week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
B.4.2 Monthly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
B.4.3 Fixed Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
C Configuring NMAP for ZENworks 123
D Troubleshooting Discovery, Deployment, and Retirement 125
E Documentation Updates 131
E.1 March 30, 2010: SP3 (10.3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

8ZENworks 10 Configuration Management Discovery, Deployment, and Retirement Reference
novdocx (en) 16 April 2010

About This Guide 9
novdocx (en) 16 April 2010
About This Guide
This Novell ZENworks 10 Configuration Management Discovery, Deployment, and Retirement
Reference helps you add devices to your ZENworks®Management Zone and then install the
ZENworks Adaptive Agent or Inventory Only Module to the devices. It also helps you install the
ZENworks Adaptive Agent to a Linux device in order to make the device a ZENworks Satellite.
The information in this guide is organized as follows:
Part I, “Device Discovery,” on page 11
Part II, “ZENworks Adaptive Agent Deployment,” on page 49
Part III, “Device Removal and Retirement,” on page 107
Part IV, “Appendixes,” on page 115
Audience
This guide is intended for anyone who will configure and manage a ZENworks system.
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 the 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/index.html).
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.
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*, should use forward slashes as required by your software.

10 ZENworks 10 Configuration Management Discovery, Deployment, and Retirement Reference
novdocx (en) 16 April 2010