62 Rate this article:
No rating

Install and License IDL 8.6

Install and License IDL

These instructions describe how to install and license IDL on Windows, UNIX, and Macintosh platforms. See the following sections:

System Requirements

For optimal performance, your video card should have a minimum of 1 GB of RAM and should support OpenGL 2.0 or later. Also be sure to install the latest drivers for your video card.

An HTML5-compatible browser is required to view product Help.

Contact Us

If you need assistance, visit the Request Technical Support page at https://www.harrisgeospatial.com/Support.aspx.

Install on Windows

Supported platforms:

Hardware

Supported Versions

Intel/AMD 64-bit

7 SP1, 8, 10

The 64-bit installers contain 32-bit binaries so that you can launch IDL in 32-bit mode on 64-bit Windows systems. You can find the 32-bit versions in the Windows Start menu under Programs > IDL x.x > 32-bit.

Tip: If you need to install IDL on multiple computers, you can record an .ini file during an installation of IDL, then use that .ini file to silently install IDLon the other computers. See Windows Silent Installation for details.

You must have administrator privileges to install software on Windows. Install IDL from a web download or a DVD as follows:

  1. Start the installer:

    • Web download: Navigate to the idlxx-win.exe file that was downloaded to your computer and run it.
    • DVD: If the installer does not automatically start after you insert the DVD, navigate to the DVD drive and run autorun.exe. When the splash screen appears, click Install.
  2. Follow the prompts to install the software.
  3. When installation is complete, license the software.

    • To activate node-locked licenses to a specific user and computer, see Manage Licenses from the Harris License Administrator Tool for steps.
    • To install a license server and activate the licenses for use by clients, see the Install and Administer the Flexera License Server Service documentation for Windows or Linux, included with your software download or installation DVD.
    • To connect a client to a license server, see Use Licenses on a License Server.

Note: The activate.exe utility will be installed in INSTALL_DIR\IDLxx\license_utils\bin.x86_64 with read and execute privileges for all users. This means that after initial license activation, any user with access to activate.exe can modify the license availability for that product installation. If the product is installed to a public directory on a machine, product administrators can choose to restrict execute privileges on the activate.exe file to prevent unauthorized use. For information on modifying file privileges, refer to your Windows system documentation, or contact a Windows system expert.

Install on UNIX or Macintosh from a Shell Script

Supported platforms:

Platform

Hardware

Operating System

Supported Versions

UNIX

Intel/AMD 64-bit

Linux

Kernel 2.6.32, glibc 2.12

SPARC 64-bit

Intel/AMD 64-bit

Solaris

10

Macintosh

Intel 64-bit

OS X

10.10, 10.11

The commands listed here may require root or sudo privileges. An X-Windows manager is required for Macintosh. IDL was tested on Mac OS X using XQuartz 2.7.11. Install IDL from a web download or a DVD as follows:

  1. Unpack and uncompress the files:

    • Web download: Uncompress the filename.tar.gz archive file that was downloaded to your computer, then unpack the file:

      gunzip filename.tar.gz
      tar -xf filename.tar

    • DVD: Insert the DVD. The DVD auto-mounts. Linux systems may auto-mount the installer DVD with incorrect permissions. If this happens, use the following commands:

      umount /dev/hdc
      mount -o ro -t udf /dev/hdc /media

      Note: Be sure to specify the correct directory for your system, for example: /dev/dvd instead of /dev/hdc.

  2. Start the installer with one of these commands:

    • Web download: ./install.sh
    • DVD: ./install-idlxx-unix.sh
  3. Follow the prompts to install the software.
  4. When installation is complete, license the software.

    • To activate node-locked licenses to a specific user and computer, see Manage Licenses from the Harris License Administrator Tool for steps.
    • To install a license server and activate the licenses for use by clients, see the Install and Administer the Flexera License Server Service documentation for Windows or Linux, included with your software download or installation DVD.
    • To connect a client to a license server, see Use Licenses on a License Server.
  5. From a terminal window, change directories to INSTALL_DIR/idlxx/bin. Enter a command at the shell prompt to start an application:

    idl: Start command-line IDL.

    idlde: Start the IDL Development Environment.

    idlhelp: Start IDL Help.

Install on Macintosh from a .pkg File

Supported platforms:

Hardware

Operating System

Supported Versions

Intel 64-bit

OS X

10.10, 10.11

An X-Windows manager is required for Macintosh. IDL was tested on Mac OS X using XQuartz 2.7.11. Install IDL from a web download or a DVD as follows:

  1. Start the installer:

    • Web download: Navigate to the idlxx-mac.pkg file that was downloaded to your computer and run it.
    • DVD: Insert the DVD. If the installer does not automatically start, navigate to the disk drive and run idlxx-mac.pkg.
  2. Follow the prompts to install the software.
  3. When installation is complete, license the software.

    • To activate node-locked licenses to a specific user and computer, see Manage Licenses from the Harris License Administrator Tool for steps.
    • To install a license server and activate the licenses for use by clients, see the Install and Administer the Flexera License Server Service documentation for Windows or Linux, included with your software download or installation DVD.
    • To connect a client to a license server, see Use Licenses on a License Server.

Manage Licenses from the License Administrator Tool

Activating a license transfers the license rights from the Harris Download and Licensing Center to a node-locked (local) computer or license server and creates the features and quantities of licenses that enable the software to run. When you purchase Harris Geospatial products, you will receive an email with an activation code to use to activate your software license. The license is a concurrent-process license for each product that was purchased.

You can activate licenses on a local computer (node-locked license), or on a license server that can serve licenses to connected clients. These instructions describe how to activate node-locked licenses. To install and set up a license server, see the Install and Administer the Flexera License Server Service documentation for Windows or Linux that is included with the software download and on the installation DVD.

In this document, you will activate licenses over the Internet. If you do not have Internet access, contact Technical Support to receive separate instructions to activate your licenses offline.

The steps that follow describe how to use the Harris License Administrator tool to:

  • Activate node-locked licenses.
  • Deactivate node-locked licenses.
  • Connect to a license server to use served licenses.
  • Disconnect from a license server.
  • Borrow licenses from a license server for a limited time.
  • Return borrowed licenses to the license server.
  • View licenses and feature details.

To perform these same functions from the command line instead of the Harris License Administrator tool, see Activate Licenses from the Command Line for details.

The Harris License Administrator Tool

To open the Harris License Administrator tool described in this section, use one of the following:

  • Windows: From the Start menu, select Tools > Harris License Administrator under the shortcut group for your product installation. Administrator privileges are required.
  • Linux: From a terminal window, launch the harrislicense command from the INSTALL_DIR/idlxx/bin directory. Sudo or root permissions are required.
  • Mac: From a Finder window, double-click the LicenseAdminstrator.app icon located under the INSTALL_DIR/idlxx directory. Administrator privileges are required.

Activate Licenses

To activate licenses:

  1. In the Harris License Administrator tool, click Activate Licenses.
  2. Enter (or copy and paste) the activation codes from your product order email into the text box provided. The text box allows one activation code per line; press the Enter key after entering each code to start a new line.
  3. Enter the Quantity of licenses you are entitled to.
  4. Click Activate. A message appears when the codes are successfully activated. To view details on the activated licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  5. Click Close to exit the tool.

Deactivate Licenses

Licenses remain activated on a computer until you deactivate them. Deactivating a license returns it to the Harris Download and Licensing Center. Deactivated licenses can then be used on another computer, by either the same person or another person. For example, if you receive a new computer and you want to install the software on it, first deactivate the licenses from the old computer. If you do not deactivate the licenses (and the old computer is no longer accessible to you), you will be unable to activate them on the new computer. If that occurs, Technical Support will need to deactivate the licenses for you.

To deactivate licenses:

  1. In the Harris License Administrator tool, click Deactivate Licenses.
  2. Use the check boxes to select the individual activation codes to deactivate, or enable the Select all check box to deactivate all activation codes.
  3. Click Deactivate.
  4. Click Close to exit the tool.

Use Licenses on a License Server

A client computer can connect to only one license server at a time; however, a client can use a combination of node-locked licenses activated locally on the computer and served licenses from a connected license server.

