SURELINE SYSTEMS 2025 Gateway Place, Suite #480, San Jose, CA, 95110

SUREedge® MIGRATOR

INSTALLATION GUIDE 5.0.1 FOR

NUTANIX ACROPOLIS

SURELINE SYSTEMS

2

Important Notice

This document is provided "as is" without any representations or warranties, express or implied by

Sureline Systems, Inc. (Sureline) and use of this document is subject to agreement of the following

conditions:

• This document and the information it contains are the property of Sureline. All copies of this

document, electronic or otherwise, must be saved in a secure location and not disclosed or

made available to any third parties without the express written permission of Sureline.

• Reproduction or distribution of this document, in whole or in part, may only be made with

Sureline’s written permission.

• Use of this document does not assure legal or regulatory compliance.

SUREedge and the Sureline logo are registered trademarks of Sureline. All other trademarks are the

property of their respective owners. Information regarding products, service and offerings may be

superseded by subsequent documents and are subject to change without notice.

For the latest information and regarding Sureline or any of its offerings or service, please visit

www.surelinesystems.com.

Information supplied by Sureline is believed to be accurate and reliable at the time of writing.

Sureline assumes no responsibility for any errors in this document. Sureline reserves the right to

make changes in product design or specifications without notice. This document is also subject to

change without notice.

SURELINE SYSTEMS

3

Table of Contents

1. Introduction ............................................................................................................................ 4

1.1 Deployment Scenarios ................................................................................................................................ 4

1.2 Installation Overview .................................................................................................................................. 5

2 Obtaining Software and Documentation .................................................................................... 6

3 Pre-requisites .......................................................................................................................... 8

3.1 Communication between source server and SUREedge® Migrator .......................................................... 9

4 Installing Software ................................................................................................................. 17

5 Obtaining Licenses ................................................................................................................. 28

6 Client Pre-requisites ............................................................................................................... 32

6.1 Prerequisites for physical Windows server .............................................................................................. 32

6.2 Prerequisites for Linux server ................................................................................................................... 35

7 Next Steps ............................................................................................................................. 38

8 Log collection and reporting Issues .......................................................................................... 38

9 Uninstall and cleanup ............................................................................................................. 38

10 Contacting Support ................................................................................................................ 39

SURELINE SYSTEMS

4

1. INTRODUCTION

SUREedge® Migrator is a proven enterprise-class software appliance for Application Mobility,

significantly simplifying and improving the process of moving enterprise applications and systems

across disparate environments. With a multi-tier application migration planner, agentless

architecture, WAN throttling, application awareness and world class encryption and deduplication

capabilities, SUREedge Migrator is easy to deploy, highly scalable and hardware- and hypervisor-

agnostic. With the ability to capture and migrate applications, data and servers between disparate

virtualization environments, data centers and public, private and hybrid clouds, SUREedge® Migrator

is the most complete and easy-to-use solution available in the market.

1.1 Deployment Scenarios

SUREedge® Migrator can be deployed in various configurations to meet the needs of the situation:

• A single instance of SUREedge Migrator can be deployed to move systems, applications and

data of physical systems into virtualization environments, between different virtualization

environments or onto new storage devices. This process is referred to as on-boarding.

• A pair of SUREedge Migrator instances can be used to move systems, applications and data

between compute environments - from one data center to another, from physical systems

into private or public clouds, across compute clouds and other virtualization environments, or

any computationally "distant" environments. This process is referred to as migration.

The main difference between migration and on-boarding scenarios is the number of SUREedge

Instances that are needed: on-boarding requires installing one SUREedge Migrator instance in the

target virtualization environment, whereas migration requires two - one at the source site where the

systems to be migrated reside, and one at the target site where they will live after the migration.

Note that the same SUREedge Migrator software is installed and same installation procedures are

followed for both the source and target instances; the role of a given instance (target or source) is

determined solely by its configuration. Therefore, these installation instructions apply to both source

and target site installs.

SURELINE SYSTEMS

5

1.2 Installation Overview

To set up an environment for on-boarding or migration you should first determine the location(s)

