Setting up Call Home with cloud services

Call Home with cloud services sends notifications directly to a centralized file repository that contains troubleshooting information that is gathered from your system. Support personnel can access this repository and be assigned issues automatically as problem reports. This method of transmitting notifications from the system to support removes the need for you to create problem reports manually.

As part of Call Home with cloud services configuration, you can define an internal proxy server within your network to manage connections between the system and the IBM Support. Other connection configurations are supported for Call Home with cloud services.

Prerequisites

If you are using Call Home with cloud services to send notifications to the IBM Support, you need to ensure that the system can connect to the IBM Support.

Before you configure Call Home with cloud services, ensure that the following prerequisites are configured on the system:

Ensure that all the nodes on the system have internet access.
Ensure that a valid service IP address is configured on each node on the system.

Call Home with cloud services support the following configurations that have extra network requirements.

Table 1. Supported network configurations for Call Home with cloud services
Supported configuration	DNS configuration	Firewall requirements
Call Home with cloud services with an internal proxy server	Required	Configure firewall to allow outbound traffic on port 443 to esupport.ibm.com
Call Home with cloud services with a DNS server	Defined, but not required	Configure firewall to allow outbound traffic on port 443 to esupport.ibm.com. Optionally allow outbound traffic on port 443 to the following IP addresses: 129.42.56.189 129.42.54.189 129.42.60.189
Call Home with cloud services	None	Configure firewall to allow outbound traffic on port 443 to the following support IP addresses: 129.42.56.189 129.42.54.189 129.42.60.189

Using the management GUI

To configure, change, or update Call Home function in the management GUI, follow these steps:

In the management GUI, select Settings > Support > Call Home.
On the Call Home page, select Send data with Call Home cloud services, click Edit, and then click Next.
If the IBM Storage Virtualize system was not integrated with IBM® Storage Insights during the initial system setup, an inline notification to add the storage system to IBM Storage Insights is displayed on the Call Home page and the Dashboard. On the Dashboard, an inline notification is displayed whenever the system is upgraded to a later version from the current version. If you close the notification, the system snoozes the notification and reminds you after 30 days.

You can integrate IBM Storage Virtualize systems with IBM Storage Insights and monitor their status, capacity, and performance by using Call Home with cloud services.
To set up IBM Storage Insights, click Add device on the Call Home page or click Learn more on Dashboard.
- To register for IBM Storage Insights, complete these steps:
  1. On the Add this storage system to IBM Storage Insights page, enter your IBMid. If you don't have an IBMid, click Don't have an IBMid? Sign up here to create an IBMid.
  2. Click Next.
  3. On the Register for IBM Storage Insights page, enter a service name in Name your IBM Storage Insights service.
  4. Read Privacy and Terms and select I have read and accepted the Privacy and Terms.
  5. Click Save. Message is displayed as You are now registered with IBM Storage Insights.
- If you have already registered to IBM Storage Insights, complete these steps:
  1. On the Add this storage system to IBM Storage Insights page, enter your IBMid. If you don't have an IBMid, click Don't have an IBMid? Sign up here to create an IBMid.
  2. Click Next. On the Verify IBM Storage Insights service page, the IBM Storage Insights services that are associated with your IBMid are displayed.
  3. Select the IBM Storage Insights service that you want to use for monitoring the storage system.
  4. Click Save.
- If you click Register Device in the Storage System GUI in IBM Storage Insights, the system redirects you to the IBM Storage Virtualize login page. Log in to IBM Storage Virtualize using your login credentials. On the IBM Storage Virtualize management GUI, complete these steps:
  1. On the Register storage system to IBM Storage Insights window, click Yes to register the storage system with IBM Storage Insights. A message is displayed as Storage system registered to IBM Storage Insights. You cannot complete the registration if Call Home is not enabled or the storage system is already registered with another IBM Storage Insights service.
  2. Wait a few minutes for processing the IBM Storage Virtualize system registration. Then, click Open IBM Storage Insights to approve and add the storage system for monitoring.
Verify that the connection status is Active and a message displays that indicates the connection was successful. If the connection status displays Error, select Monitoring > Events. If Call Home with cloud services is configured, the following connection statuses can be displayed:

Active

Indicates that the connection is active between the system and the IBM Support. A timestamp displays with the last successful connection between the system and the IBM Support.

