Sharing a common ECC instance among multiple applications

The Enterprise Common Collector is a common component that is designed to be used by multiple applications and thus it is possible to have a single ECC instance that serves multiple IBM® products. If you want to share an ECC instance, you must ensure that its version is compatible with those of other applications.

About this task

Each version of the ECC has an API major version and an API minor version that is associated with it. You cannot connect an instance of an application, such as the zEnterprise® sensor, with an ECC instance that does not have a compatible API version. In such a situation, an error message shows both the detected and the expected API versions.

The zEnterprise sensor version 1.0.0 requires:
  • The ECC API major version 1
  • The ECC API minor version 2 or higher

Procedure

  1. Use the following URL to determine the API major and minor versions of an ECC instance. You can enter the URL into a web browser of any system that has a network connection to the system that the ECC is installed on: 
    https://ecc_hostname:ecc_port_number/eccapi/version
    By default, the port number is 8443.
  2. Continue to the website even if it displays a warning that the certificate was not issued by a trusted certificate authority.
  3. Determine the api-major-version and api-minor-version from a JSON or XML string from the website. The following is an example of this string: 
    {
	"class":"ecc-version",
	"self":"/eccapi/version",
	"name":"ECC version",
	"description":"Information about the ECC and ECC API version",
	"api-major-version":1,
	"api-minor-version":2,
	"ecc-version":"1.1"
}
  4. Depending on the API major and minor versions, complete one of the following actions:
    • Major version is 1, minor version is 1. This version of the ECC is incompatible with the zEnterprise sensor. You must upgrade the ECC to version 1.1.0.2, which is provided with Agile Service Manager. For more information about upgrading the ECC, see the Enterprise Common Collector Configuration Guide and Reference.
      Note: After upgrading the ECC, you might need to upgrade other applications, such as zEnterprise Monitoring Agent of IBM Tivoli® Monitoring, that use the ECC.
    • Major version is 1, minor version is 2 or higher. This version of the ECC is compatible with the zEnterprise sensor. You can use both the sensor and the ECC.
    • Major version is 2 or higher: This version of the ECC is incompatible with the zEnterprise sensor. You can use this instance of the ECC, but you must upgrade the zEnterprise sensor to a newer version.