NASAView

##### Software Documentation

- About NASAView
- Installation
- Operation

##### Download

- Linux 32-bit Package
- Linux 64-bit Package
- Mac OS X Intel Package
- Mac Power PC Package
- Solaris Package
- Windows Package

##### Project Documentation

- Project Information
- Project Reports

## Installation

This section describes how to install the NASAView software contained in the ${xdoc-artifactId} package. The following topics can be found in this section:

- System Requirements
- Unpacking the Package
- Miscellaneous Notes

## System Requirements

The following table shows a list of platforms that NASAView currently supports:

Platform | Version
--- | ---
Linux (32-bit) | Built and tested on CentOS Red Hat 5 with Motif 2.3.4.
Linux (64-bit) | Built and tested on CentOS Red Hat 5 with Motif 2.3.4.
Mac OS X (Intel) | Built and tested on 10.8.5.
Mac PowerPC | Built on 10.8.5, but it has not been tested since PowerPC is no longer supported on Macs running 10.7 and higher.
Solaris | Built and tested on Solaris 10 with Motif 2.1.3.
Windows | Built and tested within a virtual Windows XP environment with Service Pack 3 running on a Windows 7 platform. Tested on a Windows 7 platform as well. For Windows XP users, at least Service Pack 2 is required.

The Linux and Solaris releases of NASAView require X Windows and the Motif window manager to be installed in order to function properly. NASAView is not guaranteed to run under other X Window systems, but there are rumors of success. In addition, if NASAView is to be displayed on a remote terminal, the remote terminal must have an X Windows emulator installed.

## Unpacking the Package

Download the ${xdoc-artifactId} package from the NASAView web page. The binary distribution is available in either zip or tar/gzip packages depending on the platform. Unpack the selected binary distribution file according to the selected platform below.

### Linux

Unpack the selected binary distribution file with the following command:

    [node: ~] tar -xzvf ${xdoc-artifactId}-${xdoc-version}_linux.tar.gz

The commands above result in the creation of the ${xdoc-artifactId}-${xdoc-version}_linux directory with the following directory structure:

- README.txt

  A README file directing the user to the available documentation for the project.

- LICENSE.txt

  The copyright notice from the California Institute of Technology detailing the restrictions regarding the use and distribution of this software. Although the license is strictly worded, the software has been classified as Technology and Software Publicly Available (TSPA) and is available for anyone to download and use.

- doc/

  This document directory contains a local web site with the NASAView Guide and other configuration management related information. Just point your favorite browser to the index.html file in this directory.

- nasaview

  The NASAView executable file.

- nasaview.uid

  Resource file for the NASAView application.

- *.so

  Support libraries.

- FHA01118.LBL

  Test label.

### Mac OS X

Unpack the selected binary distribution file by either double-clicking it on the desktop or executing the following command:

    [node: ~] tar -xzvf ${xdoc-artifactId}-${xdoc-version}_mac.tar.gz

The commands above result in the creation of the ${xdoc-artifactId}-${xdoc-version}_mac directory with the following directory structure:

- README.txt

  A README file directing the user to the available documentation for the project.

- LICENSE.txt

  The copyright notice from the California Institute of Technology detailing the restrictions regarding the use and distribution of this software. Although the license is strictly worded, the software has been classified as Technology and Software Publicly Available (TSPA) and is available for anyone to download and use.

- doc/

  This document directory contains a local web site with the NASAView Guide and other configuration management related information. Just point your favorite browser to the index.html file in this directory.

- NASAView

  The NASAView executable file.

### Solaris

Unpack the selected binary distribution file with the following command:

    [node: ~] tar -xzvf ${xdoc-artifactId}-${xdoc-version}_solaris.tar.gz

The commands above result in the creation of the ${xdoc-artifactId}-${xdoc-version}_solaris directory with the following directory structure:

- README.txt

  A README file directing the user to the available documentation for the project.

- LICENSE.txt

  The copyright notice from the California Institute of Technology detailing the restrictions regarding the use and distribution of this software. Although the license is strictly worded, the software has been classified as Technology and Software Publicly Available (TSPA) and is available for anyone to download and use.

- doc/

  This document directory contains a local web site with the NASAView Guide and other configuration management related information. Just point your favorite browser to the index.html file in this directory.

- nasaview

  The NASAView executable file.

- nasaview.uid

  Resource file for the NASAView application.

- *.so

  Support libraries.

- FHA01118.LBL

  Test label.

### Windows

Unpack the selected binary distribution file by either double-clicking it on the desktop or executing the following command:

    C:\> unzip ${xdoc-artifactId}-${xdoc-version}_win.zip

The commands above result in the creation of the ${xdoc-artifactId}-${xdoc-version}_win directory with the following directory structure:

- README.txt

  A README file directing the user to the available documentation for the project.

- LICENSE.txt

  The copyright notice from the California Institute of Technology detailing the restrictions regarding the use and distribution of this software. Although the license is strictly worded, the software has been classified as Technology and Software Publicly Available (TSPA) and is available for anyone to download and use.

- doc/

  This document directory contains a local web site with the NASAView Guide and other configuration management related information. Just point your favorite browser to the index.html file in this directory.

- nasaview.exe

  The NASAView executable file.

- *.dll

  Support libraries. These files can be moved to the C:\Windows\System directory if desired but are probably better off left in this location.

- FHA01118.LBL

  Test label.

## Miscellaneous Notes

NASAView can be invoked as a Web Browser helper application by specifying the following in a browser:

- File Type: application/PDS
- Action: NASAView
- Extensions: LBL, IMG