Difference between revisions of "SunCASA Installation"

From EOVSA Wiki
Jump to: navigation, search
(MacOS)
(MacOS)
Line 13: Line 13:
 
# '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
 
# '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
 
# Optional: To update the data repository, run !update-data from the SunCASA prompt.
 
# 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.
+
# Exit the current SunCASA prompt, and restart SunCASA by double-clicking on the SunCASA application icon.
 
Now SunCASA has been up and running on your Mac.
 
Now SunCASA has been up and running on your Mac.
  

Revision as of 11:08, 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. Double-click the SunCASA application to run it for the first time. You may encounter the following prompts:
    • 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 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.
  6. Setup environments for SunCASA. To do so, run !install_suncasa from a SunCASA prompt.
    • (Optional) This step also allows to create symbolic links to the SunCASA version and its executables (default to be under /usr/local/bin; administrator privileges are required), which will allow you to run suncasa, casaviewer, casaplotms, etc. from any terminal command line.
  7. Important: Make sure to turn the OS Gatekeeper back on after the installation by running sudo spctl --master-enable in Terminal.
  8. Optional: To update the data repository, run !update-data from the SunCASA prompt.
  9. Exit the current SunCASA prompt, and restart SunCASA by double-clicking on 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.

  1. 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.
  2. 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
  3. Download the packages
  4. Untar the package
    tar -xzvf SunCASA-release-##version##.tar.gz
  5. All executables, including suncasa are in the SunCASA-release-##version##/bin directory. Include these executables to your path (just for once; examples below are in bash)
    cd SunCASA-release-##version##/bin
    PATH=`pwd`:$PATH
  6. Then you can initialize SunCASA with the command in bash
    ./install_suncasa
  7. 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. Enjoy!

Help?

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