Install Guide PDF
Install Guide PDF
Installation Guide
R2014b
How to Contact MathWorks
Phone: 508-647-7000
v
Install Products With a File Installation Key . . . . . . . . . . . . 1-35
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-35
Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . 1-37
Step 2: Install With a File Installation Key . . . . . . . . . . . . . 1-38
Step 3: Review the License Agreement . . . . . . . . . . . . . . . . 1-39
Step 4: Specify the File Installation Key . . . . . . . . . . . . . . . 1-40
Step 5: Specify the Installation Folder . . . . . . . . . . . . . . . . 1-42
Step 6: Specify Products to Install . . . . . . . . . . . . . . . . . . . . 1-43
Step 7: Specify Installation Options . . . . . . . . . . . . . . . . . . 1-44
Step 8: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . 1-46
Step 9: Complete the Installation . . . . . . . . . . . . . . . . . . . . 1-47
vi Contents
Install on an Individual Computer . . . . . . . . . . . . . . . . . . . . . 2-3
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Step 2: Choose the Log In Option . . . . . . . . . . . . . . . . . . . . . 2-5
Step 3: Review the Software License Agreement . . . . . . . . . . 2-7
Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . . 2-7
Step 5: Choose Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Step 6: Select the License . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Step 7: Specify the Installation Folder . . . . . . . . . . . . . . . . 2-10
Step 8: Specify Products to Install . . . . . . . . . . . . . . . . . . . . 2-11
Step 9: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . 2-12
Step 10: Complete the Installation . . . . . . . . . . . . . . . . . . . 2-13
Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
vii
Install License Manager Using a File Installation Key . . . . . 3-9
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Step 2: Select Use a File Installation Key . . . . . . . . . . . . . . 3-13
Step 3: Review the Software License Agreement . . . . . . . . . 3-13
Step 4: Specify the File Installation Key . . . . . . . . . . . . . . . 3-14
Step 5: Specify the Installation Folder . . . . . . . . . . . . . . . . 3-15
Step 6: Select the License Manager for Installation . . . . . . . 3-16
Step 7: Specify the Location of the License File . . . . . . . . . . 3-17
Step 8: Configure the License Manager . . . . . . . . . . . . . . . . 3-18
Step 9: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . 3-20
Step 10: Complete the Installation . . . . . . . . . . . . . . . . . . . 3-21
viii Contents
Step 10: Specify Installation Options . . . . . . . . . . . . . . . . . . 3-57
Step 11: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . 3-59
Step 12: Complete the Installation . . . . . . . . . . . . . . . . . . . 3-61
Troubleshooting
4
Problems During Installation . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Installer Does Not Start Automatically . . . . . . . . . . . . . . . . . 4-2
Why is a Product Dependency Message Displayed? . . . . . . . . 4-2
How Do I Specify Proxy Server Settings? . . . . . . . . . . . . . . . 4-2
How Can I Activate Without a MathWorks Account? . . . . . . . 4-3
ix
x
1
This chapter describes how to install MathWorks products on your computer and
activate your installation.
To find detailed, step-by-step instructions for common scenarios, see the following topics:
Use these procedures if you have an Individual license or Group license. For information
about setting up the network license options, see Installing Network License Options.
1-2
MATLAB Student-Use Software
For more information about what the student-use software contains and what you can do
with it, see MATLAB for Student Use.
To use the license for MATLAB student-use software, you must be a student enrolled
at a degree-granting higher education institution, or be a student or teacher at a high
school or pre-university school. You may not use a license for student-use software at
a company or government laboratory. Also, you may not use it if you are an instructor
at a university, or for research, commercial, or industrial purposes. In these cases, you
can acquire the appropriate license by contacting MathWorks at www.mathworks.com/
academia/student_version.
1-3
1 Installation and Activation Procedures
In this section...
Before You Install on page 1-4
Step 1: Start the Installer on page 1-6
Step 2: Install Using a MathWorks Account on page 1-7
Step 3: Review the Software License Agreement on page 1-9
Step 4: Log In to Your MathWorks Account on page 1-9
Step 5: Select the License You Want to Install on page 1-12
Step 6: Specify the Installation Folder on page 1-14
Step 7: Specify Products to Install on page 1-15
Step 8: Specify Installation Options on page 1-16
Step 9: Confirm Your Choices on page 1-18
Step 10: Complete the Installation on page 1-20
Your email address and your MathWorks Account password. You will need
them to log in to your account during installation. If you have multiple licenses
associated with your account, determine which license you want to install.
If you do not have a MathWorks Account, you can create one during installation. You
must have an Activation Key to create an account. An Activation Key is the unique
code that identifies a license. Ask the administrator of the license for the Activation
Key.
1-4
Install Products Using a MathWorks Account
Note: While you use an administrator account or root privileges to install the
software, you typically do not want to activate the software for an administrative
user account. Specify the non-privileged account that will use the software when
you activate it. Running MATLAB as a user with administrator privileges or root
privileges is not recommended.
Windows Get the name and password for an account on your computer that
has administrator privileges.
Linux Get the root password. You can install MATLAB software without
superuser privileges, however, it limits certain installation options. For example, if
you want to set up symbolic links to the matlab command, install product files in
a protected folder, or edit the system boot script, you must have superuser status.
Mac OS X Get the name and password of an administrator account on your
computer. The administrator account is the user account you set up when you
configured your Mac OS X system; this is not your MathWorks Account. During
installation, you must enter this name and password in the Authenticate dialog
box.
If you do not have an Internet connection during installation, see Install Products With
a File Installation Key on page 1-35.
1-5
1 Installation and Activation Procedures
Note: MATLAB student-use software does not include DVDs. Download the installer
from the MathWorks website, instead.
1 Download the installer from the MathWorks website or locate your MATLAB DVD.
When you select an installer on the website, you receive the files that the installer
needs to run on your selected platform, not the product files. Run the installer to
select products that you want to install on the computer where you are logged in.
The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on your
platform and whether you download the installer from the MathWorks website or
use a DVD.
Windows
Downloaded installer file If you click Run when you select the installer
on the MathWorks website, the installer starts automatically. If you saved
the installer instead, double-click the self-extracting installer file in the
folder where you saved it. The name of the self-extracting installer file is
matlab_release_$ARCH, where release is the release you are installing
(for example R2014b) and $ARCH is the selected architecture.
To restart the installer at a later time, click setup.exe. This file is located in
the top level of the folder where you extracted the files.
DVD installation Insert the DVD into the DVD drive connected to your
system. The installer usually starts automatically.
Mac OS X
Downloaded installer file Double-click the archive file to extract the files
that you downloaded from the MathWorks website. After extracting the files,
open the installer folder and double-click InstallForMacOSX.app .
DVD installation Insert the DVD into the DVD drive connected to your
system. When the DVD icon appears on the desktop, double-click the icon to
1-6
Install Products Using a MathWorks Account
display the DVD contents, and then double-click the InstallForMacOSX icon
to begin the installation.
Linux
Downloaded installer file Use the unzip command to extract the files
from the archive file that you downloaded from the MathWorks website. After
extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
1-7
1 Installation and Activation Procedures
If your Internet connection requires a proxy server, click Connection Settings. Enter
the server name, port, and password in the Connection Settings page. MathWorks
supports Basic authentication and Digest authentication proxy configurations.
1-8
Install Products Using a MathWorks Account
Note: On Windows systems, the installer uses your system proxy settings, by default.
If your proxy server requires you to log in, the installer prompts you for your login
information.
If you do not have a MathWorks Account, select the Create a MathWorks Account
(requires an Activation Key) option and click Next. You are prompted to enter the
data needed to create the account.
1-9
1 Installation and Activation Procedures
To create an account, enter your email address, first name, last name, and password. You
must also provide an Activation Key because a newly created account does not have any
licenses associated with it.
The Activation Key identifies the license you want to install. The administrator of this
license can retrieve the key by visiting the License Center at the MathWorks website.
If you purchased MATLAB student-use software, your product package includes the
Activation Key.
1-10
Install Products Using a MathWorks Account
Note: When you create a new MathWorks Account, you must verify your email address
before you can proceed with installation. Before you click Next in the Email Verification
Required dialog box, go to your email program, open the message sent to you by
MathWorks, and click the verification link. Then return to this dialog box and click Next.
1-11
1 Installation and Activation Procedures
If you want to install products on a license that is not associated with your MathWorks
Account:
1 Select the Enter an Activation Key for a license not listed option.
2 Enter an Activation Key and click Next.
An Activation Key is the unique code that identifies a license. Use it to activate a
license or allow licensed end users to associate their MathWorks Account with a
license. The administrator contact on the license can retrieve the key by visiting the
License Center on the MathWorks website. If you purchased MATLAB student-use
software, your product package includes the Activation Key. Or, you can visit the
License Center at the MathWorks website to retrieve the key.
1-12
Install Products Using a MathWorks Account
If you are installing MATLAB student-use software, your product package includes the
Activation Key or you can visit the License Center at the MathWorks website to retrieve
the key.
1-13
1 Installation and Activation Procedures
When specifying a folder name, you can use any alphanumeric character and some
special characters, such as underscores. If you make a mistake while entering a folder
name and want to start over, click Restore Default Folder. After making your
selection, click Next.
1-14
Install Products Using a MathWorks Account
Note: If the products you select exist in the default download location on your computer
or on a DVD, the installer uses the local files for installation instead of downloading
them from MathWorks. If you want to download the products again, go back to the Folder
Selection dialog box and select a different installation folder.
1-15
1 Installation and Activation Procedures
After selecting the products you want to install, click Next to continue with the
installation.
Windows
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts
for starting MATLAB in the Start menu and on the desktop.
After selecting installation options, click Next to proceed with the installation.
1-16
Install Products Using a MathWorks Account
Linux
On Linux systems, you can specify whether you want to create symbolic links to the
matlab and mex scripts. Specify a folder to which you have write access and that is
common to all your user's paths, such as /usr/local/bin .
After selecting installation options, click Next to proceed with the installation.
1-17
1 Installation and Activation Procedures
1-18
Install Products Using a MathWorks Account
Depending upon which products you install, the installer might display a dialog box
containing several types of information:
1-19
1 Installation and Activation Procedures
If you choose to exit the installer without activating the software, clear the Activate
MATLAB option and click Finish (the button label changes). Use the activation
application to activate the software at a later time. If you have not activated the
software, the activation application starts automatically when you start MATLAB.
1-20
Install Products Using a MathWorks Account
Related Topics
1-21
1 Installation and Activation Procedures
If you are upgrading your MATLAB installation to the latest release, install the new
version in a new installation folder. If you are upgrading an installation of a prerelease
version of the software, install the released software in a new installation folder.
You do not need to delete an existing MATLAB installation before installing a new
release. Each release is independent of previous releases and you can run multiple
releases on the same system.
Note If you overwrite an existing installation from a prior release, the installer deletes
all the products in your installation folder and installs only those products included in
your current license. This avoids potential product incompatibilities. For example, if your
existing installation includes 10 products, but your current license only includes 9 of
those products, your MATLAB installation only includes the 9 products in your current
license.
1-22
Activate an Installation Using a MathWorks Account
In this section...
Step 1: Start the Activation Application on page 1-23
Step 2: Choose Whether to Activate Automatically or Manually on page 1-24
Step 3: Log In to Your MathWorks Account on page 1-26
Step 4: Select the License on page 1-29
Step 5: Select an Activation Type on page 1-30
Step 6: Specify the User Name on page 1-31
Step 7: Confirm Your Activation Information on page 1-32
Step 8: Complete the Activation on page 1-33
Leave the Activate MATLAB check box selected on the Installation Complete dialog
box at the end of installation.
Start an installation of MATLAB that has not been activated.
If you have MATLAB running, on the Home tab, in the Resources section, select
Help > Licensing > Activate Software.
Navigate to your MATLAB installation folder and open the activation application.
1-23
1 Installation and Activation Procedures
If you let the installer start the activation application, and you were logged in to your
MathWorks Account during installation, your login session continues into the activation
process. Click Next to proceed with activation.
If you were not logged in to your MathWorks Account during installation, or you
started the activation application independently, you must choose whether to activate
automatically or manually. If you are connected to the Internet, leave the Activate
automatically using the Internet (recommended) option selected. Activating
immediately after installation is the quickest way to start using MATLAB.
If you are not connected to the Internet, select Activate manually without the
Internet. If you select this option, you need a License File to activate manually. Your
License File identifies the products you can run. Contact the Administrator of the license
to get the file if you do not already have it.
1-24
Activate an Installation Using a MathWorks Account
Note: On Windows systems, the activation application uses your system proxy settings
by default.
If your Internet connection requires a proxy server, click the Connection Settings
button. You can enter the server name and port information in the Proxy Settings dialog
box, and access other activation options. MathWorks supports several types of proxy
configurations: Basic authentication and Digest authentication.
1-25
1 Installation and Activation Procedures
Note: If you continued with activation immediately after installation, and you logged in
to your account during installation, the activation application skips this step.
Enter the email address and password of your MathWorks Account and click Next. The
activation application contacts MathWorks to retrieve the licenses associated with your
account.
If you do not have a MathWorks Account, select the I need to create an Account
(requires an Activation Key) option and click Next.
If you already have a License File, select the Enter the full path to your license
file, including the file name option, specify the complete path to the file, and click
Next. Your License File identifies the products you can run. Contact the administrator of
your license to obtain this License File. After specifying the License File, the activation
application skips all the subsequent steps in the process and goes directly to the
Activation Complete dialog box.
1-26
Activate an Installation Using a MathWorks Account
To create an account, enter your email address, first name, last name, and password. You
must also provide an Activation Key. A newly created account does not have any licenses
associated with it. The Activation Key identifies the license you want to activate.
The administrator contact on the license can retrieve the key by visiting the License
Center at the MathWorks website. If you are activating MATLAB student-use software,
your product package includes the Activation Key or visit the License Center on the
MathWorks website to retrieve the key
1-27
1 Installation and Activation Procedures
Note: When you create a new MathWorks Account, you must verify your email address
before you can proceed with activation. Before you click Next in the Email Verification
Required dialog box, go to your email program, open the message from MathWorks, and
click the verification link. Then return to this dialog box and click Next.
1-28
Activate an Installation Using a MathWorks Account
Note: If you continued with activation immediately after installation, the activation
application assumes you want to activate the license you just installed and skips this
step. Likewise, if you created a new account in the previous step and specified an
Activation Key, the activation application skips this step.
Select a license from the list of licenses associated with your MathWorks Account and
click Next. The list contains the following information about the licenses:
If you want to activate products on a license that is not associated with your MathWorks
Account, select the Enter an Activation Key for a license not listed option, enter
an Activation Key, and click Next. An Activation Key is the unique code that identifies a
license. You can use the key to activate a license or associate a license with your account.
Ask the administrator of the license for the Activation Key.
1-29
1 Installation and Activation Procedures
If you are activating MATLAB student-use software, your product package includes the
Activation Key or you can visit the License Center at the MathWorks website to retrieve
the key.
Note: If the license you installed (or selected in the previous step) has the activation type
preset or is a license for student-use software, the activation application skips this step.
Select an activation type for your license. If you want to ensure that you are the only
person who can use the software, select the Standalone Named User option. If you
want to share the installation for nonsimultaneous use by multiple people, choose the
Designated Computer option.
1-30
Activate an Installation Using a MathWorks Account
Note: The activation application skips this step if you picked the Designated Computer
activation type for the license
If you selected the Standalone Named User activation type, you must specify the
operating system user name of the person who will use the software. The Standalone
Named User activation type limits use of the software to a particular user on a particular
computer. MathWorks uses the operating system user name to identify this person. The
operating system user name is the ID through which a user gains access to a computer.
This ID is also known as the computer login name. To use MathWorks software, you
must be logged into the computer as the user name that you specify.
By default, the activation application fills in the user name of the person running the
activation application. To accept this default, leave the I will use the software option
1-31
1 Installation and Activation Procedures
selected and click Next. If you used your administrator account to install the software
but will use another account to access the software, you can specify that user name here.
If you want to activate the license for someone else, select the Someone else will use
the software option, specify their email address, name, and operating system user
name, and click Next. The activation application looks for their MathWorks Account
or creates an account for them. This option can be useful for system administrators
activating the software for other users.
Note: The option to activate a license for someone else is not available for student-use
software.
1-32
Activate an Installation Using a MathWorks Account
1-33
1 Installation and Activation Procedures
1-34
Install Products With a File Installation Key
Ensure that the product files, including the MATLAB installer, are available in an
accessible location, for example, in the default Downloads folder on your computer, a
network share, or on a DVD. If the product files are located in a folder other than the
default Downloads folder on your computer, the installer file must be located in the
same folder as the product files.
MATLAB student-use software does not include DVDs. You must connect to
MathWorks to download and install products.
Have your File Installation Key and License File handy. You need both these items to
perform an off-network installation and activation.
The File Installation Key identifies the products you can install. The License File
activates the installation, identifying which products you can run. The administrator
of the license can retrieve the File Installation Key and License File by visiting the
License Center at the MathWorks website.
Make sure you have the correct permissions to perform the installation. If you have
questions about this, ask your system administrator.
1-35
1 Installation and Activation Procedures
Note: While you use an administrator account or root privileges to install the
software, you typically do not want to activate the software for an administrative
user account. Specify the non-privileged account that will use the software when
you activate it. Running MATLAB as a user with administrator privileges or root
privileges is not recommended.
Windows Systems Get the name and password of the administrator account
on your computer. The installer modifies the system registry during installation.
Linux Systems Get the root password. You can install MATLAB software
without superuser privileges, however, it limits certain installation options. For
example, if you want to setup symbolic links to the matlab command, install
product files in a protected folder, or edit the system boot script, you must have
superuser status.
Mac OS X Systems Get the name and password of an administrator account
on your computer. The administrator account is the user account you set up when
you configured your Mac OS X system; this is not your MathWorks Account.
During installation, you must enter this name and password in the Authenticate
dialog box, shown below.
1-36
Install Products With a File Installation Key
If you have an Internet connection, follow the instructions in Install Products Using a
MathWorks Account on page 1-4. MathWorks recommends installing and activating
using an Internet connection.
You can use this procedure to install one of the standalone or network license options. If
you use this with a network license option, you must specify the License File path and
choose whether to configure the license manager. See for more information about these
additional steps.
Note: Verify that the folder containing the product files includes the installer file for
your platform in the root of the folder (setup.exe for Windows, install for Linux,
and InstallForMacOSX for Mac OS X) and an archives subfolder. If the archives
subfolder contains less than 3 files, you might be missing required files. Ask your
administrator to download the files again using the procedure in Download Products
Without Installation on page 2-15.
1 Copy the products files (including the installer file) to your computer or an accessible
location (for example, a DVD, USB drive, or network share).
2 Start the installer. The method you use to start the installer depends on your
platform and whether you are accessing previously downloaded product files or are
using a DVD,.
Windows
DVD installation Insert the DVD into the DVD drive connected to your
system. When the DVD icon appears on the desktop, double-click the icon to
display the DVD contents, and then double-click the InstallForMacOSX icon
to begin the installation.
1-37
1 Installation and Activation Procedures
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
1-38
Install Products With a File Installation Key
1-39
1 Installation and Activation Procedures
If you have the key, select the I have the File Installation Key for my license option,
enter the File Installation Key, and click Next. The administrator contact on a license
can retrieve the File Installation Key from the License Center at the MathWorks website.
If you do not have the key, select the I do not have the File Installation Key option
and click Next. The installer provides you with the information you need to get a key.
1-40
Install Products With a File Installation Key
The Installation and Activation Next Steps dialog box contains the information you need
to retrieve your File Installation Key from the License Center at the MathWorks website.
This information includes:
Host ID
Release number (for example, R2014b)
Operating system user name (Note that user names are case-sensitive in activation.)
1-41
1 Installation and Activation Procedures
1 Copy the information displayed in this dialog box and click Finish to exit the
installer. On Windows and Linux systems, you can click Print to print out the
information.
2 Go to a computer with an Internet connection and log in to your account at the
MathWorks website.
3 Visit the License Center and enter the information from this dialog box. MathWorks
uses this information to generate a License File and a File Installation Key for your
license.
4 Return to your computer and run the installer again. With the File Installation Key
and a License File, you can install and activate the software without an Internet
connection.
1-42
Install Products With a File Installation Key
When specifying a folder name, you can use any alphanumeric character and some
special characters, such as underscores. If you make a mistake while entering a folder
name and want to start over, click Restore Default Folder. After making your
selection, click Next.
After selecting the products you want to install, click Next to continue with the
installation.
1-43
1 Installation and Activation Procedures
Note: If the product files are not located on your computer or the installer is not located
in the same folder as the product files, the installer will be unable to find products to
install.
Windows Systems
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts
for starting MATLAB in the Start menu and on the desktop.
After selecting installation options, click Next to proceed with the installation.
1-44
Install Products With a File Installation Key
Linux Systems
On Linux systems, you can specify whether you want to create symbolic links to the
matlab and mex scripts. Specify a folder to which you have write access and that is
common to all your user's paths, such as /usr/local/bin .
After selecting installation options, click Next to proceed with the installation.
1-45
1 Installation and Activation Procedures
1-46
Install Products With a File Installation Key
If you choose to exit the installer without performing activation, clear the Activate
MATLAB option and click Finish (the button label changes). You can activate later
using the activation application.
1-47
1 Installation and Activation Procedures
1-48
Activate an Installation Without the Internet
In this section...
Step 1: Start the Activation on page 1-49
Step 2: Specify the Path to the License File on page 1-50
Step 3: Complete the Activation on page 1-51
1-49
1 Installation and Activation Procedures
If you do not have your License File, select the I do not have a license file option and
click Next to get information about how to retrieve a License File.
Save the information displayed in this dialog box. You can print a copy of this
information by clicking Print. Take the information to a computer with an Internet
connection and visit the License Center at the MathWorks website. MathWorks uses this
information to generate a File Installation Key and a License File. You must have this
1-50
Activate an Installation Without the Internet
information with you when you return to the computer on which you want to install and
activate the software. To exit the activation application, click Finish.
Note: Your installation is not activated yet. You cannot run MATLAB until you retrieve
your License File.
1-51
1 Installation and Activation Procedures
1-52
Installation Management Tasks
Windows Systems:
On systems running Windows 7, click the Windows Start menu, and then select
MATLAB R2014b .
On systems running Windows XP, click the Windows Start menu, and then select
Programs > MATLAB > R2014b, and click MATLAB R2014b.
If you chose to create a shortcut on your desktop during the installation, you can
double-click the MATLAB icon on the desktop.
Enter the matlab command at the system prompt. If you did not set up symbolic
links on the Installation Options dialog box during installation, you must enter
1-53
1 Installation and Activation Procedures
You can disable validation at the License Center at the MathWorks website. See the
License Center Help for step-by-step instructions.
1-54
Installation Management Tasks
Task Description
Get an overview of MATLAB and its Read the MATLAB Getting Started
capabilities documentation.
Find out what's new in this release Read the Release Notes documentation.
Start a product or access product Select the Apps tab, browse the apps gallery, and
demonstration programs find the app you want to start.
Get information about specific On the Home tab, in the Resources section, click
MATLAB features Help > Documentation to view reference and
tutorial information in hyperlinked HTML format.
Get help with specific questions Go to the MathWorks website
you cannot find answered in the (www.mathworks.com), click Support, and search
documentation for answers.
1-55
1 Installation and Activation Procedures
Note: Deactivating a license and removing the software are separate activities. You can
deactivate a license without removing the software from your computer. For information
about deactivating software, see Deactivate an Installation on page 1-60.
On systems running Windows 8, from the Start screen, search for Control Panel.
In the Control Panel, select Uninstall a Program in the Programs category.
From the list of products displayed, click MATLAB R2014b.
On systems running Windows 7, click the Start menu, and select Control
Panel. In the Control Panel, select Uninstall a Program in the Programs
category. From the list of products displayed, click MATLAB R2014b.
On systems running Windows XP, click the Start menu, select Settings >
Control Panel > Add or Remove Programs. Select MATLAB R2014b from
the list of products and click Change/Remove.
Navigate to the matlabroot/uninstall/bin/$ARCH folder, where
matlabroot is your MATLAB installation folder and $ARCH is a platform-
specific subfolder, such as win64. Double-click the uninstaller executable,
uninstall.exe.
If you select MATLAB, you automatically remove all other MathWorks products.
1-56
Uninstall MathWorks Products
You might receive a message telling you that the product you want to uninstall has
other products that depend on it. For example, most MathWorks products require
the MATLAB product. To dismiss the message and continue removing products, click
OK. To change the products you had selected for deletion, click Cancel.
If you also want to remove your MATLAB user preferences, click the Uninstall
MATLAB preference files (including Command History) check box. By default,
the uninstaller does not delete these preference files. MATLAB preference files
contain your environment settings, such as command history and Help favorites.
To find where MATLAB stores your preferences, use the prefdir command at the
MATLAB prompt, as in the following example:
prefdir
ans =
C:\WINNT\Profiles\username\Application Data\MathWorks\MATLAB\R2014b
1-57
1 Installation and Activation Procedures
Note: If you want to deactivate a license and remove the software, be sure to deactivate
before you remove the software. When you remove the software, you also remove the
application you use to deactivate the software. For more information about deactivating,
see Deactivate an Installation on page 1-60.
1-58
Uninstall MathWorks Products
Note: When you remove a MATLAB installation, you remove the deactivation
application, so it is best to deactivate before removing your installation. For more
information about deactivating software, see Deactivate an Installation on page
1-60.
1 Get the user name and password of an administrator account on the Mac OS X
system. Depending on where you installed MATLAB software, you might need
administrator privileges to remove it.
2 Exit MATLAB before removing a MATLAB installation. You can use the lmdown
command to stop the license manager.
3 Navigate to your MATLAB installation folder. For example, the installation folder
might be named MATLAB_R2014b.app in your Applications folder.
4 Drag your MATLAB installation folder to the trash, and then select Empty Trash
from the Finder menu.
1-59
1 Installation and Activation Procedures
Deactivate an Installation
Deactivating an installation renders the MathWorks software unusable on a particular
computer. Deactivation can be a useful way to manage usage of the software on multiple
computers. For example, if you want to install and activate the software on a new
computer, and you've already performed all the activations allowed by your license,
you can deactivate one of your existing installations to enable activation on your new
computer.
The deactivation process has two parts: the license must be deactivated on your computer
and must also be deactivated in MathWorks systems. If you have Internet connectivity,
the MathWorks deactivation application can take care of both parts of the process. If you
do not have Internet connectivity, the deactivation application disables the software on
your computer and gives you a deactivation string. To complete the deactivation process,
you must visit the MathWorks website, log in to your account, and deactivate using the
deactivation string. When you deactivate a license, you deactivate all the installations of
that license on a particular computer.
Note: Deactivating a license and removing the software are separate activities. You can
deactivate a license without removing the software from your computer. For information
about removing an installation, see Uninstall MathWorks Products on page 1-56.
Window Systems:
matlabroot\uninstall\bin\win64\deactivate_matlab.exe
Linux Systems:
1-60
Deactivate an Installation
matlabroot/bin/deactivate_matlab.sh
Mac OS X Systems:
/Applications/MATLAB_R2014b.app/bin/deactivate_matlab.sh
On systems running Windows 7, click the Start menu and select MATLAB. The
deactivation application should appear on the list.
On systems running Windows XP, you can also click the Start menu and choose
Programs > MATLAB > R2014b > Deactivate MATLAB R2014b
2 Select the license that you want to deactivate and click Deactivate.
When the deactivation application starts, it displays the licenses you currently have
installed and activated on your system. If you start the application from within
MATLAB, the license you are using is preselected.
If your Internet connection requires a proxy server, click the Connection Settings
button and enter the server name and port information. Click OK to return to the
MathWorks Software Deactivation dialog box.
1-61
1 Installation and Activation Procedures
3 Confirm deactivation. Click Yes and the deactivation application attempts to contact
MathWorks.
If the deactivation application can deactivate the license on your computer and in
MathWorks systems, it displays the Deactivation Complete dialog box. Click OK to
return to the MathWorks Software Deactivation dialog box, where you can choose to
deactivate other licenses.
1-62
Deactivate an Installation
If the deactivation application can deactivate the license on your computer but not in
MathWorks systems, it displays the Deactivation Next Steps dialog box. This dialog
box contains the deactivation string. To complete deactivation, you must go to the
MathWorks website, log in to your account, and deactivate with the deactivation
string. See the License Center help for more information. Click OK to return to the
MathWorks Software Deactivation dialog box.
1-63
1 Installation and Activation Procedures
Deactivation string.
Click OK.
5 After you deactivate a license, the MathWorks Software Deactivation dialog box
displays an additional column listing the status of the licenses. To deactivate
another license, select it from the list and click Deactivate. If you are finished, click
Close to exit the deactivation application.
1-64
Deactivate an Installation
1-65
1 Installation and Activation Procedures
System Requirements
For the most up-to-date information about system requirements, go to the MathWorks
website (www.mathworks.com).
1-66
2
Download and install MATLAB software for the computer where you are logged in.
Download MATLAB products to a specified location and install the products at a later
time. You can:
Activation for both installation methods is the same as activation for licensed-end user
installations. For more information about activation, see .
2-2
Install on an Individual Computer
Consider disabling anti-virus software and Internet security applications on your system
during installation. These applications can slow the installation process or cause it to
appear unresponsive (or to hang).
If you do not have an Internet connection, download the product files as described in
Download Products Without Installation on page 2-15 and copy the files to an
accessible location or locate your MATLAB DVD. Then, install the products using a File
Installation Key. For instructions, see Install Products With a File Installation Key on
page 1-35.
2-3
2 Installation for Administrators
When you select an installer on the website, you receive the files that the installer
needs to run on your selected platform, not the product files. Run the installer to
select products that you want to install on the computer where you are logged in.
The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on your
platform and whether you download the installer from the MathWorks website or
use a DVD.
Windows
Downloaded installer file If you click Run when you select the installer
on the MathWorks website, the installer starts automatically. If you saved
the installer instead, double-click the self-extracting installer file in the
folder where you saved it. The name of the self-extracting installer file is
matlab_release_$ARCH, where release is the release you are installing
(for example R2014b) and $ARCH is the selected architecture.
To restart the installer at a later time, click setup.exe. This file is located in
the top level of the folder where you extracted the files.
DVD installation Insert the DVD into the DVD drive connected to your
system. The installer usually starts automatically.
Mac OS X
Downloaded installer file Double-click the archive file to extract the files
that you downloaded from the MathWorks website. After extracting the files,
open the installer folder and double-click InstallForMacOSX.app .
DVD installation Insert the DVD into the DVD drive connected to your
system. When the DVD icon appears on the desktop, double-click the icon to
display the DVD contents, and then double-click the InstallForMacOSX icon
to begin the installation.
Linux
2-4
Install on an Individual Computer
Downloaded installer file Use the unzip command to extract the files
from the archive file that you downloaded from the MathWorks website. After
extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
2-5
2 Installation for Administrators
If your Internet connection requires a proxy server, click Connection Settings. Enter
the server name, port, and password in the Connection Settings page. MathWorks
supports Basic authentication and Digest authentication proxy configurations.
2-6
Install on an Individual Computer
Note: On Windows systems, the installer uses your system proxy settings, by default.
If your proxy server requires you to log in, the installer prompts you for your login
information.
If you do not have a MathWorks Account, select the Create a MathWorks Account
(requires an Activation Key) option and click Next. You are prompted to enter the
data needed to create the account.
2-7
2 Installation for Administrators
This option downloads the software from MathWorks, if necessary, and installs the
software on the computer where you are logged in.
2-8
Install on an Individual Computer
If you want to install products on a license that is not associated with your MathWorks
Account:
1 Select the Enter an Activation Key for a license not listed option.
2 Enter an Activation Key and click Next.
An Activation Key is the unique code that identifies a license. Use it to activate a
license or allow licensed end users to associate their MathWorks Account with a
2-9
2 Installation for Administrators
license. The administrator contact on the license can retrieve the key by visiting the
License Center on the MathWorks website. If you purchased MATLAB student-use
software, your product package includes the Activation Key. Or, you can visit the
License Center at the MathWorks website to retrieve the key.
When specifying a folder name, you can use any alphanumeric character and some
special characters, such as underscores. If you make a mistake while entering a folder
2-10
Install on an Individual Computer
name and want to start over, click Restore Default Folder. After making your
selection, click Next.
Note: If the products you select exist in your computers default download location or on
a DVD, the installer uses the local files for installation instead of downloading them from
the MathWorks website.
2-11
2 Installation for Administrators
The installer checks if any of the products you selected depend on other products. If there
are product dependencies that are not satisfied, the installer issues a warning. Consider
adjusting your product selection.
After selecting the products to install, click Next to continue with the installation.
2-12
Install on an Individual Computer
If you choose to exit the installer without activating the software, clear the Activate
MATLAB option and click Finish (the button label changes). Use the activation
application to activate the software at a later time. If you have not activated the
software, the activation application starts automatically when you start MATLAB.
2-13
2 Installation for Administrators
Activation
Activation for this procedure is the same as activation for Licensed end users. For more
information, see .
2-14
Download Products Without Installation
This procedure describes how to download products without installing them immediately.
This procedure is useful when you want to download products and install them at a later
time on one or more computers.
Consider disabling anti-virus software and Internet security applications on your system
during installation. These applications can slow the installation process or cause it to
appear unresponsive (or to hang)
When you select an installer from the website, you receive the files that the installer
needs to run on your selected platform, not the product files. Run the installer
2-15
2 Installation for Administrators
to select products for Windows, Linux, and Mac OS X platforms. The installer
downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on your
platform.
Windows If you click Run when you select the installer on the MathWorks
website, the installer starts automatically. If you saved the installer instead,
double-click the self-extracting installer file in the folder where you saved it. The
installer should start automatically after file extraction is complete.
To restart the installer at a later time, click setup.exe. This file is located in the
top level of the folder where you extracted the files.
Mac OS X Double-click the archive file to extract the files that you
downloaded from the MathWorks website. After extracting the files, open the
installer folder and double-click InstallForMacOSX.app .
Linux Use the unzip command to extract the files from the archive file that
you downloaded from the MathWorks website and execute this command:
./install
Note: You can start the installer from a DVD, however, the installer downloads the
product files from the MathWorks website instead of using the products on the DVD.
2-16
Download Products Without Installation
If your Internet connection requires a proxy server, click the Connection Settings
button. Enter the server name, port, and password in the Connection Settings dialog
box. MathWorks supports Basic authentication and Digest authentication proxy
configurations.
2-17
2 Installation for Administrators
Note: On Windows systems, the installer uses your system proxy settings, by default.
If your proxy server requires you to log in, the installer prompts you for your login
information.
If you do not have a MathWorks Account, select the Create a MathWorks Account
(requires an Activation Key) option and click Next. You are prompted to enter the
data needed to create the account.
2-18
Download Products Without Installation
This option downloads your products from the MathWorks website for installation at a
later time.
2-19
2 Installation for Administrators
You can accept the default download folder or click Browse to select a different one.
If the folder does not exist, the installer creates it.
2 Select one or more platforms.
After the download completes, the root folder or directory in the download location
includes the installer for each selected platform.
2-20
Download Products Without Installation
If a product already exists in the specified download location, it is not selectable. The
installer does not download these products again. If you want to download the products
again, go back to the Folder Selection dialog box and select a different download location.
2-21
2 Installation for Administrators
2-22
Download Products Without Installation
2-23
2 Installation for Administrators
Use an Internet connection to access your license information and install the
software. See Install Products Using a MathWorks Account on page 1-4
Use a File Installation Key (FIK) for off-network installations. See Install Products
With a File Installation Key on page 1-35
2-24
3
This topic describes how to activate and install MathWorks products on computers in
a network configuration for licenses such as Concurrent or Network Named User. The
computers can be running the Microsoft Windows operating system (32-bit or 64-bit), the
Linux operating system (64-bit), or the Mac OS X operating system.
The following figure presents a sample License File. Each INCREMENT line identifies
a product, the number of keys available for the product, and other information. (The
INCREMENT lines in your License File might not include every element shown in the
example.) The backslash (\) character indicates that the line continues onto the next line.
The lines that begin with a pound sign (#) are comments. The MathWorks Installer uses
the information in these comment lines (license server host ID or Internet address) when
it processes the License File during installation.
# BEGIN-------cut here-------CUT HERE-------BEGIN
# MATLAB license passcode file.
# LicenseNo: 12345 HostID: INTERNET=144.212.101.43
INCREMENT TMW_Archive MLM 18 01-sep-2010 0 \
BC9DE773A77D15AF8 VENDOR_STRING=83 HOSTID=DEMO SN=12345
INCREMENT MATLAB MLM 18 01-sep-2010 1 \
4C9D3348561BE9E3B USER_BASED DUP_GROUP=U SN=12345
INCREMENT SIMULINK MLM 18 01-sep-2010 1 \
1CD148466EF58DF8B USER_BASED DUP_GROUP=U SN=12345
INCREMENT Signal_Toolbox MLM 18 01-sep-2010 1 \
6CF74B458BA143DC3 USER_BASED DUP_GROUP=U SN=12345
# END---------cut here-------CUT HERE-------END
1 License File specified on MATLAB startup command line using the -c option. You
can specify a list of paths to search. When you use the -c option, you explicitly
3-2
Understanding License Files
prohibit the searching of the environment variables. When using the -c option, keep
in mind the following:
If the path to your License File contains a space, enclose the path name in
quotation marks.
If you are specifying more than one License File, make sure to enclose the entire
list of License Files in quotation marks.
2 If no License File is specified at the MATLAB command line, MATLAB searches
two environment variables, described in the following table. MATLAB searches the
vendor specific environment variable, MLM_LICENSE_FILE first.
3-3
3 Installing Network License Options
1 Determine how you want to configure the products for users There are
several possible configurations. You must decide whether users will install MATLAB
on their computers or access MATLAB over a network.
2 Install the software on the computers required by the configuration You
must install the license manager on a server and, depending on your configuration,
either install MathWorks products on a server or install the products on client
systems. You can use the MathWorks installer to perform all of these installations.
See .
Note: You must activate the license for the installation before you run the installer. To
retrieve the License File needed for your configuration, visit the License Center at the
MathWorks website. You must provide the Host ID of the system on which you intend to
run the license manager when requesting a License File. You specify the location of your
License File during installation.
Before you install MATLAB in a network installation, you must decide what type of
configuration you want to set up. This decision determines how many installations you
need to perform. This section describes these options.
3-4
Plan Your Network Installation
In a remote client access configuration, you install MATLAB and the license manager on
a central file server. (These instructions refer to this system as your license server.) Users
on client systems access MATLAB over the network. This figure shows one possible
configuration. The license manager and MATLAB can be installed on the same server or
on separate servers.
Server
MATLAB
FLEXnet
If your license server runs the Windows operating system, follow the instructions in the
installation guide. Your configuration can include a mixture of systems. For example, a
Linux license server can serve clients running Windows.
In remote client access configurations, it can be helpful to give clients a script that sets
up a shortcut to the network copy of MATLAB and specifies a default startup folder for
MATLAB.
In a local client access configuration, you install the license manager on a server and you
install MATLAB on each client system. When users on client systems start MATLAB,
it contacts the license manager over the network to check out a license key. This figure
shows one possible configuration.
3-5
3 Installing Network License Options
Server
FLEXnet
You use the same basic network installation procedure to install MathWorks products on
a client system.
3-6
Plan Your Network Installation
the installer dialog boxes. For more information, see Install Noninteractively (Silent
Installation) on page 3-69.
3-7
3 Installing Network License Options
Use the following suggestions to help you choose an appropriate installation procedure.
3-8
Install License Manager Using a File Installation Key
Note: Starting with R2013b, network License Files have a new format. As a result,
R2013b and later releases require an update to the latest version of the license manager
that ships with R2013b or later. You can continue to use older License Files and previous
versions of the MATLAB software if you decide not to upgrade to R2013b or a later
release.
In this section...
Before You Install on page 3-9
Step 1: Start the Installer on page 3-11
Step 2: Select Use a File Installation Key on page 3-13
Step 3: Review the Software License Agreement on page 3-13
Step 4: Specify the File Installation Key on page 3-14
Step 5: Specify the Installation Folder on page 3-15
Step 6: Select the License Manager for Installation on page 3-16
Step 7: Specify the Location of the License File on page 3-17
Step 8: Configure the License Manager on page 3-18
Step 9: Confirm Your Choices on page 3-20
Step 10: Complete the Installation on page 3-21
3-9
3 Installing Network License Options
4 Specify the operating system type and Host ID of the computer on which you
intend to run the license manager. You can optionally assign a descriptive label to
the activation as well. Click Continue.
5 Choose whether to download the License File and File Installation Key or receive
them in email. Click Continue.
Shut down the license manager, if it is running. See Start the License Manager on
page 3-63 for more information.
If you are installing the license manager only, run the installer from the MathWorks
website or use a DVD.
If you want to install the license manager and the rest of your MathWorks products at
the same time, the MathWorks products must be available on your computer or on a
DVD. Use the MathWorks installer to download products without installing them, if
you dont have a DVD.
Make sure you have the correct permissions to perform the installation. If you have
questions about this, ask your system administrator.
Windows Systems Get the name and password of the administrator account
on your computer.
Linux Systems Get the root password. You can install MATLAB software
without superuser privileges, however, it limits certain installation options. For
example, if you want to set up symbolic links to the matlab command, install
product files in a protected folder, or edit the system boot script, you must have
superuser status.
Mac OS X Systems Get the name and password of an administrator account
on your computer. The administrator account is the user account you set up when
you configured your Mac OS X system; this is not your MathWorks Account.
During installation, you must enter this name and password in the Authenticate
dialog box, shown below.
3-10
Install License Manager Using a File Installation Key
Consider disabling virus checking software and Internet security applications on your
system for the duration of the installation process. These applications can slow down
or cause the installation process to appear to become unresponsive (hang).
You only need to install the license manager once at a site. For information about
installing MathWorks software on clients, see Install MathWorks Software on Client
Systems in Network Configurations on page 3-43.
When you select an installer on the website, you receive the files that the installer
needs to run on your selected platform, not the product files. Run the installer to
select products that you want to install on the computer where you are logged in.
The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on your
platform and whether you download the installer from the MathWorks website or
use a DVD.
Windows
Downloaded installer file If you click Run when you select the installer
on the MathWorks website, the installer starts automatically. If you saved
the installer instead, double-click the self-extracting installer file in the
folder where you saved it. The name of the self-extracting installer file is
3-11
3 Installing Network License Options
To restart the installer at a later time, click setup.exe. This file is located in
the top level of the folder where you extracted the files.
DVD installation Insert the DVD into the DVD drive connected to your
system. The installer usually starts automatically.
Mac OS X
Downloaded installer file Double-click the archive file to extract the files
that you downloaded from the MathWorks website. After extracting the files,
open the installer folder and double-click InstallForMacOSX.app .
DVD installation Insert the DVD into the DVD drive connected to your
system. When the DVD icon appears on the desktop, double-click the icon to
display the DVD contents, and then double-click the InstallForMacOSX icon
to begin the installation.
Linux
Downloaded installer file Use the unzip command to extract the files
from the archive file that you downloaded from the MathWorks website. After
extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
3-12
Install License Manager Using a File Installation Key
following example. Note that the name of the DVD drive might be different on
your system.
3-13
3 Installing Network License Options
3-14
Install License Manager Using a File Installation Key
3-15
3 Installing Network License Options
If you are only installing the license manager on your server, clear the check boxes next
to the other products. If you are setting up a remote access configuration where users
will run MathWorks products on a central server, and this central server is your license
server, leave all the other products in the list selected for installation.
Note: If you plan to install other MathWorks products when you install the license
manager, you need the DVD or the products must be available locally on your computer.
For additional information about downloading products to your computer, see .
After making your selections, click Next to proceed with the installation. After clicking
Next, you might receive a message telling you that one or more of the products you
selected depend on other products.
3-16
Install License Manager Using a File Installation Key
3-17
3 Installing Network License Options
Makes a copy of your License File, naming it license.dat, and puts this copy in the
\etc folder of your MATLAB installation folder.
Adds a SERVER line and a DAEMON line to the file. The SERVER line identifies the
server host and port number. The DAEMON line identifies the name of the license
manager daemon.
Stores the processed License File in matlabroot/etc, where matlabroot is your
MATLAB installation folder.
3-18
Install License Manager Using a File Installation Key
Windows Systems
Configuring the license manager service provides automatic startup at system boot time
and centralizes administration of the license manager through the Windows Services
control panel. To review the default license manager configuration settings, click View
Default Settings. If you choose not to configure the license manager service, you can do
it later.
Note: If you have an existing license manager that you want to continue to use until
you install the new one, select the Do NOT configure license manager as a service
(files will still be installed) option. The installer still installs the license manager files.
After installation, you can stop your existing license manager and start your new license
manager.
3-19
3 Installing Network License Options
Mac OS X Systems
To add an entry for the license manager to your system Startup Items folder, leave the
option selected and click Next. Specify the user name that will own the license manager
process. For security reasons, this name cannot be root.
3-20
Install License Manager Using a File Installation Key
If you installed the license manager as a service, you should restart your computer after
completing the installation. The license manager must be running to start MATLAB on
client systems. As a service, the license manager gets started automatically at system
boot time.
3-21
3 Installing Network License Options
3-22
Install License Manager Using A MathWorks Account
In this section...
Before You Install on page 3-23
Step 1: Start the Installer on page 3-25
Step 2: Select Log in with a MathWorks Account on page 3-27
Step 3: Review the Software License Agreement on page 3-28
Step 4: Log In to Your MathWorks Account on page 3-29
Step 5: Choose Install Option on page 3-30
Step 6: Select the License You Want to Install on page 3-31
Step 7: Specify the Installation Folder on page 3-32
Step 8: Select License Manager for Installation on page 3-33
Step 9: Specify the Location of the License File on page 3-34
Step 10: Configure the License Manager on page 3-35
Step 11: Confirm Your Choices on page 3-37
Step 12: Complete the Installation on page 3-39
To avoid any potential issues with License File operation, consider upgrading the license
manager software whenever you upgrade MATLAB software.
Note: Starting with R2013b, network License Files have a new format. As a result,
R2013b and later releases require an update to the latest version of the license manager
that ships with R2013b or later. You can continue to use older License Files and previous
versions of the MATLAB software if you decide not to upgrade to R2013b or a later
release.
3-23
3 Installing Network License Options
If you don't have a MathWorks Account, you can create one during installation.
However, you must have an Activation Key. An Activation Key is the unique code
that identifies a license. It is used to activate the license. The Activation Key also
allows licensed end users to associate their MathWorks Account with a license. Ask
the administrator of the license for the Activation Key.
Make sure you have the correct permissions to perform the installation. If you have
questions about this, ask your system administrator.
Windows Systems Get the name and password of the administrator account
on your computer.
Linux Systems Get the root password. You can install MATLAB software
without superuser privileges, however, it limits certain installation options. For
example, if you want to set up symbolic links to the matlab command, install
product files in a protected folder, or edit the system boot script, you must have
superuser status.
Mac OS X Systems Get the name and password of an administrator account
on your computer. The administrator account is the user account you set up when
you configured your Mac OS X system; this is not your MathWorks Account.
During installation, you must enter this name and password in the Authenticate
dialog box, shown below.
3-24
Install License Manager Using A MathWorks Account
Consider disabling virus checking software and Internet security applications on your
system for the duration of the installation process. These applications can slow down
or cause the installation process to appear to become unresponsive (hang).
You only need to install the license manager once at a site. For information about
installing MathWorks software on clients, see Install MathWorks Software on Client
Systems in Network Configurations on page 3-43.
When you select an installer on the website, you receive the files that the installer
needs to run on your selected platform, not the product files. Run the installer to
select products that you want to install on the computer where you are logged in.
The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on your
platform and whether you download the installer from the MathWorks website or
use a DVD.
Windows
Downloaded installer file If you click Run when you select the installer
on the MathWorks website, the installer starts automatically. If you saved
the installer instead, double-click the self-extracting installer file in the
folder where you saved it. The name of the self-extracting installer file is
3-25
3 Installing Network License Options
To restart the installer at a later time, click setup.exe. This file is located in
the top level of the folder where you extracted the files.
DVD installation Insert the DVD into the DVD drive connected to your
system. The installer usually starts automatically.
Mac OS X
Downloaded installer file Double-click the archive file to extract the files
that you downloaded from the MathWorks website. After extracting the files,
open the installer folder and double-click InstallForMacOSX.app .
DVD installation Insert the DVD into the DVD drive connected to your
system. When the DVD icon appears on the desktop, double-click the icon to
display the DVD contents, and then double-click the InstallForMacOSX icon
to begin the installation.
Linux
Downloaded installer file Use the unzip command to extract the files
from the archive file that you downloaded from the MathWorks website. After
extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
3-26
Install License Manager Using A MathWorks Account
following example. Note that the name of the DVD drive might be different on
your system.
If your Internet connection requires a proxy server, click Connection Settings. Enter
the server name, port, and password in the Connection Settings page. MathWorks
supports Basic authentication and Digest authentication proxy configurations.
3-27
3 Installing Network License Options
Note: On Windows systems, the installer uses your system proxy settings, by default.
If your proxy server requires you to log in, the installer prompts you for your login
information.
3-28
Install License Manager Using A MathWorks Account
If you do not have a MathWorks Account, select the Create a MathWorks Account
(requires an Activation Key) option and click Next. You are prompted to enter the
data needed to create the account.
3-29
3 Installing Network License Options
3-30
Install License Manager Using A MathWorks Account
License number.
An optional descriptive text label that can help identify the license.
Information identifying the license option and the activation type. For server
installation, select a license with one of the network license options.
If you want to install products on a license that is not associated with your MathWorks
Account, select the Enter an Activation Key for a license not listed option, enter
an Activation Key, and click Next. An Activation Key is the unique code that identifies a
license.
3-31
3 Installing Network License Options
When specifying a folder name, you can use any alphanumeric character and some
special characters, such as underscores. If you make a mistake while entering a folder
name and want to start over, click Restore Default Folder. After making your
selection, click Next.
3-32
Install License Manager Using A MathWorks Account
If you are only installing the license manager on your server, clear the check boxes next
to the other products. If you are setting up a remote access configuration where users
will run MathWorks products on a central server, and this central server is your license
server, leave all the other products in the list selected for installation.
After making your selections, click Next to proceed with the installation. After clicking
Next, you might receive a message telling you that one or more of the products you
selected depend on other products.
3-33
3 Installing Network License Options
3-34
Install License Manager Using A MathWorks Account
When you install the license manager, the installer performs the following processing of
this License File:
Makes a copy of your License File, naming it license.dat, and puts this copy in the
\etc folder of your MATLAB installation folder.
Adds a SERVER line and a DAEMON line to the file. The SERVER line identifies the
server (host and port number). The DAEMON line identifies the name of the license
manager daemon.
Windows Systems
Configuring the license manager service provides automatic startup at system boot time
and centralizes administration of the license manager through the Windows Services
3-35
3 Installing Network License Options
control panel. To review the default license manager configuration settings, click View
Default Settings. If you choose not to configure the license manager service, you can do
it later.
Note: If you have an existing license manager that you want to continue to use until
you install the new one, select the Do NOT configure license manager as a service
(files will still be installed) option. The installer still installs the license manager files.
After installation, you can stop your existing license manager and start your new license
manager.
Mac OS X Systems
To add an entry for the license manager to your system Startup Items folder, leave the
option selected and click Next. Specify the user name that will own the license manager
process. For security reasons, this name cannot be root.
3-36
Install License Manager Using A MathWorks Account
3-37
3 Installing Network License Options
As it copies files to your hard drive, the installer displays a status dialog box to show the
progress of the installation.
The installer includes information about how to start the license manager on your server.
If you installed other products, you might also see some additional product configuration
and product update information.
3-38
Install License Manager Using A MathWorks Account
If you installed the license manager as a service, you should restart your computer after
completing the installation. The license manager must be running to start MATLAB on
client systems. As a service, the license manager gets started automatically at system
boot time.
3-39
3 Installing Network License Options
3-40
Download the License Manager Daemons
1 Download the zip file for your platform from License Manager Download on the
MathWorks website.
2 If the license manager is running, shut it down. See Start the License Manager on
page 3-63 for more information.
3 Extract the files from the zip file to the license manager folder. The default
location for the license manager files is the matlabroot\etc\$ARCH folder, where
matlabroot is your MATLAB installation folder and $ARCH is a platform-specific
subfolder.
4 Restart the license manager, and configure it as needed.
3-41
3 Installing Network License Options
A License File Give users a copy of the License File that was processed during
installation of the license manager on your server. This License File must contain the
correct SERVER line for the license server you are using. For information about this
License File, see License File Processing on Server on page 3-35.
Note: Do not give users performing client installations a copy of the original License
File you created from the licensing email. They can't use the licensing information in
this form it doesnt include the correct SERVER line. Also, do not forward to users
the licensing email you received from MathWorks.
Access to product files There are several ways to make product files available
to users performing client installations. You can share the MathWorks product DVD
with users. You can also download the product files and make them available on
a server that is accessible to all clients. For these scenarios, users will need a File
Installation Key to install products.
If users performing client installations have MathWorks Accounts, you can give users
the Activation Key for the license and let them log in to their accounts to install their
MathWorks products.
Installation instructions Give users a copy of the instructions in Install
MathWorks Software on Client Systems in Network Configurations on page 3-43.
Do not give them the license manager installation instructions because this might
confuse them.
If you have many client installations to perform, you can create an installer
initialization file and run the installer noninteractively see Install
Noninteractively (Silent Installation) on page 3-69.
3-42
Install MathWorks Software on Client Systems in Network Configurations
In this section...
Before You Install on page 3-43
Step 1: Start the Installer on page 3-45
Step 2: Choose an Installation Method on page 3-48
Step 3: Review the Software License Agreement on page 3-48
Step 4: Specify the File Installation Key on page 3-49
Step 5: Log In to Your MathWorks Account on page 3-50
Step 6: Select the License You Want to Install on page 3-53
Step 7: Specify the Installation Folder on page 3-54
Step 8: Specify Products to Install on page 3-55
Step 9: Specify the License File Location on page 3-56
Step 10: Specify Installation Options on page 3-57
Step 11: Confirm Your Choices on page 3-59
Step 12: Complete the Installation on page 3-61
Product access:
If products are located on a shared DVD or on a server, obtain the File Installation
Key from your license administrator.
If you are planning to use a File Installation Key for installation, ensure that
the product files, including the MATLAB installer, are available in an accessible
location, for example, in the default Downloads folder on your computer, a network
share, or on a DVD. If the product files are located in a folder other than the
default Downloads folder on your computer, the installer file must be located in
the same folder as the product files.
3-43
3 Installing Network License Options
MATLAB student-use software does not include DVDs. You must connect to
MathWorks to download and install products.
If you are expected to use your MathWorks Account to install products, make sure
you have your email address and your MathWorks Account password handy. You
need them to log in to your account during installation.
If necessary, obtain the Activation Key. If you do not have a MathWorks Account,
you need the Activation Key to create one during installation. An Activation Key
is the unique code that identifies a license. It also allows licensed end users to
associate their MathWorks Account with a license.
The client License File. The License File must include the correct SERVER line for
the license server you need to use.
Correct permissions to perform the installation. If you have questions about
this, ask your system administrator.
Windows Systems Get the name and password of the administrator account
on your computer. The installer modifies the system registry during installation.
Linux Systems Get the root password. You can install MATLAB software
without superuser privileges, however, it limits certain installation options. For
example, if you want to setup symbolic links to the matlab command, install
product files in a protected folder, or edit the system boot script, you must have
superuser status.
Mac OS X Systems Get the name and password of an administrator account
on your computer. The administrator account is the user account you set up when
you configured your Mac OS X system; this is not your MathWorks Account.
During installation, you must enter this name and password in the Authenticate
dialog box, shown below.
3-44
Install MathWorks Software on Client Systems in Network Configurations
For best results when upgrading your MATLAB installation to the latest release, install
the new version in a new installation folder. Installing in a new installation folder also
applies when upgrading an installation of a prerelease version of the software. You do
not need to delete an existing MATLAB installation before installing a new release. You
can run multiple versions of MATLAB on the same system.
Note: If you are accessing products from a shared location and planning to use a File
Installation Key, verify that the folder containing the product files includes the installer
file for your platform in the root of the folder (setup.exe for Windows, install for
Linux, and InstallForMacOSX for Mac OS X) and an archives subfolder. If the archives
subfolder contains less than 3 files, you might be missing required files. Ask your
administrator to download the files again using the procedure in Download Products
Without Installation on page 2-15.
1 Start the installer. The method you use to start the installer depends on your
platform and whether the license administrator downloaded the installer from the
MathWorks website or you are using a DVD.
3-45
3 Installing Network License Options
Windows
To restart the installer at a later time, click setup.exe. This file is located in
the top level of the folder where you extracted the files.
DVD installation Insert the DVD into the DVD drive connected to your
system. The installer usually starts automatically.
Mac OS X
Linux
3-46
Install MathWorks Software on Client Systems in Network Configurations
share, or to media, go to the top level of the folder where the product files are
located and execute the installer command:
./install
Downloaded installer file Use the unzip command to extract the files from
the archive file in the folder where the downloaded files are located. After
extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
./install
DVD installation Insert the DVD into the DVD drive connected to your
system and execute this command:
/path_to_dvd/install &
3-47
3 Installing Network License Options
If you have an Internet connection and are expected to use a MathWorks Account to
install products, choose Log in with a MathWorks Account. For this option, you might
need to obtain an Activation Key from the license administrator.
3-48
Install MathWorks Software on Client Systems in Network Configurations
If you are using a shared DVD or the product files are accessible on a server, select Use a
File Installation Key and click Next.
3-49
3 Installing Network License Options
If you do not have a MathWorks Account, select the Create a MathWorks Account
(requires an Activation Key) option and click Next. You are prompted to enter the
data needed to create the account.
3-50
Install MathWorks Software on Client Systems in Network Configurations
To create an account, enter your email address, first name, last name, and password. You
must also provide an Activation Key because a newly created account does not have any
licenses associated with it.
The Activation Key identifies the license you want to install. The administrator of this
license can retrieve the key by visiting the License Center at the MathWorks website.
If you purchased MATLAB student-use software, your product package includes the
Activation Key.
3-51
3 Installing Network License Options
Note: When you create a new MathWorks Account, you must verify your email address
before you can proceed with installation. Before you click Next in the Email Verification
Required dialog box, go to your email program, open the message sent to you by
MathWorks, and click the verification link. Then return to this dialog box and click Next.
3-52
Install MathWorks Software on Client Systems in Network Configurations
Because the Activation Key you entered specifies a particular license, the installer skips
the license selection step.
Note: If you specified an Activation Key in the previous step, the installer skips this step.
Select a license from the list of licenses associated with your MathWorks Account and
click Next. The list contains the following information about the licenses:
License number.
An optional descriptive text label that can help identify the license.
Information identifying the license option and the activation type.
3-53
3 Installing Network License Options
If you do not see the license you want in the list, select Enter an Activation Key for a
license not listed and enter an Activation Key.
When specifying a folder name, you can use any alphanumeric character and some
special characters, such as underscores. If you make a mistake while entering a folder
name and want to start over, click Restore Default Folder. After making your
selection, click Next.
3-54
Install MathWorks Software on Client Systems in Network Configurations
After making your selections, click Next to proceed with the installation. After clicking
Next, you might receive a message telling you that one or more of the products you
selected depend on other products.
3-55
3 Installing Network License Options
3-56
Install MathWorks Software on Client Systems in Network Configurations
The installer performs the following processing of the License File on client systems:
Creates a copy of the License File you specify, naming it network.lic, and puts the
file in the \licenses folder in your MATLAB client installation folder.
Deletes all the INCREMENT lines and the DAEMON line in the License File, leaving the
SERVER line. Adds the statement USE_SERVER to the file.
On Windows Systems
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts
for starting MATLAB in the Start menu and on the desktop.
3-57
3 Installing Network License Options
After selecting installation options, click Next to proceed with the installation.
On Linux Systems
On Linux systems, you can specify whether you want to create symbolic links to the
matlab and mex scripts. Specify a folder to which you have write access and that is
common to all your user's paths, such as /usr/local/bin .
After selecting installation options, click Next to proceed with the installation.
3-58
Install MathWorks Software on Client Systems in Network Configurations
3-59
3 Installing Network License Options
Depending upon which products you install, the installer might display a dialog box
containing several types of information:
3-60
Install MathWorks Software on Client Systems in Network Configurations
3-61
3 Installing Network License Options
3-62
License Manager Tasks
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 starts up
properly only if the user name can be found during the startup process on the computer,
before network users are available.
Windows Systems
You can start the license manager on Windows systems using any of the following
methods:
Use the Windows Services control panel to start or stop the license manager, if you
chose to configure it as a service during installation. On the Windows Start menu,
select Settings > Control Panel > Administrative Tools > Services
Use the license management utility, lmtools.exe, included in your MATLAB
installation in the matlabroot\etc\$ARCH folder, where $ARCH is a platform-
3-63
3 Installing Network License Options
specific subfolder. Start the lmtools.exe application and select the Start/Stop/
Reread tab.
To start the license manager daemons on a Linux or Mac OS X system, execute the
lmstart script (located in the matlabroot/etc folder), where matlabroot represents
the name of your top-level MATLAB installation folder. The lmstart script stops any
currently running daemons and starts new ones.
To run lmstart on a Mac OS X system, open a terminal window using the Terminal
application (found in /Applications/Utilities) and navigate to the /etc folder in
your MATLAB installation folder:
cd /Applications/MATLAB_R2013b.app/etc
Note A user other than root should run the lmstart script because it is a security risk
to run any program as root that does not require root permissions. The license manager
(lmgrd) does not require root permissions. If you must start the license manager as root,
use the su command to start lmgrd as a nonprivileged user:
Start the lmboot_TMW service with the -u username option, where username
represents a valid user name other than root. For security reasons, the license manager
daemons cannot be owned by superuser.
Make sure that the license manager starts at the very end of the system boot sequence.
For the license manager to start correctly, the network must already be running. Use
whatever mechanism your version of Linux provides to configure the boot sequence.
3-64
License Manager Tasks
To illustrate, the following example shows how to use LMTOOLS to see the current
status of the license manager:
3-65
3 Installing Network License Options
FlexNet licensing includes a set of license management utilities that you can use to start,
stop, and monitor the license manager.
The -a option requests a verbose listing. You must also include the-c option to specify
the License File to use. You must use this with every lmutil option. If your installation
path contains spaces, enclose the path in quotes. The following is a portion of the
information returned.
3-66
License Manager Tasks
lmutil - Copyright (c) 1989-2010 Flexera Software Inc. All Rights Reserved.
Flexible License Manager status on Tue 11/5/2014 10:11
MLM: UP v11.9
To get help for a particular utility, type the name of the utility with the -h option, as in
the following;
lmutil lmstat -h
On Linux and Mac OS X systems, these license management utilities are individual
executables, available in the matlabroot/etc folder. For example, to view the status of
the license manager, use the lmstat utility, as follows:
lmstat -a
lmutil - Copyright (c) 1989-2010 Flexera Software Inc. All Rights Reserved.
Flexible License Manager status on Tue 11/5/2013 10:11
MLM: UP v11.9
3-67
3 Installing Network License Options
To get help for a particular utility, use the -h option, as in the following;
lmstat -h
The following table lists the names of the most useful license management tools included.
Utility Description
lmdiag Diagnose license checkout problems.
lmdown Shut down all license daemons (both lmgrd and all vendor daemons)
on the license server node.
lmhostid Report the host ID of a system.
lmreread Make the license manager daemon reread the License File and start
any new vendor daemons.
Note: When you use lmreread to reprocess a License File for a user-
based license, changes to INCLUDE statements in the associated
FlexNet options file take effect after a 15-minute delay.
lmstat Display the status of all network licensing activities.
lmswitchr Switch the report log file.
lmver Determine the version of a library or binary file.
3-68
Install Noninteractively (Silent Installation)
If you have many installations of MATLAB software to perform, and the information
you need to enter for each installation is the same, you can put this information into
a properties file and run the MathWorks installer noninteractively. You specify the
properties file on the command line when you launch the installer and the file provides
the installer with the information that you would otherwise provide interactively, using
the installer dialog boxes. Noninteractive installation (also called silent installation) can
save time and prevent errors.
Note: You need a File Installation Key to use an installer properties file.
3-69
3 Installing Network License Options
2 Open your installer properties file using any text editor, and enter values for all the
specified parameters. For example, to specify where you want to install products, set
the value of the destinationFolder= parameter to the full path of the installation
folder.
destinationFolder=C:\Program Files\MATLAB\R2013b
For example, on Windows systems, click the Start menu and select the Run option.
In the Run dialog box, enter
setup.exe -inputFile C:\temp\my_installer_input.txt
For information about specifying an installer properties file on Linux and Mac OS X
systems, see the instructions in the installer properties file template.
3-70
Uninstall Noninteractively
Uninstall Noninteractively
For example, click the Start button and select the Run option. In the Run dialog
box, enter the uninstall command, specifying the full path of the properties file as
a command-line argument:
uninstall.exe -inputFile C:\temp\my_uninstall.txt
3-71
3-72
4
Troubleshooting
This topic provides information that can help you solve common problems that you might
encounter installing MathWorks software.
If you cannot find a description here that matches your problem, check the MATLAB
Release Notes documentation that you received with your MathWorks products. That
document contains the most up-to-date information available about products and
installation procedures. Installation troubleshooting information is also available at the
MathWorks website on the Support page, www.mathworks.com/support/.
4 Troubleshooting
Note If the installer appears to become unresponsive (hang), you might want to turn off
any virus-checking software you are running on your system and restart the installer.
If the installer does not start, open a Microsoft Windows Explorer window, select your
DVD drive, and double-click the setup.exe program in the top-level folder.
To specify proxy information during installation, click Connection Settings in the first
dialog box displayed by the installer. To specify proxy information during activation,
4-2
Problems During Installation
click Advanced Options in the first dialog box displayed by the activation application.
(For information about Unassociated Activation, see How Can I Activate Without a
MathWorks Account? on page 4-3.)
Click OK.
1 Get a File Installation Key for the license you want to install. The administrator on
the license can obtain this key from the MathWorks License Center.
2 Start the MathWorks installer. Insert the DVD into your DVD drive and the
installer should start automatically.
3 Choose the Use a File Installation Key option.
4-3
4 Troubleshooting
4 When the installation is complete and the installer displays the Installation
Complete dialog box, leave the Activate MATLAB option selected and click Next.
5 In the MathWorks Software Activation dialog box:
When you return to the MathWorks Software Activation dialog box, click Next.
6 Enter an Activation Key in the Activation Key dialog box and click Next. Because
you are not logged into an account, you must enter an Activation Key to identify a
license.
Note: The only activation type available for unassociated activation is Designated
Computer.
7 Click Activate.
4-4
Problems After Installation
You can also get information about license manager error messages in the License
Administration Guide for the FlexNet Publisher Licensing Toolkit, available in PDF
format in matlabroot\etc\LicenseAdministration.pdf.
Using the interface provided by your firewall program, allow access on port 27000 for the
license manager daemon. This is the default port used to communicate with the license
manager. If you changed this port number, specify the port number used at your site.
For more information about specifying the license manager daemon port number, see the
License Administration Guide.
4-5
4 Troubleshooting
The port used by the vendor daemon is assigned dynamically. If you need to open
access to the vendor daemon in your firewall, you must assign a port for vendor daemon
communication, rather than using this dynamic port assignment. You can then open the
assigned port number in your firewall.
To specify the vendor daemon port number, edit the License File on your license server
and add the port= syntax to the DAEMON line. For more information about specifying the
vendor daemon port number, see the License Administration Guide.
4-6