SAS Scalable Performance Data Server 4.5, Administrator'S Manual

Page: 149 / 271

Start Performance Server from Command Line
You can start the SPD Server Performance Server from a UNIX command line. SPD Server
and the SAS Management Console applications must be running before you start the
Performance Server. If SPD Server must be restarted, the SPD Server Performance Server
must also be shut down and restarted after SPD Server is restarted. The Performance Server
utility is not compatible with SPD Server releases that preceded SPD Server 4.4.
Usage:
spdsperf -g SMA -n NSP -s SNP -p PLP -l LOG [-i SEC] [-c CNT]
where
• SMA is the shared memory address for the SPD Server Global Control Block (GCB).
The GCB is an internal SPD Server data map that contains all of the options that are
passed to the SPDSBase server when it starts. To get the value for the GCB address,
SPD Server must be started. After the SPD Server Name Server starts the first
SPDSBase process, issue a UNIX
ps command and look in the output to view the
address parameters that were passed to SPDSBase. The GCB shared memory address
should be found in the
ps output data.
• NSP is the process-ID number of the SPD Server Name Server whose family of
spawned processes you want to monitor
• SNP is the process-ID number of the SPD Server SNet server.
• PLP is the listening port number that SAS Management Console will use to contact
the Performance Server
• LOG is the path specification that you want to write the profile log to.
• SEC is the optional property that specifies the number of seconds that transpire between
instances of performance monitoring data captures. The permissible range for SEC
property values is integers that are greater than or equal to 1, and less than or equal to
the declared SPD Server MAXINT value.
• CNT is the optional property that specifies the count, or number of performance
monitoring data captures that you want the Performance Server to take. The permissible
range for CNT property values is integers that are greater than or equal to 0, and less
than or equal to the declared SPD Server MAXINT value. A CNT value of 0 requests
an infinite number of data captures.
Start Performance Server from Rc.perf Script
You can also start the SPD Server Performance Server by calling the rc.perf script during
start-up. The next section contains a rc.perf script that you can cut and paste into an editor
of your choice, and customize for use with your SPD Server installation. SPD Server 4.4
also ships with a sample
rc.perf script that you can modify. The sample rc.perf script is
located in your SPD Server installation folders at:
.../samples/perfmon/rc.perf
Either example file can be used to create your custom rc.perf script.
You must make the following changes when you customize your version of the rc.perf
script:
1. The sample script below uses the default SPD Server installation path of
usr/local/
spds
If your SPD Server installation uses a custom path, you must update the INSTDIR path
settting to update your installation path setting.
Start Performance Server from Rc.perf Script
143