User Tools

Site Tools


installation

Windows

Create a folder called “dana” somewhere on your computer (maybe on C:\). Download the latest version of Dana and extract the contents of the zip file into this directory. We refer to the directory containing the files “dana.exe” and “dnc.exe” as Dana's home directory.

Next we need to set an environment variable for Dana's home directory and tell Windows where the executable files are so that we can run them from anywhere.

Go to Control Panel, System, Advanced System Settings. Click on Environment Variables. Note these steps may be different on different versions of Windows (if you're not sure, search online for how to add environment variables for your version of Windows).

In the lower list of environment variables (system-wide),click on “New…

In the “variable name” field, enter DANA_HOME

In the “variable value” field, enter the path to Dana's home directory as defined above.

Click on OK.

Now find the existing environment variable in the same list called “path” or “PATH”. Click on it and click “Edit…”. In the “variable value” field, go to the very end of the text, and add a semi-colon, then type the path to Dana's home directory as defined above. This tells Windows where to locate Dana's executable files.

Click on OK.

To test that your installation works, open a command prompt window (somewhere other than in Dana's home directory) and type

dana examples.SysTest

Information about your system should be printed. If this doesn't work, close the command prompt, check your environment variables are correct, and try again.

Linux

Create a folder called “dana” somewhere on your computer (maybe in your home folder). Download the latest version of Dana and extract the contents of the zip file into this directory. We refer to the directory containing the files “dana” and “dnc” as Dana's home directory.

Now we need to make these files executable. Open a terminal in Dana's home directory and type chmod +x dana dnc and press enter. Close the terminal window.

Next we need to set an environment variable for Dana's home directory, and tell Linux where the executable files are so that we can run them from anywhere.

You can set environment variables on most Linux distributions by opening the file ~/.bashrc (this is a file called “.bashrc” in your Linux user home directory) and adding to the end:

export DANA_HOME=/home/where/you/put/dana/

PATH=$PATH:$DANA_HOME

Then save the file, log out and log in again.

To test that your installation works, open a terminal prompt (somewhere other than in Dana's home directory) and type

dana examples.SysTest

Information about your system should be printed. If this doesn't work, check your environment variables are correct, log out/log in and try again.

Mac OS X

Create a folder called “dana” somewhere on your computer (maybe in your home folder). Download the latest version of Dana and extract the contents of the zip file into this directory. We refer to the directory containing the files “dana” and “dnc” as Dana's home directory.

Now we need to make these files executable. Open a terminal in Dana's home directory and type chmod +x dana dnc and press enter. Close the terminal window.

Next we need to set an environment variable for Dana's home directory, and tell OS X where the executable files are so that we can run them from anywhere.

You can set environment variables on most OS X versions by opening the file ~/.bash_profile. This is a file called .bash_profile in your user home directory, usually /Users/your_name/. If the file does not exist you'll need to create it. Now add these two lines to the end of the file:

export DANA_HOME=/home/where/you/put/dana/

PATH=$PATH:$DANA_HOME

Then save the file and close any open terminal windows.

To test that your installation works, open a terminal window (somewhere other than in Dana's home directory) and type

dana examples.SysTest

Information about your system should be printed. If this doesn't work, check your environment variables are correct, close / reopen terminal windows and try again.

Upgrading your installation

When a new version of Dana is released you will need to update your existing installation. The safest way to do this is to run through the above procedure and use a different directory for Dana's “home”.

However, it is usually safe to simply copy the new version of Dana into your existing home directory, overwriting all files with the same name. The only cases in which this may not be safe are if (i) you have modified any of the standard library components with custom code (i.e. components in the central source tree); or (ii) the new version of Dana has new components in its standard library which happen to have the same path and name as components that you have created yourself in the standard library.

installation.txt · Last modified: 2016/08/12 06:56 by barryfp

Page Tools