Novell ZENWORKS 10 ASSET MANAGEMENT SP3 - MIGRATION GUIDE 10.3... User manual

Novell®
www.novell.com
novdocx (en) 7 January 2010
AUTHORIZED DOCUMENTATION
Novell ZENworks 10 Asset Management Migration Guide
ZENworks ® 10 Asset Management SP3
10.3
March 23, 2010
Migration Guide

novdocx (en) 7 January 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., 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).

novdocx (en) 7 January 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 Asset Management Migration Guide
novdocx (en) 7 January 2010

Contents 5
Contents
novdocx (en) 7 January 2010
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
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

6Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
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

About This Guide 7
novdocx (en) 7 January 2010
About This Guide
This Novell ZENworks 10 Asset Management Migration Guide includes information to help you
successfully migrate selected inventory and asset management data from ZENworks®Asset
Management 7.5 to an installed Novell®ZENworks 10 Asset Management system
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 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 (®, 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.

8Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010

Using the Migration Utility
1
9
novdocx (en) 7 January 2010
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:
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.

10 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
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
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.

Using the Migration Utility 11
novdocx (en) 7 January 2010
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
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.

12 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
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:
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.

Using the Migration Utility 13
novdocx (en) 7 January 2010
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
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:
1In your Web browser, access the following URL:
http:// zenworks_primary_server_id /zenworks-setup
2Click Administrative Tools and download ZAMMigration.exe to a temporary location.
3Run
ZAMmigration.exe to install it on your workstation.
4To 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:
1In ZENworks Control Center, click Configuration.
2In the Configuration Tasks list, click Download ZENworks Tools.
3Click Administrative Tools.
4Click ZAMmigration.exe to save it to your hard drive.
5Run
ZAMmigration.exe to install it on your workstation.
6To run the utility on a supported Windows device, click Start > All Programs > Novell
ZENworks > ZENworks Asset Management Migration Utility.

14 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
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:
1Click Start > All Programs > Novell ZENworks > ZENworks Asset Management Migration
Utility.
2Click the button to the right of the Select ZAM Database field. For Microsoft SQL migration,
you see the following screen:

Using the Migration Utility 15
novdocx (en) 7 January 2010
For Oracle migration, you see the following screen:
3Fill 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.

16 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
Database: Specify the database name. Each time you use this dialog box, the last database you
logged in to is displayed here.
Service Name: For Oracle migration, specify the service name. Each time you use this dialog
box, the last service you logged in to is displayed here.
User Name: Specify the username. Each time you use this dialog box, the last username you
used is displayed here.
Password: Specify the password. This must be specified every time to authenticate.
4Click OK to connect. You can click Test C onnectio n first to verify that you can connect to the
database.
5Continue with Section 1.5, “Selecting the Migration Destination,” on page 16.
1.5 Selecting the Migration Destination
To log in to your migration source Management Zone for ZENworks 10 Asset Management:
1Make sure you’ve selected the migration source (see Section 1.4, “Selecting the Migration
Source,” on page 14).
2In the Migration Console, click the button to the right of the Select Zone field.
If you have previously selected a destination zone, such as for a pilot migration, a dialog box
appears asking if you want to clear the migration status data stored in the ZENworks Asset
Management 7.5 source database. This 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.
3Fill in the following fields to authenticate to your destination Management Zone:

Using the Migration Utility 17
novdocx (en) 7 January 2010
Zone: Specify your Management Zone. This field is not filled in the first time you access the
Zone Login dialog box. Thereafter, any zone that you previously logged in to by using this
dialog box is available from the drop-down list. Each time you use this dialog box, the last zone
that you logged in to is displayed here.
User Name: Specify the username for the zone. Administrator is normally used. If this is the
first time you have logged in to this zone by using the Migration Console, nothing is displayed;
otherwise, the last username you used is displayed. If you select a Management Zone in the
Zone field, this field is automatically populated with the username you last used for that zone.
Password: Specify the password. This must be entered every time to authenticate.
Primary Server: Specify either its DNS name or IP address. This field is automatically
populated when you select a Management Zone in the Zone field.
Port: The standard port for the ZENworks Primary Server is 443. If the server is using a
different port, specify that port number.
4Click OK.
The Select Objects To Migrate tab shows the object groups available to migrate, along with the
number of objects in each group.
5Continue with Section 1.6, “Migrating Objects,” on page 17.
1.6 Migrating Objects
For details on migrating objects in each group, see the topics below. Although the steps to migrate
different types of objects are presented separately, it isn’t necessary to migrate one type of object at
a time. You can migrate all data at once or choose what data to migrate. When you migrate inventory
data, the administrator-defined fields, local product definitions, and custom report definitions are
migrated by default.
When selecting objects to migrate, keep the following in mind:
You can only migrate objects once.
You need to migrate inventory data before asset management data.
Inventory data and asset management data must be migrated using the same version of the
migration utility.
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.
To migrate the definitions only, see the related topics below:
Section 1.6.1, “Migrating Inventory Data,” on page 18
Section 1.6.2, “Migrating Administrator-Defined Field Definitions,” on page 20
Section 1.6.3, “Migrating Local Product Definitions,” on page 20
Section 1.6.4, “Migrating Asset Management Data,” on page 21
Section 1.6.5, “Migrating Asset Management Data Only,” on page 22
Section 1.6.6, “Migrating License Records,” on page 24

18 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
Section 1.6.7, “Migrating Custom Reports,” on page 25
Section 1.6.8, “Migration Performance Guidelines,” on page 27
For details about the Migration Console, see Chapter 2, “Migration Console Reference,” on page 29.
1.6.1 Migrating Inventory Data
When you migrate inventory data, by default you migrate the following:
Devices (including workstations marked as deleted, if desired. For more information, see
Section 1.6.1, “Migrating Inventory Data,” on page 18.)
Device history
Local software products
Hardware/software components
Asset management usage data
Inventory and asset management administrator-defined fields (known as user-defined fields in
ZENworks Asset Management 7.5)
Inventory and asset management custom reports
NOTE: The Migrate All Inventory Data option is not available for Oracle database migration.
Staging a Migration
You can do a staged migration by selecting a subset of workstations to migrate. Usage and inventory
data is migrated when the workstation is migrated; additional usage and inventory data
accumulating in ZENworks Asset Management 7.5 after initial migration of a workstation is not
migrated.
NOTE: Do not migrate asset management data until all staging is complete.
Migrating Deleted Workstations
You can migrate workstations marked as deleted in ZENworks Asset Management 7.5 to ZENworks
10 Asset Management. After migration, these workstations appear as discovered devices in
ZENworks Control Center (Devices > Discovered > Devices created via ZENworks Asset
Management Migration), but they are filtered out of Asset Management reports. For information on
migrating deleted workstations, see Step 5 on page 19.
Migrating Inventory Data
1Click Start > All Programs > Novell ZENworks > ZENworks Asset Management Migration
Utility.
2Log in to your ZENworks Asset Management 7.5 database and the ZENworks 10 Management
Zone as shown in Section 1.4, “Selecting the Migration Source,” on page 14 and Section 1.5,
“Selecting the Migration Destination,” on page 16.
3Click the Select Objects To Migrate tab.

Using the Migration Utility 19
novdocx (en) 7 January 2010
4Click Inventory and select the desired collection domain and collection server.
A list of workstations is shown on the right.
5Select the data to migrate.
To select all workstations, right-click Inventory and select Migrate All Inventory Data.
(The Migrate All Inventory Data option is not available for Oracle migration.)
To select individual workstations, right-click a workstation listed on the right side of the
panel and select Add Item(s) To Migration Queue. You can Shift+click or Ctrl+click to
select more than one item.
NOTE: To migrate workstations marked as deleted, click Tools > Options and select
Migrate Deleted Workstations.
6(Optional) To remove workstations from the migration list, click the Items to Migrate tab, then
right-click the workstation and select Remove Item(s) from Migration Queue.
7Click Start Migration.
The Migration Status tab opens and displays the migration details. Migrated workstations
appear as discovered devices in ZENworks Control Center (Devices > Discovered > Devices
created via ZENworks Asset Management Migration).
If you receive any of the following messages, see Section A.2, “ZAM Migration Utility
Messages,” on page 38:
There are no ZENworks 7 Desktop Management GUIDs in the inventory data.
There are devices in your ZENworks Asset Management inventory data that are already
present in the ZENworks Configuration Management target database.
This ZENworks Asset Management device will not be migrated because it is already
present in the ZENworks Configuration Management target database.

20 Novell ZENworks 10 Asset Management Migration Guide
novdocx (en) 7 January 2010
1.6.2 Migrating Administrator-Defined Field Definitions
Asset management and inventory administrator-defined field definitions are migrated automatically
the first time an inventory migration is run. (Asset management administrator-defined fields are
known as user-defined fields in ZENworks Asset Management 7.5.) If you want to migrate just the
administrator-defined fields and not the inventory data, do the following:
1Click Start > All Programs > Novell ZENworks > ZENworks Asset Management Migration
Utility.
2Log in to your ZENworks Asset Management 7.5 database and the ZENworks 10 Management
Zone as shown in Section 1.4, “Selecting the Migration Source,” on page 14 and Section 1.5,
“Selecting the Migration Destination,” on page 16.
3Click Tools > Options to open the Options window.
4Select Migrate Definitions Only.
5Select ADF Definitions.
6Click OK.
7Right-click User Defined Fields and select Migrate All User Defined Fields.
The number of user-defined fields is displayed in the Items To Migrate tab. To remove the user-
defined fields from the list, click the Items To Migrate tab, right-click All User Defined Fields,
and select Remove ‘All User Defined Fields’ from migration queue. User-defined fields cannot
be migrated individually.
8Click Start Migration.
The Migration Status tab opens and displays the migration details. Click Cancel to stop the
process.
1.6.3 Migrating Local Product Definitions
Local product definitions are migrated automatically the first time an inventory migration is run. If
you want to migrate just the local product definitions and not the inventory data, do the following:
1Click Start > All Programs > Novell ZENworks > ZENworks Asset Management Migration
Utility.
2Log in to your ZENworks Asset Management 7.5 database and the ZENworks 10 Management
Zone shown in Section 1.4, “Selecting the Migration Source,” on page 14 and Section 1.5,
“Selecting the Migration Destination,” on page 16.