DeskArtes IDS/RT 4.6 installation for Mac OS X 10.10 (Yosemite) Intel                  13.12.2015

Requirements:

- Apple Macintosh with Intel Core processor
- AMDRadeon, NVIDIA GeForce or Intel HD graphics adapter
- Mac OS X 10.10 (Yosemite)
- XQuartz 2.7.8
- 3-button or wheel mouse recommended

The program is tested with the following machine configuration:

- Apple Mac mini (Late 2014)
- 1.4 GHz Intel Core i5
- 4 GB DDR3 SDRAM
- Intel HD Graphics 5000 1536 MB
- Mac OS X 10.10.5
- XQuartz 2.7.8
- Logitech Optical Mouse

Installing X11:

On Mac OS X 10.10 (Yosemite) the X11 is not included in the installation. It has to be installed from XQuartz project web site.

1. Download XQuartz installation package (e.g. XQuartz-2.7.8.dmg) from XQuartz project web site (http://xquartz.macosforge.org/).
2. Double click the disk image "XQuartz-2.7.8.dmg" to open it in a Finder window.
3. Inside the Finder window double click the package "XQuartz.pkg" to start the installer. 
4. Logout and login after installing the XQuartz.

IDS/RT installation notes:

The IDS/RT installation consists of two packages, the actual IDS/RT software and the External utilities. The External utilities can be left out from the installation, if they are already installed on the machine. The packages for the installation can be selected by clicking the "Customize" button in the "Installation type" phase. 

- If the OpenMotif3 is installed with Fink package tool to the "/sw" directory of the machine, you should leave the OpenMotif3 package out from the installation.

On Mac OS X 10.10 (Yosemite) the programs can be as default installed only from the Mac App Store. 
- This can be changed in the "AppleMenu->System Preferences: Security & Privacy: General: Allow applications downloaded from:"
- To allow IDS and X11 installation the "Anywhere" option needs to be selected.

IDS/RT Installation:

1. Double click the disk image "DeskArtesIDSRT46intel.dmg" to open it in a Finder window.
2. Inside the Finder window double click the meta package "DeskArtesIDSRT.mpkg" to start the installer. 

Configuring user accounts:

After the Installation is done, you have to configure the environment for the DeskArtes IDS/RT use.

1. Start a terminal window from Finder window directory "Applications/Utilities/Terminal".
2. Run command "/Applications/DeskArtes/DAconfig" in the Terminal window to configure the IDS/RT for the current user.

After successful user configuration you should get the message
"The configuration for <user> is done OK". Now you can close this Terminal.

Configuration needs to be done for each user account before running DeskArtes
IDS/RT with that account.

Running DeskArtes IDS/RT on Mac OS X 10.10 (Yosemite):

1. Start a terminal window from Finder window directory "Applications/Utilities/Terminal".
2. Start a X terminal window with command "xterm" in the Terminal window. This starts automatically the XQuartz X11 also. 
3. Start DeskArtes IDS with command "DA" in the xterm window. The Rapid Tools is started in the same way with command "rt".

Getting the License:

To get a license you need to email the Mac system id to DeskArtes Oy, license@deskartes.fi. The system id can be found through the command "SYSTEM->Version info" after starting the IDS or RT software. 

Installing the license:

After receiving the license you must install it for the program.The installation contains the following steps:

1. Start IDS with "DA" command in xterm.
2. Select "SYSTEM->Version Info" command.
3. Copy/Paste or type the three code lines to the "License code:" field.
4. Press the "SAVE LICENSE CODE" button and then "OK".
5. Restart IDS. 

Alternatively you can store the license code directly to the license file ("dalic.<system id>") in the "/Applications/DeskArtes/System" directory. 

1. Start a terminal window from Finder window directory "Applications/Utilities/Terminal".
2. Open the license file for input with command "cat  >  dalic.<system id>". Here "<system id> is the system id number found through command "SYSTEM->Version info" in the DeskArtes IDS or RT.
3. Copy the three code lines into the terminal window using the Mac Copy/Paste commands, or type them in. If you type in the codes, note that they can only contain numbers 0-9 and characters A-F.
4. Close the license by pressing the Ctrl+D (The Control key and the D character key at the same time).
5. Copy the "dalic.<system id>" file to the "/Applications/DeskArtes/System" directory.

Mouse settings:

In the DeskArtes IDS/RT all three mouse buttons are in use for different commands. Especially in the modern wheel mouses the default functions of the buttons are not suitable for DeskArtes use, so you have to change the settings.

For example for the Logitech mouses the settings are changed from the "System settings->Logitech Control Center". The suitable button settings for DeskArtes IDS/RT are the following.

Name		Assigned action
------------------------------------------------------------------------------------------------
Left Button	Click
Right Button	Advanced Click ->  Click Type: Click   Button number: 2
Wheel Button	Advanced Click ->  Click Type: Click   Button number: 3
------------------------------------------------------------------------------------------------