To connect a client to a license server:

  1. On the client, open the Harris License Administrator tool.
  2. In the Harris License Administrator tool, click Use License Server.
  3. In the Server field, enter the server name or IP address.
  4. In the Port field, enter the TCP/IP port number being used by the license server for communication with license clients. The default port is 7070.
  5. Click Connect. A message appears when the client successfully connects. To view details on served licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  6. Click Close to exit the tool.

Disconnect from a License Server

To disconnect a client computer from a license server:

  1. In the Harris License Administrator tool, click Use License Server. The Server and Port number fields populate with the information for the connected license server.
  2. Click Disconnect, then click Yes to confirm the request to disconnect. A message appears when the client successfully disconnects.
  3. Click Close to exit the tool.

Borrow Licenses from a License Server

Client computers can optionally borrow licenses from a license server. Borrowing licenses activates them locally to the client computer, for a limited time. One example of borrowing is when you need to work in a remote region for one week and will be unable to connect to the license server to acquire licenses. In this case, you borrow the needed licenses for a week; then when the specified time has expired, the licenses will be automatically returned to the license server.

To borrow licenses from a license server:

  1. In the Harris License Administrator tool, click Borrow Licenses from a Server.
  2. The Server and Port fields populate with values if there is a current license server connection. Enter or change the values if needed.
  3. Use the check boxes to select the licenses to borrow, or enable the Select all check box to select all licenses.
  4. Enter the Borrow time in days. The default is 7, which is the maximum number of days allowed.
  5. Enter the Quantity of licenses to activate. The default is 1.
  6. Click Borrow from Server. A message appears when the licenses are successfully borrowed. To view details on borrowed licenses for the computer, click View Licenses. See View Licenses and Feature Details for more information.
  7. Click Close to exit the tool.

Return Borrowed Licenses to a License Server

Borrowed licenses are automatically returned to the license server at the end of the specified period, but you can return all of the licenses earlier.

To return licenses on a server:

  1. In the Harris License Administrator tool, click Borrow Licenses from a Server.
  2. The Server and Port fields populate with values if there is a current license server connection. Enter or change the values if needed.
  3. Click Return all Licenses to Server. All borrowed licenses are returned to the server.
  4. Click Close to exit the tool.

View Licenses and Feature Details

Click View Licenses in the Harris License Administrator tool to view license details and features for the computer. The license names, activation codes, and maintenance IDs available to the computer will be listed in a table. Licenses that are available from a license server will be marked with an asterisk (*) next to the Name column. To refresh the data in the table, click the refresh icon.

To view feature details for the licenses, select one or more table rows and enable the Show feature details check box. Select all table rows to show all licenses. To filter the details further to show only in-use features, enable the Show in-use only check box.

In the feature details Expiration column:

  • The expiration date is listed for licenses that have a termination date.
  • For licenses borrowed from a license server, the expiration date is listed as a maximum of seven days from the date you are viewing the details.
  • Permanent indicates the license does not have a termination date.

You can copy the details of all features to the clipboard, or save them to a .json file.

To view the license activity log for the computer, or to view device information for the computer, click View Log.

Manage Licenses from the Command Line

The steps that follow describe how to:

  • Activate node-locked licenses using commands.
  • Deactivate node-locked licenses using commands.
  • Manually create a file to connect a client to a license server.
  • Remove a client connection to a license server.
  • Borrow licenses from a license server for a limited time using commands.
  • Return borrowed licenses to a license server using commands.

These steps have you activate licenses over the Internet. If you do not have Internet access, contact Technical Support for separate instructions to activate your license offline.

The Activate Utility

For steps in the next sections that refer to using the activate utility, the utility is located in the following directories:

  • Windows: INSTALL_DIR\IDLxx\license_utils\bin.x86_64
  • Linux: INSTALL_DIR/idlxx/license_utils/bin.linux.x86_64
  • Mac: INSTALL_DIR/idlxx/license_utils/bin.darwin.x86_64

You can view parameter help for the activate utility by typing activate.exe -h on Windows, or ./activate -h on Linux and Mac.

