This project provides the required sample playbook and roles to discover the Db2 subsystem information and prompt the information of all defined Db2 subsystems in the sysplex.
The execution of this playbook will return information for each registered Db2 subsystem under DOE, such as:
- groupName
- isActive
- listenerPort
- location
- sysplexName
- systemName
- version
It is a good practice to review the playbook sample contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. Although samples are written to operate without the need for the user’s configuration, flexibility is written into the samples because it is not easy to determine if a sample has access to the host’s resources. Review the playbook notes sections for additional details and configuration.
- db2-discover-subsystems.yml - Handles discovery of all registered Db2 subsystems.
- db2_login - Holds tasks to authenticate the user of an application.
- db2_post_graphql_discovery - Holds tasks to discover a Db2 subsystem.
- db2_put_infra_discovery - Holds tasks to discover the infrastructure details of a Db2 subsystem.
These sample playbooks are designed to exploit the Db2 DevOps Experience (DOE) APIs. An environment where Db2 DevOps Experience is installed and operating is required.
In addition, the Db2 discovery sample playbook can be applied after your administrator defines the Db2 subsystem, team, environment and the application, or the set of Db2 objects that can be provisioned as an unit under DOE. These information will be the input parameters for the playbook.
If you are unfamiliar with playbooks, you can review our detailed configuration guide.
Update the playbook-specific variables in vars/db2_discover_subsystems.yml, based on the behavior that you want.
zos_target_address
- Hostname of the system on which Db2 for z/OS DevOps Experience is running. Server name used to access the DOE rest apis.valid_port_number
- Port number of Db2 DevOps Experience Server.valid_username
- Username used to access the DOE REST API.valid_password
- Password used to access the DOE REST API.
- To run the DB2 discovery playbook, type the following command from the root of this repository:
ansible-playbook db2-discover-subsystems.yml
© Copyright IBM Corporation 2021
Licensed under Apache License, Version 2.0
Please refer to the support section for more details.