PM/Agent over UDP protocol Test Procedure

1. Loopback test
   Issue the following commands:

   $ cd /opt/score/sbin
   $ ./rpmtest comp0 udp -iter 10000 -dest 0 -ping
   	Success: Two numbers similar to "8     0.000233266" are printed
                    The first number is the data size (in bytes)
                    The second number is the latency (in seconds)
   	Failure: Error and dump messages are printed
   

   If this test fails, read the Troubleshooting section.

2. Point-to-Point test
   Issue the following commands:

   $ cd /opt/score/sbin
   $ ./rpmtest comp1 udp -reply
   

   Issue the following commands in another window on the server host:

   $ cd /opt/score/sbin
   $ ./rpmtest comp0 udp -iter 10000 -dest 1 -ping
   	Results should be the same as the loopback test
   

   When the test finishes, do not forget to kill the pmtest process on the server host because the process is in an infinite loop.
   If this test fails, read the Troubleshooting section.

   Note that, on PM/Agent/UDP, you have to kill and restart the ``pmtest...-reply'' process each time before running ``pmtest...-ping'', if you try ``pmtest...-ping'' repeatedly.

Troubleshooting

Loop back test fails.

• The network interface of the host is not configured correctly.
• If the message ``pmOpenDevice: No such file or directory'' is displayed, please set environment variable ``PM_DEBUG'' to 1 (i.e. if you are using the Bourne shell, please execute ``PM_DEBUG=1; export PM_DEBUG'', or, if you are using csh, please execute ``setenv PM_DEBUG 1''), and run pmtest again.
  If the message ``pmOpenDevice/agent: unit N: missing -agent option'' is displayed, ``-agent pmaudp'' setting is missing in scorehosts.db.
  If the message ``pmOpenDevice/agent: cannot connect unit N, agent command agent_command: No such file or directory'' is displayed, the ``agent_command'' argument of ``-agent'' option is misspelled. This argument should be ``pmaudp''
  If the message ``pmOpenDevice/agent: unit N: configuration file is not specified'' is displayed, ``-config configuration_file'' setting is missing in scorehosts.db.
  If the message ``pmOpenDevice/agent: unit N: configuration file config_file: No such file or directory'' is displayed, the config_file (e.g. pm-udp.conf) does not exist.
• If the message ``pmOpenDevice: Device or resource busy'' is displayed, some other processes using PM/Agent exist on the host.
• If the message ``pmOpenDevice: Invalid argument'' is displayed, please set environment variable ``PM_DEBUG'' to 1 (i.e. if you are using the Bourne shell, please execute ``PM_DEBUG=1; export PM_DEBUG'', or, if you are using csh, please execute ``setenv PM_DEBUG 1''), and run pmtest again.
  If the message ``missing node number NODE in configuration file'' is displayed, the node number NODE is missing in configuration file.
  If message ``missing myself in configuration file'' is displayed, the host is not described in the configuration file.

Point-to-point test fails.

• If the message ``pmReceive: Connection timed out(110)'' is displayed, it is possible that ``./rpmtest...-ping'' was invoked repeatedly without restarting ``./rpmtest...-reply''. If so, this is normal and there is no problem. On PM/Agent, The process ``./rpmtest...-reply'' should be killed and restarted before invoking ``./rpmtest...-ping''.
• The node number specified using the -dest argument is different from the configuration file.