Installation

AFS(R) Installation Instructions

This section contains the instructions for tailoring the parallel operating

environment for execution with the AFS file system. The source files settokens.c and gettokens.c are intended to be used with Transarc's Kerberos Authentication program, but should be usable as a guide for other environments.

The files needed for setting up the AFS execution are in the /usr/lpp/ppe.poe/samples/afs directory. They are:

README.afs

README file that contains much of the same information in this section

gettokens.c

Subroutine to get an AFS token on the node where the user is logged on (or already authenticated)

settokens.c

Subroutine to put an AFS token on the remote node that is running the user's executable

makefile

Makefile for creating object modules from settokens.c and gettokens.c

buildAFS

Sample shell script for replacing the routines settoken and gettokens distributed with POE by the routines built by the makefile

Setting UP POE for AFS Execution

Perform the following procedure as root for setting up POE for AFS execution:

ENTER

cd /usr/lpp/ppe.poe/samples/afs to switch to the appropriate directory or copy the contents of the directory to a convenient location.

ENTER

the make command to create the files settokens.o and gettokens.o from gettokens.c and settokens.c. If you are not using the Transarc system, you may need to alter these routines to provide the desired token access. The calling sequence of the parameters cannot be changed.

VERIFY

that the partition manager daemon, pmdv3, the home node partition manager, poe, and the parallel debugger, pdbx, are in /usr/lpp/ppe.poe/bin. If not, modify the buildAFS script.

Note:

Before completing the following step, ensure that you have the following amounts of available space in the current directory:

Component(s) Being Built	Total Available Space Required (in Megabytes)
pdbx, pmdv3, poe	2

ENTER

buildAFS to create new versions of pdbx, pmdv3, and poe in the current directory. If the linking step fails, locate the libraries containing the modules that were not found, and alter the library search list in buildAFS to include them.

MOVE

pdbx, pmdv3, and poe to their usual location in /usr/lpp/ppe.poe/bin on each node. You can rename the old versions in case they need to be restored. Make sure that they are made executable.

You should not have to modify your program executables. You can now pass AFS authorization across the partition.

The .rhosts file in the user's home directory must include the nodes that are intended for Parallel Operating Environment use. This ensures that the proper access is permitted.