DeskArtes IDS/RT 4.6 installation for macOS 10.12 (Sierra) Intel                  

10.11.2017

Requirements:

- Apple Macintosh with Intel Core processor
- AMDRadeon, NVIDIA GeForce or Intel HD graphics adapter
- macOS 10.12 (Sierra)
- XQuartz 2.7.9
- 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
- macOS 10.12
- XQuartz 2.7.9
- Logitech Optical Mouse

Installing X11:

On macOS 10.12 (Sierra) 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.9.dmg) from XQuartz project web site (http://www.xquartz.org/).
2. Double click the disk image "XQuartz-2.7.9.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.

Note: The latest XQuartz version 2.7.11 does not work with the Motif window manager (mwm) needed to run IDS/RT. If you have problems starting XQuartz after installing IDS/RT and configuring the user accounts, install the version 2.7.9 instead.

IDS/RT installation notes:

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 macOS 10.12 (Sierra) the programs can be as default installed only from the Mac App Store and identified developers.

To allow IDS installation, Control-click the package icon, then choose Open from the shortcut menu and click Open.

Another way to do this is to add an exception for blocked IDS installation packages by clicking the Open Anyway buttons in the General pane of Security & Privacy preferences. 

These buttons are available for about an hour after you try to open the packages.

To open this pane, choose Apple menu > System Preferences, click Security & Privacy, then click General.

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.

If you get an error message saying

“DeskArtesIDSRT.mpkg can’t be opened because it is from an unidentified developer.”

then Ctrl-click the meta package "DeskArtesIDSRT.mpkg”, select Open from the menu and then click Open in the window that is shown.

If you get an error message saying 

“The installation failed. The installer could not install the software. The installer could not install the software because there was no software found to install.”

then inside the Finder window run the package installers (.pkg files) separately one by one by double clicking them.

IDSRT46base.pkg
IDSexamples.pkg
IDSdocuments.pkg
RTexamples.pkg
RTdocuments.pkg
OpenMotif3.pkg

The meta package installers (like “DeskArtesIDSRT.mpkg”) do not always work on macOS 10.12 (Sierra), but running the package installers separately still work.

You have to use “Ctrl-click, select Open from the menu, click Open in the window” method for each package, if you get the “… can’t be opened because it is from an unidentified developer“ error message.

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 macOS 10.12 (Sierra):

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