DeskArtes IDS/RT 4.5 installation for Mac OS X                   20.7.2005

Requirements:

- Apple Macintosh with PowerPC G4 or later
- ATI Radeon or NVIDIA GeForce graphics adapter
- Mac OS X 10.3.3 or later
- 3-button or wheel mouse recommended

The program is tested with the following machine configurations:

- Apple eMac
- 1 GHz PowerPC G4
- 384 MB SDRAM
- ATI Radeon 9200 with 32 MB DDR SDRAM
- Mac OS X 10.3.3
- Logitech Cordless Optical Mouse

- Apple PowerBook G4 17"
- 1,33 GHz PowerPC G4
- 1 GB SDRAM
- ATI Mobility Radeon 9700 with 64 MB DDR SDRAM
- Mac OS X 10.3.4

- Apple PowerMac G5
- 2 x 2 GHz PowerPC G5
- 2 GB DDR SDRAM
- NVIDIA GeForce FX 5200 Ultra with 64 MB DDR SDRAM
- Mac OS X 10.3.5

Installation notes:

The Installation consist 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 Mac OS X Developer Tools (Developer.mpkg) are installed, you should leave the CPreProcessor package out from the installation.

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

- If Korn Shell is already found at the "/bin" directory of the machine, you should leave the KornShell package out from the installation.

Installation:

1. Double click the disk image "DeskArtesIDSRT.dmg" to open it in Finder window.
2. Inside 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:

1. Start X11 from Finder window directory "Applications/Utilities/X11". When first time started, X11 will ask if you wish to use standard X11 environment. Answer NO to this question.
2. Start a Terminal with "Applications->Terminal" command available in the X11 menus on top of the screen.
3. Start DeskArtes IDS with command "DA" in the Terminal 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 OS X 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 store it into the "/Applications/DeskArtes/System" directory into the file named "dalic.<system id>". The installation contains the following steps:

1. Start Apple Works 6.
2. Select Word Processing.
3. Copy the three code lines into the empty document 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. Save the document with the command "File->SaveAs". Select "Text" file format in the command dialog and give name "dalic.<system id>" for the file. Here "<system id> is the system id number found through command "SYSTEM->Version info" in the DeskArtes IDS or RT.
5. Copy the "dalic.<system id>" file to the "/Applications/DeskArtes/System" directory.

Changing X11 to full screen mode:

The DeskArtes IDS/RT can also be run in the X11 "normal" mode, so this change is not necessarily needed. In the full screen mode the Mac OS X top menu and the dock are however not shown and therefore working with the DeskArtes IDS/RT in that mode is probably more convenient.

When X11 is running, select from its menus "X11->Preferences" and then output page. In the output page select the "Full screen mode" option.

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