SunCASA Installation: Difference between revisions

From EOVSA Wiki
Jump to navigation Jump to search
Line 1: Line 1:
==MacOS==
==MacOS==
We provide a standard disk image (dmg) for installation on MacOS. This is a repack of [https://casa.nrao.edu/casa_obtaining.shtml CASA 5.4.1-32] with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:
We provide a standard disk image (dmg) for installation on MacOS. This is a repack of [https://casa.nrao.edu/casa_obtaining.shtml CASA 5.6.0-2] with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:
* Download [https://drive.google.com/file/d/1OwFTp_bLZKL9wgPm4G8l5DrtB4JyelQ_/view?usp=sharing SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg)].  
# Download [https://drive.google.com/file/d/1OwFTp_bLZKL9wgPm4G8l5DrtB4JyelQ_/view?usp=sharing SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg)].  
* If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the [https://www.oracle.com/technetwork/java/javase/downloads/jdk12-downloads-5295953.html official site] and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
# If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the [https://www.oracle.com/technetwork/java/javase/downloads/jdk12-downloads-5295953.html official site] and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
* Open the disk image file (if your browser does not do so automatically).
# Open the disk image file (if your browser does not do so automatically).
* Drag the SunCASA application to the Applications folder of your hard disk.
# Drag the SunCASA application to the Applications folder of your hard disk.
* Eject the SunCASA disk image.
# Eject the SunCASA disk image.
* Double-click the SunCASA application to run it for the first time. If the OS does not allow you to install apps from non-Apple sources, please Change the settings in "System Preferences-> Security & Privacy -> General" and "Allow applications downloaded from: Mac App store and identified developers". If the OS still reports that the app is damaged, please turn off the OS Gatekeeper for now by running command ''sudo spctl --master-disable'' in Terminal. Then double-click the SunCASA application again.
# Double-click the SunCASA application to run it for the first time. You may encounter the following problems:
* Initialize SunCASA. To do so, run ''!install_suncasa'' from a SunCASA prompt. This step also allow you to create symbolic links to the SunCASA version and its executables (Administrator privileges are required), which will allow you to run ''suncasa'', ''casaviewer'', ''casaplotms'', etc. from any terminal command line.
## If the OS does not allow you to install apps from non-Apple sources, please Change the settings in "System Preferences-> Security & Privacy -> General" and "Allow applications downloaded from: Mac App store and identified developers".  
* '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
## If the OS complaints that the package is damaged, please turn off the OS Gatekeeper temporarily by running command ''sudo spctl --master-disable'' in Terminal. Then double-click the SunCASA application again.
* Optional: To update the data repository, run !update-data from the SunCASA prompt.
# Initialize SunCASA. To do so, run ''!install_suncasa'' from a SunCASA prompt. This step also allow you to create symbolic links to the SunCASA version and its executables (Administrator privileges are required), which will allow you to run ''suncasa'', ''casaviewer'', ''casaplotms'', etc. from any terminal command line.
* Restart SunCASA by exiting the current SunCASA prompt, and run ''suncasa'' in Terminal or double-click the SunCASA application icon.
# '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
* Now SunCASA has been up and running on your Mac.
# Optional: To update the data repository, run !update-data from the SunCASA prompt.
# Restart SunCASA by exiting the current SunCASA prompt, and run ''suncasa'' in Terminal or double-click the SunCASA application icon.
Now SunCASA has been up and running on your Mac.


==Linux==
==Linux==

Revision as of 10:24, 24 May 2019

MacOS

We provide a standard disk image (dmg) for installation on MacOS. This is a repack of CASA 5.6.0-2 with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:

  1. Download SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg).
  2. If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the official site and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
  3. Open the disk image file (if your browser does not do so automatically).
  4. Drag the SunCASA application to the Applications folder of your hard disk.
  5. Eject the SunCASA disk image.
  6. Double-click the SunCASA application to run it for the first time. You may encounter the following problems:
    1. If the OS does not allow you to install apps from non-Apple sources, please Change the settings in "System Preferences-> Security & Privacy -> General" and "Allow applications downloaded from: Mac App store and identified developers".
    2. If the OS complaints that the package is damaged, please turn off the OS Gatekeeper temporarily by running command sudo spctl --master-disable in Terminal. Then double-click the SunCASA application again.
  7. Initialize SunCASA. To do so, run !install_suncasa from a SunCASA prompt. This step also allow you to create symbolic links to the SunCASA version and its executables (Administrator privileges are required), which will allow you to run suncasa, casaviewer, casaplotms, etc. from any terminal command line.
  8. Important: Make sure to turn the OS Gatekeeper back on after the installation by running sudo spctl --master-enable in Terminal.
  9. Optional: To update the data repository, run !update-data from the SunCASA prompt.
  10. Restart SunCASA by exiting the current SunCASA prompt, and run suncasa in Terminal or double-click the SunCASA application icon.

Now SunCASA has been up and running on your Mac.

Linux

  • To install SunCASA for Linux, we have a binary distribution of SunCASA which is available as a downloadable tar file. We have tested the package under Scientific Linux 6 (derived from RHEL 6) and CentOS 7 (equivalent to RHEL 7). They may work under some other Linux distributions (e.g. Ubuntu), but YMMV.
  • If you do not have Java installed on your machine, please download from the official site and install it before SunCASA installation. The latest version was tested to work properly. Earlier versions may also work but YMMV.
  • The following libraries need to be available to run (Sun)CASA, if they do not already come with your distribution. In Redhat/CentOS, for example, use "yum install yourpackagename" to install.
    • xauth
    • libXft
    • libXi
    • libXrandr
    • libXfixes
    • libXcursor
    • libXinerama
    • libGL
    • libXpm
tar -xzvf SunCASA-release-##version##.tar.gz

You do not have to have root or sudo permission to install or run SunCASA. The package is self-contained in the (untarred) directory "SunCASA-release-##version##". You can move/delete the SunCASA directory as you wish. But to use the executables, do the following:

  • All executables, including suncasa are in the SunCASA-release-##version##/bin directory. Include these executables to your path for once (examples below are in bash)
cd SunCASA-release-##version##/bin
PATH=`pwd`:$PATH 
  • Then you can initialize SunCASA with the command in bash
install_suncasa
  • Optional: To update the data repository, run !update-data from the SunCASA prompt.
  • Now SunCASA has been successfully installed on your machine. Open a new Terminal and run suncasa.

Help?

Please contact Sijie Yu or Bin Chen for questions regarding installing SunCASA.