
Welcome to ALMA-OT tarball install
===================================

First, it is necessary to unpack the tarball you just downloaded to
your disk. It will unpack into its own directory. Please avoid
installing it under folder paths that contain whitespace or special
characters like $ ( : and alike.

You reading this README file probably means you have already unpacked
your ALMA OT tarball, so you've already accomplished a major part of
the installation procedure!

Note: When we in the following refer to the "installation directory",
we refer to the very directory this README file lives in.


Setup
======

1) Go to the "setup" directory inside your installation directory

2a) MS Windows
   Double-click "Setup-Windows" (may read "Setup-Windows.cmd")

2b) Linux/MacOS
   Run the "Setup-Linux.sh" script. From the command line this would be a command like "./Setup-Linux.sh"

3) Go back one level up to the installation directory


Starting up
============

1a) MS Windows
   Double-click "ALMA-OT" (may read "ALMA-OT.cmd")
   Tip: You could create a desktop or startmenu shortcut, and assign them an icon of your choice
   
1b) Linux/MacOS
   Run "ALMA-OT.sh" (./ALMA-OT.sh) on Linux or "ALMA-OT.app" on MacOS (./ALMA-OT.app)
   Tip: You could add the installation directory to your PATH, and/or setup an alias to execute the script.


Viewing Help
=============

The help documents (Cook Book, User Guide, and others) are available from within
the OT ("Help" menu). (Note, cookbook not yet ready)

Troubleshooting
================

Please check the Troubleshooting section on the webpage from which you
downloaded this tarball, it contains information specific to this OT version.

Also, you can find a log file with output from the tool here:

a) MS Windows
   %USERPROFILE%\.almaot\ot.log (USERPROFILE typically points to "c:\documents and settings\yourname")

b) Linux/MacOS
   $HOME/.almaot/ot.log


