Java Analysis Prerequisites

Edit online

Starting with IBM Application Discovery and Delivery Intelligence (IBM ADDI) 6.0.2, the advanced Java analysis capabilities that integrate IBM AD and IBM Wazi Analyze are introduced. If you obtain IBM AD as part of the IBM ADDI bundle, you get access to both IBM AD and IBM Wazi Analyze.

Prerequisites:

Make sure that the IBM Wazi Analyze container is deployed. For more information, see Deploying the Wazi Analyze container.
Note: Ensure that you deploy a Wazi Analyze version that is compatible with corresponding IBM ADDI version. Otherwise, the integration between IBM ADDI and Wazi Analyze will not work. Refer to the following table that shows the compatibility between IBM ADDI and IBM Wazi Analyze.
Table 1. Compatibility between IBM ADDI and IBM Wazi Analyze

IBM ADDI Version IBM Wazi Analyze Version

6.0.2 1.4.0

6.1.0 2.0.0.2

6.1.1 2.0.0.4 and 2.2.0

6.1.2 2023.2

If you need to upgrade your IBM Wazi Analyze to a later version, back up your project data first as described in Backing up project data and then check the instructions in Migrating to a newer version .
When you deploy the IBM Wazi Analyze container, the source folder where Java projects will be stored needs to be mapped to the /home/wazi/data folder within the IBM Wazi Analyze container and the port 4680 and 5000 need to be exposed. For example, to deploy the IBM Wazi Analyze container by using Docker or Podman, you can run the following commands:
Docker:
```
docker run -v <IBM_AD_Java_Projects_Path>:/home/wazi/data -it -p 5000:5000 -
p 4680:4680 --name WA ibmcom/wazianalyze:2.2.0
```
Podman:
```
podman run -v <IBM_AD_Java_Projects_Path>:/home/wazi/data -it -p 5000:5000 -
p 4680:4680 --name WA ibmcom/wazianalyze:2.2.0
```
Note: Starting with Wazi Analyze 2.0.0.3, the home directory was changed from /home/wazianalyze/data to /home/wazi/data.
Important:
- For Java Analysis, the destination of the mounting point should always be /home/wazi/data. If you already have an existing IBM Wazi Analyze container created for a different purpose and has a different mounting point destination, it cannot be used with IBM AD. In this case, you need to create a new container with the correct mapping described above.
- On Linux, when a local folder is mapped to the data folder within the Wazi Analyze container, the owner of the data folder inside the Wazi Analyze container is updated to the root user or the user who owns the local folder. To revert it back to the Wazi Analyze user within the Wazi Analyze container, complete the following steps:
  1. Open the Wazi Analyze docker container CLI window.
  2. Change the ownership of data folder back to the Wazi Analyze user by running the following command:
    sudo chown wazi:wazi data
  3. Enter sudo user password. By default, the password is same as the username wazi.
  4. The ownership of data folder should now be updated.
  When you copy source files into the project folder, you also need to change the ownership of the source files because by default those source files would be owned by the user adding them. After you copy the source files, you need to complete the following steps to change the owner of the source files to the Wazi Analyze user:
  
  Open the Wazi Analyze docker container CLI window.
  
  Go to the /home/wazi/data/<project-id>/source/ directory.
  
  Change the ownership of source files back to the Wazi Analyze user by running the following command:
  sudo chown -R wazi:wazi *
  
  Enter sudo user password. By default, the password is same as the username wazi.
  
  The ownership of source files within /home/wazi/data/<project-id>/source/ folder should now be updated.
Make sure that IBM Wazi Analyze Server is up and running. For more information on how to start or stop IBM Wazi Analyze Server, see Starting up and shutting down the server.

Table 1. Compatibility between IBM ADDI and IBM Wazi Analyze
IBM ADDI Version	IBM Wazi Analyze Version
6.0.2	1.4.0
6.1.0	2.0.0.2
6.1.1	2.0.0.4 and 2.2.0
6.1.2	2023.2

Configuration options for consideration

You can choose to either configure IBM Wazi Analyze locally or remotely to IBM AD:

To configure Wazi Analyze locally to AD when Wazi Analyze Docker Container is running on the same machine where AD Servers and Services are running, complete the following step:
1. Make sure that Docker API Port on the Wazi Analyze configuration page in AD Dashboard is left empty. For more information, see Configuring Wazi Analyze.
To configure Wazi Analyze remotely to AD when Wazi Analyze Docker Container is running on a different machine from where AD Servers and Services are running, complete the following step:
1. Configuring Docker Engine for Remote Access with TLS. The configured TCP port should be added to Docker API Port field in Wazi Analyze configuration page in AD Dashboard. For more information, see Configuring Wazi Analyze.