Before you start

Before installing Application Migration 2.5.200, please refer to the Preparation page for guidance on which platform to install or upgrade, and the accounts required to install and use it.

Application Migration 2.5.200 is provided as two MSI files downloaded as ZIP files from the 1E Support Portal.

  • ApplicationMigration.msi is located in the applicationmigration.v2.5.200.x.zip file
  • 1ETaskSequenceTools.msi is located in the 1ETaskSequenceTools.v2.5.200.x.zip file

Installing Application Migration

You can install Application Migration in one of the following ways:

You must apply the latest accumulated hotfix for SLA Platform 3.3 or Tachyon Platform 4.1, depending on the platform you have chosen. Please visit https://1eportal.force.com for more details on the available hotfixes for all 1E products and refer to the readme notes for details on any manual steps associated with installing the hotfix.
On this page:

Installing Application Migration interactively

To install the Application Migration:

  1. Start a command prompt with elevated rights. Change directory to the location where you downloaded ApplicationMigration.msi and run the following command-line:

    msiexec /i ApplicationMigration.msi /l*v <log path>\AppMigration-Install.log

    where <log path> is the location you want for the installation log files.

    If the Software Lifecycle Application Platform is not already installed, you will be prompted to install that first.
  2. On the Welcome screen, click Next.
  3. On the End User License Agreement screen, accept the terms of the agreement and click Next.
  4. On the Licensing screen, enter your license key and click Next.

    If you get Invalid License prompt when you enter a valid license key, check that you are running the installer with elevated rights: Command Prompt (Admin).

  5. On the Software Lifecycle Automation screen, enter the Base URL for the SLA Platform website. Typically for SLA Platform 3.3 this is http://localhost:8080, however: 

    • If the SLA Platform was configured to use HTTPS, the URL should be in the format https://<SLAPlatformDnsFqdn>:8443 where <SLAPlatformDnsFqdn> is the DNS Name FQDN included in the Web Server certificate
    • If a custom Host Header was specified when the SLA Platform was installed, replace localhost with the specified Host Header (note that a DNS CNAME or DNS A Record alias is required to resolve the Host Header to the SLA Platform server)
    • If a custom port was specified when the SLA Platform was installed, replace 8080 with the custom port.

    If you are installing on Tachyon 4.1 you can connect either using HTTP or HTTPS. In either case the URL will be based on the settings made on the Website Configuration screen of the Tachyon Setup program. Please refer to Tachyon 4.1 - Tachyon Setup: Website configuration for more details.

    For example, if your Tachyon server FQDN is ACME-TCN01.ACME.LOCAL and your Tachyon DNS alias is TACHYON.ACME.LOCAL, and these have been configured as the host headers on the Website Configuration screen of the Tachyon Setup program, then either of the following URLs can be used:

    • http://ACME-TCN01.ACME.LOCAL
    • https://TACHYON.ACME.LOCAL

    If you have specified a custom port on the Website Configuration screen of the Tachyon Setup program then this should also be added to the URLs. For example:

    • http://ACME-TCN01.ACME.LOCAL:8080
    • https://TACHYON.ACME.LOCAL:8443

  6. On the Install screen, click Install.
  7. On the Completion screen, click Finish.

Installing Application Migration in unattended mode

To install Application Migration in unattended mode:

  1. Navigate to the location where you downloaded ApplicationMigration.msi.
  2. Start a command prompt with elevated rights and run the following command-line: 

    msiexec /i "ApplicationMigration.msi" /qn PIDKEY=<KEY> SLAPLATFORMURL=<SLAPlatformURL> /L*v <log path>\AppMigration-Install.log

     where: 

<KEY> is your production license key
<log path> is the location you want for the installation log files
<SLAPlatformURL> is the Base URL for the SLA Platform website. Typically for SLA Platform 3.3 this is http://localhost:8080, however: 

  • If the SLA Platform was configured to use HTTPS, the URL should be in the format https://<SLAPlatformDnsFqdn>:8443 where <SLAPlatformDnsFqdn> is the DNS Name FQDN included in the Web Server certificate
  • If a custom Host Header was specified when the SLA Platform was installed, replace localhost with the specified Host Header (note that a DNS CNAME or DNS A Record alias is required to resolve the Host Header to the SLA Platform server)
  • If a custom port was specified when the SLA Platform was installed, replace 8080 with the custom port.

If you are installing on Tachyon 4.1 you can connect either using HTTP or HTTPS. In either case the URL will be based on the settings made on the Website Configuration screen of the Tachyon Setup program. Please refer to Tachyon 4.1 - Tachyon Setup: Website configuration for more details.

