Product Support

1317 - Technical Support Guide to Troubleshooting Mac 10.2.x Installations

Section 1: Overview

The purpose of this Technical Note is to provide troubleshooting steps for Mac OS X 10.2.x. As a result of changes introduced in 10.2, a patch is required to run MATLAB 6.5 (R13). In general, the workarounds presented in this document are suitable for machines running 10.2.x only.

Section 2: How Do I Create My License.Dat File?

The format of the license.dat file is important to ensure that the installation goes smoothly. Follow the steps below to create the license.dat file.

In the Finder, double-click the TextEdit icon in the /Applications folder.
Copy and paste the text of the license.dat file from your e-mail or Web browser into the Textedit window.
Make sure that no extra carriage returns or tab characters have been introduced into the file.
Choose the Make Plain Text option from the Format menu.
Choose Save As from the File menu and call the file license.dat. Select Desktop for the Where field and select the Plain Text Encoding as Western (Mac OS Roman).
Click the Save button. You may receive a message asking if you would like to append .txt to the file name. Choose Don't Append.

Section 3: Why Is the Installer Quitting During the Installation Process?

The installation process will quit if you are using copied CDs, instead of the original CDs, to install MATLAB for Mac OS X. If you were to open up the console (located in the Application -> Utilities directory) and then run the installer again using the copied CDs, you will see the follow error:

An error occured while executing the AppleScript: Can't make POSIX file "/Volumes/MathWorks_R13_1" of "script" into a alias

If you need original CDs from The MathWorks, e-mail service@mathworks.com, or call Customer Service at 508.647.7000, option 4. Alternatively, you can also download MATLAB as long as your license is under maintenance. To do this, log in to your MathWorks Account. If you are using the original CDs, then you may have a problem with the cache settings in Jaguar. Try the Jaguar Cache Cleaner from Northern Softworks at http://www.northernsoftworks.com/jaguarcachecleaner.html

To run this utility:

Close any open applications. Running this utility will require a reboot.
Double-click on the jcc.dmg image.
Double-click on the Jaguar Cache Cleaner 1.1.
Double-click on the Jaguar Cache Cleaner icon in the resulting window.
When the Jaguar Cache Cleaner starts, enter your admininstrator password.
Select the Deep Cleaning option.
Select the Clean Local Cache and Clean System Cache options.
Click the Clean button.

After rebooting your computer, the Launch MATLAB icon should work properly. Alternatively, the above error may indicate that you are experiencing a problem with DiskCopy, which can be fixed with a reinstallation from the Jaguar System CDs.

Section 4: Why Doesn't the MATLAB 6.5 (R13) Installer Recognize My License.Dat File?

I have created a license.dat file and placed it on the Desktop but when I run the installer I recieve the following error:

TMW_Archive license checkout failed. Invalid (inconsistent) license key The license-key and data for the feature do not match. This usually happens when a license file has been altered Feature: TMW_Archive License path: /Applications/MATLAB6p5/etc/license.dat FLEXlm error: -8,130

This error indicates that the license.dat file is corrupt. On Macintosh computers, this most likely means that the license.dat file was saved in rich-text format (.rtf) or was saved with Mac-style line endings that the UNIX-based installer does not understand. Before following the steps below to make a correctly formatted license.dat file, delete any previous license.dat files on the Desktop or in the /Applications/MATLAB6p5/etc directory. Also delete the MLM.opt file in the same directory if it exists. To create the a license.dat file, see Section 2.

After completing the license.dat file instructions, try running the installer again. Review this solution for instructions on running the installer.

Section 5: Why Do I Receive "License Manager Error -15"?

In order to run MATLAB 6.5 (R13) on the Mac, you must run the FLEXlm license manager software. You may receive a license manager error -15 if the license manager has not been started properly before attempting to start/run MATLAB. In order to start the license manager manually:

Open a terminal window (Applications => Utilities)
Type
```
cd /Applications/MATLAB6p5/etc
```
Type
```
./lmstart
```

