Chapter 4. Configuring the instance environment
You can configure the following in Administrator view:
- Credentials
- Repositories
- HTTP and HTTPS proxy settings
4.1. Configuring credentials
You can configure the following types of credentials in Administrator view:
- Source control
- Maven
- Proxy
4.1.1. Configuring source control credentials
You can configure source control credentials in the Credentials view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administrator 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].
Click Create.
MTA 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”
.
4.1.2. Configuring Maven credentials
You can configure new Maven credentials in the Credentials view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administrator view, click Credentials.
- Click Create new.
Enter the following information:
- Name
- Description (Optional)
- In the Type list, select Maven Settings File.
- Upload the settings file or paste its contents.
Click Create.
MTA 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”
.
4.1.3. Configuring proxy credentials
You can configure proxy credentials in the Credentials view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administrator 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.
4.2. Configuring repositories
You can configure the following types of repositories in Administrator view:
- Git
- Subversion
- Maven
4.2.1. Configuring Git repositories
You can configure Git respositories in the Repositories view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administrator view, click Repositories and then click Git.
- Toggle the Consume insecure Git repositories switch to the right.
4.2.2. Configuring subversion repositories
You can configure subversion respositories in the Repositories view of the Migration Toolkit for Applications (MTA) user interface.
Procedure
- In Administrator view, click Repositories and then click Subversion.
- Toggle the Consume insecure Subversion repositories switch to the right.
4.2.3. Configuring a Maven repository and reducing its size
You can use the MTA user interface to both configure a Maven repository and to reduce its size.
4.2.3.1. Configuring a Maven repository
You can configure a Maven repository 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
, the Consume insecure artifact repositories switch is disabled and this procedure is not possible.
Procedure
- In Administrator view, click Repositories and then click Maven.
- Toggle the Consume insecure artifact repositories switch to the right.
4.2.3.2. Reducing the size of a Maven repository
You can reduce the size of a Maven repository 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 and this procedure is not possible.
Procedure
- In Administrator view, click Repositories and then click Maven.
Click the Clear repository link.
NoteDepending on the size of the repository, the size change may not be evident despite the function working properly.
4.3. Configuring HTTP and HTTPS proxy settings
You can configure HTTP and HTTPS proxy settings with this management module.
Procedure
- In the Administrator view, click Proxy.
- Toggle HTTP proxy or HTTPS proxy to enable the proxy connection.
Enter the following information:
- Proxy host
- Proxy port
- Optional: Toggle HTTP proxy credentials or HTTPS proxy credentials to enable authentication.
- Click Insert.
4.4. Seeding an instance
If you are a project architect, you can configure the instance’s key parameters in the Controls window, before migration. The parameters can be added and edited as needed. The following parameters define applications, individuals, teams, verticals or areas within an organization affected or participating in the migration:
- Stakeholders
- Stakeholder groups
- Job functions
- Business services
- Tag types
- Tags
You can create and configure an instance in any order. However, the suggested order below is the most efficient for creating stakeholders and tags.
Stakeholders:
- Create stakeholder groups
- Create job functions
- Create stakeholders
Tags:
- Create tag types
- Create tags
Stakeholders and defined by:
- Name
- Job function
- Stakeholder groups
4.4.1. Creating a new stakeholder group
There are no default stakeholder groups defined. You can create a new stakeholder group by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Stakeholder groups.
- Click Create new.
Enter the following information:
- Name
- Description
- Member(s)
- Click Create.
4.4.2. Creating a new job function
Migration Toolkit for Applications (MTA) uses the job function attribute to classify stakeholders and provides a list of default values that can be expanded.
You can create a new job function, which is not in the default list, by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Job functions.
- Click Create new.
- Enter a job function title in the Name text box.
- Click Create.
4.4.3. Creating a new stakeholder
You can create a new migration project stakeholder by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Stakeholders.
- Click Create new.
Enter the following information:
- Name
- Job function - custom functions can be created
- Stakeholder group
- Click Create.
4.4.4. Creating a new business service
Migration Toolkit for Applications (MTA) uses the business service attribute to specify the departments within the organization that use the application and that are affected by the migration.
You can create a new business service by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Business services.
- Click Create new.
Enter the following information:
- Name
- Description
- Owner
- Click Create.
4.4.5. Creating new tag types
Migration Toolkit for Applications (MTA) uses tags in multiple categories and provides a list of default values. You can create a new tag type by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Tags.
- Click Create tag type.
Enter the following information:
- Name
- Rank - the order in which the tags appear on the applications
- Color
- Click Create.
4.4.5.1. Creating new tags
You can create a new tag, which is not in the default list, by following the procedure below.
Procedure
- In Developer view, click Controls.
- Click Tags.
- Click Create tag.
Enter the following information:
- Name
- Tag type
- Click Create.