ATLAS-AXL
Installation Instructions

This document contains instructions for

1. Installing ATLAS-AXL on Linux
2. Installing ATLAS-AXL on MS Windows when Cygwin was already installed on your system
3. Installing on MS Windows ATLAS-AXL and a minimal version of Cygwin and gcc
4. Testing the installation by performing a sample compilation and run of a program.

Installing on Linux

1. You need to have JDK 1.2.2 (or later versions) installed on your machine. Other versions of JVM (Java Virtual Machine) might work as well but they remain to be tested. You only need the Java Runtime Environment (JRE) (~5MB) that can be downloaded from: http://java.sun.com/products/jdk/1.2/download-linux.html
2. Make sure that your /usr/lib directory contains the file libhistory.so.4.0 --- If not, you should download the file
   from the following link, and store it into your /usr/lib directory.
   
3. Make a new directory into which you then download the followin tar file (~2.2 MB): ATLaS/AXL version 1.2 for Linux . Expand the tarfile using the command:
   tar xvf atlas-1.2.tar
4. Add jdk-x.y/bin to your environment variable PATH as follows:
   for bash:
   i) edit $HOME/.bash_profile, by adding the following line:
       PATH="/usr/local/jdk1.2.2/bin:"$PATH
   ii) activate the change:
   % .$HOME/.bash_profile

   for tcshrc:
   i)edit $HOME/.tcshrc, add a line like the following:
   setenv PATH "/usr/local/jdk1.2.2/bin:"$PATH
   ii)activate the change
   % source $HOME/.tcshrc

5. Test your installation by a sample compilation/run program below.

Installing on MS Windows

This assumes that cygwin is already installed on your C:\ hard-drive. Then you need to perform the following steps.

1. Download and install JDK 2 under your C:\ drive. The download site is :  http://java.sun.com/j2se/1.3/.  You only need to download the runtime environment (~5MB) rather than the complete development environment (~30MB).
   
   If you have already java installed on your system, skip this step (but then make sure that your ATLAS shortcut uses the right java.exe target—see running Atlas from the Java interface, below)
   

2. Download and unzip into a temporary directory the file Atlas.zip (~4.8 MB). 

3. Run setup.exe which is located in the directory subdirectory DISK1 of your temporary directory.

4. After the installation finishes, please make sure that your PATH environment variable includes the path C:\cygwin\bin

5. Reboot your system.

After you reboot your system verify the following:

  - An Atlas directory of size 6.37 MB has been created.

Go to running Atlas from the Java interface.

Installing ATLAS-AXL and Cygwin on Windows

This install ATLAS-AXL and a minimal version of cygwin an gcc needed to support it on your C:\ driver.

1. Download and install JDK 2 under your C:\ drive. The download site is:  http://java.sun.com/j2se/1.3/.  You only need to download the runtime environment (~5MB) rather than the complete development environment (~30MB).

If you have already java installed on your system, skip this step (but then make sure that your ATLAS shortcut uses the right java.exe target—see running ATLAS from the Java interface, below)

2. Download and unzip into a temporary directory the file Atlas.zip (~8.9 MB). 

3. Run setup.exe which is located in the directory subdirectory DISK1 of your temporary directory.

4. When the previous step complete, reboot your system.  (During rebooting
    various installation files are copied on your hard drive and the windows registry is automatically updated.)
   
   

5. After the installation finishes, please update your PATH environment variable to include C:\cygwin\bin as follows:

For Windows 2000.

On "My Computer",  RIGHT  CLICK

Properties->Advanced->EnviromentVariables->System Variables->Path->Edit...->

      and  insert  C:\cygwin\bin;  into your path. Click OK and close the windows.

For Windows 98.

Add the following PATH statement at the bottom of your autoexec.bat file.
set PATH= %PATH%;c:\cygwin\bin

For Windows NT:

Modify your PATH variable accordingly.

6. Reboot your system again (Sorry!)

After you reboot your system verify the following:

- An Atlas directory of size 6.37 MB has been created.

- A cygwin directory of size 16.8MB has been created.

At command prompt type PATH, press the Enter key, and verify that the PATH variable includes the directory specified at step 7.

You  are now ready to run Atlas from the Java interface.

Running  Atlas from the Java Interface.

You can run by double clicking on the shortcut located at the directory:

The shortcut contents are described in the image below. If your system does not launch the java interface, you may need to update the shortcut Target field to the value

java.exe AXL

If your java environment is located other than C:\ or it’s a previous version please update the shortcut accordingly.

For your convenience, you might want to copy this shortcut to your Desktop.

Performing a Sample Compilation & Run

When you double click the Atlas shortcut, the Java-based interface appears on screen. From this interface menu click:

1. File – Open
2. Browse to C:\atlas\axl\test\  and open the file aggr_mcount.adl

From the menu select:

3. Query – Compile
4. Query – Execute

Scroll the results screen on the GUI and you must see the output as described in the image below.

Final Notes:

• Remember to name your files with the extension .axl
• Delete temporary directories and files used for installation to reclaim your hard drive space.