Health Check #
Health Check contains tasks used for troubleshooting and managing the installed Open iT Client.
To run specific or multiple task/s:
- Choose the health task(s). Once selected, the check icon will change to a number icon indicating the order of task execution.
- Provide the required information.
- Click Run.
The result of the triggered job(s) will be displayed in the result viewer.
Task List #
| Description | Required Parameter | Command | Task |
|---|---|---|---|
| This task downloads and updates the configuration files in the client. | openit_apicontroller.exe -t download_dist | Download configuration from server | |
| This task downloads all the configured sources of collection from the server. | openit_apicontroller.exe -c apicontorller-one.conf -t get_user_config | Download user config | |
| This task downloads a specified directory from the client. | dir - the valid directory referenced to the $ROOT_DIR of the Open iT Client (e.g., Configuration/Components | dir /s/o-d “%ROOT%/{dir}” | Get a list of files in the given Open iT directory |
| This task deletes a specified file in the provided directory from the client. | dir - the valid directory referenced to the $ROOT_DIR of the Open iT Client (e.g., Configuration/Components) file - the name of the file to delete (e.g., autodetectlmx) | del /f /q “%ROOT%/{dir}/{file}” | Delete the given Open iT file |
| This task restarts the Open iT Client service. | net stop OpeniTClient && net start OpeniTClient | Restart the Open iT Client |
|
| This task executes the Open iT License Configuration Builder binary from the client to rebuild all the necessary configuration files for data collection. | openit_licenseconfigbuilder.exe | Build license config | |
| This task executes the Open iT License Poller binary from the client to run one polling and test the configuration with debug level 5. | openit_licpoll.exe -#1 -d5 | Run a licpoll test | |
| This task triggers a PowerShell command in the client to show the content of a specific file. | dir - the valid directory referenced to the $ROOT_DIR of the Open iT Client (e.g., Configuration/Components) file - the name of the file to show (e.g., autodetectlmx) | powershell -command “type ‘%ROOT%/{dir}/{file}’“ | Show the content of the given Open iT file |
| This task shows the X number of bottom lines of the file in the client. This is mainly for showing the Open iT Client (e.g., Configuration/Components) file - the name of the file to tail (e.g., autodetectlmx) tail - the number of lines from the last line of the file to be shown log files for troubleshooting purposes. | dir - the valid directory referenced to the $ROOT_DIR of This task shows the X number of bottom lines of the file in the client. This is mainly for showing the Open iT Client (e.g., Configuration/Components) file - the name of the file to tail (e.g., autodetectlmx) tail - the number of lines from the last line of the file to be shown | powershell -command “type ‘%ROOT%/{dir}/{file}’ -Tail {tail}" | Tail the content of the given Open iT file |
| This task displays all the running process of Open iT from the host machine. | wmic.exe get Commandline,ExecutablePath, Name,processed, parentprocessid /FORMAT:csv | findstr openit_*.exe | View the running Open iT processes |
Files #
The Files tab allows request and download of configuration and log files from the client for troubleshooting purposes.
To request and download the files:
- Hover over the folder tile of the files to request and download.
- Click Request to download the files from the client or update the previously requested files.
- Click Download.