where SUREedge Migrator should be installed. You can then:

• Obtain the required documentation and software for the environment(s) you have identified.

You should have SUREedge Migrator Installation Guide 5.0.1 for Nutanix Acropolis (this

document) and the software packages for installing SUREedge Migrator.

• Perform the installation of SUREedge Migrator software as instructed.

• License and configure SUREedge Migrator as appropriate for each environment, as described

in the Installation Guide and the User Guide.

This Installation Guide covers the steps necessary for installing SUREedge Migrator in Nutanix

Acropolis environment. The following sections will take you through the steps to obtain installation

materials and to install, license and configure SUREedge Migrator to run in Nutanix Acropolis

environment. You can then use the SUREedge 5.0.1 Migrator User Guide to configure and start using

SUREedge Migrator for on-boarding or migration.

SURELINE SYSTEMS

6

2 OBTAINING SOFTWARE AND DOCUMENTATION

SUREedge Migrator installers, tools and documentation are available online for download.

2.1 Obtaining Software

SUREedge Migrator software can be obtained via secure FTP (SFTP). Please use an SFTP client (such

as WinSCP - https://winscp.net/eng/download.php ) to download the SUREedge Migrator software

installer and tools from the SFTP site. The examples in this section show the download process using

WinSCP. Ensure that port 995 is not blocked by firewall.

1. Please use the following information to connect to the SFTP host: File Protocol: SFTP Hostname: secureftp.surelinesystems.com Port: 995 Username: sure02 Please contact mailto:support@surelinesystems.com for password.

SURELINE SYSTEMS

7

2. Click "Yes" to accept the server fingerprint and continue to log in.

3. Open the folder named "Download."

SURELINE SYSTEMS

8

4. The Download folder contains the following subfolders:

• Tools contains SUREedge Pre-Requisite tools, some useful Third Part Apps and Cloud

deployment scripts.

• SUREedge Installation Package contains SUREedge Installer binaries.

SURELINE SYSTEMS

9

SURELINE SYSTEMS

10

SUREedge Installation Package: The folder “SUREedge Installation Package” is divided into

subfolders for all available versions of SUREedge Migrator. You can navigate to the latest version

(“Current Release”) to obtain the package for installing in the environment.

SURELINE SYSTEMS

11

The Current Release folder contains installer packages for various platforms.

Please download the zip file “SUREedge_Software_Appliance_Installer_For_Acropolis.zip”:

SURELINE SYSTEMS

12

• Tools:

The “Tools” folder contains tools useful for the installation and operation of SUREedge

Migrator. It contains sub-folders, “Client_ Pre_requisite tool”, “Third Party Apps” and “Cloud

Scripts”:

SURELINE SYSTEMS

13

• The “Client_ Pre_requisite tool” directory contains binaries that could be useful in preparing

Clients. (Please see the SUREedge Migrator 5.0.1 User Guide for information on using the

pre-requisite tools).

SURELINE SYSTEMS

14

• The “Third Party Apps” directory contains programs that can help during the operation of

SUREedge Migrator:

SURELINE SYSTEMS

15

Please download applications such as –

1. Firefox: SUREedge Migrator is best viewed using the Firefox Browser; an executable for

installing Firefox is provided in this folder.

2. Notepad++ is a text viewer/editor that can be helpful for viewing log files or other text

files.

3. MobaXterm is a terminal program that can be used to make an SSH connection to the

SUREedge Store virtual machine if necessary

SURELINE SYSTEMS

16

4. Adobe Reader can be used to read the SUREedge Migrator documentation, which is

provided as PDF files.

2.2 Obtaining Documentation

SUREedge Migrator documentation is available for download as PDF files from the Sureline Systems website. To get access to SUREedge Migrator documentation, navigate to this URL in your browser:

http://www.surelinesystems.com/downloads/

You will need an account to log in and access the SUREedge Migrator documentation. If you are a new user, please register by filling in the form and clicking “Register”. If you are already a registered user, please click the “Sign in!” button and provide your credentials to access the download area.

SURELINE SYSTEMS

17

3 INSTALLING SOFTWARE

Once the Acropolis environment is ready and has the required pre-requisites available/allocated the

SUREedge Migrator instance can be installed. Log into the Windows VM as an administrator and copy

or download the SUREedge Migrator installer package for Acropolis to the Windows VM where it is

to be installed and double-click on the installer:

SURELINE SYSTEMS

18

1. Once you run exe, it shows a “Welcome” screen.

2. Click Next to continue.

3. Please review and accept the License Agreement.

SURELINE SYSTEMS

19

4. Click I Agree to continue.

SURELINE SYSTEMS

20

5. Select “SUREedge Migrator” radio button.

6. Click Next to view Acropolis Details.

SURELINE SYSTEMS

21

Populate the data in the above screen:

• IP Address: The IP address of the VMware server will be filled in (192.168.20.141) in this

example) and normally does not need to be changed.

