User Guide.

Server Migration via Cloudscraper Panel

Ve rsi on: 1.01
Date : 27 Octobe r 2014
The document guides you through the steps to migrate your server to the cloud by using Cloudscraper
Panel.
The document is intended for Cloudscraper Panel closed beta-test participants.

Contents
Introduction.......................................................................................................................................2
Cloudscraper Panel .............................................................................................................................2
Login Screen...................................................................................................................................2
Tasks View......................................................................................................................................2
Add New Agent...............................................................................................................................3
Migration Task: Configuration..........................................................................................................4
Migration Task: Monitoring .............................................................................................................6
Migration Task: Troubleshooting .....................................................................................................6
Windows Migration ............................................................................................................................8
Windows Migration: Prerequisites ...................................................................................................8
Windows Migration: Installation ......................................................................................................8
Windows Migration: Installation Troubleshooting.............................................................................8
Linux Migration ..................................................................................................................................9
Linux Migration: Prerequisites .........................................................................................................9
Linux Migration: Installation ............................................................................................................9
Linux Migration: Installation Troubleshooting ................................................................................. 10
Linux Migration: Walkthrough ....................................................................................................... 10
Version History................................................................................................................................. 15

1
Copyright 2014 M2IAAS INC

Introduction
Cloudscraper migrates servers to a cloud of your choice. Cloudscraper source server could be physical,
virtual, or cloud. Linux and Windows OS supported.
Prior migration Cloudscraper agent is installed onto the source server. Whenever migration is run,
Cloudscraper agent creates an intermediate server image and stores it on server disk or network share.
Then the image is uploaded to the target cloud. See the website for more info on the technology.
Cloudscraper agents are managed by the Cloudscraper Panel Web application. Migration tasks are
scheduled and run via the Panel.

Cloudscraper Panel
Cloudscraper Panel is SaaS application hosted by Migrate2Iaas (M2IAAS INC). The Panel provides self serviced and multitenant migration web-based environment. From the Panel one can schedule,
configure, and troubleshoot migration tasks.
The following sections will describe primary Panel screens.

Login Screen
Browse to http://panel-demo.migrate2iaas.com/ , simply enter your login and password

Tasks View
Task view contains all migration tasks available for your account, and info on servers connected to the
Panel.
The following picture shows the Tasks View screen.

2
Copyright 2014 M2IAAS INC

Add New Agent

The small text on the top briefly guides you on how to add a new source server to the Panel. Full guide
and Linux Walkthrough is available inside this guide.

Agents and tasks are shown below. Agent node names are made of three parts: your Panel username,
optionally, computer domain name, and the computer network name.

3
Copyright 2014 M2IAAS INC

Once server the migration can be started by clicking Run

button to the left of node name.

Migration Task: Configuration

Once you click Run button
Every migration tasks is configurable. This section describes what parameters are available.
The following screenshot show the options available for every migration task.

4
Copyright 2014 M2IAAS INC

Cloud:
The target cloud and region. Choose one from the list.
Key:
API Access Key of your target cloud. The value depends on cloud.

EC2 (AWS): Find AWS Access Key in AWS security credentials page (Access Keys section).
ElasticHosts: Find ElasticHosts API UUID and Secret Key on your Profile page at ElasticHosts
website
Azure: Azure Storage Account credentials (Storage Account and Primary key). Find Azure Storage
Account credentials on Azure Management Portal.

SecretKey:
API Secret Key of your target cloud. See the cloud list above.
Volumes:
Set of volumes youd like to migrate, separated by comma. C is default for Windows.
For Linux, left the field blank. Cloudscraper will migrate the system disk.
ImageDirectory:
The directory or file share where intermediate images are to be stored.
For Windows directories, double slashes \\, e.g. C:\\cloudscraper\\images\\2014-08-22
Note, there should be enough free space to store the migrated volume intermediate image (the size
approx. source volume size).
Note:
Advanced options like VPC, subnets, etc. are not included into the list yet. Theyll be added during the
beta test.

5
Copyright 2014 M2IAAS INC

Migration Task: Monitoring

After the job started you are transferred to migration project page. It shows current migration task
status and steps.

Click Back to Dashboard to return to Task View screen. From this screen you can monitor all running
migrations from one dashboard. See Migration Project Status column to see the info. Click
corresponding link in Migration Project Status column to get back to the migration project page
described above.

Migration Task: Troubleshooting

On any step, you may click Request Support link to send a support request.

6
Copyright 2014 M2IAAS INC

The link will transfer you to the request support page webform. Fill in the brief description of yo ur
question or problem in Topic field. Give more details in Request field.

Press Run to post new Ticket. Youll receive email confirmation featuring support ticket link then.

7
Copyright 2014 M2IAAS INC

