Dyalog APL V15.0 Fourth Issue: Installation READ ME FIRST

• Licence types
• Installing Dyalog APL
• Installing Dyalog APL under Windows
• Installing Dyalog APL under OS X
• Installing Dyalog APL under AIX/Linux
• Miscellaneous Operating-specific notes
• Windows
• Association of APL fonts with APL versions
• Association of APL files with APL versions

You should have received or downloaded an installation image appropriate to your licence type; Educational or Non-Commercial users should install from the Non-commercial image, all other registered users should install from the Commercial image.

If you believe that your image is for the wrong licence, please contact sales@dyalog.com

Note: The Dyalog installer for Windows will fail with a fatal error if IIS is active but there is not a website called "Default Web Site".
To avoid this you can either create a website called "Default Web Site" or temporarily disable IIS while performing the installation of Dyalog APL. IIS is enabled and disabled in the Turn Windows features on or off dialog box which can be reached in the Uninstall or change a program section of the Control Panel.

Dyalog 15.0 can be installed either with administrator rights, or without. Dyalog Ltd strongly recommends that whenever possible, the installation is performed with administrator privileges.

An installation performed without administrator privileges has the following limitations:

• The APL 385 font is not installed. Dyalog 15.0 will use the correct font, but no other application will do so.
• The IME is not installed. Instead the keyboard is defined as a series of Registry entries. This means that the keyboard cannot be used in other than the interpreter.
• No attempt is made to install the VS2015 redistributables globally; they are therefore not available outside the interpreter unless they have been installed beforehand.
• A non-administrator install is available only to the user who performed the installation; on a shared machine all users would have to perform a non-administrator installation.

In order to install this version it will be necessary to uninstall any previously installed Version 15.0 images. Note that it is not necessary to uninstall and reinstall the IME. Note: It is however necessary to reboot your PC between uninstalling any previous Version 15.0 and installing a newer one.

Note: the installation of Dyalog APL will require a reboot of the system to be fully effective !

If you are installing under Windows Vista, then we recommend that you disable User Account Control before installing Dyalog APL. UAC is enabled and disabled in Control Panel -> User Accounts -> Turn User Account Control on or off. It is best to apply any patches to the interpreter before reenabling UAC.

To perform a default installation of Dyalog APL with administrator privileges:

1. Double click on setup.exe (you are probably reading this having taken that step !).
2. Select "Yes" to the question "Do you want to restart the installer with Administrator privileges?"
3. Select "Yes" in the User Account Control pop up. Note that this Msgbox may hide behind other windows !
4. Enter your serial number into the field on the setup form. Again note that this form may hide behind other windows.
5. If installing the Unicode Edition, ensure that the Unicode IME is selected - it is optional for the Classic Edition.
6. Click on Default Install.
7. You must accept the Licence terms which will appear in a pop-up window to continue with the installation.
8. At the end of the installation process you will be prompted to reboot your PC; Dyalog APL will not be fully installed until the PC has been rebooted - it is recommended that you perform that reboot as soon as possible having installed Dyalog APL.
9. Double click on the new Dyalog APL shortcut on your desktop; enjoy Dyalog APL!

To perform a default installation of Dyalog APL without administrator privileges:

1. Double click on setup.exe (you are probably reading this having taken that step !).
2. Select "No" to the question "Do you want to restart the installer with Administrator privileges?"
3. Enter your serial number into the field on the setup form. Again note that this form may hide behind other windows.
4. Click on Default Install.
5. You must accept the Licence terms which will appear in a pop-up window to continue with the installation.
6. Click on Finish. No reboot is necessary.
7. Double click on the new Dyalog APL shortcut on your desktop; enjoy Dyalog APL!

The newly-installed files will be put in a directory similar to c:\Users\andys\AppData\Local\Programs\Dyalog\Dyalog APL-64 15.0 Unicode.

Additional information about installing Dyalog APL can be found here on the Dyalog Forums.

To install:

• If you have already installed Dyalog 15.0 on OS X and altered the mapl script, remember to take a copy of it !
• Download the installation image from http://my.dyalog.com
• Double click on the newly-downloaded dmg file
• Follow the onscreen instructions

Dyalog checks for the existence of the file ~/.dyalog/dyalog.config. If it does not exist, this file is created.
dyalog.config should be used to set non-default options for configuration parameters such as MAXWS or TRACE_ON_ERROR; this file is read each time APL is started, and these values used in preference to the default values. Dyalog recommends that this file is edited rather than the mapl startup script which will be overwritten whenever a later revision of the current version of Dyalog APL is installed.
Dyalog intends to improve the nature of the configuration file; future versions of this file will have a different structure, and will simply define name-value pairs.
All of the configuration parameters that are used by Dyalog under OS X can be found in the Dyalog for Mac OS Installation and Configuration Guide. The full list of the possible values that can be defined in this file currently appear in the Configuration Parameters section of the Dyalog for Microsoft Windows Installation and Configuration Guide.

Note that in 15.0 onwards new OS X-specific keyboard mappings have been added to the product. However these are not currently selected; these can be selected in the preferences dialog box.

Please follow the instructions in the Dyalog for UNIX Installation and Configuration Guide manual.
This can be found on http://docs.dyalog.com/15.0.

If you have multiple versions of Dyalog APL installed on your PC, uninstalling any version may result in the APL fonts being uninstalled. Dyalog has placed a zip file containing the APL fonts here so that you can download and reinstall them.

There are more details in the FAQ section of the Dyalog Forums.