Troubleshooting OES2 data migration issues with miggui
This document (7002862) is provided subject to the disclaimer at the end of this document.
Novell Open Enterprise Server (Linux based)
Miggui is a data and service GUI migration utility introduced in OES2 SP1.
Section 9: Transfer ID issues
Section 1: PrerequisitesReview and fix any issues in TID 7001767, "Troubleshooting data migrations with migfiles from NetWare 6.5 to OES 2 Linux": http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=7001767&sliceId=1&docTypeID=DT_TID_1_1&dialogID=51371089&stateId=0%200%2051369286
Section 2: Supported ServicesThe migration tool supports these service migrations:
AFP, CIFS, DHCP, File System, FTP, iFolder, iPrint, NTP, Archive Version, and server Identity Migration.
Section 3: Source and Target OS support / Supported file systems.Sources supported:
NetWare: 5.1 SP8, 6.0 SP5, 6.5 SP6 or later
Linux: OES 1, OES 2
Windows: NT, 2000 and 2K3
Target: NSS, NCP and POSIX
NetWare Source: Traditional, NSS
OES2 Source: NSS, NCP and POSIX
OES1 Source: NSS, NCP
Section 4: LogsMiggui project debug logs are available at the user specified project directory. The default project location is /var/opt/novell/migration/<PROJECT NAME>/log/. Please review these logs when there are errors or failures. The failing CLI command seen in the debug.log can often be executed manually from a terminal shell with additional debug enabled. For example, if the failure was on a migfiles command it could be executed manually from a bash shell with an additional --debug switch. It is best practice to review the man page and help screen information of the failing CLI command to determine what additional debug options are available and where it writes the log file by default.
Section 5: Miggui CLI toolsAny of the migfiles command line troubleshooting steps are applicable because miggui is a GUI wrapper for CLI tools like the migfiles utility.
CLI tools used by miggui:
Man pages are available for manual CLI usage.
Section 6: Authentication issues
- The shipping version of miggui has a bug that causes failures if the server name entered, while authenticating to the source, is a different case from the entry in the /etc/hosts file. Use the same case as seen in the hosts file.
- Login via IP address if troubleshooting DNS related issues.
- nldap.nlm should be loaded on a source NetWare server. Ldap should be configured correctly and listening on ports 389 or 636.
- The path on the target server must be correct.
echo $PATH [ENTER]
- Authentication may fail if there are incorrect entries in the/etc/pam.d/tsafs file.
- Verify the novell-sms package to see if there have been changes to this file:
- The Certificate Authority (CA) must be up and running and certificates must be valid and not expired.
- Review TID 7003251, "Miggui fails to authenticate to the target
Linux OES server":
Section 7: Data Migration issuesReview and fix any issues in TID 7001767, "Troubleshooting data migrations with migfiles from NetWare 6.5 to OES 2 Linux": http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=7001767&sliceId=1&docTypeID=DT_TID_1_1&dialogID=51371089&stateId=0%200%2051369286
There is a bug in the shipping version of novell-ncpserv code that prevents visibility of source NSS volumes in miggui that are larger than 1 terabyte in size. Update to the current novell-ncpserv code from the update channel.
The current patch code in the update channel must be used to be able to properly see cluster enabled volumes and migrate data from Cluster source servers.
OES1 iFolder data migration:
OES 1 source data on native Linux partitions can not be migrated with miggui. Miggui only recognizes NSS and NCP volumes on OES1 source servers. If IFolder data resides on native Linux partitions on OES 1 servers, either create an NCP mount point where the data resides and then use miggui, or manually migrate the data directly from the native linux partition with the migfiles CLI. Ncpcon can be used to create NCP volumes.
Here is an example of how to migrate OES 1 ifolder data on native Linux partitions to OES2 with migfiles:
migfiles --debug -s<source IP> -iPX /source/path -px /target/path
miggui and migfiles will fail in nbackup code if smszapi is not loaded on OES1 and zapi is not loaded on OES2.
Use lsmod to confirm these modules are loaded in the kernel.
Section 8: Service Migration issuesndsimon.nlm is required if migrating NetWare eDir / serverid to OES2 Linux. Confirm this NLM is loaded on the source NetWare server.
During the process of the eDirectory PreCheck, it will give errors regarding the admingroup object not being found or the unix workstation object not being found if there is not sufficient rights for the LDAP anonymous bind it does to the local target box. Make sure that Public account has the default rights needed to search the eDirectory Tree. If Public's rights have been limited, make sure to use a LDAP proxy user on the target server's LDAP group object, that has sufficient rights to browse the tree.
If using a SSL connection does not work, make sure that the default certificates on the Target server are not expired. If they are expired, you can use iManager to repair the default certificates for all servers with expired certificates.
Section 9: Transfer ID issuesReview TID 7000347,"Migration fails with error, "secure copy from NetWare failed rc=35327":
This Support Knowledgebase provides a valuable tool for NetIQ/Novell/SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.
- Document ID:7002862
- Creation Date:30-MAR-09
- Modified Date:08-NOV-12
- NovellOpen Enterprise Server
Did this document solve your problem? Provide Feedback