Difference between revisions of "SunCASA Installation"

From EOVSA Wiki
Jump to: navigation, search
(MacOS)
(MacOS)
Line 10: Line 10:
 
#* 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.
 
#* 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.
 
# Setup environments for SunCASA. To do so, run ''!install_suncasa'' from a SunCASA prompt.  
 
# 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 under /usr/local/bin (Administrator privileges are required), which will allow you to run ''suncasa'', ''casaviewer'', ''casaplotms'', etc. from any terminal command line.
+
#* (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.
 
# '''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.

Revision as of 10:36, 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:
    • 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.
  7. 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.
  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.