# Open iT Data Monitor and Alerts

The Open iT Data Monitor and Alerts allows the user to monitor and evaluate the data situation and stability processed in the Core Server. It evaluates the archived data and records each vendor license's daily life count and size. It also processes the license status files to get the number of registered vendor licenses that will be the baseline for sending email alerts.

# Data Monitor Processing

The openit_datamonitor binary processes the data used by the Data Monitor. It processes the archive and license status directories to get the file count and size as a basis for data stability.

# Configuring Open iT Data Monitor and Alerts

Open a command prompt with Administrator level privileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```

Once in the directory, activate the processing of licpoll2 archived data, run the command:

Command Syntax
openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.active=true"

To activate the processing of licpoll2 archived data upon restart (jumpstart) of Open iT services, run the command:
Command Syntax
```
openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.jumpstart=true"
```

To enable various parameters that define what the binary will do, run the command:

Command Syntax
openit_oconfinit -u "root.scheduler.jobs.process_licpoll2_monitoring.operations.arguments=<optional_parameter>"

OPTIONS:

Name	Description
`--dir archive`	This will point to the archive directory, which is by default in `C:\ProgramData\OpeniT\Data\archive`.
`--dir licstat`	This will point to the license status directory, which is by default in `C:\ProgramData\OpeniT\Data\license_status`.
`-a \| --archtype`	The archive type of the data that the binary will create.
`--utc`	The date configuration to use (utc or gmt).

Optional Parameters defining Binary Behavior

Example
openit_oconfinit -u "root.scheduler.jobs.process_licpoll2_monitoring.operations.arguments=--dir archive -a | --archtype"

All archive will be processed if archive type is not specified.

Save the changes.

Go to the bin directory, which is by default in /opt/openit/bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd /opt/openit/bin
```

Once in the directory, activate the processing of licpoll2 archived data, run the command:

Command Syntax
./openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.active=true"

To activate the processing of licpoll2 archived data upon restart (jumpstart) of Open iT services, run the command:
Command Syntax
```
./openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.jumpstart=true"
```

To enable various parameters that define what the binary will do, run the command:

Command Syntax
./openit_oconfinit -u "root.scheduler.jobs.process_licpoll2_monitoring.operations.arguments=<optional_parameter>"

OPTIONS:

Name	Description
`--dir archive`	This will point to the archive directory in the data-dir defined upon installation.
`--dir licstat`	This will point to the license status directory in the data-dir defined upon installation.
`-a \| --archtype`	The archive type of the data that the binary will create.
`--utc`	The date configuration to use (utc or gmt).

Optional Parameters defining Binary Behavior

Example
openit_oconfinit -u "root.scheduler.jobs.process_licpoll2_monitoring.operations.arguments=--dir archive -a | --archtype"

All archive will be processed if archive type is not specified.

Save the changes.

# Configuring License Status Data for Data Monitor Processing

Open a command prompt with Administrator level privileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd C:\Program Files\OpeniT\Core\bin
```

Once in the directory, activate the processing of license status data, run the command:

Command Syntax
openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licenstatus_monitoring.general.active=true"

To activate the processing of license status data upon restart (jumpstart) of Open iT services, run the command:
Command Syntax
```
openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.jumpstart=true"
```

Go to the bin directory, which is by default in /opt/openit/bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd /opt/openit/bin
```

Once in the directory, activate the processing of license status data, run the command:

Command Syntax
./openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licenstatus_monitoring.general.active=true"

To activate the processing of license status data upon restart (jumpstart) of Open iT services, run the command:
Command Syntax
```
./openit_oconfinit -u "process_datamonitor.root.scheduler.jobs.process_licpoll2_monitoring.general.jumpstart=true"
```

# Executing Data Monitor Manually

Open the command prompt with Administrator level priivileges.
Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd "C:\Program Files\OpeniT\Core\bin"
```

Once in the directory, execute the following command.

Command Syntax
openit_datamonitor [start-date] [end-date]

REQUIRED PARAMETERS:

Name	Description
`start-date`	The start of the included dates to process `YYYY-MM-DD`; if not specified, the default value is the day before the binary execution.
`end-date`	The end of the included date to process `YYYY-MM-DD`; if not specified, the default value is the day of the binary execution.

Required Parameters for Data Monitor Execution

Example
openit_datamonitor 2022-01-01 2023-01-01

This will get data from January 1, 2022 to January 1, 2023.

To further customize the command, use the optional parameters.

Command Syntax
openit_datamonitor [options] [start-date] [end-date]

OPTIONAL PARAMETERS:

Name	Description
`--dir archive`	This will point to the archive directory, which is by default in `C:\ProgramData\OpeniT\Data\archive`.
`--dir licstat`	This will point to the license status directory, which is by default in `C:\ProgramData\OpeniT\Data\license_status`.
`-a \| --archtype`	The archive type of the data that the binary will create.
`--utc`	The date configuration to use (utc or gmt). If not specified, gmt will be used.

Optional Parameters defining Binary Behavior

Combine or use optional parameters at the same time to achieve necessary capabilities.

Command Syntax
openit_datamonitor -dir archive --archtype licpoll2 --utc 2022-01-01 2023-01-01

Verify that the AlertMonitoring.db is created in the admin directory, which is by default in C:\ProgramData\OpeniT\Data\admin. This is the default output of the binary.

Go to the bin directory, which is by default in /opt/openit/bin, run the command:
Command Syntax
```
cd $BIN_DIR
```
Example
```
cd /opt/openit/bin
```

Once in the directory, execute the following command.

Command Syntax
./openit_datamonitor [start-date] [end-date]

REQUIRED PARAMETERS:

Name	Description
`start-date`	The start of the included dates to process `YYYY-MM-DD`; if not specified, the default value is the day before the binary execution.
`end-date`	The end of the included date to process `YYYY-MM-DD`; if not specified, the default value is the day of the binary execution.

Required Parameters for Data Monitor Execution

Example
./openit_datamonitor 2022-01-01 2023-01-01

This will get data from January 1, 2022 to January 1, 2023.

To further customize the command, use the optional parameters.

Command Syntax
./openit_datamonitor [options] [start-date] [end-date]

OPTIONAL PARAMETERS:

Name	Description
`--dir archive`	This will point to the archive directory in the data-dir defined upon installation.
`--dir licstat`	This will point to the license status directory in the data-dir defined upon installation.
`-a \| --archtype`	The archive type of the data that the binary will create.
`--utc`	The date configuration to use (utc or gmt). If not specified, gmt will be used.

Optional Parameters defining Binary Behavior

All archive will be processed if archive type is not specified.

Combine or use optional parameters at the same time to achieve necessary capabilities.

Example
./openit_datamonitor -dir archive --archtype licpoll2 --utc 2022-01-01 2023-01-01

Verify that the AlertMonitoring.db is created in the admin directory in your defined data_dir ($ROOT_DATA_DIR) upon Open iT server installation. This is the default output of the binary.