
Installing CrossWorks
--------------------------------------------------------------------------------

Run "./install_crossworks" as root user and follow the installation 
instructions.

If you get a "This program must be run as root" error message when you run 
"./install_crossworks", you are not running as root user. To solve this, log in 
as root user and run "./install_crossworks". Alternatively, if you are a user 
with sudo privileges you can use "sudo ./install_crossworks".


Starting CrossStudio
--------------------------------------------------------------------------------

On most distributions a CrossStudio icon will be added to the 
programming/development application desktop menu, simply click on this icon to 
start CrossStudio. 

Alternatively, you can start CrossStudio from the command line as follows:

1. Start a terminal and cd to the directory you installed CrossWorks into.

2. Start CrossStudio by running "./bin/crossstudio".


Running CrossWorks on 64-bit Linux
--------------------------------------------------------------------------------

We don't currently ship a 64-bit Linux version of CrossWorks however the 32-bit 
version will run on 64-bit Linux as long as the 32-bit libraries have been 
installed on your Linux distribution.

Typically the 32-bit version of the libraries will not have been installed by 
default on a 64-bit system so you will need to install them yourself.

To install the 32-bit libraries on 64-bit Ubuntu 14.04 LTS, run the following 
command line from a terminal:

  sudo apt-get install libstdc++6:i386 libxft2:i386 libxext6:i386 \
                       libusb-0.1-4:i386 libtinfo5:i386

To install the 32-bit libraries on 64-bit Ubuntu 10.04 LTS, run the following 
command line from a terminal:

  sudo apt-get install lib32asound2 lib32gcc1 lib32ncurses5 lib32stdc++6 \
                       lib32z1 libc6-i386 ia32-libs

To install the 32-bit libraries on 64-bit Debian 8 "Jessie", run the following 
command line from a terminal:

  dpkg --add-architecture i386
  apt-get update
  sudo apt-get install libstdc++6:i386 libxft2:i386 libxext6:i386 \
                       libusb-0.1-4:i386 libtinfo5:i386

Consult the documentation for your specific Linux distribution for more 
information.

