Configuring with the IBM AD Configuration Wizard

About this task

Starting with IBM® AD V5.1.0.7, IBM AD Configuration Wizard is introduced and 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, in a Windows environment, where the configuration of all IBM AD components is currently 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 IBM Application Discovery Configuration Wizard check box was selected, the IBM Application Discovery Configuration Wizard page will open in the system's default browser after the installation is completed.
    Note:

    If you need to use IBM Application Discovery Configuration Wizard to perform the initial setup at a later time, access http://localhost:9080/ad-audit/setup. It is recommended to use IBM Application Discovery Configuration Wizard only once, right after the installation process of IBM ADDI product is completed.

  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 IP address of the machine where the IBM ADDI product is installed.
    • 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.
    • Select database server type - Select the appropriate relational database type. If you select the IBM Db2®® for z/OS option, the Storage Group field is displayed as optional. In the Storage Group field, specify the storage group that is configured for AD on the Db2® for z/OS® server.
    • 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.
    • Instance/location (optional) - If Microsoft SQL Server was selected as 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 - enter the username and password for the IBM AD SQL Identity as previously defined in Microsoft SQL Server Configurations, or for the IBM Db2® for z/OS instance as previously defined in IBM Db2 for z/OS Server Configurations.
    Important: By clicking Test Connection, you can test the connection to your database. If the test connection succeeds, click Next.
  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 Summary page, click Commit.
  10. When the configuration is successfully completed, click Done

Results

You are redirected to the new IBM AD Configuration Service page from where you can perform the Advanced Configurations.