TC-Toolbox Installation Troubleshooting

Below are some suggestions to help troubleshoot a TC-Toolbox for MATLAB® installation.

Diagnostic Script

A diagnostic script is available to help you if you have problems running TC-Toolbox.

It is important to run this script EXACTLY the same way as you run your MATLAB® script.

The script automatically prints useful suggestions that, in many cases, will help you to fix the problem yourself. If you are unable to solve the problem, contact us for support.

The script is based on the version of Thermo-Calc installed and named tc-toolbox-diagnostic-script-2025b.m. You can find the script in these locations:

  • As an example (diagnostics.m) located in this folder C:\Users\<user>\Documents\Thermo-Calc\2025b\SDK\TC-Toolbox-MATLAB\Examples\Miscellaneous
  • In the Troubleshooting section of the TC-Toolbox for MATLAB® API Reference Documentation. Also refer to the Best Practices in the same guide to see if there are any other solutions or tips.
  • On our website.

MATLAB® Installation Directory Not Found

For Windows installations of the TC‑Toolbox for MATLAB® component, you may get an error message or window asking for the MATLAB® installation directory path.

The most common reason for this is that MATLAB® is not installed. If this is the case, exit the Thermo-Calc installation, install MATLAB® and then run the Thermo‑Calc installation program again.

If MATLAB® is installed and Thermo-Calc just did not find the file path during the installation setup process, then enter the path in the field when prompted.

Determining the Licensing Software Version (Network Installs)

Sometimes you may need to know the version of License Manager (Windows) or License Server (Linux) software being used. This can be useful while troubleshooting network installations.

  • On Windows open a command prompt and go to the directory where lservnt.exe is found. For example:

>C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT

Type the command >lservnt.exe –help and the version is displayed.

  • On Linux open a Terminal window and go to the directory where the lserv script is saved. For example:

>cd opt/Thermo‑Calc/<version>/Licensing-files

Type the command >./lserv –help and the version is displayed.

Silent Installations

Administrative rights are required to install the Thermo-Calc software package. If you or your IT department are having problems silently installing TC-Toolbox over a network, perhaps to multiple computers, you need to run a file that is available after Thermo-Calc is installed.

  1. Install Thermo-Calc as usual (requires administrative rights).

  2. After Thermo-Calc is installed, navigate to this folder:

    C:\Users\Public\Documents\Thermo-Calc\<2025b>\SDK\TC-Toolbox-MATLAB\.

  3. Double-click the InstallTCToolboxMATLAB.cmd file to run it

    The InstallTCToolboxMATLAB.cmd file must be run by the user who is going to use TC‑Toolbox for MATLAB®, i.e. anyone with admin rights can install Thermo-Calc, but for TC-Toolbox, the user must be logged in to run this file.