• Username and Password: Specify the credentials for the Windows user account under

which SUREedge Migrator will perform operations. This user should be in the Local

Administrators Group and/or the VMware Administrators Group or have equivalent

permissions for creating and controlling virtual machines.

• Datastore Share Path: Specify the path on the VMware server which SUREedge Migrator

will use as its datastore as shown in the example (eg: Datastore2).

• Datastore Size: Specify the maximum space that the datastore will use for storing

captured system images. Please note that this should be at least equal to the size of

server data to be migrated.

7. Click Next to view SUREedge Configuration.

SURELINE SYSTEMS

22

Populate the data in the fields from above screen:

• SUREedge MC Password: Specify the user credentials (must have administrator

privileges). This is the local user on the VMware Server that is performing the installation.

• Data Encryption: SUREedge Migrator can be configured to encrypt the image data that is

stored and transferred across the network. Choosing “Enable” here will enable data

encryption, and “Disable” will turn it off. Note that if this feature is not enabled all

captured data will be stored and transferred un-encrypted.

• Static IP: This should be an unused IP address on the same network as the VMware

server, and will be used by the SUREedge Migrator Store VM.

• Instance Name and Instance Location: These are informational strings that will be

displayed on the login and main screens of the SUREedge Migrator user interface.

SURELINE SYSTEMS

23

8. Click Next to view the final confirmation that you wish to continue with the installation

process. Click “Install” to proceed with the installation or “Cancel” to exit without installing.

The time required to complete the installation will vary depending on the performance and

load of the system, the storage size(s) involved, etc.

SURELINE SYSTEMS

24

The progress of the installation process will be displayed while the install is ongoing.

9. Once the installation is finished you will see the completion screen.

SURELINE SYSTEMS

25

10. Click “Finish” to complete the installation.

SURELINE SYSTEMS

26

SUREedge Migrator is now installed in your Acropolis environment. To connect to the SUREedge

Migrator user interface, open a “Firefox” web-browser window and type the "localhost" or IP address

of the Acropolis where the SUREedge Management Console (MC) component was just installed.

Login screen for SUREedge Migrator will be displayed as shown below:

SURELINE SYSTEMS

27

You can now log into the SUREedge console using the credentials that you specified during the

installation, which will present you with the SUREedge user interface:

SURELINE SYSTEMS

28

4 OBTAINING LICENSES

To obtain a license for SUREedge Migrator click “Request License” in the upper right corner of the

screen. A popup will appear with instructions and all the information required to request a license.

Please send the Appliance Serial Number to support@surelinesystems.com or please call sales (408–

331-7940) to request a license. A member from our team will provide a license key via email.

Steps to apply license to a SUREedge local instance or update the license with new license file.

1. From your web browser, login to SUREedge management console with your login credentials. The SUREedge Management Console web application opens with the dashboard page on display.

SURELINE SYSTEMS

29

2. Navigate to Settings > Instance. Various appliance configuration options display on the appliance configuration page.

SURELINE SYSTEMS

30

3. In the Configuration column, locate the SUREedge License Configuration option and click the Edit link for it from the Action column. The SUREedge License dialog box pops up.

SURELINE SYSTEMS

31

4. Click Choose File. The File Upload window opens.

