Skip to content

Latest commit

 

History

History
81 lines (53 loc) · 3.56 KB

readme.md

File metadata and controls

81 lines (53 loc) · 3.56 KB

Kindling

A standalone collection of utilities to help Ignition users. Features various tools to help work with Ignition's custom data export formats.

Tools

Thread Viewer

Parses Ignition thread dump .json files (generated by all Ignition mechanisms since 8.1.10).

IDB Viewer

Opens Ignition .idb files and displays a list of tables and allows arbitrary SQL queries to be executed.

If the file is detected as an Ignition log or metrics file, opens a custom view automatically. Right-click the tab to switch between IDB views.

Log Viewer

Open one (or multiple) wrapper.log files. If the output format is Ignition's default, they will be automatically parsed and presented in the same log view used for system logs. If multiple files are selected, an attempt will be made to sequence them and present as a single view.

Archive Explorer

Opens a zip file (including Ignition files like .gwbk or .modl). Allows opening other tools against the files within the zip, including the .idb files in a gateway backup.

Store and Forward Cache Viewer

Opens the HSQLDB file that contains the Store and Forward disk cache. Attempts to parse the Java-serialized data within into its object representation. If unable to deserialize (e.g. due to a missing class), falls back to a string explanation of the serialized data.

Note: If you encounter any issues with missing classes, please file an issue.

Usage

Download the hosted installer from JDeploy here. These installers allow for auto-updating upon launch. If you prefer an offline installation, or to avoid JDeploy, you can also download native installers from the Releases page.

Development

Kindling uses Java Swing as a GUI framework, but is written almost exclusively in Kotlin, an alternate JVM language. Gradle is used as the build tool, and will automatically download the appropriate Gradle and Java version (via the Gradle wrapper). Most IDEs (Eclipse, IntelliJ) should figure out the project structure automatically. You can directly run the main class in your IDE (MainPanel), or you can run the application via./gradlew run at the command line.

Extension

Kindling uses the ServiceLoader mechanism to register tools. Simply provide an implementation of io.github.paulgriffith.kindling.core.Tool (or any of its extensions), appropriately registered on the classpath, to add tools at runtime.

Contribution

Contributions of any kind (additional tools, polish to existing tools, test files) are welcome.

Releases

New tags pushed to GitHub will automatically trigger an action-based deployment of the given version, which will trigger JDeploy to fetch the new version upon next launch. Offline installers (created using jpackage) are also available for Windows and Linux.

Acknowledgements

Disclaimer

This is not an official Inductive Automation product and is not affiliated with, supported by, maintained by, or otherwise associated with Inductive Automation in any way. This software is provided as-is with no warranty.