License manager service for ENVI 5.0 or IDL 8.2 on Mac OS X can fail (DVD, or installer downloads prior to May 19, 2012)

THIS INFORMATION ONLY PERTAINS TO SOFTWARE VERSIONS IDL 8.5, ENVI 5.3 AND PRIOR

DESCRIPTION:

ENVI 5.0, IDL 8.2 license manager service can fail on Mac OS X when installed from the ENVI 5.0 or IDL 8.2 DVD or from a downloaded installer file obtained before May 19, 2012.

NOTE: The downloaded installers for ENVI 5.0, IDL 8.2, or the IDL 8.2 license manager installer, for Mac OS X, that were obtained from the www.exelisvis.com web site on or after May 19, 2012, are not affected by the problems described in this help article.

NOTE: Only Mac OS X machines running IDL 8.2/ENVI 5.0 license manager service to administer standard server-based single-user node-locked (SN) licenses or network floating (FL) licenses, will be affected by these issues. Unserved license types should not use the license manager service.

Briefly, affected installations may encounter one or more of the following problems:

1.) Previously installed IDL 8.1 or IDL 8.0/ENVI 4.8 license manager service interferes with IDL 8.2/ENVI 5.0 license manager service on Mac OS X, resulting in an error message like: "The TCP port number in the license, 1700, is already in use."

2.) IDL 8.2/ENVI 5.0 Mac OS X license manager service repeatedly fails and restarts encountering the error: "license manager: can't initialize: Cannot find license file"

3.) IDL 8.2/ENVI 5.0 lmgrd LaunchDaemons service on Mac OS X 10.7 (Lion) repeatedly crashes and restarts encountering the error: "Job appears to have crashed: Illegal instruction: 4"

NOTES:
* The details of these 3 issues are discussed in the section below titled "PROBLEM DETAILS".
* If you would simply like to disable the ENVI/IDL license manager service, refer to Help Article 5268: "Instructions to manually uninstall/stop the ENVI/IDL license manager service on Mac OS X".

SOLUTION:

The problems described can be resolved in one of two ways:

* Solution 1.) Download and install the updated release of ENVI 5.0, IDL 8.2 installer, for Mac OS X, obtained from the Exelis Visual Information Solutions web site.

* Solution 2.) Alternatively, download and install the ENVI 5.0/IDL 8.2 Hotfix 5/17/2012 to your affected ENVI 5.0 or IDL 8.2 installation for Mac.

Solution details:

Solution 1.) Download and install the updated release of ENVI 5.0, IDL 8.2 installer, for Mac OS X, obtained from the Exelis Visual Information Solutions web site. (The updated version of ENVI 5.0 or IDL 8.2 may be installed on top of your old ENVI 5.0 or IDL 8.2 installation.)

Download and installation steps:

a.) Go to http://www.exelisvis.com

b.) Login to the web site using your Exelis Visual Information Solutions-provided web site user name and password.

c.) Select the Downloads > Product Downloads web page menu item

d.) Select the ENVI> or IDL> product name link

e.) Click the Mac OS X Native installer download link for ENVI 5.0 or IDL 8.2. (Or, if needed, click on the link to download the UNIX style, terminal command line installer for Mac)

f.) Select the appropriate Purpose and Export Regulation Compliance buttons, and then click on the Product Download.

g.) After downloading the Native Mac installer file, double click to launch the installer and follow the prompts to complete the installation. (If you have downloaded the Unix style installer for Mac, follow the provided instructions to run the command line installer program.)

(Note, the updated version of ENVI 5.0 or IDL 8.2 may be installed on top of the old ENVI 5.0 or IDL 8.2 installation.)

h.) After running the Mac OS X Native installer for ENVI or IDL, and assuming that the correct license server based license.dat file for your machine is already installed, you should do the following: Open an X11 Terminal window, change directories to the actual the idl82/bin directory of your ENVI 5.0 or IDL 8.2 installation, and then run the "lmgrd_install" command as "root" or with "sudo" privileges. For example, after opening the terminal window, for a default installation location, issue the following terminal commands:

cd /Applications/exelis/idl82/bin
sudo ./lmgrd_install

Alternatively, you can run the license wizard utility, with "sudo" or "root" privileges, to install your license server-based license.dat file and to finish the configuration of the updated license manager service. For example (using a Bash shell):

cd /Applications/exelis/idl82/bin
. ./idl_setup.bash
sudo ./exelislicense

After the license wizard utility has appeared, select the option "Install a license file you have received", click on "Next>", click on "Browse to import license file", select the license file for your machine, allow the system configuration of the license manager service, and Finish to exit the license wizard utility.

Figure 1: License wizard license manager service configuration screen

i.) Reboot the system to stop any old running instances of the license manager program, and to ensure that the new license manager service is invoked properly.

Solution 2.) Alternatively, download and install the ENVI 5.0/IDL 8.2 Hotfix 5/17/2012 to your affected ENVI 5.0 or IDL 8.2 installation for Mac.

Download and installation steps:

a.) Go to http://www.exelisvis.com

b.) Login to the web site using your Exelis Visual Information Solutions-provided web site user name and password.

c.) Select the Downloads > Product Downloads web page menu item

d.) Click on the link to download ENVI 5.0/IDL 8.2 Hotfix 5/17/2012. The installation file is a compressed archive; save or copy this file to the ENVI or IDL installation directory (default installation directories are /usr/local/exelis on UNIX or /Applications/exelis on Macintosh).

e.) Launch a terminal window and change directories to your ENVI or IDL installation directory.

f.) Unpack the archive. First uncompress the file by entering:

gunzip ./envi50idl82_r1.tar.gz

then untar the file:

tar xf ./envi50idl82_r1.tar

Or with sudo privileges:

sudo gunzip ./envi50idl82_r1.tar.gz
sudo tar xf ./envi50idl82_r1.tar

g.) Now execute the installation program by entering the following command (be sure to issue the command as "root" or with "sudo" privileges):

    ./install_envi50idl82r1
  or
    sudo./install_envi50idl82r1

h.) Read and accept the license agreement. Follow the prompts to complete the installation.

i.) After running the Mac OS X Native installer for ENVI or IDL, and assuming that the correct license server based license.dat file for your machine is already installed, you should do the following: Open an X11 Terminal window, change directories to the actual the idl82/bin directory of your ENVI 5.0 or IDL 8.2 installation, and then run the "lmgrd_install" command as "root" or with "sudo" privileges. For example, after opening the terminal window, for a default installation location, issue the following terminal commands:

cd /Applications/exelis/idl82/bin
sudo ./lmgrd_install

Alternatively, you can run the license wizard utility, with "sudo" or "root" privileges, to install your license server-based license.dat file and to finish the configuration of the updated license manager service. For example (using a Bash shell):

    cd /Applications/exelis/idl82/bin
    . ./idl_setup.bash
    sudo ./exelislicense

After the license wizard utility has appeared, select the option "Install a license file you have received", click on "Next>", click on "Browse to import license file", select the license file for your machine, allow the system configuration of the license manager service (see Figure 1, above), and Finish to exit the license wizard utility.

j.) Reboot the system to stop any old running instances of the license manager program, and to ensure that the new license manager service is invoked properly.

PROBLEM DETAILS:

If needed, below are additional details about the problems that may be encountered:

1.) Previously installed IDL 8.1 or IDL 8.0/ENVI 4.8 license manager service interferes with IDL 8.2/ENVI 5.0 license manager service on Mac OS X.

For this problem, customers that have previously installed the ENVI 4.8 (IDL 8.0) or IDL 8.1 license manager service will encounter a conflict between the IDL 8.2 license manager service and the previous IDL 8.0/8.1 license manager service because the IDL 8.2 lmgrd_install script does not disable /Library/LaunchDaemons/com.ittvis.lmgrd.plist service before installing the com.ittvis.lmgrd.plist service. This problem can affect IDL 8.2/ENVI 5.0 on Mac OS X 10.6 and 10.7.

Below is an example of error messages caused by this problem that are repeated in the Apple Console utility:

