Hub/Switch Installation Guide

Chapter 7 HPSS User Interface Configuration
HPSS Installation Guide September 2002 449
Release 4.5, Revision 2
The fifth file (filesys.dat) is automatically updated by HDM as new aggregates and filesets are
created. Therefore, this file should not ordinary be edited by the administrator. HDM cannot be
started if this file is missing or does not contain correct information. Before starting HDM for the
first time,aspecialversion offilesys.dat mustbe createdsothatHDM willrecognize thatthefileis
correct.
It is possible to run multiple instances of HDM on one machine. For example, one HDM might be
used to handle mirrored aggregates, while another might be used to handle archived aggregates.
To set up a system in this manner, be sure to keep the associated configuration and log files in
separate directories. For example, /var/hpss/hdm/hdm1 and /var/hpss/hdm/hdm2.
Since logs necessary for HDM are heavily used and vital, it is recommended that configuration
directoriesand thedirectories wherethelogsare storedbeplaced on file systems that aremirrored
and have low latencies. Also, the log files defined in the config.dat must exist before the HDM is
run. Simply use the touch command to create these files if they do not exist already. For XFS, an
additional file, nshandle.dat, must also exist before the HDM is run. Create it using the touch
command.
7.6.3.3.1 config.dat File
Thebasicconfigurationfile,config.dat,isatextfilethatdefinestheconfigurationofanHDMserver.
It is recommended that the file be kept in the directory /var/hpss/hdm/hdm<id>.
Thefileconsists ofa seriesof lines,whereeach linedefines oneparameter. The firstfieldon the line
specifies the name of the parameter and the second field is the value for that parameter. The first
lineinthefilemustdefineServerID.Thefollowinglinesdefinetherestoftheparameters.ServerID
must begin in column one, while the other parameters must be indented by at least one tab
character. The file may contain comments that start with a ‘#’ character and continue until the end
of the line.
ServerID is an arbitrary number used to distinguish different HDM servers defined in the
configuration file. Once ServerID has beenestablished, itshould notbe changed because it is used
during event recovery whenever HDM is restarted. A good choice for ServerID is 1, since this is
the default used by hdm_admin. HDM can be started with the command:
hdm_admin start /var/hpss/hdm/hdm<id>/config.dat <ServerID>
where ServerID is a number identifying which part of the configuration file HDM should read.
Following is an extract from a typical configuration file:
# An example HDM configuration file
ServerID 1
DescName Production configuration
RegisterBitMap 0.0 #A comment
[...]
Refertothetemplatefile,/opt/hpss/config/templates/hdm_config.dat.templatewhenconstructing
a config.dat file.