Enabling Call Home

If you have disabled Call Home, use this procedure to enable the feature again.

Before you begin

Before you begin, make sure that you have the following prerequisites in place:
  • A running IBM Storage Ceph cluster with an active MGR.
  • Firewall ports configured, as detailed in Table 1. Outbound connections are made from the Call Home service to IBM servers.
    Table 1. Firewall ports for Call Home access
    Hostname Port Protocol
    esupport.ibm.com 443 HTTPS
    ecurep.ibm.com 443 HTTPS
    join.insights.ibm.com 443 HTTPS
  • Optional: Configure the Call Home proxy.
    ceph config set mgr mgr/call_home_agent/proxy http://128.64.64.12:8090
    For more information see, Modifying the Call Home agent configuration.

About this task

Note: By enabling Call Home utilizing these parameters, you agree to allow IBM and its subsidiaries to store and use your contact information and certain system information anywhere you do business worldwide as described in the Program license agreement and documentation. For more information, refer to the Program license agreement and documentation.

Call Home is enabled by default. If you have disabled Call Home and want to enable it again, use the following procedure. When re-enabling, all communication of data with IBM support systems is re-established.

Procedure

  1. Log into the cephadm shell.
    cephadm shell
  2. Enable the Call Home Agent manager module.
    ceph mgr module enable call_home_agent

    For example,

    [ceph: root@host01 /] # ceph mgr module enable call_home_agent
  3. Set the customer email.
    ceph config set mgr mgr/call_home_agent/customer_email CUSTOMER_EMAIL
  4. Set the customer phone number.
    ceph config set mgr mgr/call_home_agent/customer_phone CUSTOMER_PHONE
  5. Set the customer first name.
    Note: The customer first and last name must be set separately.
    ceph config set mgr mgr/call_home_agent/customer_first_name CUSTOMER_FIRST_NAME
  6. Set the customer last name.
    Note: The customer first and last name must be set separately.
    ceph config set mgr mgr/call_home_agent/customer_last_name CUSTOMER_LAST_NAME

Enabling service events

Enable service events for Call Home to automatically open support tickets for critical events.

Before you begin

Before you begin, make sure that IBM Call Home is enabled.

Procedure

  1. Enable service events.
    ceph config set mgr mgr/call_home_agent/enable_service_events True
  2. Set the IBM Customer Number (ICN).
    The ICN is 7 alphanumeric characters long.
    ceph callhome set icn ICN

    For example,

    [ceph: root@host01 /] # ceph callhome set icn ABCD123
  3. Set the customer country code.
    This is a two letter country code.
    ceph callhome set country-code CUSTOMER_COUNTRY_CODE

    For example,

    [ceph: root@host01 /] # ceph callhome set country-code US