Command reference, Plock | HP Process Resource Manager (PRM)

A Command reference

This chapter provides an overview of the PRM commands. The PRM commands are:

•prmagt

•prmanalyze

•prmavail

•prmconfig

•prminitconfig

•prmlist

•prmloadconf

•prmmonitor

•prmmove

•prmrecover

•prmrun

•prmsmhconfig

•prm2scomp

•scomp2prm

•srpgen

prmagt

Syntax:

prmagt -V

prmagt [-plock -stop -intervalseconds]

Availability: Only a root user can run the prmagt command.

The prmagt utility is the PRM SNMP read-only agent. It enables SNMP-aware products to collect PRM configuration and usage statistics. Information is updated once per minute or whenever a major configuration change occurs.

NOTE: Secure sites may want to disable prmagt to avoid unwanted information exchange. If prmagt is to be used, it is strongly recommended that it be used only on a trusted internal network protected by firewalls and access controls, due to known issues with the SNMP protocol.

For a listing of the types of information available and an overview of how to access this information, see “Monitoring PRM through SNMP” (page 117).

Table 17 describes the available options.

Table 17 prmagt user options/parameters.

Option	Description
No options	Starts a new prmagt daemon if one is not already running.
-V	Displays version information and exits.
-plock	Locks the agent into real memory. Use this option only on HP-UX versions prior
	to 11i.
	This option is useful when remotely collecting prmagt data for real-time
	indications of system paging.
	If memory is not locked down, the paging activities will cause significant delays
	and the monitoring tool will only get time-out messages.

prmagt 101

Image 101

HP Process Resource Manager (PRM) manual Command reference, Prmagt Prmagt -plock -stop -intervalseconds, Plock

Contents

