Open iT CFG Directives Configuration

This section shows the step by step configuration of openit.cfg file directives.

Configuring File Space Period and Offset

This covers the instructions on how to configure the StorageAnalyzer file space schedule and offset in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Locate and configure the following directives:

   • STORAGE_FILE_SPACE_PERIOD — Specifies how often file space accounting is scheduled. The default value is sunday.

     The following table describes the accepted values and their behavior.

     Value	Description
     daily	Schedules file space accounting every day.
     monday, tuesday, wednesday, thursday, friday, saturday, sunday	Schedules file space accounting weekly on the specified day.
     Blank	Disables scheduled file space accounting.

     Storage File Space Period Values
     
     
     Note

     Negative values are invalid. Other unsupported values may be interpreted as a weekly schedule rather than rejected, potentially resulting in unexpected scheduling behavior.

     Use only the accepted values listed in the table.

   • STORAGE_FILE_SPACE_OFFSET — Specifies the number of seconds after midnight when file space accounting runs on the scheduled day. The default value is 400.

     The following table describes the accepted values and their behavior.

     Value	Description
     1 to 85000	Specifies the offset in seconds after midnight.
     0, Blank	Uses the default value of 400.
     Greater than 85000	Uses 85000 as the maximum offset and generates a warning.

     Storage File Space Offset Values
     
     

3. Save the changes.

Configuring File Systems Period

This covers the instructions on how to configure the StorageAnalyzer file system period in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Locate the STORAGE_FILE_SYSTEMS_PERIOD directive and set its value to the desired collection interval in seconds. The default value is 86400 (one day).

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the collection interval in seconds. No explicit maximum value is defined.
   Blank	Disables scheduled file system collection and processing.

   Storage File Systems Period Values
   
   
   Note

   Negative and non-numeric values may cause unexpected processing behavior. Use only positive integers.

3. Save the changes.

Configuring File Type Classification

This covers the instructions on how to configure the StorageAnalyzer file type classification in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.
2. Modify the value of the STORAGE_FILE_SPACE_LEVEL directive according to your preference. The default value is 1. Change the value with your desired value. See details on different file type level in Configuring File Type Classification section.
3. Save the changes.

Configuring LSF Batch Logs Directory

This directive refers to the directory containing the LSF batch logs in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Set the path to the LSF batch logs in the LSB_ACCT_DIR directive.

   Note

   If LSB_ACCT_DIR is blank or not configured, LSF accounting collection is skipped.

   Make sure the specified directory contains the lsb.acct file. If the file is missing or unavailable, the collector logs No new lsb_acct logfile available and skips processing.

3. Save the changes.

Configuring PBS Accounting Logs Directory

This refers to the directory containing the PBS accounting logs in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Set the path to the PBS accounting logs in the PBS_ACCT_DIR directive.

   Note

   If PBS_ACCT_DIR is blank or not configured, PBS accounting collection is skipped.

   Make sure the specified directory exists. If the configured directory does not exist, the PBS accounting converter exits with an error.

3. Save the changes.

Configuring Sun Grid Engine Root Directory

This refers to the root directory of the Sun Grid Engine installation in Unix systems.

Instructions

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Set the Sun Grid Engine root directory in the SGE_ROOT_DIR directive.

   Note

   If SGE_ROOT_DIR is blank or not configured, SGE accounting collection is skipped.

   Make sure the specified root directory exists. If the configured directory does not exist, the SGE accounting converter exits with an error.

3. Save the changes.

Configuring SAR Binary Directory

This refers to the directory containing the SAR binary in Unix systems.

Instructions

The SAR data collector uses the host machine SAR binary to collect system activities. Make sure that the sysstat package is installed and the path to the SAR binary is set.

To install sysstat, follow these instructions:

1. Execute one of the following command:

   Command Syntax

   sudo dnf install -y sysstat

2. Wait until the process succeeds. Verify the installation by using the following command:

   Command Syntax

   sar -V

   It will display the current version of SAR.

   Example

   sysstat version 11.7.3
   (C) Sebastien Godard (sysstat <at> orange.fr)