In order to have the license manager start automatically at system boot, see Configuring the MATLABLmgr script.

Section 6: Why Do I Receive A "License File, $LM_FILE, Has No SERVER Lines" Error When I Try to Start the License Manager?

Error: License file, $LM_FILE, has no SERVER lines. LM_FILE = /Applications/MATLAB6p5/etc/license.dat If all features are locked to a hostid of DEMO then running license manager daemons is not required. Otherwise, fix $LM_FILE by adding SERVER and DAEMON lines(s) and try again.

This error is usually the result of the license.dat file either being saved in rich-text format (.rtf) or being saved with Mac style line endings. To correct this:

Open the TextEdit program under either Applications or Applications => Utilities.
Click on the File menu and choose Open.
In the Go to: field type
```
/Applications/MATLAB6p5/etc
```
Double-click on the license.dat file in the right menu.
Choose the Make Plain Text option from the Format menu.
Choose Save As from the File menu and call the file license.dat. Select Desktop for the Where field and leave the Plain Text Encoding as Western (Mac OS Roman).
Click the Save button. You may receive a message asking if you would like to append .txt to the file name. Choose Don't Append.

You will need to restart the license manager manually for these changes to take effect. To start the license manager:

Open a Terminal window (Applications => Utilities)
Type
```
cd /Applications/MATLAB6p5/etc
```
Type
```
./lmstart
```
If you receive a warning similar to the following: "Error: Your host does not match any SERVER line in your license file... Continue to start up license manager? y/[n]"
Type y to continue starting the license manager

Section 7: Why Do I Receive License Manager Errors -14 Or -95 When I Try to Start Either MATLAB Or the License Manager?

The license manager does not start properly in all cases on the Mac due to dynamic hostnames incorporated in OS X. Customers affected the most are those with Individual licenses on laptops, which require a license manager to be running in such a nonstatic network environment. In order to get the license manager to successfully start up, you must redirect localhost to the Rendezvous hostname using the NetInfo Manager. The Rendezvous hostname is the hostname that is given to the computer when it is off the network.

Reboot the computer while disconnected from the network.
Open a Terminal window (Applications => Utilities) and type
```
hostname
```
Make note of the output.
Open the NetInfo Manager (Applications => Utilities) and select machines in the Directory Browser window.
Click the lock at the bottom to make changes, and provide the administrator password.
Choose machine: localhost, and duplicate it by clicking the button with two folders on it (second from the left).
Select localhost copy.
Double-click on the name field (localhost copy) (in the bottom of half of the screen) and change it to the output of the hostname command from step 2.
Save changes and quit NetInfo Manager.
Open the TextEdit program (Applications => Utilities).
Click on the File menu and choose Open.
In the Go to: field type
```
/Applications/MATLAB6p5/etc"
```
Double-click on the license.dat file in the right menu.
Edit the SERVER line in the license.dat file to read:
```
SERVER your_rendezvous_name ID=license_number 27000 
            
```
where your_rendezvous_name is the rendezvous name from step 2 and license_number is your license number.
Save the file as plain text and exit TextEdit.

You should now be able to start the license manager on and off the network.

Section 8: Why Do I Get A "Dyld: /Library/MATLAB/Bin/Mac/Matlab Undefined Symbols" Error When Starting MATLAB?

Receiving the following error

dyld: /Library/MATLAB/bin/mac/matlab Undefined symbols: _tgetent _tgetstr

indicates that you must run the MATLAB Jaguar Updater patch. In some cases you may receive this error after you have already installed the patch. For instance, it you add a new toolbox to an existing installation, you will have to reapply the patch to make the necessary changes to the new components.

Section 9: Why Do I Get "License Manager Error -84"?

License Manager Error -84 USER_BASED license has no specified users -- see server log

If you receive this error, some information may have been omitted during the installation process and will need to be manually added to the license.dat and MLM.opt files in the /Applications/MATLAB6p5/etc directory. For more information on what a local options file (MLM.opt) is, review either the section on Specifying Users in an Options File of the License Administration Guide, or see Chapter 6 of the FLEXlm End User's Guide.

