Use cases for detecting system changes by using the mmcallhome command

The topic describes the use cases for the mmcallhome command for detecting system changes:

Consider the following assumptions for all use cases:

Call home is configured.
At least two daily or weekly data uploads were already completed.
A file system mari exists in the system.

Note: Only the configuration data that is collected can be compared. Since the configuration data for all the objects in IBM Storage Scale are not collected by call home, the configuration data for these objects is not listed in the configuration difference.

Use Case 1: Check the changes that happened on the system between the last two data collections that were uploaded to IBM® support

Run the following command to check whether any changes are detected:

[root@mari-11 ~]#
mmcallhome status diff
There are no differences.

Run the following command to unmount mari:


mmunmount mari -a -f
mmdelfs mari
mmcallhome run GatherSend --task DAILY

Run the following command to check whether any changes happened to the system after the unmount:

[root@mari-11 ~]#
mmcallhome status diff

The system gives an output similar to the following:

Fs Data

Device Name  =  mari	(deleted)


Nsd Data

Nsd Id  =  0A00640B5E79DB35	(modified)
Fs Name  : mari  --> (free disk)

Nsd Id  =  0A00640B5E79DB46	(modified)
Fs Name  : mari  --> (free disk)

Note: You can use the following command to generate a more detailed output:

[root@mari-11 ~]#
mmcallhome status diff -v

The system gives an output similar to the following:

Fs Data

Device Name  =  mari	(deleted)
Rw Options           : rw                                                              
Mount Options        : rw,atime,mtime,userquota;groupquota;filesetquota,nfssync,nodev  
Drive Letter         : N/A                                                             
Automount Option     : yes                                                             
Perfileset Quota     : no                                                              
Mount Point          : /mnt/mari                                                       
Device Name          : mari                                                            
Quota Option         : userquota;groupquota;filesetquota                               
Mtime Option         : mtime                                                           
Fs Type              : local                                                           
Dmapi Enabled        : no                                                              
Atime Option         : atime                                                           
Maintenance Mode     : no                                                              
Device Minor Number  : 152                                                             
Other Mount Options  : nfssync,nodev                                                   
Owning Cluster Name  : gpfs-cluster-1.localnet.com                                     
Remote Device Name   : mari                                                            


Nsd Data

Nsd Id  =  0A00640B5E79DB35	(modified)
Fs Name  : mari  --> (free disk)

Nsd Id  =  0A00640B5E79DB46	(modified)
Fs Name  : mari  --> (free disk)

If just one configuration option in the system was changed, then the system gives the following output:

Nodeclass Data

Nodeclass  =  GUI_MGMT_SERVERS	(modified)
Allmembers   : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com
Membernodes  : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com

Use Case 2: Check the changes that happened on the system between a selected historic data collection and the most recent one that is uploaded to IBM support

Note: For this use case, consider that the history of the data collections that are kept on the system is limited. If a specified number is reached for the data collection, then the old files are deleted. Hence, the old files are no longer available for configuration comparisons.

Run the following command to select a previous data collection to compare with the most recent data collection:

[root@mari-11 ~]#
mmcallhome status list -v --task weekly

The system gives an output similar to the following:


autoGroup_1  weekly    20200324122356.621  20200324122420  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200324122356621.cl0.DC                                                                                      
autoGroup_1  weekly    20200329030501.922  20200329030529  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200329030501922.cl0.DC                                                                                      
autoGroup_1  weekly    20200401112254.712  20200401112322  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200401112254712.cl0.DC                                                                                      
autoGroup_1  weekly    20200401121816.059  20200401121844  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200401121816059.cl0.DC                                                                                      
autoGroup_1  weekly    20200405030502.039  20200405030527  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200405030502039.cl0.DC                                                                                      
autoGroup_1  weekly    20200412030501.677  20200412030526  success  RC=0        /tmp/mmfs/callhome/rsENUploaded/31790849437793.5_0_5_0.123456.DE.ibmtest.autoGroup_1.gat_weekly.g_weekly.scale.20200412030501677.cl0.DC

Note: Usually all historic data collections that are gathered on the system can be used for the comparison. However, in this case only the weekly data collections is requested.

Run the following command to select one data collection to compare with the most recent data collection:

[root@mari-11 ~]#
mmcallhome status diff --old 20200412

The system gives an output similar to the following:


Nodeclass Data

Nodeclass  =  GUI_MGMT_SERVERS	(modified)
Allmembers   : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com
Membernodes  : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com

Note: If you select a file that was already removed, the system throws an error. In this case, choose another data collection.

Run the following command to compare a data collection that was created 3 days back:

[root@mari-11 ~]#
mmcallhome status diff –last-days 3

The system gives an output similar to the following:


Nodeclass Data

Nodeclass  =  GUI_MGMT_SERVERS	(modified)
Allmembers   : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com
Membernodes  : mari-12.localnet.com  --> mari-12.localnet.com,mari-13.localnet.com

Use Case 3: Check the changes that happened on the system between two distinct historic data collections

Run the following command to select and compare two distinct data collections:

[root@mari-11 ~]#
mmcallhome status diff --old 20200412 --new 20200416 -v

The system gives an output similar to the following:


Fs Data

Device Name  =  mari	(created)
Rw Options           : rw   
Mount Options        : rw,atime,mtime,userquota;groupquota;filesetquota,nfssync,nodev
Drive Letter         : N/A  
Automount Option     : yes  
Perfileset Quota     : no   
Mount Point          : /mnt/mari
Device Name          : mari 
Quota Option         : userquota;groupquota;filesetquota
Mtime Option         : mtime
Fs Type              : local
Dmapi Enabled        : no   
Atime Option         : atime
Maintenance Mode     : no   
Device Minor Number  : 152  
Other Mount Options  : nfssync,nodev
Owning Cluster Name  : gpfs-cluster-1.localnet.com
Remote Device Name   : mari 


Nsd Data

Nsd Id  =  0A00640B5E79DB35	(modified)
Fs Name  : (free disk)  --> mari

Nsd Id  =  0A00640B5E79DB46	(modified)
Fs Name  : (free disk)  --> mari