Configuring call home to enable manual and automated data upload

The call home component needs to be configured before it can be used to perform manual and automated data uploads.

The configuration process consists of the following steps:

Configure the call home settings.
Create call home groups.

After performing these steps, you will be able to use the mmcallhome run SendFile --file file [--desc DESC | --pmr {xxxxx.yyy.zzz | TSxxxxxxxxx}] command to upload a specific file to the ECuRep. Any data collection schedules that are configured are run regularly.

Configuring call home settings

To configure call home settings, perform the following steps:

If you are using proxy, configure the proxy settings:

Set the proxy location and authentication settings, by using the following command:

mmcallhome proxy change --proxy-location ProxyLocation
 -–proxy-port ProxyPort [--proxy-username ProxyUsername
 -–proxy-password ProxyPassword]

Enable the proxy by using the following command:
```
mmcallhome proxy enable [--with-proxy-auth]
```

Set up the customer information by using the following command:
```
mmcallhome info change --customer-name CustomerName
 --customer-id CustomerId --email Email --country-code CountryCode
```
Note:
In special cases, the following customer IDs must be used:
- For developer edition: DEVLIC
- For test edition for customers who are trying IBM Storage Scale: TRYBUY
The country code must correspond to the contact country. The contact country information can be found in the same source where the customer ID is found. Since the customer number is not unique throughout all countries, a country code is also required to unambiguously identify a customer. The country code must be in the ISO 3166-1 alpha-2 format. For example, US for USA, DE for Germany. For more details, see ISO 3166-1 alpha-2.
Set up the scheduled data collection if needed, by using the following commands:
```
mmcallhome schedule add --task DAILY
mmcallhome schedule add --task WEEKLY
```
Note: Explicit enabling is only needed if call home is running on nodes that have IBM Storage Scale version 5.0.1 or older installed.
Enable the call home capability by using the following command:
```
mmcallhome capability enable
```

Creating call home groups

There are two ways to create call home groups: automatically and manually.

Automatic group creation allows users to create homogeneous groups, assigning all compatible cluster nodes to one of the groups. Automatic groups are created by using the mmcallhome group auto command. For more information regarding the automatic group creation, see Configuring the call home groups automatically.

Manual group creation allows the users to fine-tune the contents of the call home groups. For example, you can make the following changes to the call home groups:

Grouping specific nodes within a group.
Create call home groups with inhomogeneous sizes.
Change the contents of an existing group without influencing other groups.

Manual group is created by using the mmcallhome group add command. For more information about the automatic group creation, see Configuring the call home groups manually.