Getting started with Peach

Every user must be registered with the Peach system to access and use it. The administrator must set up an account for the user with the same user and group ID's as accounts on the computers that participate in the system. However, the user does not need to have an account on every machine. One setting required for csh-users that need to be set correctly, is symlinks = ignore.

To use the Peach programs, the PEACH environmental variable must be defined and the Peach directory must be in the executable path list:

setenv PEACH /disk1/Peach
setenv PATH $PEACH:$PATH

Peach is designed to handle multiple single-processor tasks. The user can submit:

A single command line to run a program as a single process
A single script to run multiple commands as a single process
A script that submits multiple command lines or scripts, each a single process

The user can see what is happening to the jobs using the pview program.

Examples

A simple command

Change to a directory on the shared disk with appropriate read and write permissions. Type in the following single command line:

psubmit echo Hello World

Within a few seconds, three new files should appear:
echoHelloWorld.pl
echoHelloWorld.pl.STDERR
echoHelloWorld.pl.STDOUT

The first is the command line converted into a Perl script with the appropriate environment and the object actually submitted to the Peach system. The other two files contain the output usually displayed to the shell, plus some extra information.

To monitor what is happening, use the pview command. Type:

pview

and give the password. Some server information and four lists are displayed, indicating the

A script to submit multiple tasks

Change to a directory on the shared disk with appropriate read and write permissions.

Create a script called HelloWorld:

#!/usr/bin/perl

for (1..2) {
    print `psubmit echo Hello World $_`;
}

Change the file permissions:

chmod 700 HelloWorld

Type in the following single command line to submit the multiple tasks:

psubmit HelloWorld -ss

Submitting program command lines with options which coincide with psubmit options

For example if the user wants to psubmit the following command line:

testProgram -ss

The "-ss" option concides with psubmit's -ss option.

To avoid any complications, type the following single command line:

psubmit "testProgram -ss"

Back to Main Page

Updated 2005-02-10, Peter Leong
Updated 2004-11-30, Peter Leong and Bernard Heymann