The Option Definition File contains an environment definition file that the Trend Viewer uses for the following analyses:
Subnetwork-specific analysis
Specific-subnetwork exclusion analysis
Specific-URL access exclusion analysis
The Option Definition File is a text file. To create or edit the file, use a text editor such as Notepad. The path of this file is shown below:
[Windows]
<Variable file storage directory>\control\OptionConfig |
[UNIX]
/etc/opt/FJSVssqc/OptionConfig |
A sample Option Definition File is stored in the folder shown below during installation. The user can edit the sample file to create an Option Definition File.
[Windows]
<Installation directory>\sample\OptionConfig |
[UNIX]
/opt/FJSVssqc/sample/OptionConfig |
Character codes are as follows:
[Windows]
ASCII |
[UNIX]
ASCII |
The Option Definition File consists of the following definition blocks:
Subnetwork-specific analysis definition block (one block)
Specific-subnetwork analysis exclusion definition block (one block)
Specific-URL analysis exclusion definition block (one block)
The overall image within the file is as follows:
Subnetwork-specific analysis definition block Specific-subnetwork analysis exclusion definition block Specific-URL analysis exclusion definition block |
The coding format of Option Definition File is shown below:
Line coding format | Description |
|---|---|
[xxxxxxxxxx] | Indicates the beginning of a definition block as well as the end of the previous definition block |
xxxx = xxxxxxxxxx | Indicates parameters in a definition block. |
none | A null line is treated as a comment. |
# xxxxxxxxxx | A line beginning with '#' is treated as a comment. |
The user may want to use the Trend Viewer to perform analysis for each subnetwork that is a group of IP addresses. If so, the user can define the name of the subnetwork to be analyzed in the subnetwork-specific analysis definition block.
The format of the subnetwork-specific analysis definition block is shown below:
Format
[SubnetName]
subnet-region=subnet-name
Explanation
[SubnetName]
Indicates the beginning of a subnetwork-specific analysis definition block.
subnet-region
Specifies the subnetwork range for which a subnetwork name is defined.
Specify the subnetwork range using the following format:
Format | Meaning |
|---|---|
i.i.i.i-j.j.j.j | Area from i.i.i.i to j.j.j.j |
i.i.i.i | Area from i.i.i.i to i.i.i.255 |
i.i.i.* | Area from i.i.i.0 to i.i.i.255 |
i.i.* | Area from i.i.0.0 to i.i.255.255 |
i.* | Area from i.0.0.0 to i.255.255.255 |
* | Area from 0.0.0.0 to 255.255.255.255 |
In the above table, i and j each indicate an integer from 0 to 255 and an asterisk (*) indicates the wildcard character.
Only one wildcard character can be specified within one definition.
subnet-name
Specifies the subnetwork name corresponding to the subnetwork range.
When specifying the subnetwork name, observe the following:
The length of the subnetwork name must not exceed 200 bytes.
The following types of characters can be used for the subnetwork name:
Alphanumeric characters
Underscore (_)
Note
When defining a subnetwork-specific analysis definition block, note the following:
If two or more definitions are provided for the same subnetwork, the definition provided later is effective.
Uppercase and lowercase letters are distinguished.
You can specify the same subnetwork name for the different subnetworks.
Example
Sample definitions are shown below:
Sample definition 1 (with no duplicated definition)
[SubnetName] 10.20.125.0-10.20.125.127= SubnetExample 192.168.*=Subnet_Example |
"10.20.125.0 to 10.20.125.127" is defined as "SubnetExample."
"192.168.0.0 to 192.168.255.255" is defined as "Subnet_Example"
Sample definition 2 (with a duplicated definition: a narrower range is defined later)
[SubnetName] 10.*=SQC 10.20.30.*=SQC_Agent 10.20.30.0-10.20.30.127=SQC_Manager |
"0.0.0.0 to 9.255.255.255" are not defined as subnetworks.
"10.0.0.0 to 10.20.29.255" are defined as SQC.
"10.20.30.0 to 10.20.30.127" are defined as SQC_Manager.
"10.20.30.128 to 10.20.30.255" are defined as SQC_Agent.
"10.20.31.0 to 10.255.255.255" are defined as SQC.
"11.0.0.0 to 255.255.255.255" are not defined as subnetworks.
Sample definition 3 (with a duplicated definition: a wider range is defined later)
[SubnetName] 10.20.30.*=SQC_Manager 10.20.30.128-10.20.30.255=SQC_Agent 10.*=SQC |
"0.0.0.0 to 9.255.255.255" are not defined as subnetworks.
"10.0.0.0 to 10.255.255.255" are defined as SQC.
"11.0.0.0 to 255.255.255.255" are not defined as subnetworks.
The user may want to use the Trend Viewer to perform analysis excluding a specific subnetwork, which is a group of IP addresses, such as a management department network on the Web site. If so, the user can define the subnetworks to be excluded from analysis in the specific-subnetwork analysis exclusion definition block.
The format of the specific-subnetwork analysis exclusion definition block is shown below:
Format
[SubnetExcepted]
subnet-region
Explanation
subnet-region
Specifies the subnetwork range to be excluded from analysis.
Specify the subnetwork range using the following format:
Format | Meaning |
|---|---|
i.i.i.i-j.j.j.j | Area from i.i.i.i to j.j.j.j |
i.i.i.i | Area from i.i.i.i to i.i.i.255 |
i.i.i.* | Area from i.i.i.0 to i.i.i.255 |
i.i.* | Area from i.i.0.0 to i.i.255.255 |
i.* | Area from i.0.0.0 to i.255.255.255 |
* | Area from 0.0.0.0 to 255.255.255.255 |
In the above table, i and j each indicate an integer from 0 to 255 and an asterisk (*) indicates the wildcard character.
Note
When defining a specific-subnetwork analysis exclusion definition block, note the following:
Only one wildcard character can be specified within one definition.
Example
A sample definition is shown below:
[SubnetExcepted] 10.25.125.1-10.25.125.127 192.168.* |
The user may want to use the Trend Viewer to perform analysis excluding a specific URL such as management content on the Web site. If so, the user can define the URLs to be excluded from analysis in the specific-URL analysis exclusion definition block.
The format of the specific-URL analysis exclusion definition block is shown below:
Format
[URLExcepted]
url-name
Explanation
url-name
Specifies the path (excluding the server name) of the Web content to be excluded from analysis
When specifying the path, observe the following:
The length of the path must not exceed 1,023 characters.
The following symbols cannot be used for the path:
^ | [ ] { } < > ( ) & $ # " ' * , ? |
Note
Notes when defining the definition block with analysis of a specific URL omitted are shown below.
If the path ends with a slash (/), any record with a path ending with a slash that appears in the Web server log is excluded from analysis.
Example
A sample definition is shown below:
The sample definition shown below excludes the following URLs:
http://www.fujitsu.com/SSQC
http;//www.fujitsu.com/SQC/viewer.html
http://www.fujitsu.com/SQC/html/swwm03/swwm0168.html
http://www.fujitsu.com/cgi-bin/program.cgi
[URLExcepted] /SSQC /SQC/viewer.html /SQC/html/swwm03/swwm0168.html /cgi-bin/program.cgi |
