Keys in the ODB /Logger/History subtree: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
No edit summary
Line 16: Line 16:
when the MIDAS logger utility [[mlogger]] is started for the first time. The keys will be filled with default values which users may change as required to customize their experiments.  
when the MIDAS logger utility [[mlogger]] is started for the first time. The keys will be filled with default values which users may change as required to customize their experiments.  


When [[mlogger]] is started for the first time, it creates '''three''' odb subtrees  
When [[mlogger]] is started for the first time, it creates '''three'''<span style="color: purple;"> /Logger/History</span> ODB subtrees  
<span style="color: purple;">''0,1''</span> and <span style="color: purple;">''2''</span> as shown in the following example:
<span style="color: purple;">''0,1''</span> and <span style="color: purple;">''2''</span> as shown in the following example:


Line 61: Line 61:
== <span style="color: purple;">''/Logger/History/0/''</span> subtree ==
== <span style="color: purple;">''/Logger/History/0/''</span> subtree ==


This subtree controls history logging of Midas events.
By default, this subtree controls history logging of Midas events.


<br>
<br>
Line 75: Line 75:
This key specifies the type of history logging for this ''history-logging-channel''.  
This key specifies the type of history logging for this ''history-logging-channel''.  


[[mlogger]] creates this channel with this key set to "MIDAS" since this subtree  <span style="color: purple;">''0''</span>  controls MIDAS history logging.
[[mlogger]] creates this channel with this key set to "MIDAS" since this subtree, i.e. <span style="color: purple;">''0''</span>, controls MIDAS history logging.


<br>
<br>
Line 89: Line 89:
</div>
</div>


If set to "y", MIDAS history logging is active.
Since this subtree, i.e. <span style="color: purple;">''0''</span>,  controls MIDAS history logging (see [[#/Logger/History/0/Type|Type]]),
Set to "n" to disable MIDAS history logging.
* if set to "y", MIDAS history logging is active; [[mlogger]] will write data into this channel.
 
* if set to "n" to  MIDAS history logging is disabled.
See also [[#/Logger/History/0/Type|Type key]].  


<br>
Note:this key replaces obsolete key  
Note:this key replaces obsolete key  
[[Keys in the ODB /Logger tree #/Logger/WriteFileHistory|/Logger/WriteFileHistory]]  
[[Keys in the ODB /Logger tree #/Logger/WriteFileHistory|/Logger/WriteFileHistory]]  
Line 109: Line 109:
</div>
</div>


If set to 1, debug is enabled for this history logging channel.
This key controls the debug level.
If set to 0, debug is disabled for this history logging channel.


<br>
<br>
Line 145: Line 146:
== <span style="color: purple;">''/Logger/History/1/''</span> subtree ==
== <span style="color: purple;">''/Logger/History/1/''</span> subtree ==


This subtree controls history logging of ODBC
By default, this subtree controls history logging of ODBC.
 




Line 158: Line 158:
This key specifies the type of history logging for this ''history-logging-channel''.  
This key specifies the type of history logging for this ''history-logging-channel''.  


[[mlogger]] creates this channel with this key set to "ODBC" since this subtree  <span style="color: purple;">''1''</span>  controls ODBC history logging.
[[mlogger]] creates this channel with this key set to "ODBC" since by default this subtree  <span style="color: purple;">''1''</span>  controls ODBC history logging.


<br>
<br>
----------
----------
<br>
<br>


=== <span style="color: purple;">''/Logger/History/1/Active''</span> ===
=== <span style="color: purple;">''/Logger/History/1/Active''</span> ===
Line 170: Line 171:
</div>
</div>


If set to "y", ODBC history logging is active.
If set to "y", ODBC history logging is active. ODBC data are written into this channel.
 
 
See also [[#/Logger/History/1/Type|Type key]].  
See also [[#/Logger/History/1/Type|Type key]].  


Line 183: Line 182:
</div>
</div>


If set to 1, debug is enabled for ODBC history logging.
This key holds the debug level for this channel.
If set to 0, debug is disabled for ODBC history logging.


See also [[#/Logger/History/1/Type|Type key]].  
See also [[#/Logger/History/1/Type|Type key]].  
Line 200: Line 200:
</div>
</div>


This key is present in a history channel of Type "ODBC" only, and is created by [[mlogger]].
This key is present in a history channel of Type "ODBC" only.  It contains the ODBC Data Source Name for writing and is used by [[mlogger]].


See also [[#/Logger/History/1/Type|Type key]].  
See also [[#/Logger/History/1/Type|Type key]].  
Line 216: Line 216:
</div>
</div>


This key is present in a history channel of Type "ODBC" only, and is created by [[mlogger]].
This key is present in a history channel of Type "ODBC" only.  It contains the ODBC Data Source Name for reading, and is used by [[mhttpd]] and [[mhist]] utilities.


See also [[#/Logger/History/1/Type|Type key]].  
See also [[#/Logger/History/1/Type|Type key]].  
Line 257: Line 257:


If set to "y", SQLITE history logging is active.
If set to "y", SQLITE history logging is active.


See also [[#/Logger/History/2/Type|Type key]].  
See also [[#/Logger/History/2/Type|Type key]].  
Line 268: Line 267:
* '''Default:'''  0
* '''Default:'''  0
</div>
</div>
 
This key contains the debug level for this channel.
If set to 1, debug is enabled for SQLITE history logging.
If set to 0, debug is disabled for SQLITE history logging.


See also [[#/Logger/History/2/Type|Type key]].  
See also [[#/Logger/History/2/Type|Type key]].  
Line 284: Line 283:
* '''Default:'''   
* '''Default:'''   
</div>
</div>
This key contains the location of SQLITE database files, and is of the form "/file/system/path".


This key is present in a history channel of Type "SQLITE" only, and is created by [[mlogger]].
This key is present in a history channel of Type "SQLITE" only, and is created by [[mlogger]].


See also [[#/Logger/History/2/Type|Type key]].
See also [[#/Logger/History/2/Type|Type key]].

Revision as of 15:21, 10 June 2014

Links



/Logger/History subtree

The ODB /Logger/History subtree is a subdirectory of the ODB /Logger tree, created when the MIDAS logger utility mlogger is started for the first time. The keys will be filled with default values which users may change as required to customize their experiments.

When mlogger is started for the first time, it creates three /Logger/History ODB subtrees 0,1 and 2 as shown in the following example:

Example

The following example shows the /Logger/History ODB subtree after creation by mlogger (obtained using the odbedit ls command). See below for information on individual keys. 

[local:pol:S]/>cd /logger
[local:pol:S]/Logger>ls -r history
History
   0
       Type                    MIDAS
       Active                  y
       Debug                   0
       PerVariableHistory      0
   1
       Type                    ODBC
       Active                  n
       Debug                   0
       Writer_ODBC_DSN         history_writer
       Reader_ODBC_DSN         history_reader
   2
       Type                    SQLITE
       Active                  n
       Debug                   0
       Sqlite dir

The three subtrees are each a history-logging-channel created to control one of the three different types of history logging available, i.e. MIDAS, ODBC and SQLITE.

Each subdirectory is created with a different value in the subkey "Type", i.e.

  • Subtree 0 for MIDAS (key Type set to "MIDAS")
  • Subtree 1 for ODBC (key Type set to "ODBC")
  • Subtree 2 for SQLITE (key Type set to "SQLITE")


The keys present in each history-logging-channel are described below.


/Logger/History/0/ subtree

By default, this subtree controls history logging of Midas events.



/Logger/History/0/Type

  • Type: STRING
  • Default: MIDAS

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "MIDAS" since this subtree, i.e. 0, controls MIDAS history logging.




/Logger/History/0/Active

  • Type: BOOL
  • Default: "y"

Since this subtree, i.e. 0, controls MIDAS history logging (see Type),

  • if set to "y", MIDAS history logging is active; mlogger will write data into this channel.
  • if set to "n" to MIDAS history logging is disabled.


Note:this key replaces obsolete key /Logger/WriteFileHistory




/Logger/History/0/Debug

  • Type: INT
  • Default: 0

This key controls the debug level. If set to 0, debug is disabled for this history logging channel.




/Logger/History/0/PerVariableHistory

  • Type: INT
  • Default: 0

This key is present in a history channel of Type "MIDAS" only (see Type key).

The default value of 0 is intended to operate the midas history in "traditional" mode. In this mode:

  • there is one history record for each equipment
  • history record id is equal to the equipment id
  • /History/Events and /History/Tags are not required and can be safely deleted


Note: this key replaces obsolete key /history/PerVariableHistory






/Logger/History/1/ subtree

By default, this subtree controls history logging of ODBC.


/Logger/History/1/Type

  • Type: STRING
  • Default: "ODBC"

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "ODBC" since by default this subtree 1 controls ODBC history logging.




/Logger/History/1/Active

  • Type: BOOL
  • Default: "n"

If set to "y", ODBC history logging is active. ODBC data are written into this channel. See also Type key.


/Logger/History/1/Debug

  • Type: INT
  • Default: 0

This key holds the debug level for this channel. If set to 0, debug is disabled for ODBC history logging.

See also Type key.


Note: this key replaces obsolete key /Logger/ODBC_Debug


/Logger/History/1/Writer_ODBC_DSN

  • Type: STRING
  • Default: "history_writer"

This key is present in a history channel of Type "ODBC" only. It contains the ODBC Data Source Name for writing and is used by mlogger.

See also Type key.

Note: this key replaces obsolete key /Logger/ODBC DSN


/Logger/History/1/Reader_ODBC_DSN

  • Type: STRING
  • Default: "history_reader"

This key is present in a history channel of Type "ODBC" only. It contains the ODBC Data Source Name for reading, and is used by mhttpd and mhist utilities.

See also Type key.

Note: this key replaces obsolete key /history/ODB_DSN






/Logger/History/2/ subtree

This subtree controls history logging of SQLITE


/Logger/History/2/Type

  • Type: STRING
  • Default: "SQLITE"

This key specifies the type of history logging for this history-logging-channel.

mlogger creates this channel with this key set to "SQLITE" since this subtree 2 controls SQLITE history logging.



/Logger/History/2/Active

  • Type: BOOL
  • Default: "n"

If set to "y", SQLITE history logging is active.

See also Type key.


/Logger/History/2/Debug

  • Type: INT
  • Default: 0

This key contains the debug level for this channel. If set to 0, debug is disabled for SQLITE history logging.

See also Type key.





/Logger/History/2/Sqlite dir

  • Type: STRING
  • Default:

This key contains the location of SQLITE database files, and is of the form "/file/system/path".

This key is present in a history channel of Type "SQLITE" only, and is created by mlogger.

See also Type key.

Retrieved from "https://daq00.triumf.ca/MidasWiki/index.php?title=Keys_in_the_ODB_/Logger/History_subtree&oldid=1251"