Difference between revisions of "Seon Core environment variables"

From Seon
Jump to: navigation, search
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
Some environment variables are created and/or set by all Seon binaries. These variables are:  
+
Environment variables are created and/or set by all Seon binaries, which values are based on the configuration of Seon. These variables are:  
*<code>Seon_CFGFILE</code>: Seon main configuration file (absolute path information)  
+
*<code>Seon_CFGFILE</code>: [[Seon Core main configuration file|Seon main configuration file (absolute path information)]]
*<code>Seon_IN_DIR</code>: incoming data directory  
+
*<code>Seon_IN_DIR</code>: [[Seon_Core_configuration#data_incoming_directory|incoming data directory]]
*<code>Seon_OUT_DIR</code>: outgoing data directory  
+
*<code>Seon_OUT_DIR</code>: [[Seon_Core_configuration#data_outgoing_directory|outgoing data directory]]
*<code>Seon_TMP_DIR</code>: temporary data directory  
+
*<code>Seon_TMP_DIR</code>: [[Seon_Core_configuration#temporary_directory|temporary data directory]]
*<code>Seon_BIN_DIR</code>: binary program directory
+
*<code>Seon_BIN_DIR</code>: [[Seon_Core_configuration#binary_installation_directory|binary program directory]]
*<code>Seon_SCRIPT_DIR</code>: script installation directory
+
*<code>Seon_SCRIPT_DIR</code>: [[Seon_Core_configuration#script_installation_directory|script installation directory]]
*<code>Seon_BACKUP_DIR</code>: backup directory
+
*<code>Seon_BACKUP_DIR</code>: [[Seon_Core_configuration#database_backup_directory|backup directory]]
*<code>RAND_FILE</code>: entropy file for OFTP2 needs  
+
*<code>RAND_FILE</code>: [[Seon_Core_configuration#Entropy_file_for_random_data|entropy file for OFTP2 needs]]
*<code>OPENSSL_BIN</code>: absolute path to openSSL binary  
+
*<code>OPENSSL_BIN</code>: [[Seon_Core_configuration#absolute_path_to_.27openssl.27|absolute path to openSSL binary]]
*<code>RRDTOOL_BIN</code>: absolute path to RRDtools binary  
+
*<code>RRDTOOL_BIN</code>: [[Seon_Core_configuration#absolute_path_to_.27rrdtool.27|absolute path to RRDtools binary]]
*<code>RRDB_DATAPATH</code>: RRD data path
+
*<code>RRDB_DATAPATH</code>: [[Seon_Core_configuration#RRDB_data_path|RRD data path]]
 
*<code>Seon_WEBGUI_DIR</code>: web interface installation directory
 
*<code>Seon_WEBGUI_DIR</code>: web interface installation directory
*<code>JAVA_BIN</code>: configured path to the Java runtime (JRE) binary
+
*<code>CA_FILE</code>: [[Seon_Core_configuration#root_certificate_file_.26_root_certificate_path|configured absolute path to the root certificate file]]
 +
*<code>CA_PATH</code>: [[Seon_Core_configuration#root_certificate_file_.26_root_certificate_path|configured absolute path to the root certificate directory]]
 +
 
 +
The following environment variables are extracted form the global Seon configuration file (default: <code>/etc/seon.conf</code>):
 +
*<code>Seon_DB_HOST</code>
 +
*<code>Seon_DB_USER</code>
 +
*<code>Seon_DB_PWD</code>
 +
*<code>Seon_DB_NAME</code>
 +
*<code>Seon_DB_SOCKET</code>
 +
*<code>Seon_DB_PORT</code>
 +
*<code>Seon_DB_TYPE</code>: either "<code>mysql</code>", "<code>DB2</code>" or "<code>sqlite3</code>"
 +
 
  
 
All processes started by Seon (event scripts, plugins, etc.) have access to these environment variables.  
 
All processes started by Seon (event scripts, plugins, etc.) have access to these environment variables.  
Line 18: Line 29:
 
*you may start Seon programs in a shell where this variable is set without using the parameter "<code>-C</code>" for all binaries (because the environment variable points to the correct position of the configfile)  
 
*you may start Seon programs in a shell where this variable is set without using the parameter "<code>-C</code>" for all binaries (because the environment variable points to the correct position of the configfile)  
 
*all subsequent processes started by Seon (like event scripts) don't have to bother about the given configfile (like plugins of Seon Enterprise).
 
*all subsequent processes started by Seon (like event scripts) don't have to bother about the given configfile (like plugins of Seon Enterprise).
 +
 +
== Database performance benchmarking ==
 +
Available in Seon 3 Core, an environment variable can be set to log all database access timing information into that given file:
 +
Seon_DB_BENCHMARKLOG
 +
You can set this variable to an absolute filename where Seon logs all innformation (example: "ksh" or "bash"):
 +
export Seon_DB_BENCHMARKLOG=/tmp/db2perf.log
 +
This file logs the connect and query time for every single database access, resulting in a fast growing file. The content if this file looks like this (using DB2 database abstraction layer, others like MySQL start with "<code>MySQL</code>"):
 +
<pre>
 +
DB2 connect: 0.052482 seconds
 +
DB2 SQL query: 0.126631 seconds
 +
DB2 connect: 0.032447 seconds
 +
DB2 SQL query: 0.004983 seconds
 +
DB2 connect: 0.029555 seconds
 +
DB2 SQL query: 0.004500 seconds
 +
DB2 connect: 0.031012 seconds
 +
DB2 SQL query: 0.001324 seconds
 +
</pre>

Latest revision as of 08:13, 25 August 2017

Environment variables are created and/or set by all Seon binaries, which values are based on the configuration of Seon. These variables are:

The following environment variables are extracted form the global Seon configuration file (default: /etc/seon.conf):

  • Seon_DB_HOST
  • Seon_DB_USER
  • Seon_DB_PWD
  • Seon_DB_NAME
  • Seon_DB_SOCKET
  • Seon_DB_PORT
  • Seon_DB_TYPE: either "mysql", "DB2" or "sqlite3"


All processes started by Seon (event scripts, plugins, etc.) have access to these environment variables. The environment variable "Seon_CFGFILE" points to the absolute path to the Seon main configuration file. This has two effects:

  • you may start Seon programs in a shell where this variable is set without using the parameter "-C" for all binaries (because the environment variable points to the correct position of the configfile)
  • all subsequent processes started by Seon (like event scripts) don't have to bother about the given configfile (like plugins of Seon Enterprise).

Database performance benchmarking

Available in Seon 3 Core, an environment variable can be set to log all database access timing information into that given file:

Seon_DB_BENCHMARKLOG

You can set this variable to an absolute filename where Seon logs all innformation (example: "ksh" or "bash"):

export Seon_DB_BENCHMARKLOG=/tmp/db2perf.log

This file logs the connect and query time for every single database access, resulting in a fast growing file. The content if this file looks like this (using DB2 database abstraction layer, others like MySQL start with "MySQL"):

DB2 connect: 0.052482 seconds
DB2 SQL query: 0.126631 seconds
DB2 connect: 0.032447 seconds
DB2 SQL query: 0.004983 seconds
DB2 connect: 0.029555 seconds
DB2 SQL query: 0.004500 seconds
DB2 connect: 0.031012 seconds
DB2 SQL query: 0.001324 seconds