Application Deployment Failures
After the application is working on the test machine, failures
can be isolated in end-user deployment. The end users of your application
need to install the MATLAB® Runtime on their machines. The MATLAB Runtime includes
a set of shared libraries that provides support for all features of MATLAB.
If your application fails during end-user deployment, the following
questions in the column to the right may help you isolate the problem.
Note
There are a number of reasons why your application might not
deploy to end users, after running successfully in a test environment.
For a detailed list of guidelines for writing MATLAB code that
can be consumed by end users, see Write Deployable MATLAB Code
Is the MATLAB Runtime installed?
If running on UNIX or Mac, did you update the dynamic library path after installing the
MATLAB Runtime?
Do you receive an error message about a missing DLL?
Error messages indicating missing DLLs such as mclmcrrt7x.dll
or mclmcrrt7x.so
are
generally caused by incorrect installation of the MATLAB Runtime.
It is also possible that the MATLAB Runtime is installed correctly,
but that the PATH
, LD_LIBRARY_PATH
,
or DYLD_LIBRARY_PATH
variables are set incorrectly.
For information on installing the MATLAB Runtime on a deployment
machine, see Install and Configure the MATLAB Runtime.
Caution
Do not solve these problems by moving libraries or other files
within the MATLAB Runtime folder structure. The MATLAB Runtime system
is designed to accommodate different MATLAB Runtime versions operating
on the same machine. The folder structure is an important part of
this feature.
Do you have write access to the necessary folders?
The first operation attempted by an application with compiled MATLAB code
is extraction of the deployable archive. If the archive is not extracted,
the application cannot access the compiled MATLAB code and the
application fails.
There are three possible folders where the deployable archive
is extracted:
If the deployable archive is embedded and you are
using the default environment settings, the archive extracts into
the current user’s temp folder.
If the deployable archive is embedded and you set
the environment variable MCR_CACHE_ROOT
, the archive
extracts into the folder specified by MCR_CACHE_ROOT
.
If the deployable archive is not embedded, the archive
extracts into the current folder of the component.