The WHAM DRM3 is a performance measurement and analysis tool that collects AIX generated metrics as well as those that it creates from within the AIX kernel. This tool is non-intrusive in that it uses very little of the system resources to make and collect the measurements and it requires no relinking or compilation of any applications. This means that it will deliver a consistent set of metrics about your application as well as any third party applications you may be using. There are four image directories, choose the one corresponding to your version of AIX. There are three installp images in each directory. They are whamtools.drm.agent -- The component that makes the measurements whamtools.drm.monitor -- The component that collects and analyzes them whamtools.drm.hist -- The component automates collection and analysis The agent consists of a pair of kernel extensions and a user level daemon, the drmd. The drmd must be running for data to be made available to the monitor. The monitor may be installed on a system other than the one(s) to be measured. The monitor facilitates the collection of the data from the agent(s) as well as supporting analysis of the data. The monitor has a GUI from which data can be collected and stored for later analysis or may be viewed live. The agent must be installed on any system that is to be measured. INSTALLATION INSTRUCTIONS FOR DRM3 AGENT To install the agent you will need to first install the dce client runtime software from the AIX 4.3.2 bonus pack. The specific dce component is dce.client.core.rte 2.1.0.0 You will find ptfs for this on the regular distribution CD for AIX but not the original fileset which this is and must be installed prior to adding any of the ptfs. There is no need in the DRM for any of the ptfs. Since the dce component is on another CD you will want to install it using smit and that CD. Assuming you have that software installed, then you should copy the whamtools.drm.agent file to /tmp on your system and then issue the following commands as the root user # cd /tmp # rm .toc # installp -aXFd whamtools.drm.agent whamtools.drm.agent After the installation is complete, do the following # cd /usr/lpp/whamtools/drivers # ls -l The output should be similar to this -r-xr-xr-x 2 root system 30233 Aug 25 10:31 perf.ext -r-xr-xr-x 1 root system 2059 Aug 25 10:31 perf.load -r-xr-xr-x 2 root system 30233 Aug 25 10:31 perf_ppc.ext -r-xr-xr-x 1 root system 30349 Aug 25 10:31 perf_pwr.ext -r-xr-xr-x 2 root system 46807 Aug 25 10:31 wrap.ext -r-xr-xr-x 2 root system 46807 Aug 25 10:31 wrap_ppc.ext -r-xr-xr-x 1 root system 45845 Aug 25 10:31 wrap_pwr.ext If the perf.ext and wrap.ext entries don't exist, they must be created depending upon the architecture type of the system on which the software has been installed. If they already exist, skip this step and drop down to starting the measurements described below. If the system is old and is a Power Architecture system then do the following # ln perf_pwr.ext perf.ext # ln wrap_pwr.ext wrap.ext Otherwise do the following for PowerPC and Power3 architecture systems # ln perf_ppc.ext perf.ext # ln wrap_ppc.ext wrap.ext You are now ready to enable measurements by starting drmd this can be done by the following # /usr/sbin/drmd At this point you will be instructed to contact WHAM for licensing info and so follow the directions provided in here for obtaining a trial license. INSTALLATION INSTRUCTIONS FOR THE DRM3 MONITOR To install the monitor, the dce client software must be installed as described in the agent installation procedure above. The monitor installp image is whamtools.drm.monitor Copy it to /tmp as above and install it with the same command except substitute monitor wherever there is agent. There is no additional configuration required for the monitor after it is installed and it may be started by typing drm.gui DOCUMENTATION We have provided a quick start guide on the DRM3 in this package and it is named quickstart.pdf. The User's Guides for DRM and CDC are also contained on this cd. They are located in the DOCS directory. LICENSING AND CONTACT INFO If you would like to get more information about WHAM's performance products, consulting or training solutions please visit our web site at www.wham.com or contact Mike Shell at (512) 345-9925 ext. 107 or mshell@wham.com. Also, contact Mike if you would like to use the DRM3 on this CD for a free trial period.