Activate Licenses

To activate node-locked licenses, open a command or terminal window, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate.exe -a activation-code [-q quantity]

Example:

activate.exe -a AAAA-BBBB-CCCC-DDDD -q 1

Linux and Mac:

./activate -a activation-code [-q quantity]

Example:

./activate -a AAAA-BBBB-CCCC-DDDD -q 1

Where:

  • -a specifies the activation ID.
  • -q specifies the quantity of licenses. The default is 1.

To view details on activated licenses for the computer, see View Licenses and Feature Details for commands.

Deactivate Licenses

Licenses remain activated on a computer until you deactivate them. Deactivating a license returns it to the Harris Download and Licensing Center. Deactivated licenses can then be used on another computer, by either the same person or another person. For example, if you receive a new computer and you want to install the software on it, first deactivate the licenses from the old computer. If you do not deactivate the licenses (and the old computer is no longer accessible to you), you will be unable to activate them on the new computer. If that occurs, Technical Support will need to deactivate the licenses for you.

To deactivate licenses, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate.exe -a activation-code [-q quantity]

Example:

activate.exe -a AAAA-BBBB-CCCC-DDDD -q 0

Linux and Mac:

./activate -a activation-code [-q quantity]

Example:

./activate -a AAAA-BBBB-CCCC-DDDD -q 0

If you originally activated a quantity greater than 1, you can reduce the quantity to a specified number without deactivating all licenses. For example:

Windows:

activate.exe -a AAAA-BBBB-CCCC-DDDD -q 1

Linux:

./activate -a AAAA-BBBB-CCCC-DDDD -q 1

Connect a Client to the License Server

Create a plain text file on the client computer to reference the license server. Perform the following steps:

  1. Create a plain text file that contains a reference to the license server URL. Format the text as follows:

    http://[license-server-hostname-or-IP-address]:7070/fne/bin/capability

    For example:

    http://myserver.mycompany.com:7070/fne/bin/capability

  2. Save the file with the name o_licenseserverurl.txt.
  3. Copy the file to the license subdirectory located under your Harris installation directory. The file should have read privileges for all product users.

    Examples using the default locations:

    Windows: C:\Program Files\Harris\license\o_licenseserverurl.txt

    Linux: /usr/local/harris/license/o_licenseserverurl.txt

    Mac: /Applications/harris/license/o_licenseserverurl.txt

    To view details on served licenses for the computer, see View Licenses and Feature Details for commands.

Remove a Client Connection to a License Server

To remove the client computer's connection to the license server, delete the o_licenseserverurl.txt from the license subdirectory located under your Harris installation directory.

Borrow Licenses from a License Server

Use the activate utility to borrow licenses from a license server for a period of time.

To borrow licenses, open a command or terminal window on the client, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate.exe -a activation-code -s serverName:serverPort -t seconds

Example:

activate.exe -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400

Linux and Mac:

./activate -a activation-code -s serverName:serverPort -t seconds

Example:

./activate -a AAAA-BBBB-CCCC-DDDD -s LicenseServer:7070 -t 86400

Where:

  • -a specifies the activation ID.
  • -s specifies a license server.
  • -t specifies the borrow interval, in seconds. The default is 86400 seconds (one day). When this value expires, the features are automatically returned to the license server for use by another process.

The following are also valid command-line arguments for borrowing with activate:

  • -b specify the name of a buffered license file, to display the features it contains.
  • -c use this option with -b, to display the C source code for a buffer license.
  • -g groups features by their license source (i.e., License Portal and borrowed from a license server).

To view details on borrowed licenses for the computer, see View Licenses and Feature Details for commands.

Return Borrowed Licenses to a License Server

Use the activate utility to return borrowed licenses before their expiration date.

To return borrowed licenses, open a command or terminal window, change to the directory that contains the activate utility, and type the following at the command line:

Windows:

activate -r -s serverName:serverPort

Example:

activate -r -s LicenseServer:7070

Linux and Mac:

./activate -r -s serverName:serverPort

Example:

./activate -r -s LicenseServer:7070

Where:

  • -r returns all borrowed licenses to a license server.
  • -s specifies a license server.

View Licenses and Feature Details

To view license details and features, open a command or terminal window, change to the directory that contains the activate utility, and type one of the following at the command line:

Windows:

  • activate.exe -l
  • activate.exe -i

Linux and Mac:

  • /.activate -l
  • ./activate -i

Where:

  • -l lists feature details.
  • -i lists license-feature concurrent usage.

In the license feature output, the "name" value will have the following prefixes:

  • nl-, to indicate a node-locked license.
  • sv-, to indicate a served license.

Examples using IDL:

"name" : "nl-idl",

"name" : "sv-idl",

In the license feature output, the "expiration" value:

  • The expiration date is listed for licenses that have a termination date.
  • For licenses borrowed from a license server, the expiration date is listed as a maximum of seven days from the date you are viewing the output.
  • permanent indicates the license does not have a termination date.

Windows Silent Installation

These instructions describe how to record an .ini file you can use to silently install IDL on other Windows systems. This can be useful when you need to install IDL on multiple computers.

To record the .ini file, use the steps below:

  1. Open a command window, running as administrator.
  2. Navigate to the location of the IDL installation executable file:

    • Web download: idlxx-win.exe
    • DVD: setup-idlxx-win.exe
  3. Use the following syntax, where IDL_INSTALL_EXECUTABLE is the applicable IDL installation executable filename from above. This syntax initiates recording the .ini file and starts the IDL installer:

    IDL_INSTALL_EXECUTABLE.exe /SAVEINF='INI_FILE_DIR\IDL_only.ini'

  4. Follow the prompts to install the software. The options you select during the installation process will be recorded to the .ini file.

To use the .ini file to perform a silent install on other Windows systems:

  1. Copy IDL_only.ini to a computer that needs to have IDL installed.
  2. Open a command window, running as administrator.
  3. Use the following command and flags to start the silent installation. In the example below, IDL_INSTALL_EXECUTABLE_DIR is the directory that contains the IDL installer, IDL_INSTALL_EXECUTABLE is the applicable executable filename from above, and INI_FILE_DIR is the directory that contains the .ini file:

    \IDL_INSTALL_EXECUTABLE_DIR\IDL_INSTALL_EXECUTABLE.exe /LOADINF='INI_FILE_DIR\IDL_only.ini' /SP /VERYSILENT /SUPPRESSMSGBOXES /NOCANCEL /NORESTART /FORCECLOSEAPPLICATIONS

    The following is example syntax for a silent install from the DVD:

    D:\setup-idlxx-win.exe /LOADINF='C:\Temp\IDL_only.ini' /SP /VERYSILENT /SUPPRESSMSGBOXES /NOCANCEL /NORESTART /FORCECLOSEAPPLICATIONS

Where:

  • LOADINF tells the installer to load settings from the specified file after checking the command line. Use the SAVEINF flag to prepare the settings file.
  • SP disables the prompt, "This will install...Do you wish to continue?" that appears at the beginning of the installer.
  • SILENT tells the installer to display only the installation progress window, but not the installation wizard and background window.
  • VERYSILENT prevents the installation progress window, installation wizard, and background window from displaying.
  • SUPPRESSMSGBOXES tells the installer to suppress message windows. This flag only works when combined with SILENT or VERYSILENT.
  • NOCANCEL prevents the user from cancelling the installation. It disables the Cancel button and ignores clicks on the Close button. This flag is also used in combination with SILENT or VERYSILENT.
  • NORESTART prevents the installer from restarting the system following a successful installation or after a "Preparing to Install" failure that requests a restart. This flag is typically used in combination with SILENT or VERYSILENT.
  • FORCECLOSEAPPLICATIONS tells the installer to force a close when closing applications.

© 2016 Exelis Visual Information Solutions, Inc., a subsidiary of Harris Corporation. All Rights Reserved. This information is not subject to the controls of the International Traffic in Arms Regulations (ITAR) or the Export Administration Regulations (EAR). However, this information may be restricted from transfer to various embargoed countries under U.S. laws and regulations.

Please login or register to post comments.