HP Process Resource Manager User Guide Legal Notice Contents Setting up PRM PRM configuration planningUsing PRM with HP System Management Homepage SMH Using PRM with HP Systems Insight Manager SIM Administering PRM Fine-tuning your PRM configuration Ovpm Command reference 101 Glossary 145 Index 148 New in this edition PrefaceSupported platforms Notational conventions Providing feedback Associated documents Support and patch policies Training Overview What is HP Process Resource Manager? Introduction to PRM commands Why use HP Process Resource Manager? How PRM can improve on standard allocation Standard HP-UX resource allocationBalancing resource use between users Resources managed by PRM Prioritizing resource use for applications Prioritizing resource use between users Isolating resource use for applications and users Limiting resource consumption PRM groups Understanding how PRM manages resourcesHow PRM controls resources What are processor sets? Resource allocationHow processor sets work? Processor sets example What are shares? Altered configurationHow shares work Converting shares to percentages Parent, child, sibling, and leaf PRM groups Hierarchical PRM groups Hierarchical PRM groups-Development’s child groups Hierarchical PRM groups-top level How PRM manages CPU resources PRM CPU resource management Example PRM CPU resource management Capping CPU resource use CPU allocation and number of shares assigned Multiprocessors and PRM How PRM manages CPU resources for real-time processesHyper-Threading How HP-UX manages memory How PRM manages real memory resources Example of available memory on a 1024-Mbyte system Available memoryHow PRM controls memory usage Implementation of shares and caps Reducing memory sharesCapping memory use How PRM manages locked memory Isolating a group’s private memory resourcesHow PRM manages shared memory Locked memory distribution Example memory management How PRM manages applications How resource allocations interact PRM’s group assignments at process start-up How PRM handles child processesPattern matching for filenames Opt/specialapps/bin/*GroupS Pattern matching for renamed application processes Precedence of PRM group assignments Prmrun -g GroupA barnone MyfavoriteappBar Phonehome Understanding how PRM manages resources Using multiple configurations PRM configuration planningSelecting a configuration model Budget model configurations Application priority model configurations MEM Quick analysis Identifying resource use Detailed analysis Using prmanalyze to quickly identify resource use Initial configuration based on prmanalyze’s memory report Initial configuration based on prmanalyze’s CPU report#prmanalyze -s command -r mem -p -t summary -1filename 25% Installing PRM Setting up PRMSetting PRM to start automatically at reboot Installing PRM Setting PRM to start automatically at reboot #/opt/prm/bin/prmsmhconfig -c Using PRM with HP System Management Homepage SMHQuick start to using PRM’s SMH interface #ps -efP What PRM tasks are available through SIM? Using PRM with HP Systems Insight Manager SIMConfiguring user authorizations Role PRM administrator Quick start to using PRM’s SIM interfaceHP SIM toolboxes needed for PRM administrator role Role PRM operator #ps -efP Quick start to using PRM’s command-line interface Configuring and enabling PRM on the command line#prmconfig -s -c -fconfigfile #prmconfig -i -fconfigfile #prmconfig -e Configuring PRMPRM configuration file Configuration tips and requirements Reserved PRM groups Specifying PRM groups/controlling CPU resource use Development/Compilers/Fortran Group/CPU record syntax Hier Explained in the section Group/CPU record syntax Adding/modifying PRM groups and CPU allocations Removing groups/CPU allocations Capping CPU resource use Private memory Controlling memory useMemory record syntax #!PRMMEM Megabytes Shared memory Adding/modifying private memory shares/caps #prmconfig -e MEMAdding/modifying shared memory allocations Explained in the section Memory record syntax Removing shared memory allocations Removing private memory shares Isolating private memory for a group Duplicate application records Controlling applicationsMissing applications are ignored Application record syntax See Pattern matching for filenames See Launching a Java program under PRM Adding/modifying an application’s group assignment # prmconfig -k #prmconfig -e ApplRemoving an application’s group assignment # prmmove critapps -g # prmrun criticalapp Launching an application under PRM Launching an application in its assigned group Launching a script under PRMLaunching an application in a user-specified group #prmrun -g sales CustomerOrder Launching a Java program under PRM Specifying PRM usersUser record syntax Prmmove -p $$groupname Displaying netgroup expansions User Adding/modifying a user’s group assignment #prmmove purchasing -u advisor6 Removing a user’s group assignmentExample Changing the initial group of a user Compartment record syntax Assigning secure compartments to PRM groups Explained in the section Compartment record syntax Adding/modifying a compartment’s group assignmentRemoving a compartment’s group assignment Adding/modifying a Unix group’s PRM group assignment Assigning Unix groups to PRM groupsUnix group record syntax Explained in the section Unix group record syntax Removing a Unix group’s PRM group assignment Loading the PRM configuration Checking the configuration file Differences in loads when a configuration is already loaded Loading the PRM configuration with prmconfigPrmconfig Enabling resource managers Enabling specific resource management on the command line Updating the configurationEnabling resource managers with prmconfig #prmconfig -i -fconfigfile -s -c Using prmanalyze to analyze your configuration Fine-tuning your PRM configuration Daily weekly monthly Example Locating system bottlenecks#prmanalyze -r cpu -1 -t hourly -s prmid myacct #prmanalyze -r mem -E -1 -t hourly -s prmid myacct Example High-level views of usage Example Checking for patterns and configuration accuracy#prmanalyze -t weekly -d 16 *.acct98 Jan.acct99 Feb.acct99 #prmanalyze -s prmid -r cpu -p -t daily -x 0 filename Using GlancePlus to analyze your configuration GlancePlus information on PRM Analyzing memory use #ps -ef grep prm2d #prmconfig -L MEM Stop#tail -f /var/adm/syslog/syslog.log grepPIDofcurrentprm2d Var/adm/syslog/syslog.log file Displaying application filename matches Administering PRMMoving processes between PRM groups Bin/b*Bapplications Displaying netgroup expansions#prmlist -a #prmlist Displaying state and configuration information Displaying accessible PRM groups#prmconfig #prmlist -u +prime Setting the memory manager’s polling interval Displaying application and configuration informationSetting the application manager’s polling interval Setting the interval with prmconfig Disabling PRM with prmconfig Resetting PRMResetting PRM with prmconfig Disabling PRM Controlling application logging with prmconfig Controlling memory logging with prmconfigLogging PRM memory messages Logging PRM application messages Displaying user information Displaying groups’ allocated and used resourcesDisplaying available memory to determine number of shares #prmmonitor 30 Displaying current process information Displaying number of cores to determine number of sharesDisplaying past process information #ps -R Others Monitoring PRM with GlancePlusLog global application=prm process dev=disk,lvm transaction Mwa restart scope Protecting the PRM configuration from reboots Automating PRM administration with scriptsPRMCONFIGFILE=/etc/opt/prm/conf/dayconf.prm PRMSLEEP=n Internal copies of configuration files Reconstructing a configuration fileSpecial case of interest Client/server connections PRMINTLAPPL=seconds Backing up PRM files Online cell operations Prmagt Prmagt -plock -stop -intervalseconds Command referencePrmagt user options/parameters Plock Interval seconds Prmanalyze -s command -r cpu -t summary /var/adm/pacctStop Fconfigfile Auto uid gid command prmidPrmanalyze options/parameters Disk mem cpu Conflict Summary conflict hourly daily weekly monthlyHourly Daily , weekly , monthly Dresourcedensity Prmavail Prmavail -p -f CPU Disk MEMMminimumduration Xexcludevaluekey Configfile-i -k -s -c Prmconfig user optionsPrmconfig root user options Iintervalmanager Configuration lock already held by %sManager Prmconfig -r to reset Prminitconfig -a -r -hLmanager logarg Mmode Group Prminitconfig options/parameters Prmloadconf root user options Prmloadconf Prmloadconf -fconfigfilePrmlist user options Prmmonitor user options/parameters Differences in output from prmmonitor and topResource Interval Prmmove user options/parameters Prmrecover Prmrecover resourcePrmrecover user options/parameters Prmsmhconfig options/parameters Prmsmhconfig -c -u -hPrmrun -w Prmrun user options/parameters Prm2scomp options/parameters Prm2scomp -pprmpath-sscomppath-iScomp2prm -m -pprmpath Scomp2prm options/parameters Fbasepath Srpgen options/parameters PRM options in HP-UX commands HP-UX command/system call supportHP-UX commands/system calls that support PRM groups Structure of PRM’s Snmp data prmReadOnly Monitoring PRM through Snmp Using OpenView’s snmpwalk Accessing PRM’s Snmp data #/opt/prm/bin/prmagt Using OpenView’s xnmbrowserStart xnmbrowsesr #/opt/OV/bin/xnmbrowser Enter public in the field Community Name Navigate to the PRM’s data by following the hierarchy Monitoring PRM through Snmp Graphing resource usage Monitoring PRM through Snmp Databases/inventory PRM groups in xnmbrowser graphDatabases/order Mailserver Creating Secure Resource Partitions SERVICECMD0=/opt/prm/bin/prmrun -g mathdeptapplication Using PRM with Serviceguard EOF1 PRM and Virtual Machines Using PRM with HP Integrity Virtual Machines Prmmonitor error messages PRM error messagesPRM is not configured PRM resource managers disabled Prmconfig error messages Message PRM is disabled and not configured Message Cannot display configuration. PRM is not configuredMessage The -i and -k options cannot be used together -f option requires an argument Unrecognized keyword argument for -M option Prmconfig command-M option requires a keyword argument Prmmove error messages Requires users to be specified by login names Could not find group %s in configuration fileRequires that PRM be configured User %s does not have permission to move process %d Prmrun error messages Users Path environment variable is empty Could not launch application %s in group %sperrorApplication file %s does not exist Application file %s is empty Prmlist error messages Could not find user %s in the configuration file Could not find group %s in the configuration fileCould not find full path of application %s Please specify only one -s option Prmrecover error messages Prmloadconf error messages Prmavail error messages Prmanalyze error messages Unable to open temp file %s Unable to create temp file in /tmpFile format with acctcom Unable to read event temp file %s Prmagt error messages Alternate group Glossary Others group UID CPU Index Syntax, 111 prmrecover Index NIS Index 153 Index