PlateSpin Migrate 12 Hotfix 1 resolves specific previous issues. This hotfix is a mandatory fix that you must apply on a base installation of PlateSpin Migrate 12. This document outlines why you should install this hotfix.
Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the PlateSpin Migrate forum on NetIQ Communities, our online community that also includes product information, blogs, and links to helpful resources.
The following outline the key features and functions provided by this version, as well as issues resolved in this release:
In PlateSpin Migrate 12, the source workloads and targets that you discover using the PlateSpin Migrate Client do not display in the PlateSpin Migrate Web Interface. PlateSpin Migrate 12 Hotfix1 provides a SyncUI utility that you can use to synchronize them. After the synchronization is complete, you can view the discovered workloads and targets in the Web Interface. By default, this utility is located at ..\PlateSpin Migrate Server\bin\SyncUI.exe.
IMPORTANT:
Before you run this utility, you must ensure that no jobs are in progress.
To minimize disruptions to your migration efforts, run this utility only when you have many discovered resources to synchronize between the Client and the Web Interface.
To synchronize the discovered source workloads and targets, do the following:
On the Migrate Server, change to the location where SyncUI.exe is located.
Run the following command:
SyncUI.exe [/help] | [/verbose] | [/exportPath] | [/clientUIImportExportExe /webUIImportExportExe]
where:
help: Displays help for the SyncUI utility.
verbose: Displays the verbose logging for the SyncUI utility.
exportPath: The full path to the folder to which you export the client discovery data, and from which you import the data to the Web Interface. The default path is appdata%\PlateSpin\SyncUI. However, you can specify a different path.
clientUIImportExportExe: The path to PlateSpin.ImportExport.exe, the Migrate Client Import and Export utility. Specify this option only if you chose a different installation location for the Migrate Server. Otherwise, the command uses the default path C:\Program Files\PlateSpin Migrate Server\bin.
webUIImportExportExe: The path to ImportExport.exe, the Web Interface Import and Export utility. Specify this option only if you chose a different installation location for the Migrate Server. Otherwise, the command uses the default path c:\Program Files\PlateSpin Migrate Server\PlateSpin Forge\bin\ImportExport.
NOTE:If the PlateSpin Migrate Client has discovered Hyper-V containers, these Hyper-V containers are also listed on the Web Interface after successful synchronization. The Web Interface does not support migration of workloads to Hyper-V containers, so you can ignore them. However, If you remove these containers from the Web Interface, they also get removed from the PlateSpin Migrate Client.
PlateSpin Migrate 12 Hotfix 1 enhances the command line interface (CLI) tool to provide an additional command named massdiscover. You can use this massdiscover command to perform mass discovery of source workloads and targets. The discovered workloads and targets are displayed both in the PlateSpin Migrate Client and the PlateSpin Migrate Web Interface. For information about the location of the command line interface tool and how to effectively use this tool, see the Using the PlateSpin Migrate Command Line Interface in the PlateSpin Migrate User Guide on the PlateSpin Migrate 12 Documentation website.
NOTE: Mass discovery of Hyper-V and Image server using massdiscover command is not supported.
To mass discover workloads and targets, you must first list the workloads and targets that you want to discover in a CSV file. To create this CSV file, refer to the sample CSV file located at \PlateSpin Migrate Client\CommandLine\Sample INI\MassDiscovery.csv
To perform mass discovery:
Ensure that you have listed all the workloads and targets you want to discover in the .csv file.
In the command prompt, change to the location where the CLI tool is located and run the following command:
PlateSpin.Migrate.Console.exe massdiscover /file=CSV_file_pathname
replace CSV_file_pathname with the full pathname of the .csv file that you created. For example: C:\Users\username\Desktop\MyMassDiscovery.csv
You can view the status of the discovery jobs in the PlateSpin Migrate Web Interface and the PlateSpin Migrate Client. After a Successful discovery, the discovered workloads and targets are listed both in the PlateSpin Migrate Client and the PlateSpin Migrate Web Interface.
PlateSpin Migrate 12 Hotfix 1 provides a new LRD ISO that lets you rebuild UEFI bootable ISO after you inject additional device drivers into the boot ISO Images. For more information, see Injecting Additional Device Drivers into the Boot ISO Images in the PlateSpin Migrate User Guide on the PlateSpin Migrate 12 Documentation website.
PlateSpin Migrate 12 Hotfix 1 includes software fixes that resolve the following issues.
Issue: In the PlateSpin Client, the PlateSpin Driver Manager tool displays the wrong operating system type for the Windows Server 2012 drivers that you have added to the PlateSpin database.(Bug 948740)
Fix: The PlateSpin Client now displays the correct operating system type for Windows Server 2012 drivers.
Issue: If the source or target container address in the INI file is not a IP address, the command line interface displays an Could not discover machine error. (Bug 946885)
Fix: You can now specify the IP address, hostname, or FQDN name for the source and target container address in the INI file.
Issue: If you use the PlateSpin Driver Manager tool to delete drivers from the database, the PlateSpin Migrate Client might crash. (Bug 945220)
Fix: You can now delete drivers from the database without crashing the client.
If you choose to upgrade to Migrate 12 from a Migrate 11 or 11.1 setup that has one or more custom networks, the upgrade process displays errors and the discovered workloads and containers are not listed on the PlateSpin Migrate Web Interface after the upgrade. (Bug 944190)
Fix: Ignore the errors. PlateSpin Migrate 12 Hotfix 1 provides a SyncUI.exe file that you can run after a successful upgrade to synchronize the discovered source workloads and targets and display them in the PlateSpin Migrate Web Interface. For more information about how to synchronize the source workloads and targets, see Section 1.1, Synchronizing Source Workloads and Targets Discovered Using PlateSpin Migrate Client with PlateSpin Migrate Web Interface.
If you use the command line interface to migrate a source workload that belongs to a domain and you configure the target to join a workgroup, the migration job fails to start. (Bug 943186)
Fix: You can now successfully migrate a source workload belonging to a domain and configure the target to join a workgroup.
If a workload that has already been replicated is rediscovered and you configure the workload for incremental replication on to the same target, the status of the workload on the Workloads page is incorrectly displayed as Not Configured. (Bug 942270)
Fix: The Workloads page now displays the correct status of a workload that is configured for incremental replication.
After you prepare a workload, all the non-editable options such as VM Display Name, VCPU, and Disk Path in the Configure Migration page become editable. If you make any changes to these options and save, you will encounter errors. (Bug 941786)
Fix: The property of the non-editable options in the Configure Migration page no longer changes after you prepare a workload.
If you chose to perform a Test Cutover on a workload with Perform Incremental Replication option selected, it resulted in a Run Cutover. (Bug 940244)
Fix: Performing Test Cutover of a workload with Perform Incremental Replication option selected no longer results in a Run Cutover.
Using the PlateSpin Migrate Web Interface to perform incremental replication resulted in some errors. (Bug 940246)
Fix: You can now use the PlateSpin Migrate Web Interface to perform incremental replication.
For Conversion and Deploy Image jobs, if you edit the .ini file to specify a value for the VirtualNetwork setting, the specified value in not applied and the default value remains applicable. (Bug 942498)
Fix: The value you specify for the VirtualNetwork setting in .ini file is now applicable.
If you use the PlateSpin Migrate Web Interface to configure the migration settings for a workload and specify a value for VM Memory in the Target Workload Settings and the Target Workload Test Setting sections, the specified value is not effective. However, the default source value continues to apply. (Bug 940013)
Fix: The value you specify for VM Memory in the Target Workload Settings and Target Workload Setting sections when configuration the migration settings is now effective.
If you migrate a Linux workload having three or more disks, you might encounter issues with the replication of the disks on the target workloads. (Bug 940242)
Fix: The disks on the Linux workloads are now correctly replicated on the target workload.
When you migrate a Linux workload, the RAM size on the target workload is less when compared to the total RAM size installed on the source. This is because the size of the reserved RAM on the source workload was not included in calculating the total RAM size for the target workload. (Bug 939802)
Fix: On migrating a Linux workload, the target workload has the same size of RAM as on the source workload.
You must apply this hotfix on a base installation of PlateSpin Migrate 12. For information about PlateSpin Migrate 12, see the PlateSpin Migrate 12 Release Notes on the PlateSpin Migrate 12 Documentation website.
You can download the hotfix from PlateSpin Migrate 12 HF1 download site.
To apply the hotfix on a computer that has both PlateSpin Migrate Server and PlateSpin Migrate Client installed:
Before you apply PlateSpin Migrate 12 Hotfix 1, you must plan downtime for the ongoing replications. For a problem-free process, apply the hotfix when all replications are paused and no jobs are running.
Save the PlateSpin Migrate 12 HF1.exe file on your PlateSpin Migrate Server computer.
In the PlateSpin Migrate Web Interface and PlateSpin Migrate Client, pause all replications. Allow incomplete jobs to finish, then ensure that no jobs are running.
(Conditional) If the Platespin Migrate Client is open, close it.
Run the downloaded hotfix executable and follow the instructions in the wizard to install the hotfix.
Resume replications paused in Step 2.
Repeat Step 1 through Step 5 on each PlateSpin Migrate Server computer.
To apply the hotfix on a computer that has only the PlateSpin Migrate Client installed:
Save the PackageInstall_RemoteClient_ClientOnly.zip file on your PlateSpin Migrate Client computer.
Extract the downloaded .zip file to a temporary location.
Open a command prompt and change directory to the path where you extracted the .zip file.
Run the PackageInstaller.exe and follow the instructions in the wizard to install the hotfix.
NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issues are currently being researched. If you need further assistance with any issue, please contact Technical Support.
On Chinese locales, help is displayed in the English language.
The following PlateSpin Migrate content are not localized and display in the English language irrespective of the locale you are using:
The Validation in Progress message displayed when you start configuring a workload.
The Configure Migration option in the Replication Type dialog that displays when configuring a workload.
The Hotfix installer content.
When you use the web interface to discover workloads and targets, the discovery might fail with a warning message.
To enable the web interface to successfully discover the workloads and targets, do the following:
On the Migrate server computer, open the registry editor.
Go to HKLM\SOFTWARE\PlateSpin\OperationsFramework\Controller.
Add a key named HeartbeatStartupDelayInMS of type REG_SZ and set its value to 15000.
Restart the server computer.
If the Distributed Resource Scheduler (DRS) is enabled in a vCenter Server or at the cluster level, then the migration and server sync jobs might fail with some object reference errors.
Workaround: Disable DRS before migration and enable it only after the Migration is complete.
If you migrate a Linux workload having partitions, each partition is created as a separate disk on the migrated Linux target.
The migration status in the Command Details tab is incorrectly displayed in the following scenarios:
If you choose to perform a run cutover after full replication, the status displays as Running Cutover throughout the migration cycle even when the full replication event has just started.
If you choose to perform run cutover after an incremental replication, the status displays as Running Cutover throughout the migration cycle even when the incremental replication event has just started.
If you choose to perform a test cutover after an incremental replication, the status displays as Preparing For Test Cutover throughout the migration cycle even when the incremental replication event has just started.
Workaround: Ignore the status because there is no functionality loss.
Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.
For detailed contact information, see the Support Contact Information website.
For general corporate and product information, see the NetIQ Corporate website.
For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.
THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.
For purposes of clarity, any module, adapter or other similar material (“Module”) is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.
This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.
This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.
U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government's rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.
© 2015 NetIQ Corporation. All Rights Reserved.
For information about NetIQ trademarks, see http://www.netiq.com/company/legal/.