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
firsttime, a special version of filesys.dat must be created so that HDM will recognize that the file is
correct.
Itis 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 the directories where the logs are stored be placed on file systems that are mirrored
and have low latencies. Also, the log files defined in theconfig.dat must exist before the HDM is
run. Simply use thetouch 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
Thebasic configuration file, config.dat, is a text file that defines the configuration of an HDM server.
It is recommended that the file be kept in the directory/var/hpss/hdm/hdm<id>.
Thefile consists of a series of lines, where each line defines one parameter. The first field on the line
specifies the name of the parameter and the second field is the value for that parameter. The first
linein the file must define ServerID. The following lines define the rest of the parameters. 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
configurationfile. Once ServerID has been established, it should not be changed because it is used
during event recovery whenever HDM is restarted. A good choice forServerID is 1, since this is
the default used byhdm_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
[...]
Referto the template file, /opt/hpss/config/templates/hdm_config.dat.template when constructing
aconfig.dat file.