Install and Run

The Data Viewer can be run on Windows, Mac OS and Linux.

Mac OS

Mac OS versions are distributed as an Apple Disk Image (dmg). The dmg contains a single .app which can be placed anywhere on your machine and then run. The recommended location is in your Applications directory. The .app contains all required dependencies.

Linux

The Linux version is distributed as an AppImage which are similar to the Mac OS .apps. All dependencies are contained within the AppImage which makes it easy to distribute and run. The user or sys admin does not need to manage dependencies. The AppImage can also be run from any directory by double clicking it or running it from the terminal:

cd <dir containing appimage>
./<appimage_name>

If you are not able to run it, you may need to make it executable:

cd <dir containing appimage>
chmod +x <appimage_name>

Windows

The Windows version is distributed as a zip file that contains the executable and all dependencies. The zip file can be extracted to any location. After extraction, the .exe can be run.

Supplementary Directory

We use a separate repository for each mission to store released versions of the Data Viewer, config files, and other miscellaneous applications and files. The repository is used for more than just the Data Viewer. For example, on OCI we have an ocigse Git repository that's maintained on the gs490v-gitlab GitLab. We use the version control to provide updates to the workstations and end users.

The instructions to setup the gse repository is mission specific, but can generally be boiled down to:

1. Acquire permissions to access the repository. Usually a NAMS request.
2. Checkout the repository
3. Perform initial one-time setup

If a machine does not have direct access to the repository, the supplementary directory may instead be distributed as a zip file.

The instructions to setup the ocigse directory are maintained in the README.md of the repository: https://gs490v-gitlab.ndc.nasa.gov/497_OCI/OCI_XINA