Follow the instructions below to manually edit these files.

Editing the license.dat file

Open the TextEdit program under Applications => Utilities.
Click on the File menu and choose Open.
In the Go to: field type
```
/Applications/MATLAB6p5/etc
```
Double-click on the license.dat file in the right menu.

Look for the line in the license.dat file beginning with the word DAEMON. If this line currently reads

DAEMON MLM /Applications/MATLAB6p5/etc/lm_matlab

edit the line to look like the following:

DAEMON MLM /Applications/MATLAB6p5/etc/lm_matlab \
options=/Applications/MATLAB6p5/etc/MLM.opt

After making these changes, save the file to overight the existing license.dat file.

Editing the MLM.opt file

Open the TextEdit program under Applications => Utilities.
Click on the File menu and choose Open.
In the Go to: field type
```
/Applications/MATLAB6p5/etc
```
Double-click on the MLM.opt file in the right menu.

Edit this file to contain an INCLUDE line with the following format for each product in your license.dat file

INCLUDE product_name USER user_name

where product_name is the product name taken from the each INCREMENT line in your license.dat file and user_name is your login name, which can be obtained by typing

whoami

at a terminal prompt. (Note that the only INCREMENT line that does not require an INCLUDE line is the line containing the TMW_Archive feature.) For instance, if your license.dat file looks like the following

