After You Install

On this page…
Starting MATLAB Software Updating Your License Putting the MATLAB Installation folder on the Path Setting Up MATLAB Printing Options Starting the License Manager

Note    For more information about setting up network configurations, see the License Administration Guide.

Starting MATLAB Software

To start MATLAB, navigate to the MATLAB installation folder and double-click the MATLAB icon.

If you installed MathWorks products in a network configuration, the license manager must be running on your server to start MATLAB on client systems. If you accepted the defaults during installation of the license manager on your server, the installer configures the license manager to start automatically at system startup. If you need to start the license manager manually, see Starting the License Manager.

Back to Top

Updating Your License

Throughout the term of your license, your MATLAB installation periodically contacts The MathWorks to verify that your license is up-to-date, a process called validation. If it determines that you need to update your license, the validation process displays a dialog box giving you the option to update your license. Validation updates expiring licenses and License Files with product configuration changes. (You can also check for License File updates at any time by selecting Help > Licensing > Update Current Licenses from the MATLAB desktop.)

The administrator contact on a license can modify validation settings for the license at the License Center at the MathWorks Web site. See the License Center Help for more information.

Back to Top

Putting the MATLAB Installation folder on the Path

If you want to start MATLAB by just typing matlab at the UNIX prompt, you must put the location of the MATLAB software on your path. If the MATLAB software is not on the path, you will need to type the full path each time to run MATLAB from the prompt.

To put the MATLAB software on the path, you can add a symbolic link to the matlab command in a folder that is already on your path. For example, on a standalone, single-user machine, you can use /usr/bin.

You can add the symbolic link at the UNIX prompt by entering

ln -s matlabroot/bin/matlab

where matlabroot is the full path to your top-level MATLAB installation folder (as returned by the matlabroot command.) You must execute this command in a folder that is currently on the path, for example, /usr/bin. (To add mex and mbuild to the path, you must repeat the same process.)

For information on adding symbolic links on multiuser computers, see the Installation Guide for UNIX.

Note    If you add symbolic links, you might need to rehash the UNIX path. Type rehash at the UNIX prompt.

Back to Top

Setting Up MATLAB Printing Options

Printers must be added to the Printer Setup Utility in the /Applications/Utilities folder for MATLAB to recognize them. The MATLAB print command uses lpr like other UNIX systems. MATLAB uses the Macintosh default printer as set in the Printer Setup Utility if you do not use -P<printer>. For example, to print the current figure to printer trinity, you can use

print -Ptrinity

To set up a printer, open the Printer Setup Utility in /Applications/Utilities. Click Add Printer. Refer to Macintosh Help (Command+?) for additional information.

Back to Top

Starting the License Manager

In installations where the license manager is needed, the installation process automatically configures the license manager to start when you start your system. If you accepted the defaults when you installed your MathWorks products, the installer configures the license manager to start automatically when you start your machine. If you chose not to configure the license manager during installation, the following sections describe how to configure the license manager to start at startup time or to start the license manager manually:

• Configuring the License Manager to Start Up Automatically

• Disabling Automatic Startup of the License Manager

• Starting the License Manager Manually

Note   The user name associated with the license manager process should be a user that is defined locally on the system, not defined on a network. The license manager will only start up properly if the user name can be found during the startup process on the computer, before network users are available.

Configuring the License Manager to Start Up Automatically

The following procedure explains how to configure the license manager to start automatically. You must be an administrator to install this startup folder.

1. Navigate to the top-level /Library folder.

2. Create a folder within /Library called StartupItems, if it does not already exist.

3. Copy the matlabroot/etc/MATLABLmgr folder into the StartupItems folder.

4. Run the Terminal application (located in /Applications/Utilities) and in the Terminal window enter the commands:

   cd /Library/StartupItems/MATLABLmgr
   ./config_lm.sh

5. The config_lm.sh script asks you to enter the folder where your MathWorks products are installed, that is, the MATLAB root folder (matlabroot). For example, if you installed MathWorks products in /Applications/MATLAB_R2009b, enter:

   /Applications/MATLAB_R2009b

6. The script then asks for your user name. The script uses the user name returned by the whoami command as the default. Accept the default or enter a different user name.

7. When the script finishes, restart your machine.

During startup, the message Starting MATLAB License Manager should appear on the screen. If you have difficulty starting the license manager, see Troubleshooting for more information.

Disabling Automatic Startup of the License Manager

If you do not want the license manager to start automatically at startup, you can disable it. To disable the MATLABLmgr script:

1. From the Finder, select Go To Folder from the Go menu.

2. In the Go to the folder field in the Go To Folder dialog box, enter

   /Library/StartupItems/MATLABLmgr

   and click Go. A window titled MATLABLmgr appears, containing several files.

3. Rename the file StartupParameters.plist to StartupParameters_disabled.plist.

You can re-enable the license manager to start at startup by following steps 1 to 3 above and renaming StartupParameters_disabled.plist back to StartupParameters.plist.

Starting the License Manager Manually

To start the license manager manually:

1. Start the Terminal application (/Applications/Utilities).

2. At the command prompt in the Terminal window, navigate to your MATLAB installation folder:

   cd /Applications/MATLAB_R2009b/etc

3. To start the license manager, execute the following command:

   ./lmstart

Note    Any time you make changes to the license.dat file, you must restart the license manager daemons by running lmstart. The lmstart script stops any currently running daemons and starts new ones.

Back to Top

Installing MathWorks Products in a Network Configuration

Deactivating and Removing a MATLAB Installation

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS