Dyalog APL V18.0 Issue 4: Installation READ ME FIRST

This document contains information that may affect the installation of Dyalog APL.

This file is setup_readme.htm and is included in the help directory in the Dyalog installation directory.

Table of Contents

Licence Types

From V17.1 onwards there is a single licence for Dyalog APL, covering both commercial and non-commerical usage.

Unregistered installations (those which do not have a valid serial number) are covered by the non-commercial licence.

Using or entering a serial number other than the one issued to you is not permitted. Transferring the serial number to anyone else is not permitted. For the full licence terms and conditions, see https://www.dyalog.com/uploads/documents/Terms_and_Conditions.pdf.

All beta installation images are released under the non-commercial licence; they should not be used for production.

Installing Dyalog APL under Windows

Dyalog 18.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:

Note: Dyalog strongly recommends that if not already installed, you include the VS2015 runtime packages when you install Dyalog APL; failure to do so may result in the failure of .Net-related code.

In order to install this version it will be necessary to uninstall any previously installed Version 18.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 18.0 and installing a newer one.

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

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

  1. Extract the contents of the downloaded zip file into a temporary directory
  2. Double click on the newly extracted setup.exe (you are probably reading this having taken these two steps !).
  3. Select "Yes" to the question "Do you want to restart the installer with Administrator privileges?"
  4. Select "Yes" in the User Account Control pop up. Note that this Msgbox may hide behind other windows !
  5. Enter your serial number into the field on the setup form. Again note that this form may hide behind other windows.
  6. If installing the Unicode Edition, ensure that the Unicode IME is selected - it is optional for the Classic Edition.
  7. Click on Default Install.
  8. You must accept the Licence terms which will appear in a pop-up window to continue with the installation.
  9. 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.
  10. 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 18.0 Unicode.

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

If you have problems typing APL characters, it is worth taking a look at the links at the bottom of the Fonts and Keyboard page on the Dyalog website at www.dyalog.com/apl-font-keyboard.htm.

Installing Dyalog APL under macOS

Dyalog APL is now notarised, which should mean that it installs without issue on macOS Catalina and Big Sur.

Dyalog APL is built and QAed on High Sierra, so any version of macOS from High Sierra onwards should support 18.0. Under Catalina when first you attempt to access certain directories (Documents or remote filesystems) you will be prompted by the operating systemto allow Dyalog APL to access that directory.

To install:

You should read the Configuration section of the release notes which explain the purpose of and usage of the ~/.dyalog/*dcfg files. They allow you to configure Dyalog APL in a cross-platform manner.
All of the configuration parameters that are used by Dyalog under macOS can be found in the Dyalog for macOS 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.

Installing Dyalog APL under AIX/Linux

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

Under Linux (including the Raspberry Pi) if you install from your desktop you should find a Dyalog APL (TTY) icon in the start menus. If you subsequently install RIDE 4.3, a "Dyalog" icon is also added; this causes RIDE 4.3 to start and to start a Dyalog session.

Under Linux (including Pi) the script /usr/bin/dyalog is under the control of the update_alternatives system. If you have multiple versions of Dyalog APL installed on Linux and you wish to change the version which /usr/bin/dyalog starts, use sudo update_alternatives --config dyalog.
You should read the Configuration section of the release notes which explain the purpose of and usage of the ~/.dyalog/*dcfg files. They allow you to configure Dyalog APL in a cross-platform manner.
Dyalog recommends that you never edit /usr/bin/dyalog or $DYALOG/mapl. Rather either take a copy of the script and edit that, or write your own script which sets the environment and then calls the Dyalog-supplied script, or better yet, edit your personal copy of the new configuration files.

Installing Dyalog APL on Raspberry Pi

Dyalog APL version 18.0 requires Raspbian Buster on any model of Pi, but note that .NET Core is not supported on armv6 CPU - that is, Pi Zero, 1 and 2.

Instructions for installing Dyalog APL on a Raspberry Pi can be found at http://packages.dyalog.com/. The notes in the Linux section above also apply.

Windows: Association of APL fonts with APL versions

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.

Windows: Association of APL files with APL versions

When a version of Dyalog APL is installed on Windows, files such as workspaces are associated with that newly-installed version. The user command ]fileassociations can be used to change the association, but you will need to run APL with Administator Permissions to make this change.