5. In the File Upload window, browse to the folder containing the license file, select the license file and then click Open.

6. In the SUREedge License dialog box, click on Submit. The management console accepts the license file and displays the appliance configuration page.

SURELINE SYSTEMS

32

5 CLIENT PRE-REQUISITES

This section explains pre-requisites to be executed on the client. Following is the step by step

description about preparing clients to be migrated using SUREedge

5.1 Prerequisites for physical Windows server

Windows Pre-requisite tools are available on SUREedge MC Machine under “C:\UwAmp\www\sureedge\prerequisitetool\” with name “Client_pre_requisite_tool.zip” Copy this tools on the server to be migrated. Unzip and navigate to Windows folder:

Open command prompt, navigate and run – TestAndUpdate.cmd. Sample output is shown below.

SURELINE SYSTEMS

33

SURELINE SYSTEMS

34

Note:

Please read the results carefully and proceed further. Some pre-checks can be ignored based on the

deploying environment

SURELINE SYSTEMS

35

• Oracle Pre-Check failed in above screen. This can be ignored because Oracle is not installed

on the client.

• Hyper-V pre-check can be ignored while migrating to VMware environment.

• Checking pre-requisite for recovering machine on Nutanix can be ignored for windows OS

server 2012 and above.

Conclusion: This test will ensure that Windows server is prepared to be migrated using SUREedge.

5.2 Prerequisites for Linux server

a. Identify user which will be used for server migration.

b. “root” user cannot be used for migration

c. Identified user should be added to sudoers, below section explains how to add user in

sudoers

Open the terminal and issue the command: sudo visudo -f /etc/sudoers

For example, username is “sureline”

Add following lines at the end of the file: Defaults:sureline !requiretty

sureline ALL=NOPASSWD: ALL

SURELINE SYSTEMS

36

d. Copy pre-requisite script to the server to be migrated. Script is available under

“C:\UwAmp\www\sureedge\prerequisitetool\” with name “Client_pre_requisite_tool.zip”.

Unzip the Client_pre_requisite_tool.zip. After unzipping go to “Linux” folder and upload

“precheckForLinuxClient.sh” to Linux client which is to be migrated.

e. Modify permissions to this script using the command:

chmod 0755 precheckForLinuxClient.sh

f. Run the shell script using following command:

./precheckForLinuxClient.sh -username sureline -u

SURELINE SYSTEMS

37

g. Make sure that the result for all pre-checks is PASS.

If “LVM Snapshot is not supported” is reported either machine is not using LVM or LVM is not

detected by SUREedge. If LVM is not detected after recovery machine will be recovered

without LVM.

Conclusion: This test will ensure that Linux server is prepared to be migrated using SUREedge.

SURELINE SYSTEMS

38

6 NEXT STEPS

Your system is now installed and ready to perform migration or on-boarding operations. Please refer

to the SUREedge Migrator User Guide for more information about on-boarding and migrating

applications and systems.

7 LOG COLLECTION AND REPORTING ISSUES

In case of any failures/issues please contact support (email – support@surelinesystems.com) with

installation logs and the username used for installation.

To collect installation logs please create zip file of *.log and *.txt files under

“C:\SUREedgeInstallationFiles.”

8 UNINSTALL AND CLEANUP

Uninstall SUREedge Migrator Software from Windows Server that acts as SUREedge MC

Log into the Windows VM on which SUREedge Migrator Software is installed as an administrator and

to remove SUREedge Migrator 5.0.0 from Control Panel, follow these steps:

• Open Programs and Features from Control Panel.

• Locate the SUREedge 5.0.0 in the list of currently installed programs.

• Select it, and then click Uninstall.

SURELINE SYSTEMS

39

Cleanup Software binary present in user’s AppData folder on Windows Server

• To access user’s AppData folder, simply type the following in Start -> Run (WinKey+R):

%appdata%

• From the AppData location, delete a folder with name “Sureline”

9 CONTACTING SUPPORT

Please write an email to support@surelinesystems.com with a detailed description of the issue. This

will automatically create a support ticket, and a member of our customer support team will reach out

to you soon after.