To configure the SAR binary directory:

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Set the path to the SAR binary in the SAR directive.

   Example

   SAR     /usr/bin/sar

   Note

   The SAR directive must point to an existing executable file.

   If the directive is blank, not configured, or points to an invalid or non-executable file, SAR data collection does not run.

3. Save the changes.

Configuring Power BI Cut-off Age and Data Types

The POWERBI_CUTOFF_AGE and POWERBI_DATATYPES directives configure the historical data period and data types processed for Power BI.

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate and configure the following directives:

   • POWERBI_CUTOFF_AGE — Specifies the number of years to subtract from the current year to determine the starting year of Power BI data processing. Processing begins on January 1 of the resulting year. The default configuration value is 2.

     For example, if the current year is 2026 and the value is 2, processing begins on January 1, 2024.

     The following table describes the accepted values and their behavior.

     Value	Description
     Integer	Specifies the number of years to subtract from the current year. No explicit minimum or maximum is defined.
     Blank	Uses the fallback value of 3.

     Power BI Cut-off Age Values
     
     
     Note

     Negative values are not explicitly rejected but may result in an unintended starting year. Non-numeric values may cause processing to exit with a warning or produce unexpected results if they contain digits.

     Use only valid integer values.

   • POWERBI_DATATYPES — Specifies the data types to process for Power BI. The default configuration value is 75,94,95,102.

     The following table describes the accepted values and their behavior.

     Value	Description
     all	Processes all available datatype directories under DATA_DIR.
     Comma-separated datatype IDs	Processes only the specified data types, such as 75,94,95,102.
     Blank	Uses all and processes all available datatype directories under DATA_DIR.

     Power BI Datatypes Values
     
     
     Note

     Invalid values may cause unexpected processing behavior. Non-existent datatype IDs are skipped with a warning.

     Use all or valid comma-separated datatype IDs.

3. Save the changes.

Configuring the Maximum Age of the dist-config Distributable

This directive refers to the maximum age (in seconds) of the dist-config distributable.

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate the DIST_CONFIG_MAX_AGE directive and set its value to the desired maximum cache age in seconds. The default value is 86400.

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the maximum age of the cached dist-config distributable in seconds. If the cached file is within the configured age, it is reused. Otherwise, it is rebuilt.
   Not Configured	Uses the default value of 86400 seconds.

   Maximum Age of the dist-config Distributable Values
   
   
   Note

   If DIST_CONFIG_MAX_AGE is left blank or contains a non-integer value, a ValueError occurs. Negative values cause the cache to be treated as expired, which will result in rebuilding the dist-config distributable.

   Use only positive integers to avoid unexpected behavior.

3. Save the file.

Configuring Classification Values Cut-off Age

This directive refers to the maximum age of the classification values to extract from the database.

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate the CLASSVAR_CUTOFF_AGE directive and set its value to the desired number of years of historical data to include. The default configuration value is 3.

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the number of years of historical data to include when scanning classification values. No explicit maximum value is defined.
   0	Scans classification values from all available years without applying a year-based cutoff.
   Blank	Treated as 0, allowing classification values from all available years to be scanned.
   Not Configured	Uses the fallback value of 2 years.

   Classification Values Cut-off Age Values
   
   

3. Save the file.

Configuring License Status Max Age

This directive controls when the old status files will be deleted. If this directive is not present, the Core Server will remove files older than one day (86400 seconds).

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate the LICENSE_STATUS_MAX_AGE directive and set its value to the desired maximum age in seconds. The default configuration value is 172800.

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the maximum age of license status files in seconds. No explicit maximum value is defined.
   0	Makes license status files eligible for immediate removal.
   Not Configured	Uses the fallback value of 86400 seconds (1 day).

   License Status Max Age Values
   
   
   Note

   Negative and non-numeric values are not explicitly rejected. Negative values make license status files eligible for immediate removal, while non-numeric values are treated as 0, producing the same result.

   Use only positive integers to avoid unexpected behavior.

