INSTALL.md

**Installation instructions for AutoAssign 2.4.0 in your machine**

You may have to download Java JDK if you do not have it already 
installed. It should be available in the next link:  

https://www.oracle.com/java/technologies/downloads/#jdk18-mac

- For Mac  x86_64 : download x64 DMG Installer and install 
- For Mac with M1 : download Arm 64 DMG Installer and install 
- Look for the same for other machines like Linux. 

Local software on my machine is under /opt/software, can be be also 
/usr/local/software or any of your choice. Here I will use the /opt/software 
for the installation.

Install  AutoAssign2_4_0.tgz under /opt/software, so as sudo

 1. cd /opt/software    (or you create it if not present)
 2. tar xvfz AutoAssign2_4_0.tgz  (will decompress and install). Maybe you 
    will need to change permissions/ownerships to allow it run

Then change to the newly created /opt/software/AutoAssign2.4.0 
and adjust a few things in the file .AArc : 

 1. cd /opt/software/AutoAssign2.4.0
 2. look for line -> Host: sos-chem-l1002.local  in file .AArc
 3. change "sos-chem-l1002" to fit the name of your computer
 4. look for line -> WebBrowser:  
    and adapt it to your machine, I usually use
   - MacOSX: WebBrowser: open -a safari
   - Linux:  WebBrowser: /usr/bin/firefox
 5. save it here and also copy .AArc to your home dir. This file will be used by 
    when is called to set up some defaults. 
    
**SPECIAL NOTE for Macs**: when installing in a Mac the first time you run the software it will be blocked 
by the machine as it is not comming from recognized developer, to avoid this one can go to Privacy&Security
and "allow anyway" each time something is blocked (for more info check 
https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) 
or you can use: 
- sudo spctl --master-disable  (and give your admin password)
once everything is properly running you can revert to the full security again: 
- sudo spctl --master-enable  (be ready to give admin password). 

That should be all needed.  Hopefully it will work as long as you
have the java installed. All other requirements should be satisfied
by the installation.

Just pick some of the examples in the ExampleData included in the
AutoAssign or apply to some example you already have