Modifying the Call Home agent configuration

Edit online

Modify the Call Home configuration using either environment variables or the Ceph configuration options.

CAUTION: The Call Home agent does not generally need modifying. Misconfiguration can result in data transmission failure.

You can provide configuration parameters as environment variables, with the CHA prefix, or as Ceph configuration options. Environment variables have precedence over Ceph configuration options.

Environment variables

When using Environment variables, a restart of the manager daemons is needed to apply the relevant changes. This kind of configuration is used in Kubernetes environments, where the start of the manager pod can use a configuration map or any other persistence strategy for the environment variables. The configuration map must contain the required configuration settings expressed as environment variables.

Ceph configuration options

When using Ceph configuration options, the changes in the configuration are applied immediately and no further actions to the manager, such as restart or failover, are required.

Table 1. Call Home agent configuration options
Configuration options Definition Environment variable syntax Ceph configuration syntax Default value
interval_inventory_report_seconds

Inventory report shipping frequency in seconds.

For example, one day in seconds is calculated as 60*60*24. 

export CHA_INTERVAL_INVENTORY_REPORT_SECONDS= 86400
 
ceph config set mgr mgr/call_home_agent/interval_inventory_report_seconds 86400
 One day (86400 seconds)
interval_status_report_seconds

Status report shipping frequency in seconds.

For example, 30 minutes in seconds is calculated as 60*30. 

export CHA_INTERVAL_STATUS_REPORT_SECONDS=300
 
ceph config set mgr mgr/call_home_agent/interval_status_report_seconds 1800
 30 minutes (1800 seconds)
interval_last_contact_report_seconds

Last contact report shipping frequency in seconds.

For example, 5 minutes in seconds is calculated as 60*5. 

export CHA_INTERVAL_LAST_CONTACT_REPORT_SECONDS=300
 
ceph config set mgr mgr/call_home_agent/interval_last_contact_report_seconds 300
 5 minutes (300 seconds)
proxy Internal network proxy used to reach external IBM Call Home endpoint. 
export CHA_PROXY=http://128.64.64.12:8090
 
ceph config set mgr mgr/call_home_agent/proxy http://128.64.64.12:8090
 N/A

References

For more details about Call Home firewall and proxy configuration, see: