Configuring additional data providers
Learn how to configure the Application Discovery static analysis data provider and the z/OS® Discovery Library Adapter data services data provider for analysis.
- Application Discovery static analysis
- z/OS Discovery Library Adapter data services
Configuring Application Discovery static analysis data provider
Application Discovery (AD) static analysis data provider can be used as an alternative static analysis data provider. If an AD data provider is specified, its data will be used by Wazi Analyze user interface and data API, instead of the default built-in data provider of Wazi Analyze.
Complete the following steps to configure AD static analysis data provider.
- The Wazi Analyze container is started with port 4680 that is opened.
- AD server is running and web services are enabled to allow communication with Wazi Analyze server.
- (Optional) If the Wazi Analyze server is running, shut down the server.
wa-shutdown.sh
- Edit the environment file (
analysis.cfg
) in the /home/wazianalyze/azn-api/azn-api-server/api/ directory.Note:- You can use any text editor to view or edit the file.
- If you use the VI editor, you can run the following command to open the file.
vi /home/wazianalyze/azn-api/azn-api-server/api/analysis.cfg
You can use the following keys to change the editing mode of VI editor:- Press i to go to edit mode.
- Press Esc + :wq to save and exit.
- Press Esc + :q! to exit without saving.
- Edit the following lines in the environment file to specify the AD data provider host addresses.
For example:
ApplicationDiscoveryServer=http://my.ad.host:9080 ApplicationDiscoveryMFProjServer=http://my.ad.host:7650
Be sure to remove the "#" at the beginning of each edited line in order to uncomment the line.
Note: If the AD server is configured withhttps
protocol, changehttp
tohttps
. Ensure that you obtain a valid signed TLS/SSL security certificate for the AD server, otherwise you will not be able to access it. For evaluation purposes, the AD server comes with a self-signed certificate and you can use it by setting the following environment variable before starting the Wazi Analyze servers:export AZN_SSL_LAX=true
- If AD providers enable authentication and authorization through an authentication server,
specify the address of the AD authentication server in the environment file by editing the following
lines. For more information, see Configuring Authentication Server (DEX).For example:
ApplicationDiscoveryAuthServer=http://my.ad.host:7600/dex/token ApplicationDiscoveryAuth_client_id=analyze-client ApplicationDiscoveryAuth_client_secret=password
Be sure to remove the "#" at the beginning of each edited line in order to uncomment the line.
- Save the changes to the
analysis.cfg
file. - Start the Wazi Analyze server.
wa-startup.sh
Configuring z/OS Discovery Library Adapter data services data provider
z/OS Discovery Library Adapter (z/OS DLA) data services data provider can be specified to supply Wazi Analyze UI and data API with information about a z/OS system. The z/OS system must be running the z/OS DLA and a z/OS data services data provider must be running to provide access to data.
Complete the following steps to configure z/OS DLA data services data provider.
- The Wazi Analyze container is started with the port 4680 that is opened.
- z/OS DLA server is running.
- If you have not yet done so, start the container and launch the container terminal.
- Edit the environment file (
analysis.cfg
) in the /home/wazianalyze/azn-api/azn-api-server/api/ directory.Note:- You can use any text editor to view or edit the file.
- If you use the VI editor, you can run the following command to open the file.
vi /home/wazianalyze/azn-api/azn-api-server/api/analysis.cfg
You can use the following keys to change the editing mode of VI editor:- Press i to go to edit mode.
- Press Esc + :wq to save and exit.
- Press Esc + :q! to exit without saving.
- Add the following line in the environment file to specify the z/OS DLA host address.
For example:ZdlaServer=<host_address>:<port_number>
ZdlaServer=https://my.zdla.host:5680
- Save the changes to the
analysis.cfg
file. - Start the Wazi Analyze server and supply the token key from the z/OS
DLA.
wa-startup.sh -d <token>
Note: Ensure that you obtain a valid signed TLS/SSL security certificate for the server running the z/OS DLA data services provider, otherwise you will not be able to access it. For evaluation purposes, the z/OS DLA data services provider comes with a self-signed certificate and you can use it by setting the following environment variable before starting the Wazi Analyze servers:export AZN_SSL_LAX=true