Error

Indicates that the system cannot connect to the IBM Support through Call Home with cloud services. The system attempts connections every 30 minutes and if the connection continually fails for four hours, an event error is raised and is displayed. A timestamp displays when the failed connection attempt occurred. Select Monitoring > Events to determine the cause of the problem. Use the lscloudcallhome command to display the status of the connection. The system attempts connections for four hours and if the connection continually fails, an event error is raised. If the connection parameter displays error_sequence_number, the last attempt to connect to the IBM Support failed. The error_sequence_number indicates the error number that can be used to determine the cause of the problem. One common issue that causes connection errors between the system and IBM Support is firewall filters that exclude connections to the IBM Support.

Untried

Indicates that Call Home with cloud services is enabled but the system is waiting for the results from the connection test to the IBM Support. After the test completes, the connection status changes to either Active or Error.
To define an internal proxy server to manage connections between the system and support, click Add Proxy. A DNS server is required to use an internal proxy server with Call Home with cloud services. The management GUI prompts you to define a DNS server if one is not configured.
If the storage system is being monitored by IBM Storage Insights and you want to change which service is being used, complete these steps:
1. Click Edit.
2. On the Modify IBM Storage Insights service page, enter your IBMid.
3. Click Next. In Current IBM Storage Insights service, the name of service that is monitoring the storage system is displayed.
4. To change the IBM Storage Insights service that is monitoring the storage system, select that service in Other services associated with your IBMid.
5. Click Save.
Under Additional Settings, enter your preferences for inventory intervals and configuration reporting. Inventory reports can be configured with Call Home and provides additional information to support personnel. An inventory report summarizes the hardware components and configuration of a system. Support personnel can use this information to contact you when relevant updates are available or when an issue that can affect your configuration is discovered. By default, these reports include configuration data that support personnel can use to automatically generate recommendations that are based on your actual configuration. You can have sensitive data that is redacted from these reports, if necessary.
Click Save.

Using the command-line interface

To configure Call Home with cloud services in the command-line interface, complete these steps:

To create at least one DNS server for Call Home with cloud services, enter the following command:
```
mkdnsserver -name mydns
            –ip x.x.x.x.x
```
Where mydns is the name of the DNS server and x.x.x.x.x is the IP address for the DNS server.
To use an internal proxy server to manage outbound connections to the IBM Support, enter one of the following set of commands:
1. To create an open proxy without any access controls, enter the following command:
```
mkproxy -url http://proxy.mycompany.com -port 8080 
```
  where https://proxy1.mycompany.com is the URL for the proxy server and 8080 is the port.
2. To create a proxy server that requires basic authentication for connections, enter the following command:
```
mkproxy -url http://proxy.mycompany.com -port 8080 -username myusername -password mypassword
```
3. To encrypt packages that sent to support through a proxy server, enter the following command:
```
mkproxy -url https://proxy1.mycompany.com -port 4128 -sslcert /cert/mycert.pem
```
4. To use both basic authentication and encryption, enter the following command:
```
mkproxy -url http://proxy.mycompany.com -port 8080 -username myusername -password mypassword -sslcert /cert/mycert.pem
```
To enable Call Home with cloud services, enter the following command:
```
chcloudcallhome -enable
```
To set name of the IBM Storage Insights service for linking the storage system with IBM Storage Insights, enter the following command:
```
chcloudcallhome -sitenantid <service name>
```
Note: Service name must have minimum 16 characters and cannot contain more than 63 characters. Only alphanumeric characters, '-', '.' and '_' characters are allowed.
Enter the following command to change the name of the IBM Storage Insights service:
```
chcloudcallhome -cleartenantid
```
To verify that the connection was established between the system and IBM Support through cloud services, enter the following command:
```
lscloudcallhome
```
In the results that display, verify that the status is enabled and the connection is active. These values indicate that the system is enabled for Call Home with cloud services and that a valid connection between the system and the IBM Support is established. The system attempts connections every 30 minutes and if the connection continually fails for four hours, an event error is raised and is displayed in the error_sequence_number parameter. If the value in the connection parameter is error, the error_sequence_number parameter indicates the event code that was created. Check the event log for more details on the error. In case the name of the IBM Storage Insights service is set after you enable Call Home with cloud services, the command result also displays the service name in the si_tenant_id parameter.