For example, if your Tachyon server FQDN is ACME-TCN01.ACME.LOCAL and your Tachyon DNS alias is TACHYON.ACME.LOCAL, and these have been configured as the host headers on the Website Configuration screen of the Tachyon Setup program, then either of the following URLs can be used:

  • http://ACME-TCN01.ACME.LOCAL
  • https://TACHYON.ACME.LOCAL

If you have specified a custom port on the Website Configuration screen of the Tachyon Setup program then this should also be added to the URLs. For example:

  • http://ACME-TCN01.ACME.LOCAL:8080
  • https://TACHYON.ACME.LOCAL:8443

Installing Application Migration with the Windows Servicing Suite installer

The Windows Servicing Suite installer (1EWSSInstaller.exe) is designed to automate the installation of the entire Windows Servicing Suite, including the 1E Catalog, SLA Platform, Application Migration and the Task Sequence Tools required to implement Application Migration.

To install Application Migration, double-click the 1EWSSInstaller.exe and follow the prompts.

  1. On the Welcome screen, click Next.
  2. On the License Agreement screen, accept the terms of the license and click Next.
  3. On the Deployment Model screen, choose the deployment model that best reflects your setup.
    The Deployment model screen
  4. On the Select Features screen, choose Application migration and click Next.
    Selecting the Application Migration feature to install
  5. On the Feature Configuration – Application Migration screen:
    Licensing Application Migration
    1. Enter the Application Migration license key and click Next.
  6. On the Installation Credentials screen:
    Providing your installation credentials
    1. The Username is pre-populated with the current user and cannot be changed – this account is used for the installation.
    2. In Password, enter the password for this account. This is necessary as the wizard creates scheduled tasks (which runs with the same account used to run the wizard) to install the 1E components on remote and local servers.
    3. Click Next.
  7. On the Installation Progress screen, click Install and when the installation is complete, click Done.
    • Click Show Details to see the features you elected to install
    • Click Install to start the installation – the wizard runs its prerequisite checks on the specified servers. If there are failures, click the link in the Status column to view them. When you have rectified these errors, click Retry.
    • If you want to review the log files for the respective products when the installation is complete, click the Log link for the installed product.
    • If you want to review the wizard logs, click the View log file link at the bottom of the products table.
  8. On the Completion screen, click Finish.

Reviewing the Application Migration installation

To review your Application Migration installation:

  1. In a browser, enter the URL for the SLA Platform (for example,  http://localhost:8080). If you already have a browser pointing to that page, refresh it.
  2. On the left navigation menu, click Application Migration and ensure the console loads.

The Application Migration menu

Relicensing Application Migration

To relicense Application Migration:

  1. Navigate to the folder where Application Migration is installed (typically at %ProgramFiles%\1E\SLA Platform\UI\bin\Modules\Application Migration\<version>\API
  2. Start a command prompt with elevated rights and run:

    LicenseUtility.exe -relicense=<key>

    where <key> is your new license key.

  3. The following messages are displayed on the command-line:
    • Application Migration successfully relicensed – if a valid key is used
    • Application Migration relicensing failed. The current license remains unchanged – if an invalid key is used

 

Installing the 1E Task Sequence tools

The Task Sequence Tools installer extends the Configuration Manager Task Sequence Editor, adding the Application Migration step that can be added to OS deployment task sequences. This step executes during the OS deployment, calling an Application Migration API that returns a list of Configuration Manager Applications and Programs to be installed on the computer being deployed.

Install the Task Sequence Tools on the following systems:

  • The Configuration Manager Primary Site server. In a multi-site hierarchy, install it on the CAS and each primary site.
  • If any site has one or more remote SMS Providers, install it on each remote SMS Provider server
  • Any remote Configuration Manager console systems that are used to edit task sequences.

To install the Task Sequence Tools:

  1. Start a command prompt with elevated rights and run the following command-line from the location the installer was downloaded:

    msiexec /i 1ETaskSequenceTools.msi /l*v C:\Temp\TSTools-Intsall.log
  2. On the Welcome screen, click Next.
  3. On the License Agreement screen, accept the terms of the agreement and click Next.
  4. On the Ready to Install screen, click Next.
  5. On the Completion screen, click Finish.

Reviewing your installation for the 1E Task Sequence Tools

To review your Task Sequence Tools installation:

  1. From your Configuration Manager console, choose the Software Library workspace.
  2. Expand the Operating Systems folder and select Task Sequences.
  3. Right-click any task sequence and from the context menu, choose Edit.
  4. In the Task Sequence Editor, click Add (located top left in the dialog) and ensure the 1E OSD group appears and it contains the AppMigration Task Sequence step.
  5. Exit the Task Sequence Editor without making any change.