7-Mode Transition Tool Installation and Administration
7-Mode Transition Tool Installation and Administration
7-Mode Transition Tool Installation and Administration
Contents
Troubleshooting issues...................................................................................................15
Tool installation fails with an incompatible OS error...................................................................................................15
Installation or uninstallation of the 7-Mode Transition Tool is blocked...................................................................... 15
Reinstalling or upgrading the 7-Mode Transition Tool fails on Windows system....................................................... 15
Windows Program Compatibility Assistant notification displayed while installing the tool....................................... 16
If your transition target is running ... You must use this 7-Mode Transition Tool version ...
ONTAP 9.8 or earlier supported release 3.3.3
ONTAP 9.7P2 or later 9.7 P release 3.3.2
Note: Earlier 9.7 releases are not supported.
Copy-free transitions are supported to these ONTAP target releases using 7-Mode Transition Tool
3.3.1.
• ONTAP 9.4 and earlier ONTAP 9 releases.
• Clustered Data ONTAP 8.3.2 and later 8.x releases.
Note: You cannot use the 7-Mode Transition Tool to transition to ONTAP 9.5 or later using the
copy-free method. To do so, you must first transition to ONTAP 9.4 using 7-Mode Transition
Tool 3.3.1 and then upgrade your cluster to ONTAP 9.5 or later. 7-Mode Transition Tool 3.3.2
does not support copy-free transitions.
Installation and Setup Guide 4
Transition to clustered ONTAP by using the 7-Mode Transition Tool
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.
To transition netgroups and CIFS local users and groups, the following requirements must be met:
• Port 8088 of the 7-Mode Transition Tool must be available.
For an alternative to port 8088, you must change the port specified by the tool.http.port
parameter in the transition-tool.conf file, and then restart the 7-Mode Transition Tool
service.
• Each node in the cluster must have at least one data LIF configured for the target SVM.
• All of the SVM data LIFs must be able to communicate with the 7-Mode Transition Tool port
8088 or the port specified by the tool.http.port parameter in the transition-
tool.conf file.
Note: You must ensure that firewalls do not block this traffic.
Installation and Setup Guide 8
Installing or uninstalling the 7-Mode Transition Tool on a Windows system
IP_address is the IP address of the server and port can be 8443 (default), the
value specified for tool.https.port, or 8088, the value specified for the
tool.http.port parameter in the transition-tool.conf file.
User who is a member of the Use a supported browser to navigate to one of the following URLs:
Administrator group and if you
• https://IP_address:port/transition
are accessing the tool (web
interface) from another computer • http://IP_address:port/transition
IP_address is the IP address of the server and port can be 8443 (default), the
value specified for tool.https.port, or 8088, the value specified for the
tool.http.port parameter in the transition-tool.conf file.
Installation and Setup Guide 10
Installing or uninstalling the 7-Mode Transition Tool on a Windows system
2. If the browser displays a message about the self-signed SSL certificate, then accept the self-
signed certificate to continue.
3. Log in to the web interface by using the credentials of the Windows system in which the tool is
installed.
Steps
1. Download the tar.gz file from the NetApp Support Site.
NetApp Downloads: Software
2. Extract the tar.gz file to a directory in the Linux system:
tar -xzvf NetApp_7ModeTransitionTool_Setup.tar.gz -C directory_path
3. Change the directory to the installation directory:
cd directory_path/NetApp_7ModeTransitionTool
4. Configure the 7-Mode Transition Tool server:
./configure
This starts the 7-Mode Transition Tool service on the Linux system.
5. Verify that the 7-Mode Transition Tool service is running on the Linux system:
service transition-service status
Example
Related information
NetApp Support
Example
bash-4.2# cd /root/Downloads/extracted_folder/NetApp_7ModeTransitionTool
bash-4.2# ./unconfigure
Installation and Setup Guide 13
Installing or uninstalling the 7-Mode Transition Tool on Linux (Copy-based transition only)
bash-4.2# cd ..
bash-4.2# rm -rf NetApp_7ModeTransitionTool
Installation and Setup Guide 14
Modifying the configuration options of the 7-Mode Transition Tool
3. After the 7-Mode Transition Tool service is restarted, add the 7-Mode system and cluster
credentials again.
Installation and Setup Guide 15
Troubleshooting issues
Troubleshooting issues
You need to be aware of some of the common issues with the 7-Mode Transition Tool and the
steps to resolve them.
Workaround
1. Right-click the NetApp_7ModeTransitionTool_Setup.exe file, and then select
Properties.
2. In the Compatibility tab, click Change settings for all users.
3. Verify that the Run this program in compatibility mode for: check box is not
selected, and then click Apply.
Workaround
Before you begin, ensure that there are no open instances or dialog boxes of the 7-Mode Transition
Tool. Otherwise, you might have to perform the steps again.
1. Open Registry by clicking Start.
2. In Search programs and files, enter RegEdit.
3. When Registry Editor is open, locate the HKEY_LOCAL_MACHINE registry hive.
4. Expand the HKEY_LOCAL_MACHINE hive by clicking the expand icon to the left of the
folder icon.
5. Continue to expand the registry keys and subkeys until you locate HKEY_LOCAL_MACHINE\
SOFTWARE \NetApp \7-Mode Transition Tool.
6. Click 7-Mode Transition Tool.
7. Right-click INSTALLATION_STATUS, and select Modify.
8. Change the value from INSTALLER_RUNNING to INSTALLED, and click OK.
You should now be able to perform any operation using the 7-Mode Transition Tool installer or the
uninstaller.
Cause
Some of the files in the 7-Mode Transition Tool installation folder are open.
Corrective action
1. Close all of the 7-Mode Transition Tool installation files.
2. Open the registry entry for 7-Mode Transition Tool:
a. Check the INSTALLATION_STATUS field.
b. If the value is INSTALLER_IS_RUNNING, change it to INSTALLED.
3. Retry reinstalling or upgrading the tool.
Copyright
Copyright © 2021 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 system—without 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.
Data contained herein pertains to a commercial item (as defined in FAR 2.101) and is proprietary
to NetApp, Inc. The U.S. Government has a non-exclusive, non-transferrable, non-sublicensable,
worldwide, limited irrevocable license to use the Data only in connection with and in support of
the U.S. Government contract under which the Data was delivered. Except as provided herein, the
Data may not be used, disclosed, reproduced, modified, performed, or displayed without the prior
written approval of NetApp, Inc. United States Government license rights for the Department of
Defense are limited to those rights identified in DFARS clause 252.227-7015(b).
Trademark
NETAPP, the NETAPP logo, and the marks listed on the NetApp Trademarks page are trademarks
of NetApp, Inc. Other company and product names may be trademarks of their respective owners.
https://www.netapp.com/company/legal/trademarks/
Machine translation
See important information about localized content at netapp.com.
https://www.netapp.com/company/legal/machine-translation/