update_net_data_headers(1)
NAME
update_net_data_headers - Update some fixed header values in all net
performance data files with the values from the configuration file
SYNOPSIS
update_net_data_headers |
[Option [...]] ConfigurationFile |
DESCRIPTION
The script update_net_data_headers updates some fixed header values in
all net performance data files with the values from the configuration files.
This is especially useful when you made a change to a configuration file.
Please note that these fixed header values are mainly added for the sake of the
Web presentation; they play no role during the net performance measurements.
Most fixed headers are not dependent from the data file, however, some are used
for the description of the current data file.
The latter ones are not directly dependent from the configuration file,
but they may depend from some directives of the configuration file.
The fixed headers are described in more detail in the
FIXED HEADERS section.
Note: please see also the WARNING
section.
FIXED HEADERS
Below the fixed headers are described who are updated by this script.
When the value of a fixed header is derived from a configuration directive, the
name of the configuration directive is placed between [...]
after the header name.
The configuration directives are described in more detail in the sample
configuration file config.mk.
See the FILES section.
- set_title [HOSTS_TITLE]
- Contains the title of the hosts set for which the network performance tests
are executed.
- one_direct [ONE_DIRECT]
- Do the network performance tests only in one direction when its value is
true; do the tests in two directions when it is
false.
- use_qos [USE_QOS]
- Do also Quality-of-Service tests when this flag is true; when it
is false, only tests along the "usual" Internet route are
performed.
- qos_title [QOS_TITLE]
- The title used above the QoS results.
- inet_title [INET_TITLE]
- The title used above the results of the "usual" Internet route.
It is only used when there are also QoS performance tests performed.
- period [PERIOD]
- The period in minutes between two performance tests.
- file_type
- The type of the current net data file.
It is not dependent from the configuration directives and is therefore not
influenced by this script.
- file_id
- The ID of the file when there are more files from the same type.
In general it is the number of the week, month or quarter represented in the
data file.
It is not directly directly dependent from the configuration directives and
is therefore not influenced by this script.
OPTIONS
The following options can be specified:
- -skip Header
- Skip the specified header with its corresponding content from the data
files.
This option may be multiple specified.
FILES
- InstallRoot/config/config.mk
- Sample configuration file from this package which serves as an example for
the installation of the network performance tests between a set of hosts.
The configuration directives are described in more detail in this file.
The directory InstallRoot is the directory you used to install
this package.
It is the root directory from the distribution archive.
WARNING
When you make a mistake this script may corrupt your data files.
Therefore, it is a save procedure to backup the data files prior to
running this script.
For instance you can make a gzip(1) compressed
tar(1) archive of the data root directory with the following
command line which should be substituted from the directory one level higher:
% tar -cvf - data | gzip -cv > data.tar.gz
SEE ALSO
gzip(1),
sed_net_data(1),
tar(1)