aila2-siteconfig: A Tool to Generate a Site Configuration File

Table of Content:

• Introduction
• Processing
• Usage
• Usage notes
• Output
• Conclusion
• References
• Document history

Introduction:

This tool is the final touch to the aila2 project, which includes a standalone executable to filter IIS log files (aila2-filter), the main IIS log analyzer tool (aila2.exe), a program to keep an output folder synchronized with the IIS log folder (aila2-runner.exe) and two web-ui sections: a Quickview page and a Calendar View.

The Calendar View is driven by a siteconfig json file. This download contains a tool to generate a site configuration file automatically based on the content of a given folder.

Top

Processing:

The aila2-siteconfig tool takes a single command line argument that point to the folder containing the json files and produces a json output string to be used with the Calendar View.

The tool picks up all json files from the location with the exclusions of the siteconfig.json (if it already exists) and put the file names in the file_list array.

As previously stated the output is generated in stdout.

Top

Usage:

Usage: aila2-siteconfig -i <json directory path>

Output a json formated string to the console defining a sitename string, a
schema_version int and a file_list string array (listing all json files found
in the provided path), as shown in this sample:

    {
            "sitename" : "aila2-web2",
            "schema_version" : 1,
            "max_graphs" : 60,
            "file_list" : [
                    "u_ex140101.json",
                    "u_ex131231.json",
                    "u_ex131230.json"
            ]
    }

Additional command line options:

    -v, --version   Display the tool version
    /?, --help      Display the tool usage (this message).

Top

Usage Notes:

For simplicity the output is generated out to stdout. This means that the user will _need_ to redirect the output to a file in order to save the results.

Here's a sample execution for my test server:

aila2-siteconfig -i c:\inetpub\wwwroot\atrs5 > c:\inetpub\wwwroot\atrs5\siteconfig.json

Top

Output:

Here is the sample (truncated) output from the above command, without the file redirect:

C:\aila2>aila2-siteconfig -i c:\inetpub\wwwroot\atrs5
{
        "sitename" : "aila2-web",
        "schema_version" : 1,
        "max_graphs": 60,
        "file_list" : [
                "u_ex121121.json",
                "u_ex121122.json",
                "u_ex121123.json",
                "u_ex121124.json",
                "u_ex121125.json",
                "u_ex121126.json",
                "u_ex121127.json",
                "u_ex121128.json",

... [data truncated here]...

                "u_ex140103.json",
                "u_ex140104.json",
                "u_ex140105.json",
                "u_ex140106.json",
                "u_ex140107.json",
                "u_ex140108.json",
                "u_ex140109.json",
                "u_ex140110.json",
                "u_ex140111.json",
                "u_ex140112.json",
                "u_ex140113.json"
        ]
}

Top

Conclusion:

With this last tool in the aila2 Version 1 kit we can now start automating the generation and maintenance of the calendar view with minimal user interactions.

Top

References:

Top

Document history:

Version 1:

Releasing version 1 of the tool (based on Github tag Version-1.2).

File details:

• File name: aila2-siteconfig.zip
• File sha256 sum: 477925baff6d0b3417a9f86fe45692ea056e3f0ef0a02e4f3ce90c1b490816a6

Top