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)