Novell ZENWORKS LINUX MANAGEMENT 7.2 IR2 - ... User manual

Novell®
www.novell.com
novdocx (en) 11 July 2008
AUTHORIZED DOCUMENTATION
Novell ZENworks 7.2 Linux Management Troubleshooting Guide
ZENworks ® Linux Management
7.2 IR2
August 22, 2008
Troubleshooting guide

novdocx (en) 11 July 2008
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-2008 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. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed on the Novell Legal Patents Web page (http://www.novell.com/company/legal/patents/) and one or
more additional patents or pending patent applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get
updates, see the Novell Documentation Web page (http://www.novell.com/documentation).

novdocx (en) 11 July 2008
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.

novdocx (en) 11 July 2008

Contents 5
Contents
novdocx (en) 11 July 2008
About This Guide 7
Part I Installation, Upgrade, and ZENworks Database 9
1 Installation and Upgrade Troubleshooting Strategies 11
1.1 Troubleshooting the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2 Troubleshooting the Upgrade Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Part II Policy Handlers 15
2 Policy Handlers Error Messages 17
2.1 General Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.2 Remote Execute Policy Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3 Policy Handlers Troubleshooting Strategies 25
3.1 General Troubleshooting Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.2 Troubleshooting the Epiphany Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.3 Troubleshooting the Generic GNOME Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.4 Troubleshooting the Remote Execute Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5 Troubleshooting the Text File Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Part III Event Monitoring 33
4 Event Monitoring Troubleshooting Strategies 35
4.1 Troubleshooting Event Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Part IV Inventory 37
5 Inventory Roll-Up Error Messages 39
6 Inventory Troubleshooting Strategies 43
6.1 Troubleshooting Inventory Roll-Up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.2 Troubleshooting Hardware Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Part V Disaster Recovery 47
7 Disaster Recovery 49
7.1 Safeguarding Your System through Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.1.1 The Data Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.1.2 The Object Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6Novell ZENworks 7.2 Linux Management Troubleshooting Guide
novdocx (en) 11 July 2008
7.1.3 The Package Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.1.4 The zlmmirror Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.2 Safeguarding Your System through Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.2.1 Data Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.2.2 Object Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.2.3 Package Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.2.4 Message Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.3 Restoring Your System after a Primary Server Failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.3.1 Converting a Secondary Server to a Primary Server. . . . . . . . . . . . . . . . . . . . . . . . . 52
7.4 Moving Devices to the New Primary Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
8 Disaster Recovery Error Messages 55
Part VI Remote Management 57
9 Remote Management Error Messages 59
10 Remote Management Troubleshooting Strategies 63
Part VII Dell DTK 67
11 Dell Configuration Bundle Troubleshooting Strategies 69
Part VIII Package and Content Management 71
12 Package and Content Management Error Messages 73
13 Package and Content Management Troubleshooting Strategies 75
Part IX Preboot Services 79
14 Preboot Services Troubleshooting Strategies 81
A Documentation Updates 83
A.1 August 22, 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
A.2 May 19, 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
A.2.1 Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
A.2.2 Package and Content Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
A.3 August 23, 2007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
A.3.1 Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
A.4 May 21, 2007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
A.4.1 Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

About This Guide 7
novdocx (en) 11 July 2008
About This Guide
This guide includes troubleshooting strategies that you can use and error messages that might be
displayed for problems that could occur as you use Novell®ZENworks®7.2 Linux Management in
your production environment.
As administrators gain experience using Linux Management, some unusual or previously untested
implementation scenarios and undocumented product limitations might surface. We will gather this
feedback from Novell customers and add it to this guide as it becomes practical to do so.
The guide is intended for network administrators and is divided into the following sections:
Part I, “Installation, Upgrade, and ZENworks Database,” on page 9
Part II, “Policy Handlers,” on page 15
Part III, “Event Monitoring,” on page 33
Part IV, “Inventory,” on page 37
Part V, “Disaster Recovery,” on page 47
Part VI, “Remote Management,” on page 57
Part VII, “Dell DTK,” on page 67
Part VIII, “Package and Content Management,” on page 71
Appendix A, “Documentation Updates,” on page 83
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* or UNIX*, should use forward slashes as required by your software.
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
For the latest documentation on installing or upgrading to ZENworks 7.2 Linux Management, see
the Novell ZENworks 7.2 Linux Management Installation Guide.
For the latest documentation on configuring and managing ZENworks 7 Linux Management, see the
Novell ZENworks 7.2 Linux Management Administration Guide.

8Novell ZENworks 7.2 Linux Management Troubleshooting Guide
novdocx (en) 11 July 2008

Installation, Upgrade, and ZENworks Database
I
9
novdocx (en) 11 July 2008
I
Installation, Upgrade, and
ZENworks Database
The following section provides solutions to problems you might encounter when installing the
Novell®ZENworks®7.2 Linux Management, or working with the ZENworks Database:
Chapter 1, “Installation and Upgrade Troubleshooting Strategies,” on page 11

10 Novell ZENworks 7.2 Linux Management Troubleshooting Guide
novdocx (en) 11 July 2008