# BEGIN-------cut here-------CUT HERE-------BEGIN
# MATLAB license passcode file for use with FLEXlm.
# LicenseNo: 12345           HostID: ID=12345
SERVER John-Smith's-Computer.local. ID=12345 27000
DAEMON MLM /Applications/MATLAB6p5/etc/lm_matlab \
options=/Applications/MATLAB6p5/etc/MLM.opt
INCREMENT TMW_Archive MLM 13 01-jan-0000 0 9C5DC487495FB62A5A03 \
  VENDOR_STRING="83" HOSTID=DEMO SN=[2~
INCREMENT MATLAB MLM 13 01-jan-0000 1 BC5DA407300473E9F750 \
  DUP_GROUP=UH SN=12345
INCREMENT SIMULINK MLM 13 01-jan-0000 1 3C7D4457A2CDECE3D9A7 \
  DUP_GROUP=UH SN=12345
INCREMENT Signal_Toolbox MLM 13 01-jan-0000 1 4C2D64E7A8C1660149A3 \
  DUP_GROUP=UH SN=12345
# END---------cut here-------CUT HERE-------END

you would need to add the following INCLUDE lines to your MLM.opt file:

INCLUDE MATLAB USER jsmith
INCLUDE SIMULINK USER jsmith
INCLUDE Signal_Toolbox USER jsmith

After editing this file, make sure to leave an extra carriage return after your last INCLUDE line.

You will need to restart the license manager manually for these changes to take effect. To start the license manager:

Open a Terminal window (Applications => Utilities)
Type
```
cd /Applications/MATLAB6p5/etc
```
Type
```
./lmstart
```
If you receive a warning similar to the following: "Error: Your host does not match any SERVER line in your license file... Continue to start up license manager? y/[n]"
type y to continue starting the license manager.

Section 10: Why Do I Get "License Manager Error -39"?

License Manager Error -39 User/host not on INCLUDE list for feature

This error is caused by an incorrect username on the INCLUDE line of your MLM.opt file. In order to avoid this error, check to make sure that your username matches the name in each INCLUDE line in your MLM.opt file. To obtain your current username and edit the MLM.opt file:

Open a Terminal window (Applications => Utilities).
Type
```
whoami
```
at the command prompt.
Open the TextEdit (Applications => Utilities).
Click on the File menu and select Open.
In the Go to: field type
```
/Applications/MATLAB6p5/etc
```
Double-click on the MLM.opt file in the right menu.
Each INCLUDE line in the MLM.opt file will have the following format
```
INCLUDE product_name USER user_name
                        
```
where is the product name taken from the each INCREMENT line in your license.dat file and is your login name. Make sure that matches the name obtained in step 2.

You will need to restart the license manager manually for the changes to take effect. To start the license manager:

Open a Terminal window (Applications => Utilities)
Type
```
cd /Applications/MATLAB6p5/etc
```
Type
```
./lmstart
```
If you receive a warning similar to the following: "Error: Your host does not match any SERVER line in your license file... Continue to start up license manager? y/[n]"
Type y to continue starting the license manager.

Section 11: Why Does Oroborosx Not Launch When I Double Click On the Launchmatlab Icon?

You may have problems starting MATLAB if OroborOSX is either not installed, or not running. Confirm that OroborOSX is installed, and you are starting MATLAB using the Launch Matlab icon in the /Applications/MATLAB6p5/bin directory. If this fails to start OroborOSX, run the XFree86 updater contained in the MATLAB Jaguar Updater by clicking on the XFree86_4.2.0.1_10.2 icon.

If you still have problems after installing the XFree86 updater, try running the Jaguar Cache Cleaner utility at the following URL:

http://www.northernsoftworks.com/jaguarcachecleaner.html

To run this utility:

Close any open applications. Running this utility will require a reboot.
Double-click on the jcc.dmg image.
Double-click on the Jaguar Cache Cleaner 1.1.
Double-click on the Jaguar Cache Cleaner icon in the resulting window.
When the Jaguar Cache Cleaner starts, enter your admin password.
Select the Deep Cleaning option.
Select the Clean Local Cache and Clean System Cache options.
Click the Clean button.

If this still does not resolve the problem, make sure that you are using the version of OroborOSX (0.8preview3) that ships with MATLAB 6.5 (R13).

Also, if you are attempting to start MATLAB from the command line instead of using the LaunchMatlab icon, you must use the OroborOSX window. If you try to start MATLAB from a terminal window, MATLAB will appear momentarily and then disappear.

Section 12: Why Does MATLAB Start And Then Disappear After Double-Clicking On the Launchmatlab Icon?

If try to start it manually from the terminal, or open the console, the following error is produced:

execution error: No user interaction allowed. (-1713)

You may have a problem with the cache settings in Jaguar. Try the Jaguar Cache Cleaner from Northern Softworks at

http://www.northernsoftworks.com/jaguarcachecleaner.html

To run this utility, see the previous section.

Section 13: Why Does the License Manager Not Start At Boot Time After Configuring the Matlablmgr Script?

The license manager will not start up automatically at boot time if the MATLABLmgr file was not edited correctly. We recommend using the TextEdit application to edit the MATLABLmgr file. Follow the steps below to recreate this script:

Copy the entire MATLABLmgr folder from the /Applications/MATLAB6p5/etc directory to the /Library/StartupItems directory. (Make sure that you are navigating to the Library folder at the top level of your hard drive and that a StartupItems folder has been created within the /Library folder.)
Open the TextEdit program under either Applications or Applications => Utilities.
Select Open from the File menu and open the /Library/StartupItems/MATLABLmgr script.
Choose the Make Plain Text option from the Format menu if that option is available.
Change |>MATLAB<| to be the location where MATLAB is installed (such as /Applications/MATLAB6p5).
Change |>ME<| to be the username under which the License Manager daemon will be started. For example, use your own userid. To determine your userid, open the terminal application and type
```
whoami
```
at the terminal prompt. For security reasons, the userid must not be root.

Note: When editing the script, make sure that when you entered your MATLAB installation directory and username that you removed the '|', '>', and '<' characters. For example, if installing into the default location ( /Applications/MALTAB6p5) and using the username jsmith the resulting edits will look like the following:
```
MATLAB=/Applications/MALTAB6p5
ME=jsmith
```
Choose Save As from the File menu and call the file MATLABLmgr and leave the Plain Text Encoding as Western (Mac OS Roman).
Click the Save button. You may receive a message asking if you would like to append .txt to the file name. Choose Don't Append.

Products & Services	Industries	Academia	Support	User Community	Company