IT42939: STORAGE INSIGHTS DOCUMENTATION SHOULD BE UPDATED TO INCLUDE VMWARE AND SWITCHES TO DEFINE A LARGE ENVIRONMENT.

APAR status

• Closed as documentation error.

Error description

• Managing data collectors -
  https://www.ibm.com/docs/en/storage-insights?topic=configuring-m
  anaging-data-collectors
  
  "Deployment planning" section, in the Large environments,
  currently this page has no info about monitoring switches or
  VMware environments, and the only consideration is the storage
  subsystems and volumes monitored.
  
  As the same best practice requirements of "1 collector for up to
  25 devices" applies for storage or switches or VMware
  "Large" environments should be defined as 25+ devices of any
  kind -- including storage devices + switches + VMware monitored
  The Storage Insights documentation should be modify as follow:
   If your organization uses more than 25 devices, counting
  storage, VMware, and switches, or your devices have more than
  50,000 volumes, then your environment is considered "large".
   The best practice for large environments is to deploy one data
  collector for every 25 devices that you want to monitor.
   In large environments, you must provide 2 CPU with at least 4
  GB of RAM and 4 GB of disk space on top of the OS requirements
  for the server or virtual machine where the data collector is
  deployed.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Storage Insights users deploying a Data Collector        *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * In the Storage Insights documentation:                       *
  *                                                              *
  * https://www.ibm.com/docs/en/storage-insights?topic=configuri *
  * ng-managing-data-collectors                                  *
  *                                                              *
  * In the "Managing data collectors", "Deployment planning"     *
  * section, concerning the Large environments -- currently this *
  *                                                              *
  * page has no info about monitoring switches or VMware         *
  * environments, and the only consideration is the storage      *
  * subsystems and volumes monitored.                            *
  *                                                              *
  * As the same best practice requirements of "1 collector for   *
  * up to                                                        *
  * 25 devices" applies for storage or switches or VMware        *
  * "Large" environments should be defined as 25+ devices of any *
  * kind -- including storage devices + switches + VMware        *
  * monitored                                                    *
  *                                                              *
  * The Storage Insights documentation should be modify as       *
  * follow:                                                      *
  *                                                              *
  * > If your organization uses more than 25 devices, counting   *
  * storage, VMware, and switches, or your devices have more     *
  * than                                                         *
  * 50,000 volumes, then your environment is considered "large". *
  *                                                              *
  * > The best practice for large environments is to deploy one  *
  * data                                                         *
  * collector for every 25 devices that you want to monitor.     *
  *                                                              *
  * > In large environments, you must provide 2 CPU with at      *
  * least 4                                                      *
  * GB of RAM and 4 GB of disk space on top of the OS            *
  * requirements                                                 *
  * for the server or virtual machine where the data collector   *
  * is                                                           *
  * deployed.                                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following release:
  
  IBM Storage Insights 1Q23   Ý 54X-IBM-SI ¨
  ( release target 1Q 2023 / February )
  
  The target dates for future releases do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels