Main Content

Transition Existing Installations to Campus-Wide License

Follow these instructions to transition MATLAB® product installations configured for previous licenses (Individual, Designated Computer, Concurrent, or Network Named User) to use the Campus-Wide License. You can also use these instructions to update older Campus-Wide License configurations and migrate your users to the latest release of MATLAB.

To transition existing MATLAB installations, you can either reinstall MATLAB on each machine or update MATLAB without reinstalling.

Reinstall MATLAB

The simplest way to transition an existing installation to the Campus-Wide License is to uninstall and then reinstall MATLAB.

To reinstall MATLAB on multiple computers with the same configuration, complete the following steps:

  1. Uninstall all releases of MATLAB that are linked to other licenses. See Uninstall MATLAB.

  2. (Concurrent and Network Named User licenses only) Uninstall the network license manager if one is in use. See Uninstall Network License Manager.

  3. Install the latest release of MATLAB on each computer using a silent, command-line installer by following the instructions in Install Products Programmatically.

    To get the file installation key required for this step, go to the License Center and select the MATLAB (Individual) license. Then on the Installation and Activate tab, select Advanced Options, and copy the file installation key for the product you are installing.

To reinstall MATLAB on a small number of computers, uninstall and reinstall each MATLAB installation manually.

  1. Uninstall MATLAB from the computer. See Uninstall MATLAB.

  2. From MathWorks Downloads, download and install the latest release of MATLAB. When prompted during installation, select the MATLAB (Individual) license. For more details, see Download and Install MATLAB.

Update MATLAB Without Reinstalling

To transition existing MATLAB installations to the MATLAB (Individual) license without reinstalling them, complete the following steps:

  1. Delete existing license files from university computers. The license file locations depend on the type of license in use and the platform of the computer.

    Individual Licenses

    Files for Individual licenses are stored in the R20XXy_licenses subfolder of the user's profile or home folder. The default location of this folder is given below, where R20XXy is the MATLAB release.

    • Windows®%AppData%\MathWorks\MATLAB\R20XXy_licenses

    • Linux®~/.matlab/R20XXy_licenses

    • macOS/Users/$USER/Library/Application Support/MathWorks/MATLAB/R20XXy_licenses

    Designated Computer, Concurrent, and Network Named User Licenses

    Files for Designated Computer, Concurrent, and Network Named User licenses are stored in the matlabroot/licenses subfolder of the MATLAB installation folder, matlabroot. The default location of this folder is given below, where R20XXy is the MATLAB release.

    • Windows — C:\Program Files\MATLAB\R20XXy\licenses

    • Linux and macOS/usr/local/MATLAB/R20XXy/licenses

  2. Replace the deleted license files with a file containing information required by the Campus-Wide License.

    1. Create a file named license_info.xml.

    2. Copy the information below into the license_info.xml file.

      license_info.xml
      <root>  
        <ActivationEntry hostname="*" matlabroot="*" user="*">    
          <licmode>onlinelicensing</licmode>  
        </ActivationEntry> 
      </root> 

    3. Save this file in the matlabroot/licenses folder of each installed MATLAB release.

  3. (Concurrent and Network Named User licenses only) Uninstall the network license manager if one is in use. See Uninstall Network License Manager. If any client machines have an environment variable set to an old license server, delete that environment variable.

  4. Start MATLAB and verify that the sign-in prompt opens. If you are not prompted to sign in, the installation might still point to an old license. Confirm that all old license files have been removed and repeat this procedure, if necessary.

See Also

Topics