The overwhelmingly most common problem in getting set up in the new system is getting the environment set up. The new user must add some items to his .cshrc or .zshrc resource files. This is described in Section-2.3 of the User's Guide; read it again.
There are a few environment variables which must be set for
the system to work:
AFS_HOME
ZOSTYPE
ZARCH_TYPE
ZEUS_BASE_ROOT
ZMAKEDIR
Check their settings by issuing a printenv command.
The other thing that must be set properly is the PATH variable. The ZSMSM setup procedures define this for the user, and they provide a standard mechanism for the user to add his own directories to the path. If the user overrides the PATH variable, the system has little chance of working.
Home Directories:
Many users have a home directory on ZOW which is different than their AFS Home
directory. This is usually set also as the home directory on the ZARAHs.
This is still workable, but the user must replace his .cshrc
or .zshrc resource file in this ZOW/ZARAH Home directory with one
similar to the one used in his AFS Home directory.
This is described in some detail in Section-2.3 of the User's Guide.
However, it is more advisable to have the ZARAH Home directory respecified
to be the AFS Home directory. (Send E-Mail to the ZARAH crew.)
There are a number of simple failures of running Make, which have
equally simple solutions.
The most common failure is to execute a version of Make which is not
GNU Make.
This situation will manifest itself by make giving you an error
message like one of the following:
make: Fatal error in reader: makefile, line 92: Unexpected end of line seen ...missing separator...
To find out from where you are getting the command make, type which make. If this is GNU Make, it will respond to the command make --version with some Copyright information from FSF. Also, if the version is less than 3.74, you will need to upgrade it.
The ZSMSM setups should give you GNU Make when you type make. If this is not what you are getting, then you have probably altered the PATH variable in a way that has broken ZSMSM.
Another common make failure results in the following message:
cannot get /basic.make for including.This means that the ZMAKEDIR environment variable is not set. Check the initialization of ZSMSM again.
To include header files (sequences) from various ZEUS libraries, one must add
the inc directory for that library to the search-path for include-files.
For example, if you want to include some header file from Phantom,
you would need to add this line in your eaze_job.make:
FPPFLAGS += $(PHANTOMINCS)
There is one of these definitions for each ZEUS project library;
see the
Project Definitions document .