Chapter 2. Configuring the Migration Toolkit for Applications instance environment
You can configure the Migration Toolkit for Applications (MTA) instance environment by setting up the following parameters:
- General
- Credentials
- Repositories
- Proxy
- Custom migration targets
- Issue management
- Assessment questionnaires
2.1. Prerequisites Copy linkLink copied to clipboard!
- You installed the MTA UI. For more information, see Installing the Migration Toolkit for Applications user interface.
2.2. Configuring credentials Copy linkLink copied to clipboard!
You can set up the following credential types to configure the Migration Toolkit for Applications (MTA) instance environment:
- Source control
- Maven settings file
- Proxy
- Basic auth (Jira)
- Bearer token (Jira)
2.2.1. Configuring source control credentials Copy linkLink copied to clipboard!
To access private repositories when analyzing an application or creating a custom migration target that pulls the rules from a private repository, you can configure source control credentials. These credentials include the username and password or Supply Chain Management (SCM) private key and a passphrase.
Procedure
- In Administration view, click Credentials.
- Click Create new.
Enter the following information:
- Name
- Description (Optional)
- In the Type list, select Source Control.
In the User credentials list, select Credential Type and enter the requested information:
Username/Password
- Username
- Password (hidden)
SCM Private Key/Passphrase
- SCM Private Key
Private Key Passphrase (hidden)
NoteType-specific credential information such as keys and passphrases is either hidden or shown as [Encrypted].
- Optional: If you want to set source control credentials as default, enable the Use as the source control credential if an application does not have any assigned? switch.
Click Create.
NoteMTA validates the input and creates a new credential. SCM keys must be parsed and checked for validity. If the validation fails, the following error message is displayed:
“not a valid key/XML file”
.
2.2.2. Configuring Maven credentials Copy linkLink copied to clipboard!
To access private Maven repositories, you can configure new Maven credentials by using the settings.xml
settings file.
Procedure
- In Administration view, click Credentials.
- Click Create new.
Enter the following information:
- Name
- Description (Optional)
- In the Type list, select Maven Settings File.
-
Upload the
settings.xml
settings file or paste its contents. Optional: If you want to set Maven credentials as default, enable the Use as the source control credential if an application does not have any assigned? switch. These credentials will be used by default for all applications that do not have any assigned credentials.
ImportantIf you do not set Maven credentials as default, you must assign these credentials to the application manually before running an analysis. Otherwise, credentials will not be picked up by the application, which might result in the analysis running longer.
Click Create.
NoteMTA validates the input and creates a new credential. The Maven
settings.xml
file must be parsed and checked for validity. If the validation fails, the following error message is displayed:“not a valid key/XML file”
.
2.2.3. Configuring proxy credentials Copy linkLink copied to clipboard!
You can configure a username and password credentials for using along with a Proxy.
Procedure
- In Administration view, click Credentials.
- Click Create new.
Enter the following information:
- Name
- Description (Optional)
- In the Type list, select Proxy.
Enter the following information.
- Username
Password
NoteType-specific credential information such as keys and passphrases is either hidden or shown as [Encrypted].
Click Create.
MTA validates the input and creates a new credential.
2.3. Configuring repositories Copy linkLink copied to clipboard!
You can configure the following repository types for the Migration Toolkit for Applications (MTA) instance environment:
- Git
- Subversion
- Maven
2.3.1. Configuring Git repositories Copy linkLink copied to clipboard!
You can configure Git repositories in the Repositories view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administration view, click Repositories and then click Git.
- Enable the Consume insecure Git repositories switch.
2.3.2. Configuring subversion repositories Copy linkLink copied to clipboard!
You can configure subversion repositories in the Repositories view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administration view, click Repositories and then click Subversion.
- Enable the Consume insecure Subversion repositories switch.
2.3.3. Configuring a Maven repository Copy linkLink copied to clipboard!
You can both configure a Maven repository and reduce its size in the Repositories view of the Migration Toolkit for Applications (MTA) user interface.
If the rwx_supported
configuration option of the Tackle CR is set to false
, both the Local artifact repository field and the Clear repository button are disabled. Therefore, you cannot perform the following procedure.
Procedure
- In Administration view, click Repositories and then click Maven.
- Enable the Consume insecure artifact repositories switch.
Optional:To reduce the size of the Maven repository, click the Clear repository link.
NoteDepending on the size of the Maven repository, the size change might not be evident.
2.4. Configuring proxy settings Copy linkLink copied to clipboard!
You can configure HTTP and HTTPS proxy settings for the Migration Toolkit for Applications (MTA) instance environment.
Procedure
- In the Administration view, click Proxy.
- Enable the HTTP proxy or HTTPS proxy switch to enable the proxy connection.
Enter the following information:
- Proxy host
- Proxy port
- Optional: Enable the HTTP proxy credentials or HTTPS proxy credentials switch to enable authentication.
- Click Insert.
2.5. Creating custom migration targets Copy linkLink copied to clipboard!
Architects or users with admin
permissions can create and maintain custom rulesets associated with custom migration targets. Architects can upload custom rule files and assign them to various custom migration targets. The custom migration targets can then be selected in the analysis configuration wizard.
By using ready-made custom migration targets, you can avoid configuring custom rules for each analysis run. This simplifies analysis configuration and execution for non-admin users or third-party developers.
Prerequisites
-
You are logged in as a user with
admin
permissions.
Procedure
- In the Administration view, click Custom migration targets.
- Click Create new.
- Enter the name and description of the target.
Click the Provider drop-down menu and choose the language provider.
ImportantSupport for the Python and Node.js language providers is available as a Technology Preview only.
- In the Image section, upload an image file for the target’s icon. The file can be in either the PNG or JPEG format, up to 1 MB. If you do not upload any file, a default icon is used.
In the Custom rules section, select either Upload manually or Retrieve from a repository:
- If you selected Upload manually, upload or drag and drop the required rule files from your local drive.
If you selected Retrieve from a repository, complete the following steps:
- Choose Git or Subversion.
- Enter the Source repository, Branch, and Root path fields.
- If the repository requires credentials, enter these credentials in the Associated credentials field.
Click Create.
The new migration target appears on the Custom migration targets page. It can now be used by non-admin users in the Migration view.