MATLAB® and Simulink®

Login Named User Administration Guide

How to Contact MathWorks

Latest news: www.mathworks.com

Sales and services: www.mathworks.com/sales_and_services

User community: www.mathworks.com/matlabcentral

Technical support: www.mathworks.com/support/contact_us

Phone: 508-647-7000

The MathWorks, Inc.3 Apple Hill DriveNatick, MA 01760-2098

Login Named User Administration Guide© COPYRIGHT 2014–2015 by The MathWorks, Inc.The software described in this document is furnished under a license agreement. The software may be usedor copied only under the terms of the license agreement. No part of this manual may be photocopied orreproduced in any form without prior written consent from The MathWorks, Inc.FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentationby, for, or through the federal government of the United States. By accepting delivery of the Programor Documentation, the government hereby agrees that this software or documentation qualifies ascommercial computer software or commercial computer software documentation as such terms are usedor defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms andconditions of this Agreement and only those rights specified in this Agreement, shall pertain to andgovern the use, modification, reproduction, release, performance, display, and disclosure of the Programand Documentation by the federal government (or other entity acquiring for or through the federalgovernment) and shall supersede any conflicting contractual terms or conditions. If this License failsto meet the government's needs or is inconsistent in any respect with federal procurement law, thegovernment agrees to return the Program and Documentation, unused, to The MathWorks, Inc.

Trademarks

MATLAB and Simulink are registered trademarks of The MathWorks, Inc. Seewww.mathworks.com/trademarks for a list of additional trademarks. Other product or brandnames may be trademarks or registered trademarks of their respective holders.Patents

MathWorks products are protected by one or more U.S. patents. Please seewww.mathworks.com/patents for more information.Revision History

September 2012 Online only New for MATLAB 8.0 (R2012b)March 2015 Online only

iii

Contents

Login Named User1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Login Named User Description . . . . . . . . . . . . . . . . . . . . . . . 1-2Required Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Set Up Login Named User . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Start MATLAB with Login Named User . . . . . . . . . . . . . . . . . 1-6

Enable or Disable Login Named User2

Use the Activation Application . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Use a MATLAB Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Edit the license_info.xml File . . . . . . . . . . . . . . . . . . . . . . . . . 2-5The license_info.xml File Location . . . . . . . . . . . . . . . . . . . . 2-5How to Edit the license_info.xml file . . . . . . . . . . . . . . . . . . . 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

1

Login Named User

• “Overview” on page 1-2• “Set Up Login Named User” on page 1-4• “Start MATLAB with Login Named User” on page 1-6

1 Login Named User

1-2

Overview

In this section...

“Login Named User Description” on page 1-2“Required Actions” on page 1-3

Login Named User Description

Login Named User is a license feature that allows you to access MATLAB® from anycomputer where you install the software, as long as:

• You have a valid MathWorks® Account email address and password. MathWorks usesthis information to check your license rights when you start MATLAB.

• You have a license that allows you to use Login Named User and you are associatedwith that license.

• Your computer has an uninterrupted internet connection to MathWorks when youstart a MATLAB session.

Each time you start MATLAB, you are prompted to provide your MathWorks Accountemail address and password. MathWorks uses this information to check your licenserights instead of copying a License File to your computer.

Your computer must also have an uninterrupted connection to the Internet whileyou are using the software. Once you start a MATLAB session, MATLAB periodicallychecks that the internet connection to MathWorks is still active.

Benefits

• Login Named User is useful if you want to access the software:

• On multiple computers connected to the Internet, such as your laptop, your officecomputer, and a lab computer.

• On shared computers with internet connections, such as in labs or conferencerooms.

• In a cloud environment hosted either by a third party or on your premises.• MATLAB Administrators who deploy MATLAB software to many computers for use

by multiple users may find it easier to use Login Named User to enable license rights,instead of an activated License File on each computer.

Overview

1-3

What Happens When Connectivity is Lost?

If MATLAB loses its internet connection to MathWorks, the software displays warningswhen you interact with the MATLAB desktop (for example, when you press Enter ortype text in an editor).

If MATLAB cannot detect an active connection to MathWorks after a pre-configuredamount of time, the MATLAB session terminates. Before exiting, MATLAB displays amessage instructing you to save your workspace.

Required Actions

To set up and use Login Named User:

• Install and activate the MATLAB software on the computers where you plan to accessit. For example, you could install the software on a laptop, on computers in a sharedlab, and on a computer in a conference room.

• Provide your MathWorks Account email address and password every time you startMATLAB.

MathWorks uses these credentials to confirm that you have the correct license rightsto access the product.

• Ensure that you have an uninterrupted internet connection to MathWorks while aMATLAB session is active.

1 Login Named User

1-4

Set Up Login Named User

Setup for using Login Named User occurs during activation. If you have a license thatincludes Login Named User, the activation application displays the following page:

1 Select Authenticate (log in) each time the software starts and click Next.2 If prompted to do so, enter your user name and click Next.

