
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".


Installing CrossWorks on a headless server
================================================================================

Run "./install_crossworks --copy-files-to installation_directory" and follow 
the instructions.


Troubleshooting
================================================================================

Installing on systems running the Wayland display server
--------------------------------------------------------------------------------

When running the installer on systems running the Wayland display server, root 
needs permission to access the display server. If root does not have 
permission, you will get the following error when running the installer:

  No protocol specified
  error: cannot open display

To resolve this, run the following command from a terminal before running the 
installer:

  xhost +SI:localuser:root

NOTE: When running this command you should be logged in as the user with 
permission to access the display server rather than root.

