#ADMB Project

*ADMB-11.2*  
*Released December 23, 2014*  

Installing and using ADMB from binary zip distributions for Unix operating systems such as Linux, MacOS, Solaris and BSD.

---

Prerequisites
-------------

The following programs are required to be installed on the local computer.

* C++ compiler

      Supported C++ Compilers for Unix

      * GNU C++
      * Intel C++ Compiler
      * Oracle Solaris Studio 12.3
            

* GNU stream editor (sed)

_**Note** &mdash; For MacOS, install XCode with command line tools includes all the prerequistes._

Quick Start
-----------

1. Open a **Terminal** window

2. **Download** ADMB

       Download binary zip distribution

       * For Ubuntu 14 (64Bit), download [admb-11.2-fedora20-gcc4.8-64bit](http://ftp.admb-project.org/admb-11.2/admb-11.2-ubuntu14-64bit.zip).
       * For Fedora 20 (64Bit), download [admb-11.2-fedora20-gcc4.8-64bit](http://ftp.admb-project.org/admb-11.2/admb-11.2-fedora20-gcc4.8-64bit.zip).
       * For Fedora 20 (32Bit), download [admb-11.2-fedora20-gcc4.8-64bit](http://ftp.admb-project.org/admb-11.2/admb-11.2-fedora20-gcc4.8-32bit.zip).
       * For Centos 6 and Oracle Solaris Studio 12.3 (32Bit), download [admb-11.2-centos6-solarisstudio12.3-32bit](http://ftp.admb-project.org/admb-11.2/admb-11.2-centos6-solarisstudio12.3-32bit.zip).
       * For Centos 6 and Intel C++ Compiler (64Bit), download [admb-11.2-centos6-intelicpc2013-64bit](http://ftp.admb-project.org/admb-11.2/admb-11.2-centos6-intelicpc2013-64bit.zip).   

       Use the command below to extract contents of zip file to _~/admb/_. 

       For Ubuntu 14 (64Bit),

           [~]$ unzip admb-11.2-ubuntu14-64bit.zip

       For Fedora 20 (64Bit),

           [~]$ unzip admb-11.2-fedora20-64bit.zip

       For Fedora 20 (32Bit),

           [~]$ unzip admb-11.2-fedora20-32bit.zip

       For Centos 6 and Oracle Solaris Studio 12.3 (32Bit),

           [~]$ unzip admb-11.2-centos6-solarisstudio12.3-32bit.zip

       For Centos 6 and Intel C++ Compiler (64Bit),

           [~]$ unzip admb-11.2-centos6-intelicpc2013-64bit.zip

3. **Use** ADMB

       In the **Terminal** window, use the steps below to build and run the simple example.

       Change to simple example directory.       

           [~]$ cd admb/examples/admb/simple

       Build simple example.

           [~/admb/examples/admb/simple/]$ ~/admb/admb simple.tpl

       For building with MinGW or Cygwin shells, use the **'admb.sh'** script.

           [~/admb/examples/admb/simple/]$ ~/admb/admb.sh simple.tpl

       Run simple example.

           [~/admb/examples/admb/simple/]$ ./simple

       Read [manuals](http://ftp.admb-project.org/admb-11.2/manuals/) for more information.

4. _**Optional**_ &mdash; Multi-User Installation    

       Installs binary distribution folder to /usr/local/ as super-user.

           [~/admb/]$ sudo make install

       Build and run the simple example without the directory prefix.

           [~]$ cd admb/examples/admb/simple
           [~/admb/examples/admb/simple/]$ admb simple.tpl
           [~/admb/examples/admb/simple/]$ ./simple

       _If unable to build simple example, then use the Manual Installation below._

       _**Alternative**_ &mdash; Manual Installation    

       Copy binary distribution folder to /usr/local/ as super-user.

           [~]$ sudo cp -Rvf admb /usr/local/admb

       Create symlink to main admb script.  Directory _/usr/local/bin/_ should already exist.

           [~]$ sudo ln -sf /usr/local/admb/admb /usr/local/bin/admb

--------------------------------------------------------------------------------
For help and support, contact <users@admb-project.org>.

$Id: QuickStartUnix.txt 2877 2014-12-23 18:11:52Z johnoel $
