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
ZENworks 10 Personality Migration Reference
ZENworks ® 10 Personality Migration
10.3
March 30, 2010
Personality Migration 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 © 2008-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 Personality Migration Reference
novdocx (en) 16 April 2010

Contents 5
Contents
novdocx (en) 16 April 2010
About This Guide 7
1 What Is Novell ZENworks Personality Migration? 9
1.1 Migrating User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2 Migrating System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3 Migrating Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.4 Migrating Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2 Installing ZENworks Personality Migration 11
2.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2 Installing ZENworks Personality Migration on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.3 Installing ZENworks Personality Migration by Using ZENworks Bundles . . . . . . . . . . . . . . . . 12
2.4 Installing the ZENworks Personality Migration Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.5 Installation Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3 Uninstalling Personality Migration 15
3.1 Uninstalling Personality Migration by Using the ZENworksPersonalityMigration.exe file. . . . . 15
3.2 Uninstalling Personality Migration by Using the Command Line Utility . . . . . . . . . . . . . . . . . . 15
3.3 Uninstalling Personality Migration by Using Windows Add or Remove Programs . . . . . . . . . . 15
4 Manually Migrating Personality Settings 17
4.1 Storing a User’s Personality Settings and Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.1.1 Transferring Data by Using Direct Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.1.2 Transferring Data by Using File Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.2 Applying a User’s Personality Settings and Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5 Automatically Migrating Personality Settings 27
5.1 Creating a Personality Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
5.1.1 Starting the Template Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
5.1.2 Using the Template Builder to Create a Template . . . . . . . . . . . . . . . . . . . . . . . . . . 28
5.2 Modifying an Existing Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.3 Automatically Migrating Personality Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.4 Migrating Personality Settings by Using the Command Prompt. . . . . . . . . . . . . . . . . . . . . . . . 39
5.5 Command Prompt Options to Store and Apply Personalities. . . . . . . . . . . . . . . . . . . . . . . . . . 40
A Best Practices 41
A.1 Storing and Applying Personalities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
A.2 Setting the Length of the Computer Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

6ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010
B Troubleshooting Personality Migration 43
C Migration Settings
45
D Supported Settings in Personality Migration
47
D.1 System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
D.2 Application Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
D.2.1 Adobe Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
D.2.2 Corel Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
D.2.3 IBM Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
D.2.4 Microsoft Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
D.2.5 Palm Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
D.2.6 Qualcomm Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
D.2.7 Research in Motion Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
D.2.8 Sun Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
D.2.9 America Online Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
D.2.10 GAIM Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
D.2.11 Mozilla Foundation Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
D.2.12 OpenOffice.org Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
E Understanding Variables 57
F Cross-User Migration Scenarios 61
F.1 Migration Scenarios If the PNP file has the personalities of all users . . . . . . . . . . . . . . . . . . . 61
F.2 Migration Scenarios If the PNP file has the personality of the currently logged-in user. . . . . . 62
F.3 Migration Scenarios If the PNP File has the Personality of a Specific User. . . . . . . . . . . . . . . 64
F.4 Migration Scenarios If the PNP File has the Personalities of Multiple Specific Users . . . . . . . 65
G Documentation Updates 69
G.1 March 30, 2010: SP3 (10.3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

About This Guide 7
novdocx (en) 16 April 2010
About This Guide
This Novell ZENworks Configuration Personality Migration Reference consists of conceptual
information to help you install and use Novell®ZENworks®Personality Migration.
The sections include:
Chapter 1, “What Is Novell ZENworks Personality Migration?,” on page 9
Chapter 2, “Installing ZENworks Personality Migration,” on page 11
Chapter 4, “Manually Migrating Personality Settings,” on page 17
Chapter 5, “Automatically Migrating Personality Settings,” on page 27
Appendix A, “Best Practices,” on page 41
Appendix B, “Troubleshooting Personality Migration,” on page 43
Appendix C, “Migration Settings,” on page 45
Appendix D, “Supported Settings in Personality Migration,” on page 47
Appendix F, “Cross-User Migration Scenarios,” on page 61
Appendix G, “Documentation Updates,” on page 69
Audience
This guide is intended for network administrators and IT professionals who manage network
resources, and who want to use ZENworks Personality Migration to preserve the applications and
configurations on network workstations when users begin using new hardware.
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 SP3 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.

8ZENworks 10 Personality Migration Reference
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*, should use forward slashes as required by your software.

What Is Novell ZENworks Personality Migration?
1
9
novdocx (en) 16 April 2010
1
What Is Novell ZENworks
Personality Migration?
Novell®ZENworks®Personality Migration is part of the Novell ZENworks Configuration
Management product line.
A personality is a collection of applications and system settings that a user commonly uses on a
device. Typical settings can be desktop wallpaper, e-mail account settings, browser proxy settings,
files and folders, archived e-mails, Microsoft office templates, Microsoft Office macros, etc.
ZENworks Personality Migration provides a way to automate this process, both on a standalone
device or from a centrally managed console. The process significantly reduces the time and effort
required in setting up or reconfiguring a desktop for users. This is particularly useful while
provisioning new desktops and applications.
ZENworks Personality Migration allows you to store the personality of a Windows* user and
migrate the personality to another Windows user. For enterprise-scale migrations, you can use
ZENworks Configuration Management to distribute Directive bundles to store and apply personality
settings to the users.
The Personality Migration utility is provided with ZENworks Configuration Management. For more
information on installing the utility, see Chapter 2, “Installing ZENworks Personality Migration,” on
page 11.
The utility allows you to:
Store the personality of one or more users on a Windows device to a compressed and password-
protected personality file.
Apply the personality settings from a personality file to a Windows desktop.
Directly migrate the personality data from the desktops of one or more users on a Windows
device to the users on another Windows device without any intermediate file, if the two devices
are interconnected.
Review the following sections:
Section 1.1, “Migrating User Accounts,” on page 9
Section 1.2, “Migrating System Settings,” on page 10
Section 1.3, “Migrating Applications,” on page 10
Section 1.4, “Migrating Files and Folders,” on page 10
1.1 Migrating User Accounts
ZENworks Personality Migration allows you to migrate the user profiles for the user who has logged
on to the device, or for multiple users. You can select the local users or domain users whose
personalities you want to migrate. You can also map the users to apply the personalities. You can
apply these personalities to a single user or multiple users.

10 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010
1.2 Migrating System Settings
You can migrate the following system settings:
Accessibility
Appearance
Date and regional Settings
Keyboard, mouse, and other hardware
Network settings
Sounds and multimedia
For a detailed list of the settings, see Appendix D, “Supported Settings in Personality Migration,” on
page 47.
IMPORTANT: You can migrate the network settings only in the File mode. For more information,
see Appendix B, “Troubleshooting Personality Migration,” on page 43
1.3 Migrating Applications
You can migrate the applications of the following companies:
Adobe*
America Online*
Corel*
GAIM
IBM*
Macromedia*
Microsoft*
Mozilla*
OpenOffice.org*
Palm*
Qualcomm*
Research in Motion*
Sun*
For a detailed list of the applications, versions, and settings, see Appendix D, “Supported Settings in
Personality Migration,” on page 47.
1.4 Migrating Files and Folders
You can select to migrate files, file types, or folders. You can also select the location on the
destination device to store these files and folders.