Ansible Configuration for IIB Agent

The following is an example of Ansible® role to install PHP Agent on AIX or Redhat based Linux system.

---
- hosts: all
  tasks:
    - name: Include variables for the controller settings
      include_vars:
          # Include all yaml files under the vars directory
          dir: vars
          extensions:
          - 'yaml'
          - 'yml'

    - include_role:
        name: appdynamics.agents.iib
      vars:
        agent_version: latest
        # possible value:
        #          - latest: Latest version 
        #          - 22.10.0.5500.0: Any Specific version number
        agent_type: iib
        agent_action: upgrade
        # possible value:
        #          - upgrade: upgrade currently installed agent to  agent_version 
        #          - install: install agent_version
        #          - rollback: rollback to previous backup if any

YML

IIB Agent Variables

Variable	Description	Possible Values	Required	Default
`iib_log_dir`	Path to the directory containing the IIB agent log files.	directory path	Optional	`/tmp/appd`
`iib_user_exit`	The exit name of the user. This must be in the alphanumeric format, as provided in the `mqsichangebroker` command.	`ecom`	Optional	`None`
`iib_flow_level_visibility_enabled`	Set 1 to enable, and 0 to disable. See IIB Agent Flow Level Visibility.	0, 1	Optional	`0`
`iib_node_reuse`	The node name reuse function enables users to reuse the node names of historical VMs for new VMs. It prevents the rapid increase of differently named nodes, especially when the nodes are identical processes that run over different times. This helps you monitor environments with short-life VMs. See Enable the Node Name Reuse.	`true` or `false`	Optional	`None`
`iib_node_reuse_prefix`	Use this property when `iib-node-reuse` is set to `true`. If you do not set this property, the agent generates node names as per the internal node name standards of IBM. See Enable the Node Name Reuse.	`ecom`	Optional	`None`
`config_file_path`	Use this property to set the path for node or server configuration files. You can specify multiple paths separated by a comma.	`/opt/node1.conf.yaml`, `/opt/node2.conf.yaml`	Optional	`None`
`iib_controller_cert_file`	Full path to the PEM format X509 certificate for SSL. See, Enable SSL for the C/C++ SDK for more information on how to obtain the certificate file.	`/etc/controller/iib.pem`	Optional	`None`

Important

For IIB Agent configurations, see Install the IIB Agent.
Set the necessary variable for Controller in the controller-info.xml file. See Common Role Variables.

Custom Proxy Configuration Variables

Variable	Description	Possible Values	Required	Default
`controller_proxy_host`	Host name or IP address of the proxy. It is required to connect the agent to the Controller.	`ecommerce.proxy.com`	Optional	`None`
`controller_proxy_port`	Proxy port to route data to the Controller through a proxy server.	`8090`	Optional	`None`
`controller_proxy_username`	Proxy username required to log in to proxy server host.	`ecommere-user`	Optional	`None`
`controller_proxy_password`	The password for authenticating the proxy user.	`/etc/ecommerce/passwd`	Optional	`None`
`controller_proxy_passwordfile`	The full path name of a file containing the password to authenticate the proxy user.	`/etc/ecommerce/passwd`	Optional	`None`

Unable to render {include} The included page could not be found.