5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) The TCP port number in the license, 1700, is already in use.
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) Possible causes:
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) 1) The license server manager (lmgrd) is already running for this license.
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) 2) The OS has not "cleared" this port since lmgrd died.
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) 3) Another process is using this port number (unlikely).
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) Solutions:
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) 1) Make sure lmgrd and all vendor daemons for this
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) license are not running.
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) 2) You may have to wait for the OS to clear this port.
5/4/12 6:02:01 PM com.exelis.lmgrd[6557] 18:02:01 (lmgrd) Retrying for about 5 more minutes
5/4/12 6:02:19 PM com.exelis.lmgrd[6557] 18:02:19 (lmgrd) Still trying...
5/4/12 6:05:19 PM com.exelis.lmgrd[6557] 18:05:19 (lmgrd) Still trying...

The last status is repeated continuously. Eventually an error like the following is encountered:

5/4/12 6:05:34 PM com.exelis.lmgrd[6557] 18:05:34 (lmgrd) Failed to open the TCP port number in the license.
5/4/12 6:05:34 PM com.apple.launchd[1] (com.exelis.lmgrd[6557]) Exited with exit code: 35

Finally, the license manager service tries to start again, resulting in a repeat of the above errors.

2.) IDL 8.2/ENVI 5.0 Mac OS X license manager service repeatedly fails and restarts because of error: "license manager: can't initialize: Cannot find license file"

The “idl82/bin/lmgrd” shell script contains a “license.dat” file path definition for the LM_LICENSE_FILE variable that points to an incorrect relative legacy license folder location that expected the presence of the extra “idl” directory above them main “idl81” or “idl80” directory. This problem can affect IDL 8.2/ENVI 5.0 on Mac OS X 10.6 and 10.7.

Below is an example of the repeated error messages caused by this problem, which can be observed in the Apple Console utility:

5/4/12 6:22:10 PM com.exelis.lmgrd[6748] license manager: can't initialize: Cannot find license file.
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] The license files (or license server system network addresses) attempted are
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] listed below. Use LM_LICENSE_FILE to use a different license file,
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] or contact your software provider for a license file.
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] Filename: /usr/local/flexlm/licenses/license.dat
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] License path: /usr/local/flexlm/licenses/license.dat:
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] FLEXnet Licensing error:-1,359. System Error: 2 "No such file or directory"
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] For further information, refer to the FLEXnet Licensing documentation,
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] available at "www.acresso.com".
5/4/12 6:22:10 PM com.exelis.lmgrd[6748] 18:22:10 (lmgrd) Using license file "/usr/local/flexlm/licenses/license.dat"
5/4/12 6:22:10 PM com.apple.launchd[1] (com.exelis.lmgrd[6748]) Exited with exit code: 255
5/4/12 6:22:10 PM com.apple.launchd[1] (com.exelis.lmgrd) Throttling respawn: Will start in 10 seconds

3.) IDL 8.2/ENVI 5.0 lmgrd LaunchDaemons service on Mac OS X 10.7 (Lion) repeatedly crashes and restarts because of error: "Job appears to have crashed: Illegal instruction: 4"

Even if the first two issues above are repaired, this third problem will occur with the IDL 8.2/ENVI 5.0 license manager service running on Mac OS X 10.7 (Lion). This problem can also occur with the IDL 8.1 license manager service configuration on Lion.

Below is an example of the repeated error messages that are generated by this problem:

07/05/12 18:39:44,000 kernel CODE SIGNING: cs_invalid_page(0x100000000): p=7102[lmgrd] clearing CS_VALID
07/05/12 18:39:44,422 com.apple.launchd (com.exelis.lmgrd[7102]) Job appears to have crashed: Illegal instruction: 4
07/05/12 18:39:44,422 com.apple.launchd (com.exelis.lmgrd) Throttling respawn: Will start in 10 seconds
07/05/12 18:39:44,473 ReportCrash Saved crash report for lmgrd[7102] version ??? (???) to /Library/Logs/DiagnosticReports/lmgrd_2012-05-07-183944_localhost.crash

ENVI 5.0 and IDL 8.2 license manager problems on Mac, Linux, Solaris (DVD, or installer downloads prior May 19, 2012) Instructions to manually uninstall/stop the ENVI/IDL license manager service on Mac OS X