Tech Tip: VMWare API Consolidated Patch CCC 2.9.4

Document created by biecl01 Employee on Nov 28, 2017
Version 1Show Document
  • View in full screen mode

The attached VMWare API Consolidated Patch for Capacity Command Center 2.9.4 includes the following enhancements:

  • Ability to include the chunk size parameter to collect API data without changing the vCenter metric limit
  • VMware API DA implementation to allow for fetching 5-minutes data
  • Ability to handle missing operand in expression error
  • Enhancement of VMWare API with metrics:
    • DATASTORE_VM_USED_GB
    • DATASTORE_VM_PROVISIONED_GB
    • DATASTORE_VM_UNSHARED_GB
  • Ability to change the parameter for the VM OS to use guestFullName instead of guestId

 

To deploy the patch on Windows, follow these steps. On Linux, the paths are similar.

 

Deploy the XML and CLASS files

 

1. Extract the VMWareAPIPatch directory from the attached zip file. The folder contains the following files:

  • 20171110000000_SQL_Queries.sql
  • AthensConfig.class
  • DatabaseWriter.class
  • DSHead.jsp
  • DSVMAPI.jsp
  • hyp_vmware_api.xml
  • VMWare_API_Engine.class
  • WebClient_VIJava.class
  • WebClient_VMWareSDK.class
  • WebClientInterface.class

2. Make a backup copy of the following files:

  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\hyp_vmware_api.xml
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\Engine\VMWare_API_Engine.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\VmwareAPI\WebClient_VIJava.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\VmwareAPI\WebClient_VMWareSDK.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\VmwareAPI\WebClientInterface.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\DataGatherEngine\DataIntf\DBWriter\DatabaseWriter.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\com\hyperformix\athens\utilities\AthensConfig.class
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\DSHead.jsp
  • <ccc_install_folder>\ApacheTomcat\webapps\DM\DSVMAPI.jsp

3. Replace these files with the ones you extracted from the attached zip file.

4. Open the <ccc_install_folder>\ApacheTomcat\webapps\DM\WEB-INF\classes\config.txt file in a text editor and add the following parameter:

 

ENABLE_MISSING_OPERAND_ERROR=N

 

5. Restart the Apache Tomcat Service:

Windows:

  • Click Start, Control Panel, Administrative Tools. Click Services.
  • Select the Apache Tomcat 7.0 CA_CCC service and restart it.

Linux:

  • In a terminal, navigate to the bin directory of Apache Tomcat Server: <ccc_install_folder>/ApacheTomcat/bin
  • Do: ./startup.sh

 

Deploy the SQL file on Windows

 

1. Copy the 20171110000000_SQL_Queries.sql file to the following location: <ccc-install-folder>\ccc-migrations\standard\scripts.

2. If not already set, provide the DM DB password in the ccc-db.properties file at the following two locations:

  • <ccc_install_folder>\ccc-migrations\standard\environments
  • <ccc_install_folder>\ccc-migrations\cml\environments

3. Navigate to <ccc_install_folder>\ccc-migrations\bin and run the upgrade-ccc-db.bat script.

4. Verify the upgrade-ccc-db.log file to ensure the new script was executed without any errors

 

Deploy the SQL file on Linux

 

1. Copy the 20171110000000_SQL_Queries.sql file to the following location: <ccc-install-folder>/ccc-migrations/standard/scripts.

2. If not already set, provide the DM DB password in the ccc-db.properties file at the following two locations:

  • <ccc_install_folder>/ccc-migrations/standard/environments
  • <ccc_install_folder>/ccc-migrations/cml/environments

3. Navigate to <ccc_install_folder>/ccc-migrations/bin and run the upgrade-ccc-db.sh script.

4. Verify the upgrade-ccc-db.log file to ensure the new script was executed without any errors. No error means the tables in the DM database were updated successfully.

Attachments

    Outcomes