Application Migration Wizard

The Application Migration wizard allows you to migrate an application from a remote grid or a URL or migrate an application to a remote grid.

You can reach the Application Migration wizard in the following ways:

• Application Import
  • from the dashboard, select the Applications tab and press the Migrate from button at the top of the application list or right-click the mouse and select Migrate From from the context menu.

• Application Export
  • from the dashboard, select the Applications tab, select the application to be migrated, and press the Migrate to button at the top of the application list or right-click the mouse and select Migrate To from the context menu.

Table of Contents

Setting up Trust between the grids

Before the Application Import Wizard can be run, "trust between the two grids" must be set up. To setup trust between the two grids, perform the following steps:

1. From the grid shell, execute grid info -v and copy the value of the Grid Public SSH Key.
2. Log into the remote grid and create a new user specifying the public SSH key retrieved in the previous step as the sshkey parameter. For Example:
   user create reotegrid@3tera.net pwd=somepwd sshkey=sshkey
3. Execute the 'application import wizard'
4. Optional: remove the user that was created in on the remote grid if no more applications need to be imported.

In addition, either the user's and/or the grid's public SSH key must also be installed on the remote grid in order to set up a "trust" between the two grids. When importing an application from a remote grid,

Importing an application from a remote grid

When importing an application from a remote grid, the Application Import Wizard walks the user through the steps necessary to import and configure an application that resides on a remote grid. The wizard walks the user through the following steps:

• General (Step 1 of 3)
• Configuration Properties (Step 2 of 3)
• Finalizing (step 3 of 3)
• Migrating

See Importing an application from URL below if you are importing an application from a URL.

General (Step 1 of 3)

When the 'Import from Grid' radial button is selected, the wizard allows the following fields to be specified:

Remote Grid

DNS name or IP address of remote grid from which the application is to be imported (e.g., mygrid.3tera.net).

Remote Application Name

Name of application on remote grid that is to be imported.

New Application Name

Optional new name for imported application. If a new name is not specified, the imported application will have the same name as the 'Remote Application Name' specified above.

The 'Import from Grid' option is similar to executing the application migrate command from the grid shell.

Configuration Properties (Step 2 of 3)

The 'Configuration Properties' dialog of the wizard allows you to set values for properties of the application, allowing you to specialize this instance of the application. This is useful for configuring location-specific parameters, such as IP addresses, and for configuring tuning parameters, such as cache sizes.

The default values of the properties are shown in normal font weight. Property values explicitly configured for this application are in bold. Mandatory property values that have not yet been configured are highlighted in red.

For information on the property, its type and allowed values, select the info button . To restore the default value of a property, press the restore button (use the "Reset All" button to reset the values of all properties to their defaults).

Finalizing (step 3 of 3)

The 'Finalizing' dialog of the wizard allows for you to specify the following:

Do not compress volumes when migrating application

Select this option to disable compression when transferring volumes for the application. This option may speed up the operation if the application contains very large volumes.

Skip cleanup upon failure or completion (troubleshooting)

Select this option to not cleanup the imported application if a failure is encountered.

Migrating

The 'Migrating' dialog of the wizard shows the overall progress for the application import operation.

Importing an application from a URL

General

When the 'Import from URL radial button is selected, the wizard allows the following fields to be specified:

URL

URL of the directory where the application archive resides. Must be in the form: http://path.

Application Name

Name of the imported application.

User Name

Optional user name for gaining access to the HTTP server.

Password

Optional password for gaining access to the HTTP server.

The 'Import from URL' option is similar to executing the application import command from the grid shell and specifying a URL for the exchange directory.

Migrating

The 'Migrating' dialog of the wizard shows the overall progress for the application import operation.

When the application has been successfully imported, it may be configured using the Application Configurator.

Exporting an Application to a Remote Grid

When exporting an application to a remote grid, the Application Export Wizard walks the user through the steps necessary to export and configure the application to reside on a remote grid. The wizard walks the user through the following steps:

• General (Step 1 of 3)
• Configuration Properties (Step 2 of 3)
• Finalizing (step 3 of 3)
• Migrating

General (Step 1 of 3)

Remote Grid

DNS name or IP address of remote grid to which the application is to be exported (e.g., mygrid.3tera.net).

New Application Name

Optional new name for exported application. If a new name is not specified, the exported application will have the same name as the local application being exported.

Configuration Properties (Step 2 of 3)

The 'Configuration Properties' dialog of the wizard allows you to set values for properties of the application, allowing you to specialize this instance of the application. This is useful for configuring location-specific parameters, such as IP addresses, and for configuring tuning parameters, such as cache sizes.

The default values of the properties are shown in normal font weight. Property values explicitly configured for this application are in bold. Mandatory property values that have not yet been configured are highlighted in red.

For information on the property, its type and allowed values, select the info button . To restore the default value of a property, press the restore button (use the "Reset All" button to reset the values of all properties to their defaults).

Finalizing (step 3 of 3)

The 'Finalizing' dialog of the wizard allows for you to specify the follow

Do not compress volumes when migrating application

Select this option to disable compression when transferring volumes for the application. This option may speed up the operation if the application contains very large volumes.

Skip cleanup upon failure or completion (troubleshooting)

Select this option to not cleanup the imported application if a failure is encountered.

Migrating

The 'Migrating' dialog of the wizard shows the overall progress for the application export operation.

-- BeckyH - 03 Sep 2008