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 view.
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.

5. Click Discover applications to open the Discover applications window.

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

6. Optional: Click +Add a name to enter one application per text field and repeat the process to add more than one application. For example, app-a.
7. Optional: Click +Add a space to enter one space per text field and repeat the process to add more than one space. For example, space1.

8. Click +Add an organization to enter at least one organization per text field and repeat the process to add more than one organization. For example, org1.

   Note

   For a CF instance, the application names field can contain glob expressions (globs), for example, app*.

9. Click Next to review the configuration.

10. Click Discover applications.

    This action triggers an application import task.

11. Close the Discover applications window.
12. 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 view.
2. Click the Options menu ( ) near Analyze.

3. Click Discover applications to open the Discover applications window.

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

4. Select the source platform name from the drop-down list for application discovery.
5. Click Next to navigate to the Filters.
6. Optional: Click +Add a name to enter one application per text field and repeat the process to add more than one application. For example, app-a.
7. Optional: Click +Add a space to enter one space per text field and repeat the process to add more than one space. For example, space1.

8. Click +Add an organization to enter at least one organization per text field and repeat the process to add more than one organization. For example, org1.

   Note

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

9. Click Next to review the configuration.

10. Click Discover applications.

    This action triggers an application import task.

11. Close the Discover applications window.
12. Optional: Click the application import task to check the status of the task and 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:

   1. 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"]
            }

      3. name: Type the name of the application.
      4. space: Configure the CF space in which the app is deployed in the source platform.
4. Click Save and close the Update application dialog.

1. Click anywhere on the application 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 view.

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

   • Retrieve configuration for a single application:

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

   • 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.