October 15, 2019 
Contact: Ivan Galkin, Ivan_Galkin@uml.edu
Credits: Tobias Verhulst, RMI for figuring this out

*** 32-bit compatibility issues:

   The official SAO EXplorer installer package for Linux (c) 2011 was built for 32 bit OS. It runs in 32-bit Java VM.
   Most modern computers use 64-bit operating systems
   The latest SAO Explorer versions are built in 64-bit architecture
   If you plan to upgrade to the latest SAO X, use 64-bit Java machine and install 32-bit compatibility package

*** 32-bit compatibility package installation

   Your mileage will vary. Please consult Internet gurus for details.
   
     >sudo dpkg --add-architecture i386 && sudo apt update
     >sudo apt install libc6-i386 

   Additional libraries may be requested once SAO-X is installed and launched. Add those as needed.

     >sudo apt install libxext6:i386 libxrender1:i386 libxtst6:i386 

*** Java Machine Requirements:

   64-bit JRE 1.8 is recommended
   Java 7 will NOT work
   Higher versions have not been tested
   You will need 32-bit compatibility package (see above)
   Installation varies by linux flavor; please google your solution
   Oracle version of java is best but not available anymore; consider OpenJDK
   Make default java 8 by commanding >update-java-alternatives and setting $JAVA_HOME correctly
   Verify VM installation by commanding >java -version

*** SAO-X Installation Steps:

1. Use standard SAO-X download page at ulcar.uml.edu to download the official Linux version "install.bin" -- with Java VM
2. The installer binary may not run your modern-day computer because it does not handle newer Java machines, even with the 32-bit package in place
   Start it with the option to directly specify the alternative java VM, e.g.:

   >./install.bin LAX_VM /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java

3. Once installer starts, follow its direction and select Java VM provided with the package.

4. Once complete, attempt running SAO Explorer

   >./SAOExplorer

   If problems, consider running it with your newer Java VM, e.g.:

   >./SAOExplorer LAX_VM /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java

   If still problems, consider uploading the latest SAOExplorer.jar file from here:

   https://ulcar.uml.edu/SAO-X/SAOExplorer/SAOExplorer_3.5.9.jar
    
*** NHPC Installation Steps:

1. Download nhpc.bin file from here:

   https://ulcar.uml.edu/SAO-X/SAOExplorer/linux/nhpc.bin

   and place in SAO-X home folder.
2. Make nhpc.bin executable:

   >sudo chmod 744 nhpc.bin

3. Update sunspot number file, please ensure all letters upper case:

   https://ulcar.uml.edu/SAO-X/SAOExplorer/linux/SUNSPT.ASC