Peach

Version 0.86

• Home
  
• Installation
  • Source code
  • Install
  • Configure
  • Upgrade
    
• Administration
  
  • Runtime
    
  • pserv
  • pjobd
    
• User guide
  • Getting started
  • pview
  • psubmit
  • plist
  • pkill
    
• Help
  
  • Compatibility
    
  • FAQ
    
  • Feedback
• History
• Contributors
• References

Pview

Usage: pview

Requires: password access

An operational Peach system can be monitored and to limited extent managed using the program pview. As with other Peach commands, pview requires a password from the user for access. The program is launched without options.

Once pview is launched, it displays four lists:

• A list of jobs being processed
• A list of jobs on a queue waiting to be processed
• A list of responding job daemons
• A list of completed jobs of the owner running pview
  

The user can issue key codes to do several tasks:

• k: kill a job - requires the job id number of the job to kill. (Multiple jobs can be killed, for example kill 1-9)
  
• n: notify of job completion - requires a job id number.
• x or q: exit program.
• ? or h: display help menu.
• 1-5: Toggle lists
• j: Toggle job information (full/disk/path/file)
• p: Toggle pjobd information (normal/extra)
  
• c: clear jobs from completed jobs list - requires the job id number or "all".
  

An administrator has more options to manage the system:

• r: restart a job daemon or the server - requires a job daemon number or "all".  This will restart a job daemon without affecting the jobs it is running. If the job daemon fails the secuirty check, an asterisk '*' will be prepended to its Hostname.
• s: shut down a job daemon or the server - requires a job daemon number or "all" or "server".  This will kill of any jobs running on the computer on which the job daemon is shutdown.
  
• w: make a job daemon wait a number of minutes - requires two values: a number  of minutes and a job daemon number.
• f: force a job daemon to execute a job within a number of minutes - requires two values: a number  of minutes and a job daemon number.
• t: target a job to a specific job daemon - requires two values: a job number and a job daemon number.
• u: upgrade a job daemon - requires a job daemon number. This upgrades a job daemon without affecting the jobs it is running.  The upgrade can also be used when a computer has been upgraded, for example adding of new memory, to update the pjobd configuration file.  If the job daemon fails the secuirty check, an asterisk '*' will be prepended to its Hostname.
  
• b: broadcast a message by e-mail to all users - requires a text message.
  

Glossary of Pview

• Job Processing List - Jobs on the job processing list are jobs that are currently being processed by the computer listed in the LOCATION column.
  
• ID (job)- This refers to the Job ID number.  Use this number when killing the job.
• OWNER - This refers to the owner of the job.
• JOB_PATH - This refers to the path of the job relative to the user's shared disk directory.  Can be toggled by pressing j key.
• LOCATION - This refers to the job daemon which is processing the job.
  
• WORKTIME - This refers to the actual time (as opposed to wall time) taken to process the job so far.
  
• Job Queue - Jobs on the job queue are jobs that have not yet been submitted to any of the computers for processing.
  
• ID (job)- This refers to the Job ID number.  Use this number when killing the job.
• OWNER - This refers to the owner of the job.
• JOB_PATH - This refers to the path of the job relative to the user's shared disk directory.  Can be toggled by pressing j key.  This column also includes any requirements of the job specified by the user such as the operating system and memory size.
• QUEUE_TIME - This refers to the wall time the job was queued.
• Job Daemon Status List - This lists displays information from each Job daemon running on the network. Can be toggled by pressing p.
  
• ID (job daemon) - This refers to the Job Daemon ID number.
• HOST - This displays information about the host of the job daemon.
  
• USERS - This refers to the total number of users of the computer.
• CPU% - This refers to the total percentage of CPU usage.
• MEM% - This refers to the total percentage of memory usage.
• #PROC - This refers to the number of processors on this computer.
• SPD - This refers to the clock speed of the CPU in GHz.
• MSIZE - This refers to the memory size in Gb.
• #JOBS - This refers to the number of jobs being processed on the computer.
• STATUS - The status tells whether the computer is free to accept jobs or if the computer is busy due to interactive work (busy(INT)) or due to it having the maximum number of jobs (busy(MAX)).
• UP_TIME - This refers to how long the job daemon has been running.
• VER# - This refers to the job daemon version number (for administrative purposes only).
• IP_ADDRESS - This refers to the IP address of the job daemon host computer.
• OS - This refers to the operating system running on the job daemon host computer.
• SHARED_DISKS - This refers to all currently available shared disks on the job daemon host computer.
  

Legend:

• * - indicates job daemon failed security check during restart/upgrade attempt.
  

---

Bernard Heymann 20080922