Windows Migration
The following sections describe how to migrate your Windows server.

Windows Migration: Prerequisites

Any Windows Server version that the target cloud supports. Please refer the online compatibility matrix
to check if your Windows Server is compatible with a target cloud.

Windows Migration: Installation

Download
https://subversion.assembla.com/svn/cloudscraper.install/trunk/tests/jenkins_auto/cloudscrap
er_agent.exe
Run jenkins_auto.exe
Start the installation

The server will appear in Cloudscraper Panel. From there the migration is configured and started.

Windows Migration: Installation Troubleshooting

Please see the following log files inside Windows system in case of misbehaviors:

C:\cloudscraper-agent\cloudscraper-auto-install.log
C:\cloudscraper-agent\node.bat.log
C:\cloudscraper-agent\node.batslave.error.log
C:\cloudscraper-agent\node.batslave.log
C:\cloudscraper-agent\java-auto-install.log

8
Copyright 2014 M2IAAS INC

Linux Migration
The following sections describe how to migrate your server running Linux OS.

Linux Migration: Prerequisites

Environment: Any virtual or cloud
Distributions:
Following distributions are supported

Red Hat Enterprise Linux 5.1 - 6.5

Centos 5.1 - 6.5
Ubuntu 12.04, 12.10, 13.04, 13.10
Debian 6.0.0 - 6.0.8, 7.0.0 - 7.2.0
Oracle Linux

Software:
These packages should be installed on the source server

wget
python: version 2.6 or 2.7 ( type `python -V` to check )

System Resources (Disk Space):

Drive or network share possessing enough space to keep the image should be used to store
intermediate images. The approximate image size is used space in your root (/) partition. Use of another
volume other than root to store images is encouraged.
Other Requirements:

Internet connectivity
Firewall enabled for all ssh connections
Ports 80 and 443 are available for outbound connections

Linux Migration: Installation

Login to your Linux server and execute:
wget \
http://subversion.assembla.com/svn/cloudscraper.install/trunk/tests/jenkins_auto/linux
/install.sh
chmod +x install.sh
sudo ./install.sh

The installation will prompt you for login and password. Note, you wont be able to access the server
from console if specify wrong username or password.
After the installation process complete the Linux server will appear in Cloudscraper Console. The
migration starts from the console.
Itll install cloudscraper service to the system. Its started automatically. You could start it manually by
typing:
9
Copyright 2014 M2IAAS INC

sudo service cloudscraper start

Linux Migration: Installation Troubleshooting

Please see the following log files inside Linux system in case of misbehaviors:

cloudscraper-auto-install.log

Linux Migration: Walkthrough

This walkthrough describes steps to add your Linux server as an agent to the Cloudscraper Console and
then migrate it.
In the walkthrough, the Linux server is migrated from AWS cloud to AWS EC2, Azure, or ElasticHosts
cloud. Note, AWS source server is used for the demonstration purposes only. You could select any Linux
server whether on-premise or cloud.

Login into your AWS Linux Instance and check the pre-requisites
o Use either putty (if you run Windows) or ssh (for Linux)

Enter your credentials

10
Copyright 2014 M2IAAS INC

o
o

Check the version of the instance and make sure it satisfies the OS requirements.
Check the python version on your instance and see if it satisfies the Python version specified
in prerequisites as shown below or get the right version.

Make sure you have enough space on the file system as shown below:

Issue the following command to install on Linux:

wget
http://subversion.assembla.com/svn/cloudscraper.install/trunk/tests/jenkins_aut
o/linux/install.sh

You should see the following message on the screen if it was successful.

11
Copyright 2014 M2IAAS INC

Run Issue the following command to make the install file executable.
chmod +x install.sh

Run the following command.

sudo ./install.sh

Confirm installation of new packages by entering y

Enter your migration panel username and password on the screen below:

Once you enter the migration panel user id and password if you see the following output on the
screen then the Linux server is successfully connected to the migration panel.

12
Copyright 2014 M2IAAS INC

Open your internet browser, navigate to http://panel-demo.migrate2iaas.com/

You would see the following screen

Enter your user id and password you would see the following screen.

13
Copyright 2014 M2IAAS INC

 Click on the run button which is circled in red to the left of task name (ait15-ip-173*) you will see the
following screen.

Enter the target cloud secrete key details etc., on the screen above.
Press Build button once you fill all the details.
The following screen appears:

14
Copyright 2014 M2IAAS INC

Wait until the migration complete. The task will show either blue on Cloudsraper Panel if successful
or red if failed.

Version History
1.00

5 September 2014

1.01

27 October 2014

15
Copyright 2014 M2IAAS INC

Initial version. Features Windows

and Linux installation instructions.
Linux walkthrough. TODO:
troubleshooting info
Added more explanatory Panel
screens.