= Starlink Software Collection — Download and Install 2023A = [[2023A|2023A release notes]] The following distributions of the 2023A release of the Starlink Software Collection are available: * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-Linux-CentOS7.tar.gz|Linux (CentOS 7)]] 1.3G .tar.gz, MD5 sum: d4c2ef42829de7e55296d313587ca500 * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-Linux-Rocky8.tar.gz|Linux (Rocky 8)]] 1.4G .tar.gz, MD5 sum: a35f5fafb326db2889f7536930e26c5e * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-Linux-Rocky9.tar.gz|Linux (Rocky 9)]] 1.3G .tar.gz, MD5 sum: ea6f2bbed81fa8ddfbf488f62e77306b * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-Linux-Ubuntu22.tar.gz|Linux (Ubuntu 22.04)]] 1.4G .tar.gz, MD5 sum: ff93c8735d38dfb0a1cf9eac82abb014 * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-Linux-Ubuntu23.tar.gz|Linux (Ubuntu 23.10)]] 1.4G .tar.gz, MD5 sum: 47276f35a9b0eced1586d1c321e2ba12 * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-macOS-ARM.tar.gz|Linux (macOS, ARM)]] 805M .tar.gz, MD5 sum: 7256584e182b990f0c2f24fd2991d250 * [[https://ftp.eao.hawaii.edu/starlink/2023A/starlink-2023A-macOS-Intel.tar.gz|Linux (macOS, Intel)]] 857M .tar.gz, MD5 sum: eba7ac8a3d57576aa4ee6b1286bee2fe * For earlier previews, please see the [[https://ftp.eao.hawaii.edu/starlink/2023A/beta| beta directory]]. To check the MD5 checksum of your downloaded file, run either the `md5sum`, `md5`, or `md5deep` command, depending on which you have installed. For Linux you can also try [[StarlinkFlatpak | installing using Flatpak]]. ## This macOS software was built on Yosemite, but is believed to run on all versions from Snow Leopard onwards. Please note that the East Asian Observatory does not, however, have access to versions of macOS prior to Yosemite for testing or bug fixing. ## We also have three new experimental builds, built on macOS 10.14.6 (Mojave), CentOS 7.4 and on Ubuntu 17.10. We do not run these systems routinely at EAO so these builds have had less testing than our CentOS 6 build: ## * [[https://ftp.eao.hawaii.edu/starlink/2021A/REV1/starlink-2021A-OSX-REV1.tar.gz|macOS (64-bit, macOS 10.14.6 Mojave)]] (720 MB .tar.gz, MD5 sum: 88b37573dfbc5870bf0d5ea62dd343fd) ## * [[https://ftp.eao.hawaii.edu/starlink/2021A/REV1/starlink-2021A-CentOS7-REV1.tar.gz|CentOS 7.4 (64-bit, CentOS 7.4 Linux)]] (959 MB .tar.gz, MD5 sum: e6aa09509b314ec43389f44bcdeae004) ## * [[https://ftp.eao.hawaii.edu/starlink/2021A/REV1/starlink-2021A-Ubuntu-REV1.tar.gz|Ubuntu 17.10 (64-bit, Ubuntu 17.10 Linux)]] (978 MB .tar.gz, MD5 sum: 43de7460303987824e692e147be3ef18) == Installation instructions == The tar file will unzip into a `star-2023A/` directory in the directory where you downloaded the tar file. This release can be placed anywhere. When using the software, set the `STARLINK_DIR` environment variable to the location of the `star-2023A/` directory, i.e. if you had unzipped it into a `/home/person/software` directory, then the `STARLINK_DIR` environment variable would be set to `/home/person/software/star-2023A`. === macOS === There may be non-trusted developer warnings on macOS Catalina (10.15) and later. In this case you can try removing the com.apple.quarantine attribute as follows: `sudo xattr -dr com.apple.quarantine star-2023A` ==== macOS Requirements ==== 1. An up-to-date XQuartz X11 distribution must be installed. If you already have XQuartz installed but need to update it, you can run the application and go to the top menu and select: X11->Check for X11 updates. If you need to install the software, it can be found here: [[http://xquartz.macosforge.org/landing/|http://xquartz.macosforge.org/landing]]. 2. A recent Java JDK must be installed to use the StarJava programs such as `topcat`, `splat` `stilts` and `frog`. This can be found at [[http://www.oracle.com/technetwork/java/javase/downloads/index.html]]. To check if you have Java installed already, open a terminal, type `java -version` and see if the command is found, and if you have 1.8 installed. There should not be any other dependencies for installing the macOS build. === Known issues on macOS builds === * We have not yet been able to create a working splat installation in the ARM macOS build. If we manage to get this working we will release a patched version of this build only. * We couldn't get the VTK software to build correctly; it has been disabled on macOS builds in this relase, which will prevent Gaia from using its 3D volume rendering features. * ORAC-DR appears to have trouble launching figaro commands on the macOS builds. For JCMT data, we believe this will only affect you if you're reducing heterodyne pointing observations. * When starting gaia you may see an error similar to this: {{{ X Error of failed request: BadValue (integer parameter out of range for operation) Major opcode of failed request: 45 (X_OpenFont) Value in failed request: 0x60015d Serial number of failed request: 1743 Current serial number in output stream: 1744 }}} This seems to be caused by some problem in the interaction between Tk and unicode font handling in XQuartz. If you see this error, it can usually be resolved by starting gaia with an option that prevents the use of unicode characters: {{{ % gaia -unicoderadec 0 }}} This error will also make it hard to launch ORAC-DR with the interactive display, we recommend using a -nodisplay option if you have to run gaia with the `-unicoderadec 0` flag == Post-installation Run-up == Before you can run the Starlink Software Collection, you need to run our setup scripts. This will have to be done every time you open a new terminal, before you can run any Starlink commands. If your terminal is running `bash` or other `sh`-like shell (this is the usual default on modern Linux distributions and macOS) please type the following commands into your terminal `export STARLINK_DIR=/star-2023A` `source $STARLINK_DIR/etc/profile` If you have installed your star-2023A somewhere other than into the root directory (`/`) you would instead set the first command to point to the location of the installed star-2023A/ directory. e.g., if you had put it in your home directory, you would type: `export STARLINK_DIR=/home/MyUserName/star-2023A` `source $STARLINK_DIR/etc/profile` Some astronomy departments still set up their computers to use `tcsh` as the default shell instead of `bash`. The setup process is similar, but the commands are slightly different. If you have installed star-2023A into the root directory, you will need to type the following commands into your terminal: `setenv STARLINK_DIR /star-2023A` `source $STARLINK_DIR/etc/cshrc` `source $STARLINK_DIR/etc/login` And again, similar to the bash shell instructions above, if you have installed star-2023A into a different directory you will have to give the path to that directory in your first command (and still run the following two commands) e.g.: `setenv STARLINK_DIR /home/MyUserName/star-2023A` You can now run Starlink commands within your current terminal. Any time you wish to start using Starlink Software in a new terminal, you will need to run the appropriate 2 or 3 commands above again. For convenience, you could save these commands into an alias. === Running Software Packages === For most command line packages, typing the name of a package will make its commands available to use, tell you that it has been loaded, and tell you what command to run to find out more about the package. For example, try typing: `kappa` into your terminal. Some Starlink software also launches a graphical interface. If you type: `gaia &` into your terminal, the GAIA data visualization software will launch and you can load in astronomy maps and cubes to view (both SDF and FITS formats are supported). === Important Note (for Linux only in this release) === The setup scripts put the 'Starlink' version of various libraries into your `LD_LIBRARY_PATH` variable. Unfortunately, this means that after sourcing the Starlink setup scripts, other command line programs (such as e.g. CASA) may not work ''inside the terminal in which you sourced Starlink''. To get around this, simply: 1. Don't source the Starlink scripts by default (e.g. don't put the commands into your `.bashrc`, `.profile`, `.login` or `.cshrc` files), but instead source them manually every time you're running Starlink software. 2. Run other software (such as CASA) in a different terminal from the one in which you are running Starlink. == ORAC-DR for WFCAM == Because of the large size of WFCAM calibration files, they have been split off from the main download tarballs, as not everybody will be reducing WFCAM data using ORAC-DR. These calibrations can be [[http://starlink.eao.hawaii.edu/extras/oracdr_cal_wfcam-kapuahi.tar.gz|downloaded here]] (1.06GB .tar.gz). The tar file will unzip into a `wfcam/` directory in the directory you downloaded the tar file to. To install these calibration files, copy the directory into the `$STARLINK_DIR/bin/oracdr/cal/` directory, thus creating the `$STARLINK_DIR/bin/oracdr/cal/wfcam/` directory containing the calibration files. This file has changed for the 2015B release to include flatfield images for the 1.644FeII filter. These were created in 2012 (Kapuahi release) but not previously made publicly available. If you downloaded the tar ball for intervening releases after Lehuakona, you only need to download it again should you require the additional FeII flats.