ptx®/PDC (Performance Data Collector) is a set of commands and libraries that provide easy access to system performance data on NUMA-Q® systems. The ptx/PDC application programming interface (API) provides a unified method for accessing raw performance data. The ptx/PDC API protects performance measurement products that use the API from changes in the underlying operating system and layered products. It does this by isolating the changes within the PDC itself while maintaining the API used by the products. Products that use the ptx/PDC API will list ptx/PDC as a requirement to run. The ptx/PDC API is currently available for use by third-party application developers, but is not available for general use.
These Release Notes contain the following information:
Compatibility information
Installation instructions
Open problem reports
Brocade® FC Switch metrics
Special instructions for EMCTM Symmetrix® metrics
These release notes do not describe how to use the products that use the ptx/PDC API, such as Datametrics® ViewPointTM. Refer to the documentation for those products for further information.
ptx/PDC V1.2.0 is compatible with the following software products running on Symmetry® and NUMA-QTM systems:
DYNIX/ptx® V4.4.4 or later (required)
ptx/LAN V4.5.3 or later (required)
ptx/TCP/IP V4.5.1 or later (required)
ptx/SVM V2.1.1 or later (optional)
ptx/CLUSTERS V2.1.1 or later (optional)
ptx/NFS® V4.6.2 or later (optional)
ptx/EFS V1.3.4 or later (optional)
ptx/CFS V1.0.2 or later (optional)
ptx/SDI V2.0.0 or later (optional)
Brocade Fiber Channel Switch firmware V1.4b (optional)
EMC SYMAPI V3.2-72-5 or later (optional)
This release of ptx/PDC provides support for the following new features:
ptx/PDC must be installed prior to using any products which list ptx/PDC as a requirement.
Refer to the DYNIX/ptx and Layered Products Software Installation Release Notes for installation procedures.
Once you have installed ptx/PDC, you can start the data collection daemon (pdcd) by entering the following command:
#/etc/init.d/pdc start
To stop the data collection daemon, enter the following command:
# /etc/init.d/pdc stop
The data collection daemon is automatically started when the system is rebooted and stopped when the system is shut down.
The number that appears in parentheses in problem report titles is the Problem Tracking System number assigned to the report. This problem will be corrected in a future release unless otherwise noted.
The pdcd daemon logs initialization errors to EES and ktlog for layered products that are not installed on the system. The pdcd daemon should only log initialization errors if the layered product is installed but the associated ptx/PDC component still could not initialize properly.
Workaround. None.
The following list shows fixed problems in ptx/PDC V1.2.0:
(243567) The memory component could cause pdcd to dump core on multi-quad systems.
(244460) The Token Ring, FDDI, and Region components could generate "Can't Update Row" errors when all instances were requested and more than one instance was present.
ptx/PDC does not support metrics from Brocade FC Switch firmware.
ptx/PDC collects EMC Symmetrix metrics through use of a software product from EMC Corporation called the Symmetrix API Runtime and CLI. This product requires additional setup and configuration beyond installation of the ptx/PDC software. The EMC software must be installed and configured prior to using ptx/PDC in order for ptx/PDC to discover and collect EMC metrics.
ATTENTION The Symmetrix API Runtime and CLI feature that ptx/PDC uses to collect metrics requires a license key from EMC. Please contact EMC for licensing information (http://www.emc.com).
The Symmetrix API Runtime and CLI feature is distributed with EMC's Symmetrix Manager - Base Component product (V3.2.0 and higher) on the Solutions Enabler CD-ROM. The installation process for the software is described in the EMC Solutions Enabler Installation Procedures Product Guide. Use and administration of the software is described in the EMC Solutions Enabler SYMCLI Base Component Product Guide. Contact EMC Corporation to obtain the software and its documentation.