Introduction

This package substitues the obsolete logService. A new requirement whereby database technologies other than ORACLE had to be dropped came in around spiring 2007. This new requirement meant the re-writing of the logService package, which was higly dependent on MySQL. This opportunity was taken to refactorize the code, especially the log manager, which was never very user friendly. Currently, the database access in C++ code is written using CORAL, which hides the underlying technology. For the log manager, JAVA was the language chosen, since it brings in the flexibility requiered to make this tool more intuitive. The resulting java applicatio can be run from the console, or remotely using the Java Web Start technology.

Known issues/bugs

The ls package has not been fully tested yet, although initial usage has been satisfactory. The JAVA-based log manager is still not fully developed. It requires a better look, more feauters, and most importantly, proper handling of large number of entries O(100,000).

To be implemented

Complete the development of the Log Manager.

Changes from previous release

Example applications

None exist at the moment.

Log Manager

Usage: log_manager 
Instruction on how to use to be written.

Applications

Usage: lsReceiver -p partitionName -u userName -n ISserverName -c connectionString 
Options/Arguments:
        -p partitionName      Partition name
        -u userName           User name
        -n ISserverName       Name of the Information Service to publish the message rate into.
        -c connectionString  Database connection string. 
        "The log receiver subscribes to the MRS service to receive and log on a database messages produced by TDAQ applications."

Test

Usage: logTest -p partitionName -l level -c connectionString 
Options/Arguments:
        -p partitionName      Partition name
        -l level           Level of Complexity of the test [1: open/close - 2: tests the Log Service Infrastructure].
        -c connectionString  Database connection string. 
        "Test binary for the Log Receiver application."

Utilities

Usage: logSelect -p partitionName -xyz searchCriteria -c connectionString 
Options/Arguments:
        -p partitionName      Partition name
        -xzy searchCriteria  Combination of argument options to define the search criteria. Do a logSelect -h for further information.
        -c connectionString  Database connection string. 
        "Application to retrieve log messages for a given partition according to the command arguments. By default, messages are dumped on std::cout"

Usage: logDelete -p partitionName -xyz searchCriteria -c connectionString 
Options/Arguments:
        -p partitionName      Partition name
        -xzy searchCriteria  Combination of argument options to define the search criteria. Do a logSelect -h for further information.
        -c connectionString  Database connection string. 
        "Application to remove log messages for a given partition according to the command arguments."

Usage: logDropTable -p partitionName -c connectionString 
Options/Arguments:
        -p partitionName      Partition name
        -c connectionString  Database connection string. 
        "Application to remove a table for a given partition."

Usage: logShowTables -c connectionString 
Options/Arguments:
        -c connectionString  Database connection string. 
        "Application to dump all the table names and corresponding partitions."

Usage: logCleanDatabase -c connectionString 
Options/Arguments:
        -c connectionString  Database connection string. 
        "Application to clean the database by removing all the existing tables."