MATLAB Administrators: If you are a MATLAB administrator, you can set up thelicense for yourself or for someone else. If you set up the license for someone whodoes not have a MathWorks Account, the activation application creates this accountfor you.

3 On the confirmation page, verify that the Activation type specifies Login Required.

Set Up Login Named User

1-5

4 Click Confirm to complete the license setup.

For more information about installation and activation, see the Installation Guide.

1 Login Named User

1-6

Start MATLAB with Login Named User

To start MATLAB with Login Named User:

1 Start MATLAB.2 Enter a valid MathWorks Account email address and password and click OK.3 Select the license you want to use, if necessary.

• If you are entitled to use one license only, MATLAB selects that licenseautomatically.

• If you are entitled to use more than one license with Login Named User, selectthe license you want to use in the License Selection dialog box and click OK.

After you enter your MathWorks Account credentials and select a license (if necessary),MATLAB checks your license rights. If you have the correct license rights, MATLABstarts. Otherwise, a dialog box displays a message explaining that you do not have thecorrect license rights to access MATLAB using the Internet.

2

Enable or Disable Login Named User

• “Use the Activation Application” on page 2-2• “Use a MATLAB Command” on page 2-4• “Edit the license_info.xml File” on page 2-5

2 Enable or Disable Login Named User

2-2

Use the Activation Application

The recommended method for enabling or disabling Login Named User after initial setupis to use the activation application. If you disable Login Named User, MATLAB uses youroriginal license option with an activated License File.

1 Start the activation application using one of the following methods:

• If you have MATLAB running, on the Home tab, in the Resources section, selectHelp and then select Licensing > Activate Software.

• Navigate to the MATLAB installation folder and open the activation application.

• Windows — Double-click the activate_matlab.exe file in matlabroot/bin/$ARCH folder, where matlabroot is your MATLAB installation folder,and $ARCH is a platform-specific subfolder, for example: matlabroot\bin\win32

• Linux — Execute the activate_matlab.sh script in the matlabroot/binfolder.

• Mac OS X — Double-click the activation application icon in the MATLABapplication package. To view the contents of the MATLAB applicationpackage, right-click (or Ctrl+click) the package and select Show PackageContents.

2 Select the activation method and enter your MathWorks Account email address andpassword. If you are entitled to activate more than one license, select the license youwant to use, If you are entitled to use one license only, the activation applicationselects that license automatically.

3 In the Authentication Options page, select the appropriate option and click Next:

• To enable Login Named User and disable use of the license with an activatedLicense File, select this option:

Use the Activation Application

2-3

• To disable Login Named User and enable use of the license with an activatedLicense File, select this option:

4 Follow the instructions in the wizard to finish the license setup.

The changes you make take effect the next time you start MATLAB.

2 Enable or Disable Login Named User

2-4

Use a MATLAB Command

You can enable or disable Login Named User after initial setup by using a command inthe MATLAB Command Window.

• To enable Login Named User and disable use of the license with an activated LicenseFile, enter:

matlab.internal.licensing.changeModeTo('online')

• To disable Login Named User and enable use of the license with an activated LicenseFile, enter:

matlab.internal.licensing.changeModeTo('file')

The changes you make take effect the next time you start MATLAB.

If you change from Login Named User to a license option with a License File and you didnot activate the software previously, the activation application starts the next time youstart MATLAB.

Edit the license_info.xml File

2-5

Edit the license_info.xml File

The attributes in the license_info.xml file determine whether MATLAB uses LoginNamed User or a license with an activated License File.

You can edit this file to enable or disable Login Named User after initial setup. Ifyou change from using a license option with an activated License File, the activationapplication creates the license_info.xml file or, if the file already exists, it modifiesthis file.

Note The license_info.xml file does not contain the MathWorks Account emailaddress and password; you cannot use thelicense_info.xml file to change thesevalues.

The license_info.xml File Location

If you select Login Named User during license setup, the activation application createsthe license_info.xml file in one of the following locations:

• In the licenses folder in the user profile, if a user profile exists.

When you start MATLAB, the application looks for the license_info.xml file inthis location first.

• In your MATLAB installation folder, if no user profile exists.

If the application cannot find the license_info.xml file in the user profile, it looksfor the file in the MATLAB installation folder.

2 Enable or Disable Login Named User

2-6

How to Edit the license_info.xml file

To edit the file:

1 Locate the file:

a First, look in the <release>_licenses folder in the user profile, where<release> is the MATLAB release number (for example R2015a).

b If the licenses folder in the user profile does not contain thelicense_info.xml file, look in the MATLAB installation folder for licenses\lic_info.xml.

2 Open the file in a text editor, locate the <licmode> attribute, and change its value.

• To enable Login Named User and disable use of a license with an activatedLicense File, change the <licmode> value to online. MATLAB requires a validMathWorks Account email address and password when it starts.

• To disable Login Named User and enable use of a license an activated LicenseFile, change the <licmode> value to file. MATLAB uses the License File whenit starts.

If you change from using Login Named User to using a license option with an activatedLicense File and did not activate the software previously, the activation applicationstarts automatically the next time you start MATLAB.