warning

This page is intentionally hidden from navigation but remains accessible via direct link. It is retained for internal reference purposes only and may contain outdated or transitional content.

Raw Archive Regeneration

On the client side of Open iT, the collector programs parse the collected raw data, convert them to Open iT data, and send it to the server for further processing. Problems may arise if faulty parsing occurs.
The raw archive regenerator (openit_rawarchiveregenerator) is a program that converts raw data into Open iT data on the server's side. It allows fixing the corresponding parser and regenerating raw data to the correct Open iT data.

The following sections will guide you in running the openit_rawarchiveregenerator application.

warning

Execute the following steps in the Open iT server.

Requirements

• Open iT Core Server
• Administrative rights

Regenerating Raw Archive

Windows

1. Open a command prompt with Administrator level privileges.

2. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Example

   cd C:\Program Files\OpeniT\Core\bin

3. Run the command:

   Command Syntax

   openit_rawarchiveregenerator -i "<archive_name>"

   where <archive_name> could be any of the following:

   Archive Name	Description
   LogFileCollector.license.alm	Use this argument to regenerate raw ALM record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.altair	Use this argument to regenerate raw Altair event log data into parsed.
   LogFileCollector.license.altium	Use this argument to regenerate raw Altium record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.betalm	Use this argument to regenerate raw BetaLM event log data into parsed.
   LogFileCollector.license.catiaevents	Use this argument to regenerate raw Catia record log data into parsed.
   LogFileCollector.license.codemtr	Use this argument to regenerate raw CodeMeter record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.dslsevents	Use this argument to regenerate raw DSLS record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.eaevents	Use this argument to regenerate raw Enterprise Architect record log data into parsed.
   LogFileCollector.license.encom	Use this argument to regenerate raw Encom record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.eplan	Use this argument to regenerate raw EPLAN record log data. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.fekete	Use this argument to regenerate raw Fekete record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.haspevents2	Use this argument to regenerate raw Petroleum Experts record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.honeywellulm	Use this argument to regenerate raw Honeywell record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.ipsevents	Use this argument to regenerate raw IPS record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.lmx	Use this argument to regenerate raw LM-X event log data into parsed.
   LogFileCollector.license.olicense	Use this argument to regenerate raw OLicense record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.orcaflex	Use this argument to regenerate raw OrcaFlex record log data into parsed.
   LogFileCollector.license.parasoftevents	Use this argument to regenerate raw Parasoft record log data into parsed.
   LogFileCollector.license.peloton	Use this argument to regenerate raw Peloton record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.pelotonevents	Use this argument to regenerate raw Peloton record log data into parsed. (for v6.x)
   LogFileCollector.license.petrelevents	Use this argument to regenerate raw Petrel record log data into parsed.
   LogFileCollector.license.rlm	Use this argument to regenerate raw RLM record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.sentinel	Use this argument to regenerate raw Sentinel record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.tebis	Use this argument to regenerate raw Tebis record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.tlm	Use this argument to regenerate raw Tasking License Management system record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.system.catiaevents	Use this argument to regenerate raw Catia system record log data into parsed.
   LogFileCollector.system.petrelevents	Use this argument to regenerate raw Petrel system record log data into parsed.
   PollCollector.LUM.Events	Use this argument to regenerate raw LUM event poll data into parsed. (for v6.x)
   PollCollector.license.codemeter_dongle	Use this argument to regenerate raw CodeMeter dongle poll data into parsed.
   PollCollector.license.lum	Use this argument to regenerate raw LUM poll event data into parsed.
   PollCollector.license.vector_dongle	Use this argument to regenerate raw Vector dongle poll data into parsed.
   PollCollector.license.vray	Use this argument to regenerate raw V-Ray poll data into parsed.
   PollCollector.license.wibukey_dongle	Use this argument to regenerate raw WibuKey dongle poll data into parsed.
   PollCollector.system.registry	Use this argument to regenerate raw registry system poll data into parsed.
   PollCollector.usageanalyzer.webappbrowserlog	Use this argument to regenerate raw web app browser poll data into parsed.

   Supported Archives
   
   
   Example

   openit_rawarchiveregenerator -i "LogFileCollector.license.dslsevents"
   NOTE

   You can also include the date range of the raw archive you want to regenerate into parsed using the formats YYYY-MM-DD YYYY-MM-DD (e.g., 2023-01-01 2023-07-01), YYYY-MM YYYY-MM (e.g., 2023-01 2023-07), or YYYY YYYY (e.g., 2022 2023).

   Example

   openit_rawarchiveregenerator -i "LogFileCollector.license.dslsevents 2023-01-01 2023-07-01" --env-datatype event

   Running this example will regenerate raw DSLS event log data from January 1, 2023 to July 1, 2023 to parsed.

   OPTIONAL PARAMETERS:

   Parameter	Description
   --help	Use this to display the help message.
   --version	Use this to display the Open iT version.
   --debug	Use this to specify the debug level. Possible values are: 1 - info 2 - debug 3 - warning 4 - verbose 5 - trace
   -c <arg>	Use this to specify the path of the configuration file to use instead of the default.
   -d <arg>	Use this to specify the directory path to where the output will be placed (this is in the incoming directory, which is in C:\ProgramData\OpeniT\Data\incoming by default).
   --no-csv	Use this to only produce CodeMeter, Vector, and Wibukey dongle archives in Open iT format.
   --batch-size <arg>	Use this to specify the number of days to process (default value is 7).
   --list	Use this to list all of the supported archives.

   Optional Parameters for RawArchiveRegenerator
   
   

   Make sure that there are no errors encountered.

