.. _qsg_download:

Downloading Source Code
=======================

GAMIT/GLOBK requires a license to run, which is granted to an institution, not individuals;
all current members of a licensed institution are permitted to run GAMIT/GLOBK.
See http://geoweb.mit.edu/gg/license.php for more information.

Once you have obtained the license information, download at least the following files (|release| is the current version) from our server, as described in the instructions received:

* com.\ |release|.tar.gz
* gamit.\ |release|.tar.gz
* help.\ |release|.tar.gz
* kf.\ |release|.tar.gz
* libraries.\ |release|.tar.gz
* tables.\ |release|.tar.gz
* test_install.\ |release|.tar.gz

and any :file:`incremental_updates.{<YYYYMMDD>}.tar.gz` files, where :file:`{<YYYYMMDD>}` is the calendar date of the latest updates.
You can use :command:`curl` or :command:`wget` from the command line, e.g.:

.. code-block:: console
   :substitutions:

   $ curl -k -R -O -u <username>:<password> '<url>/source/{com,gamit,help,kf,libraries,tables,test_install}.|rel|.tar.gz'

then:

.. code-block:: console

   $ curl -k -R -O -u <username>:<password> <url>/source/incremental_updates.<YYYY><MM>01.tar.gz

or:

.. code-block:: console
   :substitutions:

   $ wget --no-check-certificate -N --user=<username> --password=<password> <url>/source/{com,gamit,help,kf,libraries,tables,test_install}.|rel|.tar.gz <url>/source/incremental_updates.<YYYY><MM>01.tar.gz

where :console:`<url>` must be replaced by our server address and directory, :console:`<username>` by the username and :console:`<password>` by the password provided in the instructions received, and :console:`<YYYY>` and :console:`<MM>` by the current (four-digit) year and (two-digit) month, respectively.
You may also access the distribution via a web browser but you must use our \https:// URL.
Most browsers nowadays block FTP connections and you may therefore be prompted to open an alternative program, for example Finder on a Mac, if you enter the old \ftp:// URL into a browser.

The incremental updates contain sometimes critical updates to source code and tables, and should be downloaded on at least a monthly basis.
Failure to keep GAMIT/GLOBK updated will result in errors and other issues.
Updates can be compiled in exactly the same way as described in the :doc:`compilation` section, below.

Before downloading these files, we recommend choosing where you wish to install GAMIT/GLOBK by creating a main source directory.
Examples include :file:`src/gg/|rel|/` or :file:`gamit-globk/|rel|/` in your home directory.
In the following sections we refer to your chosen main directory as :file:`{<source>}`.