Install on RedHat or CentOS

There are two ways to install UV-CDAT on your system; method 1 is to download a binary release of the application (available here), and method 2 is to do a full build from source. We strongly recommend the binary installation; it's a lot faster and easier to do if you're not comfortable with the command line. It also requires a lot fewer pieces of software to be installed; almost everything gets bundled with the binary installation. This guide will walk you through installation on your system using both methods (binary and source).

System Requirements

First, let's start with the bare minimum you need to actually be able to install UV-CDAT.

Requirements for All Installations

• Qt (4.8.x)
  • The version of Qt bundled with RedHat has a couple of bugs that make it not work with UV-CDAT
  • You can obtain a correctly build version of Qt here.
    • Once you've downloaded it, move it to /
      • sudo mv qt-CentOS-6.5-RedHat6-64bit-4.8.4.tar.bz2 /
    • Now you can untar it
      • sudo tar -xf qt-CentOS-6.5-RedHat6-64bit-4.8.4.tar.bz2
• gfortran (4.6 <= version < 5.0)
  • sudo yum install gcc-gfortran

Requirements for Source Install

If you want to just install everything in one go, the yum command is here:

sudo yum install cmake gcc-gfortran libpng-devel libjpeg-devel libxml2-devel libxslt-devel sqlite sqlite-devel bzip2-devel gdbm-devel openssl-devel tcl-devel tk-devel db4-devel expat-devel libffi-devel gcc-c++ mesa-libGL-devel mesa-libGLU-devel libXt-devel automake

• CMake (2.8.12 or greater)
  • sudo yum install cmake
• libpng
  • sudo yum install libpng-devel
• libjpeg
  • sudo yum install libjpeg-devel
• libxml2
  • sudo yum install libxml2-devel
• libxslt
  • sudo yum install libxslt-devel
• sqlite
  • sudo yum install sqlite-devel
• bzip2
  • sudo yum install bzip2-devel
• gdbm
  • sudo yum install gdbm-devel
• openssl
  • sudo yum install openssl-devel
• tcl
  • sudo yum install tcl-devel
• tk
  • sudo yum install tk-devel
• db4
  • sudo yum install db4-devel
• expat
  • sudo yum install expat-devel
• libffi
  • sudo yum install libffi-devel
• c++
  • sudo yum install gcc-c++
• mesa
  • sudo yum install mesa-libGL-devel
  • sudo yum install mesa-libGLU-devel
• libxt
  • sudo yum install libXt-devel
• automake
  • sudo yum install automake

Installing from Binary

1. Download the most recent release of UV-CDAT
2. Move the binary to /
sudo mv UV-CDAT-2.4.1-CentOS-6.5-RedHat6-64bit.tar.gz /
3. Change directory to /
cd /
4. Extract the binary from the archive
   sudo tar xzf UV-CDAT-4.2.1-CentOS-6.5-RedHat6-64bit.tar.gz
5. That's it! You're all done installing. Skip on down to Run UV-CDAT.

Installing from Source

1. Go to the directory you want to download UV-CDAT's source code to
   cd ~
2. Clone UV-CDAT
   git clone git://github.com/UV-CDAT/uvcdat
3. Create a build directory
   mkdir build-uvcdat
4. Change directory to the build directory
   cd build-uvcdat
5. Initialize the build scripts using CMake
   cmake ../uvcdat -DQT_QMAKE_EXECUTABLE="/usr/local/uvcdat/Qt/4.8.4/bin/qmake"
   • To install to a specific location, you can use cmake ../uvcdat -DCMAKE_INSTALL_PREFIX="/path/to/install/uvcdat" -DQT_QMAKE_EXECUTABLE="/usr/local/uvcdat/Qt/4.8.4/bin/qmake"
   • Other build options are documented here
6. Run make
make -j4
7. Once it finishes building, you're all done! UV-CDAT will be installed either in the build-uvcdat/install folder or at whatever path you provided in the -DCMAKE_INSTALL_PREFIX argument to cmake.

Run UVCDAT

1. Set up the UV-CDAT environment for your current shell session
   source /usr/local/uvcdat/2.4.1/bin/setup_runtime.sh (or setup_runtime.csh, for [t]cshell users)
2. Start UV-CDAT
   uvcdat

Restore your environment to its pre-uvcdat state

source /usr/local/uvcdat/2.4.1/bin/reset_runtime.sh (or reset_runtime.csh, for cshell users)