# AXL Installation

> [HTML Version](axlinstallation.htm)

The complete package consists of the following parts, some or all of which may need to be downloaded/installed manually:

**External library:** The low-level code is packaged as a single external library file, which can be downloaded manually from the MicroSabio [LibXL download directory](http://www.microsabio.net/dist/other/axl/).

For Windows, the file is libxl.dll, and can be just dropping in the A-Shell bin directory (where the ashw32.exe file is).

For Unix, the file is libxl.so.#.#.#.xxx, which can also be dropped into the A-Shell bin directory (where the ashell executable is). Then you must create a symbolic link to it named /usr/lib/libxl.so.1, e.g.:

\$ sudo ln -s /vm/miame/bin/libxl.so.3.7.2.lnx /usr/lib/libxl.so.1

You can test that the library itself has all of its prerequisites with the ldd command:

\$ ldd /usr/lib/libxl.so.1

linux-gate.so.1 =>  (0x00818000)

libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x00279000)

libm.so.6 => /lib/libm.so.6 (0x00161000)

libgcc\_s.so.1 => /lib/libgcc\_s.so.1 (0x003c3000)

libc.so.6 => /lib/libc.so.6 (0x00506000)

/lib/ld-linux.so.2 (0x004e9000)



**LIBXL: ersatz directory:** define an ersatz device LIBXL: which points to the directory where you install the LIBXL API files. This directory is typically \[908,68\], and is included (as \[908,68\]) in the [MicroSabio EXLIB Repository](https://bitbucket.org/microsabio/exlib#_blank). You might as well just download the entire library, updating the existing one you may already have installed.

**SOSFUNC: and ASHINC: **Several files in these standard ersatz directories, typically \[907,10\] and \[907,16\] are used by the LibXL module and almost certainly require updating. Since they are both part of the [MicroSabio SOSLIB Repository](https://bitbucket.org/microsabio/soslib#_blank), the easiest way to satisfy this requirement is to download/update the entire set of \[907,xxx\] directories.

**A-Shell 6.3.15xx:** LibXL absolutely requires 6.3 as a minimum.

**Compiler edit 793:** If using APN, you should ideally have the 793 (or later) version of the standalone compiler. You’ll also need to update your compil command line in APN to include the -p or -px switch (see next section for details).

Having completed the above, you should be able to compile and run one of the sample programs, e.g.

.LOG LIBXL:

.COMPIL TSTACB/X:2/M/P

.RUN TSTACB