Questo contenuto non è disponibile nella lingua selezionata.
Chapter 2. Configuring the migration toolkit for applications instance environment
To adjust migration projects to specific requirements, configure the migration toolkit for applications (MTA) instance environment.
You can configure the MTA instance environment by setting up the following parameters:
- General
- Credentials
- Repositories
- Proxy
- Custom migration targets
- Issue management
- Assessment questionnaires
2.1. Prerequisites Copia collegamentoCollegamento copiato negli appunti!
- You installed the MTA UI. For more information, see Installing the migration toolkit for applications user interface.
2.2. Configuring credentials Copia collegamentoCollegamento copiato negli appunti!
To provide the migration toolkit for applications (MTA) instance environment with secure access to your private source code and repositories, configure credentials in the user interface (UI).
You can set up the following credential types to configure the MTA instance environment:
- Source control
- Maven settings file
- Proxy
- Basic auth (Jira)
- Bearer token (Jira)
2.2.1. Configuring source control credentials Copia collegamentoCollegamento copiato negli appunti!
To provide the migration toolkit for applications (MTA) with secure access to private repositories when analyzing an application or creating a custom migration target, configure source control credentials.
Source control 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 Copia collegamentoCollegamento copiato negli appunti!
To provide the migration toolkit for applications (MTA) with secure access to your private Maven repositories, configure authentication credentials in the user interface. Adding these credentials ensures analysis tasks can automatically retrieve the required data.
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.xmlfile or paste its contents. Optional: If you want to set Maven credentials as default, enable the Use as the Maven 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.xmlfile 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 Copia collegamentoCollegamento copiato negli appunti!
To allow the migration toolkit for applications (MTA) to access external network resources through a secured gateway, configure proxy credentials in the user interface.
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 Copia collegamentoCollegamento copiato negli appunti!
To allow the migration toolkit for applications (MTA) access to the data required for the migration tasks, configure source and binary repositories in the user interface (UI).
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 Copia collegamentoCollegamento copiato negli appunti!
To allow migration toolkit for applications (MTA) to access the data required for migration tasks, configure Git repositories in the user interface (UI). By configuring these repositories, you enable MTA to access your source code to identify modernization paths and required steps for your modernization efforts.
Procedure
- In Administration view, click Repositories and then click Git.
- Enable the Consume insecure Git repositories switch.
2.3.2. Configuring Subversion repositories Copia collegamentoCollegamento copiato negli appunti!
To allow the migration toolkit for applications (MTA) to access the data required for the migration tasks, configure Subversion repositories in the user interface (UI). By configuring these repositories, you allow MTA to access your source code to identify modernization paths and required steps for your modernization efforts.
Procedure
- In Administration view, click Repositories and then click Subversion.
- Enable the Consume insecure Subversion repositories switch.
2.3.3. Configuring a Maven repository Copia collegamentoCollegamento copiato negli appunti!
To give migration toolkit for applications (MTA) access to the data required for the migration tasks, configure Maven repositories in the user interface (UI). By configuring these repositories, you allow MTA to access your source code to identify modernization paths and required steps for your modernization efforts.
You can both configure a Maven repository and reduce its size in the Repositories view of the MTA UI.
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 Copia collegamentoCollegamento copiato negli appunti!
To enable the migration toolkit for applications (MTA) to access external network resources through a secured gateway, configure HTTP and HTTPS proxy settings in the user interface. Establishing these connection parameters ensures that your modernization projects can retrieve essential metadata and updates.
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 Copia collegamentoCollegamento copiato negli appunti!
To adjust application analysis and assessment to your needs, define custom migration targets in the migration toolkit for applications (MTA).
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
adminpermissions.
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.