Job Management Partner 1/Performance Management - Agent Option for Platform Description, User's Guide and Reference
- Organization of this subsection
- (1) Executing the data collection command
- (2) Checking the operation details
- (3) Collecting error information
- (4) Collecting other information
- (5) Performance data information
(1) Executing the data collection command
To collect data for investigating the cause of the error, you use the jpcras command. The procedure for executing the data collection command is described below. Note that the operations explained here must be executed by an OS user who has the root user permission.
- Log on to the host on which the service for which the data to be collected is installed.
- Specify the data and the storage destination directory for the data to be collected and execute the jpcras command.
To use the jpcras command to store all of the data that can be collected in the /tmp/jpc/agt directory, specify as follows:
The data collected by the data collection command is stored in the specified directory in compressed format by the tar command and compress command. The file name is as follows:
jpcras /tmp/jpc/agt all all
jpcrasYYMMDD.tar.Z
Year, month and date are placed in YYMMDD.
When the jpcras command is executed, the jpctool service list -id * -host * (jpcctrl list * host=*) command is executed internally to obtain a list of PFM services and to confirm whether the services are running. Execution of this internal command might take a long time if a firewall exists between the host that executes the command and a host in another Performance Management system or if the system configuration is large. In either case, you can set the JPC_COLCTRLNOHOST environment variable to 1 to suppress processing of the jpctool service list -id * -host * (jpcctrl list * host=*) command to shorten the command execution time.
For details about the jpcras command, see the chapter explaining commands in the manual Job Management Partner 1/Performance Management Reference.
(2) Checking the operation details
Check the operation that was taking place when the error occurred and record it. You need to check the following information:
- Operation details
- Time at which the error occurred
- Machine configuration (including each OS version, host name, and the configurations of PFM - Manager and PFM - Agent)
- Whether the error can be reproduced
- Performance Management user name used for logon if the user logged on from PFM - Web Console.
(3) Collecting error information
The following types of error information must be collected:
- Messages output to the console if the error occurred during command execution
(4) Collecting other information
The following types of information must also be collected:
- The argument specified for the command if the error occurred during command execution
(5) Performance data information
You also need to collect the following information related to performance data. The following table lists the information related to performance data to be specifically collected by PFM - Agent for Platform, depending on the installation environment.
Table 8-6 Performance data information
Collected item Command Can be collected using the jpcras command? AIX HP-UX Solaris Linux Processor information
- lsdev -Cc processor
- lsattr -El proc#
ioscan -fnC processor psrinfo -v /proc/cpuinfo Y System paging space information lsps -a swapinfo -a swap -l
- /proc/meminfo
- free
- /proc/swaps
- procinfo
Y I/O statistics information
- lsdev -Cc disk
- iostat
- lscfg
- lsdev -C disk
- iostat
- /etc/netconfig
- Iostat
- prtconf -D
- lsdev
- iostat
- procinfo
Y Status information for inter-process communication function ipcs -a ipcs -a ipcs -a
- ipcs -a
- ipcs -at
- ipcs -ap
- ipcs -ac
- ipcs -al
- ipcs -au
Y Static information about file system /etc/filesystems /etc/fstab /etc/vfstab /etc/fstab Y Network status information
- netstat -s
- netstat -in
- lsattr -E -l inet0
- /etc/inetd.conf
- netstat -s
- netstat -in
- ioscan -fnC lan
- /etc/rc.config.d/netconf
- /etc/inetd.conf
- netstat -s
- netstat -in
- /etc/inet/*
- /etc/defaultrouter
- /etc/inetd.conf
- netstat -s
- netstat -ni
- ifconfig -a
Y LAN device configuration and status display ifconfig -a lanscan -v ifconfig -a ifconfig -a Y hosts file information -- -- -- /etc/hosts Y NIS configuration file information /etc/netsvc.conf /etc/nsswitch.conf /etc/inet/hosts /etc/yp.conf Y Summary information for file system assignment repquota -a repquota -a repquota -a repquota -a Y Storage information collected by agent agtu/agent/storage.d agtu/agent/storage.d agtu/agent/storage.d agtu/agent/storage.d Y Bit count information for kernel bootinfo -K getconf KERNEL_BITS isainfo -kv getconf LONG_BIT Y Implemented memory size information bootinfo -r grep -i Physical /var/adm/syslog/syslog.log prtconf
- /proc/meminfo
- free
- procinfo
Y System information (OS, version, and model) uname -aoslevel uname -a uname -a uname -a Y Execution level information who -r who -r who -r runlevel Y System time date date date date Y Time zone
- /etc/environment
- /etc/profile
/etc/TIMEZONE
- /etc/TIMEZONE
- /etc/default/init
/etc/sysconfig/clock Y Directory information to be exported onto NFS client
- /etc/exports
- /etc/xtab
- /etc/exports
- /etc/xtab
- /etc/dfs/dfstab
- /etc/dfs/sharetab#
- /etc/rmtab#
- /etc/exports
- /var/lib/nfs/xtab
Y Workgroup monitor settings information agtu/agent/wgfile agtu/agent/wgfile agtu/agent/wgfile agtu/agent/wgfile Y Event file monitor settings information agtu/agent/evfile agtu/agent/evfile agtu/agent/evfile agtu/agent/evfile Y Installed software information lslpp -L all swlist pkginfo
- rpm -qai
- rpm -qa -last
Y OS patch information instfix -a
- swlist -l patch
- what /stand/vmunix
showrev -a
- rpm -qai
- rpm -qa -last
Y OS setup information
- /usr/bin/ls -l /unix
- /usr/bin/ls -la /usr/lib/boot
-- -- -- Y Process list -- -- /bin/ps -elfZ (Solaris 10 only) -- Y Solaris zone information -- -- /usr/sbin/zoneadm list -cv (Solaris 10 only) -- Y
- Legend:
- Y: Can be collected
- --: Not applicable
- #
- When the zone functionality is used in Solaris 10, this information cannot be collected in a non-global zone environment.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.