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.

Installing ZENworks Personality Migration
2
11
novdocx (en) 16 April 2010
2
Installing ZENworks Personality
Migration
You can run Novell®ZENworks®Configuration Management Personality Migration on a Windows
workstation. ZENworks Personality Migration allows you to migrate personality from a Windows
device to another Windows device.
Section 2.1, “System Requirements,” on page 11
Section 2.2, “Installing ZENworks Personality Migration on Windows,” on page 11
Section 2.3, “Installing ZENworks Personality Migration by Using ZENworks Bundles,” on
page 12
Section 2.4, “Installing the ZENworks Personality Migration Core,” on page 12
Section 2.5, “Installation Options,” on page 12
2.1 System Requirements
ZENworks Personality Migration is supported on the following platforms in Microsoft Windows:
Windows 2000 Professional SP4 (only the 32-bit operating system version)
Windows Vista* (both 32-bit and 64-bit operating system versions)
Vista SP1 (both 32- bit and 64-bit operating system versions)
Windows XP Professional SP2 (only the 32-bit operating system version)
Windows XP Professional SP3 (only the 32-bit operating system version)
Windows 7 (both 32-bit and 64-bit operating system versions on Professional, Ultimate, and
Enterprise editions)
To successfully store a personality to a device, the device must have at least double the amount or
greater free disk space than the size of the personality being stored.
For example, to successfully store a personality of 1 GB, the device on which you are storing the
personality must have a free disk space of at least 2*1 GB or greater.
2.2 Installing ZENworks Personality Migration on
Windows
1In your Web browser, access the following URL:
http://zenworks_primary_server_id/zenworks-setup/?pageId=tools.
The zenworks_primary_server_id is the IP address of the ZENworks Primary Server from
where you want to download the Personality Migration utility.
2Download
ZENworksPersonalityMigration.exe to a temporary location.
3Run
ZENworksPersonalityMigration.exe and follow the on-screen prompts to install it on
your workstation.

12 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010
2.3 Installing ZENworks Personality Migration by
Using ZENworks Bundles
1In your Web browser, access the following URL:
http://zenworks_primary_server_id/zenworks-setup/?pageId=tools.
The zenworks_primary_server_id is the IP address of your ZENworks Primary Server from
where you want to download the Personality Migration utility.
2Download
ZenworksPersonalityMigration.exe to a temporary location.
3Create a directive bundle with an Install File(s) action by using the
ZenworksPersonalityMigration.exe file located on the ZENworks server. Specify a
destination folder on the managed device to install this file.
For example, you can specify the destination folder as
C:\Install .
4Add a Launch Executable action in the install set of the bundle that you created. In the General
tab, specify the path where the
ZENworksPersonalityMigration.exe file is located on the
managed device in the Command option.
For example, if the
ZENworksPersonalityMigration.exe file is located in C:\Install on
the managed device, then the path is
C:\Install\ZENworksPersonalityMigration.exe .
5In the Command Line Parameters, enter
/quiet to install Personality Migration without user
intervention.
6Click the Advanced tab, then do the following:
6a Set the Executable security level to Run as secure system user.
6b Set the Wait before proceeding to next action to When action is complete.
7Assign this bundle to the managed device.
2.4 Installing the ZENworks Personality
Migration Core
You can migrate a personality either by using a graphical user interface or by using a command line.
To use the command line option, you need the ZENworks Personality Migration Core. The graphical
user interface option and the Core option are installed automatically when you install ZENworks
Personality Migration, or you can choose to install only the Core option.
You can install the ZENworks Personality Migration Core separately by using the
ZenworksPersonalityMigration.exe /coreonly command. For more information, see
Section 2.5, “Installation Options,” on page 12.
2.5 Installation Options
The following table lists the options that can be used with the
ZenworksPersonalityMigration.exe command:

Installing ZENworks Personality Migration 13
novdocx (en) 16 April 2010
Table 2-1 Installation Options
IMPORTANT: The options listed are case sensitive.
Option Description
/? Displays help and the available options
/passive Displays the progress of installation; does not require user intervention
/quiet Installs Personality Migration silently without the graphical user interface
/uninstall Uninstalls ZENworks Personality Migration
/coreonly Install ZENworks Personality Migration without using the Graphical User Interface
/repair Repairs the installed version of ZENworks Personality Migration

14 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010