4. Verify that there are *.in files created in the server in the incoming directory, which is by default in C:\ProgramData\OpeniT\Data\incoming.

Unix

1. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Example

   cd /opt/openit/bin

2. Run the command:

   Command Syntax

   ./openit_rawarchiveregenerator -i "<archive_name>"

   where <archive_name> could be any of the following:

   Archive Name	Description
   LogFileCollector.license.altium	Use this argument to regenerate raw ALM record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.catiaevents	Use this argument to regenerate raw Catia record log data into parsed.
   LogFileCollector.license.codemtr	Use this argument to regenerate raw CodeMeter record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.dslsevents	Use this argument to regenerate raw DSLS record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.eaevents	Use this argument to regenerate raw Enterprise Architect record log data into parsed.
   LogFileCollector.license.fekete	Use this argument to regenerate raw Fekete record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.honeywellulm	Use this argument to regenerate raw Honeywell record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.ipsevents	Use this argument to regenerate raw IPS events record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.olicense	Use this argument to regenerate raw OLicense event log data into parsed.
   LogFileCollector.license.orcaflex	Use this argument to regenerate raw OrcaFlex record log data into parsed.
   LogFileCollector.license.parasoftevents	Use this argument to regenerate raw Parasoft events record log data into parsed.
   LogFileCollector.license.peloton	Use this argument to regenerate raw Peloton record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.pelotonevents	Use this argument to regenerate raw Peloton record log data into parsed. Add --env-datatype event to regenerate raw event data instead. (for v6.x)
   LogFileCollector.license.petrelevents	Use this argument to regenerate raw Petrel record log data into parsed.
   LogFileCollector.license.rlm	Use this argument to regenerate raw RLM record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.sentinel	Use this argument to regenerate raw Sentinel record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogFileCollector.license.tebis	Use this argument to regenerate raw Tebis record log data into parsed. Add --env-datatype event to regenerate raw event data instead.
   LogParserPlugin.applicationtracker.webappbrowseractivity	Use this argument to regenerate raw web app browser activity data into parsed.
   LogParserProxy.applicationtracker.webappproxylog	Use this argument to regenerate raw web app proxy log into parsed.
   PollCollector.LUM.Events	Use this argument to regenerate raw LUM events poll data into parsed.
   PollCollector.license.codemeter_dongle	Use this argument to regenerate raw CodeMeter dongle poll data into parsed.
   PollCollector.license.lum	Use this argument to regenerate raw LUM poll data into parsed.
   PollCollector.license.vector_dongle	Use this argument to regenerate raw Vector dongle poll data into parsed.
   PollCollector.license.vray	Use this argument to regenerate raw V-Ray poll data into parsed.
   PollCollector.license.wibukey_dongle	Use this argument to regenerate raw WibuKey Dongle poll data into parsed.
   PollCollector.system.registry	Use this argument to regenerate raw registry system poll data into parsed.
   PollCollector.usageanalyzer.webappbrowserlog	Use this argument to regenerate raw web app browser poll data into parsed.
   PollParserSQLite.licenseanalyzer.bentley	Use this argument to regenerate raw Bentley poll parser SQLite data into parsed.

   Supported Archives
   
   
   Example

   ./openit_rawarchiveregenerator -i "LogFileCollector.license.dslsevents"
   NOTE

   You can also include the date range of the raw archive you want to regenerate into parsed following the formats YYYY-MM-DD YYYY-MM-DD (e.g., 2023-01-01 2023-07-01), YYYY-MM YYYY-MM (e.g., 2023-01 2023-07), or YYYY YYYY (e.g., 2022 2023).

   Example

   ./openit_rawarchiveregenerator -i "LogFileCollector.license.dslsevents 2023-01-01 2023-07-01" --env-datatype event

   Running this example will regenerate raw DSLS event log data from January 1, 2023 to July 1, 2023 to parsed.

   OPTIONAL PARAMETERS:

   Parameter	Description
   --help	Use this to display the help message.
   --version	Use this to display the Open iT version.
   --debug	Use this to specify the debug level. Possible values are: 1 - info 2 - debug 3 - warning 4 - verbose 5 - trace
   -c <arg>	Use this to specify the path of the configuration file to use instead of the default.
   -d <arg>	Use this to specify the directory path to where the output will be placed (this is in the incoming directory in your defined data_dir ($ROOT_DATA_DIR) upon Open iT server installation by default).
   --no-csv	Use this to only produce CodeMeter, Vector, and Wibukey dongle archives in Open iT format.
   --batch-size <arg>	Use this to specify the number of days to process (default value is 7).
   --list	Use this to list all of the supported archives.

   Optional Parameters for RawArchiveRegenerator
   
   

   Make sure that there are no errors encountered.

3. Verify that there are *.in files created in the incoming directory in your defined data_dir ($ROOT_DATA_DIR) upon Open iT server installation.