Configuring by using IBM ADDI Configuration Wizard

Edit online

About this task

IBM® ADDI Configuration Wizard helps to easily configure the Application Discovery and Delivery Intelligence servers, databases, and components, without the need to manually update the configuration files.
Important:
  • IBM ADDI Configuration Wizard is available only for clean installations, where all the IBM ADDI components are configured without using IBM ADDI Authentication Server (DEX). To simplify the configuration process, all the IBM ADDI components must be installed on the same machine.

Procedure

  1. If the IBM ADDI Configuration Wizard check box was selected during the IBM ADDI installation, the IBM ADDI Configuration Wizard page opens in the system default browser after the installation is completed.
    Notes:
    • The browser might display a message indicating that it does not trust the website certificate. This can also occur if the browser was opened during the IBM ADDI installation and did not have the opportunity to load the newly installed IBM ADDI self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the IBM ADDI Configuration Wizard URL, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM ADDI Configuration Wizard page now is displayed without any warnings.
    • If you need to use IBM ADDI Configuration Wizard for the initial setup later, access https://localhost:9443/ad/admin/setup. It is recommended to use IBM ADDI Configuration Wizard only once, right after the IBM ADDI installation is completed.
    • IBM ADDI Configuration Wizard is now multi-language ready. When you access its web interface, you can select the language menu and choose one of the available languages. The entire configuration process is displayed in the selected language.
  2. On the Welcome page, click Get Started.
  3. On the General Settings page, complete the following actions:
    • Select the Encoding. The default value of the encoding that is used in the source files is windows-1252. If necessary, the encoding can be changed. For more information, see https://www.iana.org/assignments/character-sets/character-sets.xhtml.
    • Select or enter the Fully qualified domain name (FQDN) or IP address of the machine where the IBM ADDI product is installed. Using an FQDN is recommended.
    • In the Ports section, all default ports are present. If needed, the ports can be changed.
    • In the Create Environment section, enter the name of the environment or leave it as Default.
      Note: When a new environment is created, a default workspace is also created and automatically attached to the new environment. The default workspace is where all the IBM ADDI Build projects are available.
  4. On the Paths page, enter the following information:
    • Default projects path - enter the path where all mainframe projects will be stored.
    • Path for the retrieved members - enter the path where source code files that are automatically downloaded from Mainframe systems (by using IBM ADDI Connect for Mainframe) will be stored.
    • z/OS Configurations path - enter the path where all z/OS configurations will be stored.
    • Manual Resolutions path - enter the path where all journal files will be stored.
    • Search indexes path - enter the path where all indexes will be stored.
  5. On the Relational Database Server page, enter the following information:
    • Server name - enter an appropriate name (alias) for the relational database server.
      Note: For a Db2 for LUW (Linux®, UNIX, and Windows) database server, the server name must follow the general Db2 object naming rules. This alias will be used to catalog Db2 for LUW server node into a local node directory in case that you decide to automatically create the databases within IBM ADDI (Project database, Cross Service database, Annotation database).
    • Select database server type - Select the appropriate relational database type.
    • Host - enter the IP or the hostname where the relational database server is installed.
    • Port - enter the relational database server port. The default port for SQL Server is 1433.
    • Security - select the security protocol that the relational database server uses. The default protocol depends on the relational database server type that is selected.
    • Instance/location (optional) - If Microsoft SQL Server was selected as the database server type and multiple instances are installed on the same machine, enter the required relational database server instance name (if exists).
    • Username and Password
      1. For Microsoft SQL Server instance, enter the username and password for the IBM ADDI SQL Identity as previously defined in Microsoft SQL server configurations.
      2. For Db2 for LUW (Linux, UNIX, and Windows) instance, enter the username and password.
    Important:
    • For Microsoft SQL database server, you can test your database by clicking Test Connection. If the test connection succeeds, click Next.
    • For a Db2 for LUW (Linux, UNIX, and Windows) database server, Test Connection is optional. After you fill in a database name, the Test Connection button will be enabled. If your specified database does not exist in the Database Server, you can click Test Connection to verify whether the database creation prerequisite is met programmatically by trying to create the database temporarily.
    • If you select a Microsoft SQL database server or IBM Db2 database server with a custom certificate, make sure to clear the option of Create a sample 'GenApp' project and perform a health check at step 10.
  6. On the Database Names page, enter the following information:
    Note: The names of the databases need to respect the database name restrictions that are in place on the type relational database server (SQL, Db2) that was associated.
    • Enter the Annotations Database name and schema name.
    • Enter the Audit Database name.
    • Enter the Cross Analysis Database name.
  7. On the Graph Database Server page, set a new password for GraphDB Server's root user and confirm it.
  8. On the Batch Server page, the following information is available:
    • Projects - the asterisk * means that all projects are considered for this service.
    • Components - represents a list of component names that are initially selected for this service.
      Note: Additional components can be considered for this service. For more information, see the Additional Components table.
  9. On the User access page, enter the following information to create an administrator account for accessing the IBM Application Discovery Configuration Admin dashboard.
    • Username - enter the username that needs to access the dashboard.
    • Password - set a password for the username.
    • Confirm password - enter the password again to confirm it.
    Important: Select IBM Application Discovery and Delivery Intelligence Configuration Admin can be accessed remotely.
  10. On the Health check page, follow the instructions, check the box, and click Next.
  11. On the Summary page, click Commit.
  12. When the configuration is successfully completed, click Done
  13. Log in to IBM Application Discovery and Delivery Intelligence with your account.

Results

You are redirected to the new IBM ADDI Configuration Wizard page from where you can perform the Advanced configurations.