Hyrax_BES_Installation.adoc

BES Installation

Table of Contents

• 1. Download
• 2. Install

1. Download

It is necessary that you download and install both the libdap and BES binaries.

1. Visit the Hyrax Data Server Page.

2. Select the most recent in the list of Available Versions.

3. Scroll down the following page until you reach the section entitled Binaries for Hyrax x.x.x, then continue scrolling until you see the heading titled BES.

4. You need to download both the libdap and BES RPMs which should be named libdap-x.x.x and bes-x.x.x.

5. The downloaded files should be named something like libdap-x.x.x.el6.x86_64.rpm and bes-x.x.x.static.el6.x86_64.rpm.

Warning

In order to install the RPMs on your system, you must be running a 64bit OS. If you are running 32bit OS, attempting to install the libdap and BES RPMs will result in errors.

2. Install

1. Use yum to install the libdap and bes RPMs:
   sudo yum install libdap-3.x.x.rpm bes-3.x.x.rpm).

2. At this point you can test the BES by typing the following into a terminal:

   1. start it:
      sudo service besd start
      (Or use the script in /etc/init.d with sudo: /etc/init.d/besd start)

   2. connect using a simple client:
      bescmdln

   3. get version information:
      BESClient> show version

   4. exit from bescmdln:
      BESClient> exit

Note

If you are upgrading to Hyrax 1.13.4 or newer from an existing installation older than 1.13.0, in the bes.conf file the keys BES.CacheDir, BES.CacheSize, and BES.CachePrefix have been replaced with BES.UncompressCache.dir, BES.UncompressCache.size, and BES.UncompressCache.prefix respectively. Other changes include the gateway cache configuration (gateway.conf) which now uses the keys Gateway.Cache.dir, Gateway.Cache.size, and Gateway.Cache.prefix to configure its cache. Changing the names enabled the BES to use separate parameters for each of its several caches, which fixes the problem of 'cache collisions.'