# Utilities # XINA Connect XINA Connect is a Java application which combines the features of the XINA Tunnel and XINA Import applicatons with a UI. This application is distributed as a Java jar file and requires Java 17 or greater to run. The recommended OpenJDK build is available [here](https://learn.microsoft.com/en-us/java/openjdk/download). ### Latest Version #### 1.1.0 [Windows Installer](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.1.0.msi) [Windows Portable](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.1.0.zip) [MacOS Installer](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.1.0.dmg) [Jar File](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.1.0.jar.zip)(requires Java 17+) `java -jar xina_connect.jar` ### Previous Versions #### 1.0.0 [Windows Installer](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.0.0.msi) [MacOS Installer](https://smce-xina.s3.amazonaws.com/dist/connect/XINA+Connect+Beta-1.0.0.dmg) # XINA Tunnel XINA Tunnel is a command line application required for client applications to communicate with the XINA Server via the [XINA API](/books/api-reference). This application is distributed as a Java jar file and requires Java 17 or greater to run. The recommended OpenJDK build is available [here](https://learn.microsoft.com/en-us/java/openjdk/download). ### Latest Version #### XINA Tunnel 11.2.3 [Download](https://smce-xina.s3.amazonaws.com/dist/11.2.3/xina-tunnel.jar) ### Usage Windows ``` java -jar "path to xina_tunnel.jar" ^ -host "host URL or IP address" ^ -keyfile "path to key.json" ``` MacOS, Linux ``` java -jar "path to xina_tunnel.jar" \ -host "host URL or IP address" \ -keyfile "path to key.json" ``` ### Old Versions #### XINA Tunnel 9.2.0 [Download](https://smce-xina.s3.amazonaws.com/dist/tunnel/xina_tunnel_9.2.0.zip) ### Usage Windows ``` java -jar "path to xina_tunnel.jar" ^ -host "host URL or IP address" ^ -keyfile "path to key.json" ``` MacOS, Linux ``` java -jar "path to xina_tunnel.jar" \ -host "host URL or IP address" \ -keyfile "path to key.json" ``` # XINA Import XINA Import is a utility for importing XINA API actions as JSON files. This application is distributed as a Java jar file and requires Java 17 or greater to run. The recommended OpenJDK build is available [here](https://learn.microsoft.com/en-us/java/openjdk/download). ### Latest Version #### XINA Import 11.2.3 [Download](https://smce-xina.s3.amazonaws.com/dist/11.2.3/xina-import.jar) Windows ``` java -jar "path to xina_import.jar" ^ [additional arguments...] ``` MacOS, Linux ``` java -jar "path to xina_import.jar" \ [additional arguments...] ```
Argument | Info | Default |
---|---|---|
`-host | the XINA Tunnel host | `"localhost"` |
`-post | the XINA Tunnel port | `41746` |
`-okmove | if set, move files to path to after successful import | none (files are not moved) |
`-oktrash` | if set, move files to OS trash after successful import | `false` |
`-okdelete` | if set, permanently delete files after successful import | `false` |
`-ermove` | if set, move files to path to after failed import | none (errors stop import) |
`-dir | path to directory containing files to import | |
`-watch | path to directory to watch for files to import | |
`-recursive` | if true in `dir` or `watch` mode, searches directory recursively for JSON files | `false` |
Argument | Info | Default |
---|---|---|
`-host | the XINA Tunnel host | `"localhost"` |
`-post | the XINA Tunnel port | `41746` |
`-okmove | if set, move files to path to after successful import | none (files are not moved) |
`-oktrash` | if set, move files to OS trash after successful import | `false` |
`-okdelete` | if set, permanently delete files after successful import | `false` |
`-ermove` | if set, move files to path to after failed import | none (errors stop import) |
`-dir | path to directory containing files to import | |
`-watch | path to directory to watch for files to import | |
`-recursive` | if true in `dir` or `watch` mode, searches directory recursively for JSON files | `false` |
Argument | Info | Default |
---|---|---|
`-host | the XINA Tunnel host | `"localhost"` |
`-post | the XINA Tunnel port | `41746` |
`-movejson | directory to move JSON files to after import | none (files are not moved) |
`-movefile | directory to move other files to after import | none (files are not moved) |
`-deljson` | if set, permanently delete JSON files after import | `false` |
`-delfile` | if set, permanently delete other files after import | `false` |
`-dir | path to directory containing files to import | |
`-watch | path to directory to watch for files to import | |
`-recursive` | if true in `dir` or `watch` mode, searches directory recursively for JSON files | `false` |
Name | Req | Description | Default |
---|---|---|---|
task | ✓ | task ID | |
conf | ✓ | JSON conf file path | |
temp | ✓ | temp directory path | |
import | ✓ | import directory path (for file outputs) | |
post | ✓ | post directory path (for post-import outputs) | |
host | tunnel host | `"localhost"` | |
port | tunnel port | `41746` |
Name | Req | Description | Default |
---|---|---|---|
origin | ✓ | origin group | |
slice | slice length in minutes | `60` | |
t | slice time barrier (see below) |
Name | Req | Description | Default |
---|---|---|---|
task | ✓ | task ID | |
conf | ✓ | JSON conf file path | |
temp | ✓ | temp directory path | |
import | ✓ | import directory path (for file outputs) | |
post | ✓ | post directory path (for post-import outputs) | |
host | tunnel host | `"localhost"` | |
port | tunnel port | `41746` |
Name | Req | Description | Default |
---|---|---|---|
pipe | ✓ | pipe group path, or model path if no pipe | |
slice | slice length in minutes | `60` | |
t | TBD REMOVE slice time barrier (see below) | ||
TODO: Add re-mine options |
Name | Req | Description | Default |
---|---|---|---|
task | ✓ | task ID | |
conf | ✓ | JSON configuration file path | |
temp | ✓ | temp directory path for storing temporary files during execution | |
import | ✓ | import directory path (for file outputs) | |
log | ✓ | log file path | |
out | ✓ | \[TBD\] the ouptut directory path | |
post | ✓ | post directory path (for post-import outputs) | |
cancellation | Path to the cancellation file for detecting cancel requests | ||
extract | Path to the [struct\_extract](https://wiki.xina.io/books/structured-data-standards/page/struct-extract-interface) app. Only used if the archive format is `xpf`. | ||
pkt\_models | \[TBD\] models to use packet time by default | ||
plot | ✓ | Path to app that generates plot PDFs | |
python | ✓ | Path to the Python executable used by the plot app | |
host | tunnel host | `"localhost"` | |
port | tunnel port | `41746` |
Name | Type | Req | Description | Default |
---|---|---|---|---|
model | `utf8text ` | ✓ | path of model to export data from | |
label | `utf8text` | The text that will be used to name the files and final zip file. The format will be like `2024_06_12_00_00_00_2024_06_12_00_20_00_profile_label` | ||
profile | `utf8text ` | The name of the Profile if the export was generated from one | ||
start | `instant(us)` | ✓ | Start time of data to export | |
end | `instant(us)` | ✓ | End time of data to export | |
ueid | `UUID` | Event UUID of interval if the export was requested for an interval. The event's start and end time will be used instead of `start` and `end`. | ||
auto\_conf | `struct_auto_conf` | The `struct_auto_conf` that triggered the export. Only provided if the export was auto generated. | ||
plot\_conf | `struct_plot_conf` | The plot configuration used to generate the plot PDF. See [plot format](https://wiki.xina.io/books/oci-user-guide/page/export-plot-configuration-json-format). | One mnemonic per plot, one plot per page, sorted by `mn_id` in ascending order. | |
data\_conf | `struct_data_conf` | ✓ | See [struct\_data\_conf](https://wiki.xina.io/link/170#bkmrk-struct_data_conf-jso) | |
disable\_filter | `boolean` | If `true`, does not apply the filters defined in `data_conf`. | false | |
copy | `boolean` | \[TBD REMOVE\] | ||
multi | `boolean` | \[TBD REMOVE\] Has extract process all archives at once. This was added for performance reasons since loading the mnem def is slow. |