How To Install Antelope for MacOS and RHEL Users

Summary

This page will walk you through the installation process for Antelope on macOS and RHEL hosts. The download and installation process is the same for both macOS and RHEL users. For RHEL users, after completing the Antelope installation, see Registering and Requesting Licensing For RHEL. 

If you have any issues with this installation, please contact the IGPP HelpDesk for assistance.

Downloading and Installing Antelope 

To obtain the Antelope installer:

1. Fill out the Antelope registration page: http://sunlight.brtt.com:8010/edu_registration_download.
   
   
   
2. Check your email for the Antelope ISO download link.
3. Mount the ISO:
   1. macOS: double-click on the ISO to mount it.

   2. RHEL: 

      mount -t iso9660 -o loop Antelope5.14.rhel9_x86.iso /mnt

4. Run the installer: 
   1. macOS: double-click on Install_antelope. 

   2. RHEL: 

      sudo /mnt/Install_antelope

5. During the RHEL installation process: 

   1. Do you accept the above license agreement [yn] ? y
   2. Do you wish to download and install the Antelope contributed code [yn] ? y
   3. Do you wish to download and install the approx. 5.0 GB of high-resolution map data [yn] ? n
6. At the end of the macOS installation process, go to How To Install Antelope for MacOS and RHEL Users#Registering and Requesting a License for macOS.

7. At the end of the RHEL installation process, you will see something like: 

   Exiting Antelope Installer.
   
   Done.

   On RHEL, unmount the ISO: 

   umount /mnt

   On RHEL, go to How To Install Antelope for MacOS and RHEL Users#Registering and Requesting a License For RHEL. 

Registering and Requesting a License for macOS

1. During the installation on MacOS, you will see a pop-up to register Antelope. Fill out the form with your information and click "Register" in the bottom right corner.
   **Note: For the hostname, enter <HOSTNAME>.ucsd.edu of the host that you are installing on.**

    

   The register_antelope(1) GUI will run as a normal part of the Antelope installation process. This program will request that you fill out a form with relevant details. When you hit the Register button, the license request will be sent to register@brtt.com.

   For renewal

   If you already have Antelope installed and need to renew or request a license, you may run register_antelope(1) from the command line after properly setting up your Antelope environment (register_antelope(1) resides in $(ANTELOPE)/bin). Setting up your environment is done by executing one of the following commands:

   1. For csh or tcsh shells: 

      source /opt/antelope/5.12/setup.csh

   2. For zsh or bash shells: 

      source /opt/antelope/5.12/setup.sh

2. To start a license request, use this command:

   ~/BRTT-license-request

3. You will be sent an email to confirm your license request after you click to register. It will take roughly 1-3 days for BRTT to respond with your license. 
4. You will see another pop-up requesting additional information. This can be skipped by clicking "Abort"
   
5. Go back to your Terminal window and type "yes" to continue with the download and installation of Antelope.

6. After the download is complete, unmount the ISO with the following command:

   umount /Volumes/Antelope_5.12 

Applying the License to MacOS

1. Once you have the license.pf file, open the /opt/antelope/5.12/data/pf folder

   open /opt/antelope/5.12/data/pf.

2. drop the license.pf file into the pf folder

Registering and Requesting a License For RHEL

1. Run register_Antelope: 

   /opt/antelope/5.13/bin/register_antelope

   Sample output: 

   Please edit and completely fill out the form
   	in this file:
   
   		~/BRTT-license-request
   
   	Then send it to register@brtt.com.

2. Edit the file listed in the output: 

   vim ~/BRTT-license-request

   Filing out the following fields: 

   License Key Request for Release 5.13 Linux CentOS release 7.9.2009 (Core) 3.10.0 2023-04-29 
   (Please e-mail this file to register@brtt.com)
   # parameters:
   contact		         
   email                
   institution          
   address1             
   city                 
   state                
   country              
   zip                  
   phone                

3. Email the completed file to:

   register@brtt.com

4. When the license.pf file is returned, move the file to /opt/antelope/5.13/data/pf: 

   sudo mv ~/license.pf /opt/antelope/5.13/data/pf/

5. Change the permissions: 

   sudo chmod 664 /opt/antelope/5.13/data/pf/license.pf

Check License

1. Setup the Antelope environment for the current session (for Bourne or related shells): 

   source /opt/antelope/5.13/setup.sh 

   (for CSH-compatible shell): 

   source /opt/antelope/5.13/setup.csh

2. Check license: 

   /opt/antelope/5.13/bin/check_license

   Should see: 

   license ok

   For additional information: 

   /opt/antelope/5.13/bin/check_license -v