|
In order for PVM and ZFEM to work properly some environment variables have to be defined in the .cshrc file in the user's home directory (in all the hosts to be used):
setenv PVM_ROOT /location/of/pvm setenv PVM_ARCH `$PVM_ROOT/lib/pvmgetarch` set path=($path $PVM_ROOT/lib) set path=($path $PVM_ROOT/lib/$PVM_ARCH) set path=($path /location/of/zfem/executables/$PVM_ARCH)
If several computers are to be used simultaneously, it must be possible to execute an rsh command from any of them into any of the others with no password. If this is not possible, try creating a .rhosts file in the user's home direcotry with the ip address of all the desired machines. If it still does not work contact your system administrator.
The list of machines to be used must be supplied to the PVM deamon. This is done by listing all the machines in a hostfile. For example:
*dx=/location/of/pvm/lib/SGI5/pvmd3 ep=/location/of/zfem/bin/SGI5 local1.host.here local2.host.here *dx=/location/of/pvm/lib/SGI64/pvmd3 ep=/location/of/zfem/bin/SGI64 remote.host.here
Here three machines are included. The first two share the file system, therefore a unique deamon executable (dx) and path to the executables (ep) are provided. The last computer is located somwhere else and does not share the file system with the previous two. Furthermore it has a different operating system, therefore a new dx and ep must be provided.
Refer to the PVM documentation for further information.
Before starting ZFEM, the PVM deamon must be running with the proper hostfile. To start the deamon (in the background) type:
% pvmd hostfile &
To check the configuration of PVM, type:
% pvm (to enter the PVM console)
pvm> conf (this will list all the machines available as well as some
other information for each host)
pvm> quit (this will exit the PVM console while leaving the deamon
running)
To stop the PVM deamon, type:
% pvm (to enter the PVM console) pvm> halt (this will quite the console and stop the deamon)
Once the PVM deamon is running with the correct hostfile, to run zfem simply type:
% zfem2
The command usage is:
zfem2 [-e script][-n][-s][-r][-c][-h]
-e file: execute a script file -n : do not save actions to zfem_script file -r : do not read/save master resources -s : silent run -> no information messages in the console -c : compact script before exit -h : print the command line usage and stop
To start the lite version of ZFEM it is not necessary to perform any of the PVM setup described in the previous section or to start the PVM deamon as described above. Just run the executable:
% zfemLite
When zfem is launched it looks for a resource directory called .zfemrc in the home directory of the user. If the directory is found it tries to read some customization files from it, which contain information about the number of viewers running, the position and size of the windows, etc. If this information is found, it re-launches the viewers and re-sizes and re-positions the windows accordingly. If the user desires to avoid this behavior zfem must be launched with the -r option in the command line.
When zfem is stopped the status of the windows is saved to the resource files. These files contain some extra information such as the browser to use to read the HTML documentation. These resources can be changed by editing the files.
Similarly zfemLite saves its resources to a directory called .zfemLiterc in the user's home directory.
To stop ZFEM (an all the modules) press the "quit" icon in the tools window. A confirmation dialog will popup before exiting the application:
Or simply press CTRL-C in the console where ZFEM was started (to send an INTERRUPT signal to ZFEM, which can also be accomplished through the command kill -2). Do not try to kill zfem2 directly because other processes could continue to run (such as viewers, workers, etc.)