Uninstalling Personality Migration
3
15
novdocx (en) 16 April 2010
3
Uninstalling Personality Migration
You can uninstall Personality Migration in any of the following ways:
Section 3.1, “Uninstalling Personality Migration by Using the
ZENworksPersonalityMigration.exe file,” on page 15
Section 3.2, “Uninstalling Personality Migration by Using the Command Line Utility,” on
page 15
Section 3.3, “Uninstalling Personality Migration by Using Windows Add or Remove
Programs,” on page 15
IMPORTANT: Before uninstalling Personality Migration, ensure that you close the Personality
Migration application and the Personality Migration template builder.
3.1 Uninstalling Personality Migration by Using
the ZENworksPersonalityMigration.exe file
1Go to the location where the ZENworksPersonalityMigration.exe file is located and
double-click the file.
2On the Welcome to ZENworks Personality Migration Setup page, click Next.
3Select Remove, then click Next.
3.2 Uninstalling Personality Migration by Using
the Command Line Utility
1At the Windows command prompt, go to the location where the
ZENworksPersonalityMigration.exe file is located.
2Run the
ZENworksPersonalityMigration.exe /uninstall command.
or
To perform a silent uninstallation, run the following command:
ZENworksPersonalityMigration.exe /uninstall /quiet
3.3 Uninstalling Personality Migration by Using
Windows Add or Remove Programs
1On the desktop, click Start > Settings > Control Panel > Add or Remove Programs.
2In the Add or Remove Programs window, select ZENworks Personality Migration, then click
Remove.

16 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010

Manually Migrating Personality Settings
4
17
novdocx (en) 16 April 2010
4
Manually Migrating Personality
Settings
ZENworks®Personality Migration allows you to store a user’s personality and migrate the
personality from a Windows device to another Windows device.
To manually migrate the personality settings, perform the following tasks in the order listed:
Section 4.1, “Storing a User’s Personality Settings and Data,” on page 17
Section 4.2, “Applying a User’s Personality Settings and Data,” on page 22
4.1 Storing a User’s Personality Settings and
Data
1Before beginning the migration process, do the following:
Ensure that the ZENworks Personality Migration is installed on the source device. For
more information, see Section 2.2, “Installing ZENworks Personality Migration on
Windows,” on page 11.
Close the applications whose settings you want to migrate. (You are also prompted to
close any open applications upon launching ZENworks Personality Migration).
If you are migrating system settings and user settings across interconnected devices
without using an intermediate file, you must make sure that the Windows Firewall has
been enabled to treat the Personality Migration software as an exception, so applications
can interact with each other. For more information, see “Enabling ZENworks Personality
Migration through the Windows Firewall” on page 21.
If you want to migrate personality for multiple user accounts on the device, then log in as
a user with administrator privileges.
2Use one of the following methods to launch ZENworks Personality Migration:
Double-click the ZENworks Personality Migration shortcut icon on the desktop.
Click Start > All Programs > Novell ZENworks > ZENworks Personality Migration.

18 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010
3Click Store to store the user account information, system settings, application settings and data
of the source system to a PNP
(Platform Neutral Package) file.
4Click Next to search the source system for the user information and the installed applications
whose settings you can migrate.This can take several minutes.
By default, all the user accounts listed are selected.
5Deselect the user account whose settings you do not want to migrate
6Click Next to deselect the system settings you do not want to migrate.

Manually Migrating Personality Settings 19
novdocx (en) 16 April 2010
7Click Next to deselect the application settings you do not want to migrate.
8Click Next to deselect the files and folders you do not want to migrate.

20 ZENworks 10 Personality Migration Reference
novdocx (en) 16 April 2010
This page also enables you to add files, folders or files of a particular type to the list of
migration files.
9(Optional) Click Add File to add a file to migrate. The added file is listed in the Source
column.
10 (Optional) Click Add Folder to add a folder to migrate. The added folder is listed in the Source
column.
11 (Optional) Click Add File Type to specify the types of files you want to migrate.
12 (Optional) Click Remove Item to remove the highlighted item from the list of items to be
migrated.
13 (Optional) Click Exclude Item to exclude any files and folders you do not want to migrate.
14 Click Next, then select the mode to transfer the settings and data. You can transfer the data
either by Direct mode or File mode.
Direct: Provides real-time migration of settings and data between systems in the same
subnet.
IMPORTANT: Do not migrate network settings in the Direct mode. For more
information, see Appendix B, “Troubleshooting Personality Migration,” on page 43.
Alternatively, you can migrate the network settings in the File mode.
Continue with Section 4.1.1, “Transferring Data by Using Direct Mode,” on page 21.
File: Stores the migration settings and data in a PNP file. Specify the filename or click
Browse to browse to and select the file to store the settings and data.
Continue with Section 4.1.2, “Transferring Data by Using File Mode,” on page 22.