Configuring by using IBM AD Configuration Wizard

Edit online

About this task

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

Procedure

  1. If during the installation process of the IBM ADDI application, the check box of IBM Application Discovery Configuration Wizard was selected, the IBM Application Discovery Configuration Wizard page will open in the system's default browser after the installation is completed.
    Notes:
    • The browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
    • If you need to use IBM Application Discovery Configuration Wizard to perform the initial setup later, access https://localhost:9443/ad/admin/setup. It is recommended to use IBM Application Discovery Configuration Wizard only once, right after the installation process of the IBM ADDI product is completed.
    • IBM AD Configuration Wizard is now multi-language ready. Once you access its web interface, you can select the language menu from the upper right corner 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, perform 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 you can 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 IBM AD 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 AD 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 AD 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 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 AD Configuration Service page from where you can perform the Advanced Configurations.