Novell ZENWORKS 10 Migration Guide
Migration Guide
Novell®
ZENworks® 10 Asset Management SP3
novdocx (en) 7 January 2010
AUTHORIZED DOCUMENTATION
10.3
March 23, 2010
www.novell.com
Novell ZENworks 10 Asset Management Migration Guide
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.
novdocx (en) 7 January 2010
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., 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 latest online documentation for this and other Novell products, see
the Novell Documentation Web page (http://www.novell.com/documentation).
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) 7 January 2010
novdocx (en) 7 January 2010
4 Novell ZENworks 10 Asset Management Migration Guide
Contents
About This Guide 7
1 Using the Migration Utility 9
1.1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.2 The Migration Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.3 Installing the Migration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4 Selecting the Migration Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.5 Selecting the Migration Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.6 Migrating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.6.1 Migrating Inventory Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.6.2 Migrating Administrator-Defined Field Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.6.3 Migrating Local Product Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.6.4 Migrating Asset Management Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
1.6.5 Migrating Asset Management Data Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1.6.6 Migrating License Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.6.7 Migrating Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.6.8 Migration Performance Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
novdocx (en) 7 January 2010
2 Migration Console Reference 29
2.1 Menu Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.2 Select Objects to Migrate Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.3 Items to Migrate Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.4 Migration Status Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.5 Migration History Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.6 Migrated Objects Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.7 Select ZAM Database Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.8 Select Zone Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2.9 Start Migration Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.10 Cancel Button. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.11 Migration Queue Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.12 Migration Task Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
A Migrating Both ZENworks 7 Desktop Management and ZENworks 7.5 Asset
Management 37
A.1 Migration Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
A.2 ZAM Migration Utility Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
B ZENworks Objects and Their Uniqueness 41
B.1 Duplicate Object Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
B.1.1 Purchase Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.1.2 Catalog Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.1.3 Licensed Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.1.4 Discovered Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Contents 5
B.1.5 Software Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.1.6 Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.1.7 Date Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
B.1.8 Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
C Documentation Updates 45
C.1 March 23, 2010: SP3 (10.3). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
C.2 August 17, 2009: SP2 Update (10.2.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
C.3 April 29, 2009: SP2 (10.2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
C.4 August 6, 2008: SP1 (10.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Glossary 47
novdocx (en) 7 January 2010
6 Novell ZENworks 10 Asset Management Migration Guide
About This Guide
novdocx (en) 7 January 2010
This Novell ZENworks 10 Asset Management Migration Guide includes information to help you
successfully migrate selected inventory and asset management data from ZENworks
Management 7.5 to an installed Novell
The information in this guide is organized as follows:
Chapter 1, “Using the Migration Utility,” on page 9
Chapter 2, “Migration Console Reference,” on page 29
Appendix B, “ZENworks Objects and Their Uniqueness,” on page 41
“Glossary” on page 47
Audience
This guide is intended for ZENworks administrators.
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 Asset Management system
®
Asset
ZENworks 10 Asset Management is supported by other documentation (in both PDF and HTML
formats) that you can use to learn about and implement the product. 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 (
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.
, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party
About This Guide 7
novdocx (en) 7 January 2010
8 Novell ZENworks 10 Asset Management Migration Guide
1
Using the Migration Utility
The following sections provide instructions on how to use the Novell® ZENworks® 10 Asset
Management Migration utility to migrate data from ZENworks Asset Management 7.5:
Section 1.1, “Before You Begin,” on page 9
Section 1.2, “Overview,” on page 10
Section 1.3, “Installing the Migration Utility,” on page 13
Section 1.4, “Selecting the Migration Source,” on page 14
Section 1.5, “Selecting the Migration Destination,” on page 16
Section 1.6, “Migrating Objects,” on page 17
1.1 Before You Begin
Before you begin migrating data from ZENworks Asset Management 7.5 to ZENworks 10 Asset
Management, consider the following:
novdocx (en) 7 January 2010
1
If you also have ZENworks 7 Desktop Management installed on your ZENworks Asset
Management 7.5 workstations, see Appendix A, “Migrating Both ZENworks 7 Desktop
Management and ZENworks 7.5 Asset Management,” on page 37 to ensure that you migrate
the two products in the correct order.
You should back up both source and destination databases.
Turn off the inventory process on ZENworks Asset Management 7.5 before you run the
migration utility.
If you have migrated inventory data with a previous version of the migration utility, you must
use that same version to migrate the asset management data.
The version of the migration utility that you use must match the ZENworks Management Zone
version. The migration utility will not connect to a zone that does not match its version number.
You can only migrate objects once.
Network devices are not migrated.
You need to migrate inventory data before asset management data. If you want to do a staged
migration, do not migrate asset management data until all staging is complete. For more
information about staging, see “Staging a Migration” on page 18.
Not all custom reports are migrated. For a list of custom reports that are not migrated, see
Section 1.6.7, “Migrating Custom Reports,” on page 25.
When migrating to a SQL server, note the following file size recommendations:
The destination data file should be at least 1.1 times the size of the source data file.
The destination log file should be at least 1.2 times the size of the source data file.
Using the Migration Utility
9
If you are migrating data installation that already contains some of the same asset management
data, you might see migration errors or fail in the migration process. See “ZENworks Objects
and Their Uniqueness” on page 41 for more information.
For better migration performance, it is strongly recommended that you purge the ZENworks
Asset Management 7.5 database before you begin. For details, see Section 1.6.8, “Migration
Performance Guidelines,” on page 27.
1.2 Overview
The migration utility is used to migrate inventory data, which is defined by your ZENworks Asset
Management 7.5 collection domains, and asset management data. This data includes the following:
Inventory data
Devices (including deleted devices, if desired. See Section 1.6.1, “Migrating Inventory
Data,” on page 18)
Device history
Local software products
Hardware/software components
novdocx (en) 7 January 2010
Administrator-defined fields (known as user-defined fields in ZENworks Asset
Management 7.5)
Custom reports
Asset management data
Asset management usage data
Asset management custom reports
Asset management administrator-defined fields (known as user-defined fields in
ZENworks Asset Management 7.5)
Catalog products
Discovered products
Purchase records
Licensed products
Software collections
Contracts and date notifications
Documents
Network devices and contract-network relationships are not migrated. Contract-to-network-device
relationships can be reestablished after a network discovery process is run within ZENworks 10
Asset Management.
Inventory data can be migrated by individual device or as a group. Asset management data is
migrated as a group.
10 Novell ZENworks 10 Asset Management Migration Guide
When you migrate inventory data, by default you are also migrating the following:
Local Product Definitions: Local product definitions defined in ZENworks Asset
Management 7.5. These product definitions are migrated as a group; they cannot be migrated
individually. If you want to migrate just the local product definitions without the inventory
data, see “Migrating Local Product Definitions” on page 20.
Administrator-Defined Field Definitions: Asset management and inventory administrator-
defined fields defined in ZENworks Asset Management 7.5. (Administrator-defined fields are
known as user-defined fields ZENworks Asset Management 7.5.) These field definitions are
migrated as a group; they cannot be migrated individually. If you want to migrate just the
administrator-defined field definitions without the inventory data, see “Using the Migration
Utility” on page 9.
Custom Reports: Asset management and inventory custom reports defined in ZENworks
Asset Management 7.5. The reports are migrated as a group. If you want to migrate custom
reports without the inventory data, see “Migrating Custom Reports” on page 25.
Migrating inventory data also migrates the following asset management data:
Usage data
Custom reports
Administrator-defined fields
novdocx (en) 7 January 2010
1.2.1 System Requirements
The migration utility requires the following:
Windows* XP Professional 5.1 SP 2, Windows XP Professional 5.1 SP 3, Windows Vista* SP1
x86, Windows Server* 2003 5.2 SP2, or Windows Server 2008 x86; Windows 2000 and
Windows 2008 are not supported
Network connectivity to source and destination database servers
Migration source: ZENworks Asset Management 7.5
Migration destination: ZENworks 10 Asset Management
Microsoft .NET Framework Version 2.0 Redistributable Package (x86)
(Optional) ZENworks 10 Asset Management. This product is required to view migrated asset
management data.
The following combinations of databases can be used to migrate data:
SQL Server to SQL Server
SQL Server to Sybase
Oracle to Oracle
For migration purposes, the Oracle databases can be Oracle 9.2, Oracle 10.1, or Oracle 10.2. If you
are using an Oracle database, please observe the following:
The Oracle client must be installed on the machine that runs the migration utility. For versions
10.1 and 10.2, this must be Administrator, not InstantClient.
Using the Migration Utility 11
For the Oracle 10.2 client, you must apply patch 5473334 (Doc ID 387818.1). Of the several
data access components included in the patch, Oracle Provider for OLEDB version 10.2.0.2.20
is required.
TNSNAMES.ORA
must contain entries for both the source and destination database services. To
create these entries automatically, log on to the ZENworks Asset Management 7.5 and
ZENworks 10 Asset Management databases using the Oracle Enterprise Manager Console or
Net Configuration Assistant—Local Net Service Name configuration. Note that the names used
for the entries must match the corresponding service name exactly.
The Oracle bin directory (e.g.,
C:\oracle\product\10.2.0\client_1\BIN
) must be in
your PATH setting; however, directories from other Oracle products and installs must not be in
your PATH setting.
The user associated with the schema for the ZENworks Asset Management 7.5 Oracle database
(NCSYSTEM by default) must have the “DBA” role while migration is running (by default,
NCSYSTEM only has the “CONNECT” role).
1.2.2 The Migration Process
Migrating objects (inventory data, custom reports, and so on) consists of six steps:
novdocx (en) 7 January 2010
1. Installing the migration utility. For more information, see Section 1.3, “Installing the Migration
Utility,” on page 13.
2. Backing up both source and destination databases before starting migration and after each
successful staging.
3. Selecting the migration source. For more information, see Section 1.4, “Selecting the Migration
Source,” on page 14.
4. Selecting the migration destination. For more information, see Section 1.5, “Selecting the
Migration Destination,” on page 16.
If you have selected a destination zone previously, for example, for a pilot migration, a dialog
appears asking if you want to clear the migration status data stored in the ZENworks Asset
Management 7.5 source database, which is necessary if you change your migration destination.
Click OK to clear the migration status data.
WARNING: You cannot reselect a migration destination. For example, if you choose a pilot
migration destination, then switch to a production destination, you cannot switch back to the
pilot destination.
5. Selecting objects to migrate.
Administrator-defined field definitions, local product definitions, and custom reports are
migrated by default the first time inventory data is migrated. To migrate them separately, see
Section 1.6, “Migrating Objects,” on page 17. Some custom reports are not migrated because
of database schema changes. For more information, see Section 1.6.7, “Migrating Custom
Reports,” on page 25.
When selecting objects to migrate, keep the following in mind:
Inventory data and asset management data must be migrated using the same version of the
migration utility.
You can only migrate objects once.
12 Novell ZENworks 10 Asset Management Migration Guide
You need to migrate inventory data before asset management data.
Workstations that have not been inventoried are not migrated. In addition, if the
workstation is associated with a contract, the contract-workstation relationship isn’t
migrated, either.
If you want to do a staged migration, select a subset of workstations to migrate. Do not migrate
asset management data until all staging is complete. For more information about staging, see
“Staging a Migration” on page 18.
6. Initiating the migration.
Migration can take several hours to complete, depending on the size of the database being
migrated. During the migration, the migration utility may become unresponsive at times. If
migration is interrupted or canceled, it can be restarted. The migration then continues from the
last migrated record in the migration process. If any errors are listed when the migration
process is run again, you can ignore them. For more information, see Section 1.6, “Migrating
Objects,” on page 17.
1.3 Installing the Migration Utility
novdocx (en) 7 January 2010
There are two ways to install the migration utility: either through a Web browser or through
ZENworks Control Center.
NOTE: Microsoft .NET Framework Version 2.0 Redistributable Package (x86) must be installed
prior to installing the Migration utility.
To use a Web browser to install the utility:
1 In your Web browser, access the following URL:
http://
2 Click Administrative Tools and download
3 Run
4 To run the utility on a supported Windows device, click Start > All Programs > Novell
ZENworks > ZENworks Asset Management Migration Utility.
To use ZENworks Control Center to install the utility:
1 In ZENworks Control Center, click Configuration.
2 In the Configuration Tasks list, click Download ZENworks Tools.
3 Click Administrative Tools.
4 Click ZAMmigration.exe to save it to your hard drive.
5 Run
6 To run the utility on a supported Windows device, click Start > All Programs > Novell
ZENworks > ZENworks Asset Management Migration Utility.
zenworks_primary_server_id
ZAMmigration.exe
ZAMmigration.exe
to install it on your workstation.
to install it on your workstation.
/zenworks-setup
ZAMMigration.exe
to a temporary location.
Using the Migration Utility 13
1.4 Selecting the Migration Source
The migration source is your ZENworks Asset Management 7.5 database. The migration utility
requires that you log in to the migration source with create, modify, and delete privileges. To log in
to your database:
1 Click Start > All Programs > Novell ZENworks > ZENworks Asset Management Migration
Utility.
novdocx (en) 7 January 2010
2 Click the button to the right of the Select ZAM Database field. For Microsoft SQL migration,
you see the following screen:
14 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
For Oracle migration, you see the following screen:
3 Fill in the following fields:
Database Type: Specify the database type. For example, specify MS SQL Server 2000/2005
for both external and embedded MS SQL Server databases. Or specify Oracle 9i/10g for the
latest Oracle database type.
Database Server: Specify either the DNS name or IP address of the database server. Each time
you use this dialog box, the last server you logged in to is displayed here.
Using the Migration Utility 15
Loading...