Support

---

Overview

Ticket System

FAQ

Patches

IRIS

U.S. EDU/Research

Documentation

How to Install Contributed Code for Antelope

The Antelope User Community produces open-source Contributed Software that is based on Antelope and designed to be used in conjunction with it. Antelope versions 5.4 and earlier included compiled copies of the contributed code in the main Antelope ISO image. As discussed further in the Release Notes for Antelope 5.5, for Antelope 5.5 and later the contributed code is separately hosted by the Antelope User Community. The contributed code may be installed

• as an option during the Antelope installation process;
• at a later time via the supplied install_contrib(1) script;
• downloading and installing the compiled tarball by hand; or
• by compiling the contributed source-code onesself.

Itemized Steps -- option A (Antelope installer option)

The default option to install the contributed code is to approve download and unpacking of the contributed-code tarball when prompted by the main Antelope installation program. This method requires a working internet connection that can connect to the appropriate web-site to download the contributed-code tarball:

1. Install Antelope
2. During the Antelope installation process, respond "Yes" when prompted by the installer to "Download contributed code?" (one of the last steps in the installation process)

Itemized Steps -- option B (install_contrib(1) script)

If you choose not to install the contributed code during the Antelope installation process, or you do not have an internet connection at the time, you may install later via the install_contrib(1) script. This option also requires an internet connection:

1. source the appropriate setup file ($ANTELOPE/setup.csh or $ANTELOPE/setup.sh)
2. Run the program install_contrib

Itemized Steps -- option C (download and install by hand)

In lieu of running the install_contrib(1) script, you may download and install the relevant files by hand:

1. Check the current download location and filename:

   % pfecho install_antelope 'contribcode_params{download_site}' 'contribcode_params{filename}'
   contribcode_params{download_site}       https://github.com/antelopeusersgroup/antelope_contrib/releases/download/5.8
   contribcode_params{filename}    Darwin_x86_contrib.tar.bz2
   
   

2. Download the file with web-browser, wget or similar utility:

   % wget 'https://github.com/antelopeusersgroup/antelope_contrib/releases/download/5.8/Darwin_x86_contrib.tar.bz2'
   

   (Note that the URL will change depending on the platform you're on)
3. Install the contributed-code file:

   % mv Darwin_x86_contrib.tar.bz2 /opt/antelope
   % cd /opt/antelope
   % bunzip2 -c Darwin_x86_contrib.tar.bz2 | tar xvf -
   

Itemized Steps -- option D (compile from source)

If you wish, you may download the contributed-code source and compile it yourself:

1. Make sure Antelope is installed
2. source the appropriate setup file $ANTELOPE/setup.csh or $ANTELOPE/setup.sh
3. In a terminal window or shell, run the following:
   1. % cd $ANTELOPE
   2. % mkdir contrib
   3. % cd contrib
   4. % git clone https://github.com/antelopeusersgroup/antelope_contrib src
   5. % cd src
   6. % make Include
   7. % make install

Note that if developers have committed changes to the contributed-code repository that are incompatible with the version of Antelope you are running, the affected contributed-code programs may not work. We reiterate that BRTT does not provide support for contributed code, including for compilation problems. For support on compiling and/or using contributed-code programs, please contact the originating author(s) (hopefully listed in the man-pages for the programs/libraries in question), or the Antelope User Community.