Chapter 11. Platform awareness in MTA user interface

Procedure

1. In the MTA user interface, select the Administration working mode.
2. Click Source platform in the left menu bar to go to the Source platforms page.
3. Click Create new platform. The Create new platform dialog appears.

4. In the form, enter the following information:

   1. Name: A unique name for the source platform (CF) instance.
   2. Type: Select source platform from the drop down menu. For example, Cloud Foundry.
   3. URL: API URL of the source platform. For example, the API URL of CF platform.
   4. Credentials: Select the name of the Source Control credentials that you configured for the source platform.

5. Click Create.

   The source platform instance is created. A source platform instance can be linked with one or more applications.

Procedure

1. In the MTA user interface, select the Administration working mode.
2. Click Source Platforms in the navigation menu to go to the Source Platforms page.
3. Select a source platform on the Source platforms page.

4. Click the Options menu ( ) of a source platform and click Discover applications. The Discover applications window appears.

   The discovery process imports all or selected applications that are deployed in the source platform instance to the Applications Inventory page on MTA.

5. Type the platform coordinate details based on which MTA filters applications during the discovery process.

   The following example shows platform coordinates of a CF instance:

   {
       "names": ["app-a", "app-b"],
       "spaces": ["example-space"]
   }

   Copy to Clipboard Toggle word wrap
   Note

   For a CF instance, the application names field can contain globs. For example, app*.

6. Review the configuration and click Discover applications. This action tiggers an application import task.
7. Close the Discover applications window.
8. (Optional) Hover over the source platform name to check the status of the application import task and click the application import task to view the task details in YAML format.

Procedure

1. In the MTA user interface, select the Migration mode.
2. On the Application Inventory page, click the edit icon ( ) in an application. The Update application dialog appears.
3. Enter the following information in the form:

4. Click Source platform and enter the following fields:

   1. Source platform: Select a source platform instance.

   2. Source platform coordinates: Configure the source platform coordinates in either way:

      1. Enter the source platform coordinates in the fields. For example, name and space for a CF instance.

      2. Enable the source platform coordinates to enter application coordinates in JSON. For example, a CF instance coordinates can be:

         {
             "name": ["example-app"],
             "space": ["example-space"]
         }

         Copy to Clipboard Toggle word wrap
   3. name: Type the name of the application.
   4. space: Configure the CF space in which the app is deployed in the source platform.
5. Click Save and close the Update application dialog.

1. Click anywhere on the appication row to open the application details view.
2. Click the Platform tab to verify the source platform coordinates that you configured.
3. Enable the JSON switch for the source platform coordinates to check the coordinates in JSON format.

Procedure

1. In the MTA user interface, select the Migration working mode.

2. On the Application Inventory page, you can retrieve configuration for one or more applications.

   1. To retrieve configuration for an application:

      1. Select an application and click the Options menu ( ).
      2. Click Retrieve Configurations.

   2. To retrieve configurations for multiple applications:

      1. Select the target applications or click the Select all option ( ).
      2. Click the Options menu near Analyze at the top and click Retrieve Configurations.
3. You can review the read-only configurations in the Retrieve Configurations dialog and click Retrieve. MTA triggers a task to retrieve configuration for each application.

Verification

1. Click an application row to open the application details view and click the Platform tab.
2. Review the discovery manifest with the retrieved configuration and download the JSON configuration, if necessary.