7-Mode Transition Tool 2.1
7-Mode Transition Tool 2.1
7-Mode Transition Tool 2.1
1
Release Notes
NetApp, Inc.
495 East Java Drive
Sunnyvale, CA 94089
U.S.
Table of Contents | 3
Contents
Overview of 7-Mode Transition Tool .......................................................... 5
New features and enhancements in 7-Mode Transition Tool 2.1 ............. 6
Requirements for transition ........................................................................ 7
System requirements for 7-Mode Transition Tool ...................................................... 7
Storage and host version requirements for transition assessment ............................... 9
Data ONTAP version requirements for migration ....................................................... 9
License requirements for transition ............................................................................. 9
7-Mode Transition Tool service must be running ....................................................... 9
Limits for transition ..................................................................................................... 9
4 | Release Notes
The 7-Mode Transition Tool runs on a Windows or Linux system. You can perform the following
tasks by using the 7-Mode Transition Tool:
Assess the features and functionalities of these systems, and identify how these features and
functionalities work in the clustered Data ONTAP version selected for transition.
Run prechecks on volumes included in a transition project to verify their compatibility for
transition and view possible corrective actions.
Apply 7-Mode configurations to clustered Data ONTAP before disconnecting client access,
reducing the downtime.
The 7-Mode Transition Tool provides both a web interface and a command-line interface for
managing your transition operations. However, you must use the web interface of the tool to collect
inventory information from the systems and assess these systems.
Attention: You must use only one interface for an end-to-end transition workflow to avoid any
undesirable configurations. For example, if you start a transition operation for a set of volumes by
using the web interface, you must complete the transition of those volumes by using the same
interface.
Login for users who are not members of the Administrator group
Users who are not members of Administrator group on the Windows system on which the 7Mode Transition Tool is installed can log in to the tool.
Performing assessment operations for host-multipath drivers and HBA by using the
Interoperability Matrix data from April 2, 2015
Related information
4-GB RAM
40-GB HDD
Windows 7 Enterprise
Transition Tool installer automatically installs 64-bit JRE 1.8 update 45. If an earlier version of
64-bit JRE is installed, the installer automatically updates it to JRE 1.8 update 45.
Linux system: software requirements
The 7-Mode Transition Tool web interface is not supported on Linux. You must use the CLI to
perform the transition tasks on a Linux system.
8 | Release Notes
Ports 8443 (for HTTPS) and 8088 (for HTTP) must be available.
If port 8443 is not available, or if you want to use a different port for HTTPS, you must change
the port specified by using the tool.https.port parameter in the transition-tool.conf
file. For an alternative HTTP port, you must change the port specified by the tool.http.port
parameter in the transition-tool.conf file.
Note: You must restart the 7-Mode Transition Tool service after changing the port in the
configuration file.
The firewall should be either turned off or configured to allow traffic on the port that is used to
access the tool.
10 | Release Notes
migration, you should review the number of volumes in a subproject and number of subprojects that
can be run simultaneously.
The following table lists the number of controllers and hosts that can be assessed simultaneously:
Parameter
Maximum limit
Number of controllers
Number of hosts
20
The following table lists the number of volumes in a subproject and the number of subprojects that
can be run simultaneously during migration:
Parameter
Maximum limit
160
240
11
Traditional volumes
SnapLock volumes
FlexCache volumes
32-bit volumes and 64-bit volumes that have 32-bit Snapshot copies if the destination cluster is
running Data ONTAP 8.3 or later
FlexClone volumes
FlexClone volumes can be transitioned as FlexVol volumes, but the clone hierarchy and storage
efficiency will be lost.
Root volume of a vFiler unit, where the root volume is based on a qtree that belongs to the default
vFiler unit
krb5p if the target cluster is running Data ONTAP 8.3 and later
krb5i and krb5p if the target cluster is running Data ONTAP 8.2.x
IPv6 configurations
SnapVault relationships
Volumes that are the source of a SnapVault relationship can be migrated; however, the SnapVault
relationship is not transitioned. A volume that is the destination of a SnapVault relationship can
be migrated only after the SnapVault relationship is broken or deleted.
NetApp Technical Report 4052: Successfully Transitioning to Clustered Data ONTAP (Data
ONTAP 8.2.x and 8.3)
FPolicy configurations
12 | Release Notes
BranchCache configurations
Antivirus configurations
PC-NFS
WebNFS
NFSv2
FTP
Transition of volumes serving CIFS data that is being accessed by local users and groups to a
Data ONTAP 8.2 destination cluster
7-Mode Transition Tool supports the transition of local users and groups only to clustered Data
ONTAP 8.2.1 and later.
Configuration to allow the administrator to connect to the CIFS home directories of other users
(cifs.homedirs_public_for_admin option on the 7-Mode system)
NetApp Technical Report 4052: Successfully Transitioning to Clustered Data ONTAP (Data
ONTAP 8.2.x and 8.3)
NDMP configurations
SFTP server
TFTP server
You can work with your NetApp representative to identify workarounds for transitioning some of
these features.
The following 7-Mode features enable you to continue with the transition process, but are not
supported in clustered Data ONTAP:
SnapValidator
The following 7-Mode feature is not transitioned by the 7-Mode Transition Tool:
14
Fixed issues
It is a good practice to review the bugs that are fixed in this release of 7-Mode Transition Tool.
Bugs Online provides detailed information about fixed issues. To view information about the status
of the bug, you can click the Bug ID hyperlink to access the report in Bugs Online.
895012
Windows clients cannot access VHD files after transition to clustered Data ONTAP 8.2.x
or 8.3.
15
Known issues
Some unexpected behaviors have been identified as well as workarounds, in some cases, to avoid
these behaviors.
Multiple DNS servers are configured for the data SVM, with at least one of the DNS servers
unresponsive and at least one of them responsive.
The unresponsive DNS server is the last one in the list of configured DNS servers.
Either of the A record or AAAA record of the host name does not exist in the responsive
DNS server.
The responsive DNS server reports the absence of the A or AAAA record in an unexpected
way.
Workaround
Remove the unresponsive DNS servers from the data SVM DNS configuration.
Related information
NetApp Bugs Online Bug ID 900864: DNS server timeout causes NFS mount failure after
transition
NetApp Bugs Online Bug ID 882760: January 2015 Java Runtime Environment (JRE)
Vulnerabilities in 7-Mode Transition Tool
16 | Release Notes
NetApp Bugs Online Bug ID 900911: Clustered disks are incorrectly reported for Windows 2008
and Windows 2012 hosts
The 7-Mode Transition Tool incorrectly reports that root access from NFS might be denied if ACLs
do not allow permission to root users in clustered Data ONTAP. However, starting with clustered
Data ONTAP 8.3.1, you can enable root access from NFS even if ACLs do not allow permission to
root users. You can enable root access from NFS after the transition by using the vserver nfs
modify -vserver <svm-name> -ignore-nt-acl-for-root enabled option.
Related information
NetApp Bugs Online Bug ID 921052: 7-Mode Transition Tool incorrectly reports that NT ACLs
on UNIX Security-style volumes cannot be turned off in clustered Data ONTAP
NetApp Bugs Online Bug ID 921050: 7-Mode Transition Tool incorrectly reports that root access
from NFS cannot be enabled in clustered Data ONTAP
Known issues | 17
Related information
NetApp Bugs Online Bug ID 858997: 7MTT GUI (on Internet Explorer) browser might be
unresponsive when user tries to modify the storage system password after the 7MTT service is
restarted
Clustered Data ONTAP 8.3 MetroCluster Management and Disaster Recovery Guide
7-Mode Transition Tool 2.1 Data and Configuration Transition Guide
Workaround for backup and restore operations using SnapDrive and SnapManager in
clustered Data ONTAP 8.3
Perform the one of the following actions:
18 | Release Notes
Retain the 7-Mode systems till the 7-Mode Snapshot copies expire.
You can use the 7-Mode system to restore a file from a LUN in the 7-Mode Snapshot copy and
then migrate it to clustered Data ONTAP, if required.
Use single file SnapRestore in clustered Data ONTAP to restore the LUN from a 7-Mode
Snapshot copy to the active file system, and then mount the restored LUN for single file restore.
Workaround for backup and restore operations using SME and SMHV in clustered
Data ONTAP 8.3.1 and later
Perform the one of the following actions:
Verify that the SnapManager backups created in 7-Mode are valid before you perform a storage
cutover to clustered Data ONTAP.
Create a clone of the volume in clustered Data ONTAP from the transitioned 7-Mode Snapshot
copies, and then mount the LUN on the cloned volume for backup verification and restore
operations.
The best practice is to retain the 7-Mode systems till the 7-Mode Snapshot copies expire.
Related information
NetApp Bugs Online Bug ID 779835: Cluster becomes unresponsive or access can fail if you use
CIFS or NFSV4 client to access ASCII directory on a transitioned volume.
Known issues | 19
NetApp Bugs Online Bug ID 699190: Automatic conversion of large directories no longer occurs
CIFS symbolic link translation might not work for some CIFS
shares with absolute symbolic links
In clustered Data ONTAP, certain absolute symbolic links might not be resolved when their
translation is of locality type local, and the symbolic link is accessed from a CIFS share other than
the one defined in the symbolic link configuration.
The symbolic link is resolved when accessed from the same CIFS share that is defined in the
symbolic link configuration.
Related information
NetApp Bugs Online Bug ID 859970: CIFS symlink translation might not work for some CIFS
shares for absolute symlinks
NetApp Bugs Online Bug ID 865557: In secondary subproject edit workflow, volume and its
SnapMirror relationship cannot be selected for transition if the SnapMirror relationship for the
volume is configured using the connection definition name
NetApp Bugs Online Bug ID 831837: LDAP client configurations are not transitioned if CIFS
server is not configured on the SVM
20 | Release Notes
NetApp Bugs Online Bug ID 828399: 7-Mode Transition Tool hangs during precheck operation if
any operation is in progress for another sub-project
NetApp Bugs Online Bug ID 828493: Unable to resume the data transfer for some paused
subprojects
Known issues | 21
Workaround
Manually modify your backup scripts to match the Snapshot naming convention in clustered Data
ONTAP after transition.
Related information
NetApp Bugs Online Bug ID 821993: Scheduled Snapshot Ordinal Naming in Clustered ONTAP
NetApp Bugs Online Bug ID 800931: Transition complete operation fails while resolving group
members by the security identifier (SID) for the CIFS local users and groups.
NetApp Bugs Online Bug ID 787153: Audit path configuration is not transitioned when
transitioning NFS only configuration
22 | Release Notes
Transition Tool. During transition, the AD Kerberos machine account is created as part of the default
Organizational Unit in the AD server.
Workaround
Manually modify the Kerberos configuration for each of the data LIFs transitioned as part of the
subproject to specify the Organizational Unit in which the Microsoft AD Kerberos machine account
has to be created.
Related information
NetApp Bugs Online Bug ID 749963: The AD Kerberos machine account is created as part of the
default Organizational Unit in the AD server
Clustered Data ONTAP 8.3 File Access Management Guide for NFS
NetApp Bugs Online Bug ID 618684: The command-line interface (CLI) of the 7-Mode Transition
Tool does not validate the Kerberos AD Server and KRB Server credentials provided during the
transition complete operation.
Known issues | 23
2. Modify the LDAP schema on the SVM by using the following command:
vserver services ldap client schema modify -vserver vserver_name -schema
new_schema
Related information
NetApp Bugs Online Bug ID 713010: The 7-mode Transition Tool displays the warning 'Failed to
modify LDAP schema' during transition complete if the schema name length exceeds 32 characters
NetApp Bugs Online Bug ID 709451: The 7-Mode Transition Tool does not add LDAP to the -nmswitch of the Vserver.
24 | Release Notes
Mode controller, creating the subproject fails with the following error message: Source host does
not exist on 7-Mode storage system.
This issue occurs because the host name of the primary 7-Mode controller either does not resolve to
any IP address, or it resolves to an IP address that does not belong to the primary 7-Mode controller.
Workaround
Edit the /etc/hosts file of the default vFiler unit of the secondary 7-Mode controller and add the
host entry for the primary 7-Mode controller to the file. This ensures that the host name of the
primary 7-Mode controller resolves to the correct primary 7-Mode controller IP address from the
default vFiler unit.
Related information
NetApp Bugs Online Bug ID 704012: Subproject creation might fail in the 7-Mode Transition
Tool web interface with a host name error.
NetApp Bugs Online Bug ID 753632: Cutover takes excessively long time with scaled
configuration.
25
Copyright information
Copyright 19942015 NetApp, Inc. All rights reserved. Printed in the U.S.
No part of this document covered by copyright may be reproduced in any form or by any means
graphic, electronic, or mechanical, including photocopying, recording, taping, or storage in an
electronic retrieval systemwithout prior written permission of the copyright owner.
Software derived from copyrighted NetApp material is subject to the following license and
disclaimer:
THIS SOFTWARE IS PROVIDED BY NETAPP "AS IS" AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE,
WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL NETAPP BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
NetApp reserves the right to change any products described herein at any time, and without notice.
NetApp assumes no responsibility or liability arising from the use of products described herein,
except as expressly agreed to in writing by NetApp. The use or purchase of this product does not
convey a license under any patent rights, trademark rights, or any other intellectual property rights of
NetApp.
The product described in this manual may be protected by one or more U.S. patents, foreign patents,
or pending applications.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer
Software clause at DFARS 252.277-7103 (October 1988) and FAR 52-227-19 (June 1987).
26
Trademark information
NetApp, the NetApp logo, Go Further, Faster, AltaVault, ASUP, AutoSupport, Campaign Express,
Cloud ONTAP, Clustered Data ONTAP, Customer Fitness, Data ONTAP, DataMotion, Fitness, Flash
Accel, Flash Cache, Flash Pool, FlashRay, FlexArray, FlexCache, FlexClone, FlexPod, FlexScale,
FlexShare, FlexVol, FPolicy, GetSuccessful, LockVault, Manage ONTAP, Mars, MetroCluster,
MultiStore, NetApp Insight, OnCommand, ONTAP, ONTAPI, RAID DP, RAID-TEC, SANtricity,
SecureShare, Simplicity, Simulate ONTAP, Snap Creator, SnapCenter, SnapCopy, SnapDrive,
SnapIntegrator, SnapLock, SnapManager, SnapMirror, SnapMover, SnapProtect, SnapRestore,
Snapshot, SnapValidator, SnapVault, StorageGRID, Tech OnTap, Unbound Cloud, and WAFL and
other names are trademarks or registered trademarks of NetApp, Inc., in the United States, and/or
other countries. All other brands or products are trademarks or registered trademarks of their
respective holders and should be treated as such. A current list of NetApp trademarks is available on
the web at http://www.netapp.com/us/legal/netapptmlist.aspx.
27