3. Save the file.

Configuring App Status Max Age

This directive controls when the old app status files will be deleted.

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate the APP_STATUS_MAX_AGE directive and set its value to the desired maximum age in seconds. The default configuration value is 172800.

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the maximum age of application status files in seconds.
   0	Makes application status files eligible for immediate removal.
   Blank	Treated as 0, making application status files eligible for immediate removal.

   App Status Max Age Values
   
   
   Note

   Negative values are not explicitly rejected and make application status files eligible for immediate removal. Invalid values may cause files to be removed sooner than expected.

   Use only positive integers to avoid unexpected behavior.

3. Save the file.

Configuring Client Info Max Days

This refers to the maximum number of days a client information will be kept in the client info file on the Core Server.

Instructions

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\ for Windows or in the openit directory, which is by default in /etc/opt/openit for Unix.

2. Locate the CLIENT_INFO_MAX_DAYS directive and set its value to the desired maximum retention period in days. The default configuration value is 0.

   The following table describes the accepted values and their behavior.

   Value	Description
   Positive integer	Specifies the maximum number of days to retain client information entries. Entries older than the configured number of days are removed during cleanup. No explicit maximum value is defined.
   0	Disables age-based expiration, so client information entries are not removed based on their age.
   Blank	Treated as 0, disabling age-based expiration.
   Not configured	Skips client information cleanup.

   Client Info Max Days Values
   
   
   Note

   Negative values are not explicitly rejected and may cause client information entries to be removed immediately or sooner than intended. Non-numeric values are treated as 0, disabling age-based expiration.

   Use only non-negative integers to avoid unexpected behavior.

3. Save the file.

Changing the Data Loading Behavior of Servers

Instructions for Windows

1. Open the openit.cfg file in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration\.

2. Locate the SERVER_TYPE directive and set its value to STANDALONE, PRIMARY, or SECONDARY, depending on the server's role. The default value is STANDALONE.

   The following table describes the accepted values and their behavior.

   Value	Description
   STANDALONE	This is the default server behavior, where the entire database is loaded.
   PRIMARY	This is for the main server in a multi-server setup. Use this value to load all non-filtrator and filtrator data types configured on in the data_generation_config file.
   SECONDARY	This is the additional processing server in a multi-server setup. Use this value to only load filtrator data types configured on in the data_generation_config file.

   Data Loading Behavior of Servers Values
   
   

3. Save the file.

   In a multi-server setup, if you are regenerating data type that is not active on any server, the data type will not be loaded.

   To load it manually, run the following command:

   Command Syntax

   "C:\Program Files\OpeniT\Core\External\Strawberry\perl\bin\perl.exe" "C:\Program Files\OpeniT\
   Core\bin\add.pl" --datatype <data_type_no>

   where <data_type_no> is the data type number to load.

Instructions for Unix

1. Open the openit.cfg file in the openit directory, which is by default in /etc/opt/openit.

2. Locate the SERVER_TYPE directive and set its value to STANDALONE, PRIMARY, or SECONDARY, depending on the server's role. The default value is STANDALONE.

   The following table describes the accepted values and their behavior.

   Value	Description
   STANDALONE	This is the default server behavior, where the entire database is loaded.
   PRIMARY	This is for the main server in a multi-server setup. Use this value to load all non-filtrator and filtrator data types configured on in the data_generation_config file.
   SECONDARY	This is the additional processing server in a multi-server setup. Use this value to only load filtrator data types configured on in the data_generation_config file.

   Data Loading Behavior of Servers Values
   
   

3. Save the file.

   In a multi-server setup, if you are regenerating data type that is not active on any server, the data type will not be loaded.

   To load it manually, run the following command:

   Command Syntax

   runuser openit -c "/opt/openit/bin/add --datatype <data_type_no>"

   where <data_type_no> is the data type number to load.

note

Multi-server setup must be explicitly configured to behave correctly. There are no strict rules on which servers should process non-filtrator data types.