Modifying the Call Home agent configuration

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=1800
 
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, 30 minutes in seconds is calculated as 60 × 30. 

export CHA_INTERVAL_LAST_CONTACT_REPORT_SECONDS=1800
 
ceph config set mgr mgr/call_home_agent/interval_last_contact_report_seconds 1800
 30 minutes (1800 seconds)
interval_performance_report_seconds Time frequency for the performance report in seconds. For example, 5 minutes in seconds is calculated as 60 × 5. 
export CHA_INTERVAL_PERFORMANCE_REPORT_SECONDS=300
 
ceph config set mgr mgr/call_home_agent/interval_performance_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
upload_ops_persistence_seconds Time interval during which requests with same SI request ID will not be processed. N/A N/A 10 days (864000 seconds)
level_one_upload_cooling_window_seconds Time interval needed to pass before a new diagnostics upload operation level one will be accepted. N/A N/A 5 minutes (300 seconds)
level_two_upload_cooling_window_seconds Time interval needed to pass before a new diagnostics upload operation level two or higher will be accepted. N/A N/A 1 hour (3600 seconds)

References

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