View source for CIDD-Binary-Release

== How to install the CIDD binary release? ==

The CIDD display is tricky to compile, requiring a 32-bit mode for the build.
We compile CIDD and package it up into a binary tar file, from which it can be installed.

1. Download the tar file

You can find the tar file under the latest releases page on github:

* '''[https://github.com/NCAR/lrose-core/releases lrose-core releases]'''

Here is an example name from the 2020/07/01 release:

<code lang="bash">  lrose-cidd-20200701.bin.x86_64.tgz </code>


2. Untar the tar file

Untar the file into a temporary directory. Here we use the above file as an example:

<code lang="bash">  cd /tmp </code>

<code lang="bash">  tar xvfz ~/Downloads/lrose-cidd-20200701.bin.x86_64.tgz </code>


3. Perform the installation

<code lang="bash">  cd /tmp/lrose-cidd-20200701.bin.x86_64 </code>

<code lang="bash">  ./install_cidd_bin_release.py </code>

This will install the CIDD binaries into <code lang="bash"> /usr/local/lrose/bin </code>.

The relevant files are:

<code lang="bash">  /usr/local/lrose/bin/CIDD </code>

<code lang="bash">  /usr/local/lrose/bin/lrose-cidd_runtime_libs </code>

The <code lang="bash">lrose-core_runtime_libs </code> directory contains most of the 32-bit libraries that were used during the compile and build.


4. Install 32-bit runtime support

To ensure that you have 32-bit runtime support for CIDD, you will need to install the relevant 32-bit packages.

The best way to do that is to run a python script from lrose-core.

<code lang="bash">  mkdir ~/git </code>

<code lang="bash">  cd ~/git </code>

<code lang="bash">  git clone https://github.com/ncar/lrose-core </code>

<code lang="bash">  cd lrose-core/build </code>

<code lang="bash">  install_linux_packages.py --cidd32 </code>

<code lang="bash"> install_linux_packages.py </code> will determine the operating system version from the <code lang="bash">/etc/os-release </code> file. It will then install the required packages for that version of the OS.


5. Running CIDD

You should now be able to run CIDD.

The following is a good test:


<code lang="bash"> exec /bin/csh
  # set resources
  set timestr = `date -u +%Y%m%d%H%M%S`
  set XResourcesFile = /tmp/XResources4CIDD.${timestr}
  touch $XResourcesFile
  echo "OpenWindows.MonospaceFont: 7x13" >> $XResourcesFile
  echo "OpenWindows.RegularFont: 6x13" >> $XResourcesFile
  echo "OpenWindows.BoldFont: 6x13bold" >> $XResourcesFile
  xrdb -nocpp -override $XResourcesFile
  /bin/rm -f $XResourcesFile
  if (-e ~/.Xdefaults) then
    xrdb -nocpp -override ~/.Xdefaults
  endif
  # set fonts
  xset fp= /usr/share/X11/fonts/misc/,/usr/share/X11/fonts/75dpi/,/usr/share/X11/fonts/100dpi/
  xset fp= /usr/share/fonts/X11/misc/,/usr/share/fonts/X11/75dpi/,/usr/share/fonts/X11/100dpi/
  xset fp= /usr/X11R6/lib/X11/fonts/misc/,/usr/X11R6/lib/X11/fonts/75dpi/,/usr/X11R6/lib/X11/fonts/100dpi/
  # start CIDD
  /usr/local/lrose/bin/CIDD -font fixed -p http://front.eol.ucar.edu/displayParams/CIDD.pecan </code>

This should download data remotely from NCAR/EOL, and display it on CIDD.