MATLAB: How to use both Compiler 3.x (R13) applications and Compiler 4.x (R14 and later) applications on the same machine

3.04.0interopMATLAB Compilerversion

I have multiple MATLAB Compiler-generated applications built using MATLAB Compiler 3.x (R13) and MATLAB Compiler 4.x (R14 and later). I would like to configure my system so that all of them can execute correctly.

Best Answer

This enhancement has been incorporated in Release 2007a (R2007a). For previous product releases, read below for any possible workarounds:

Starting with MATLAB Compiler 4.0 (R14), the MATLAB Compiler Runtime libraries (MCR) are versioned. This allows several MCRs to be listed on the library search path and Windows registry; see the Related Solution below for more specifics.

The equivalent libraries for MATLAB Compiler 3.x (R13) are not versioned. You must therefore execute Compiler 4.x applications in one environment with only Compiler 4.x libraries on the search path, and Compiler 3.x applications in another with only Compiler 3.x libraries on the search path.

This can be simplified using Batch files on Windows, and shell scripts on Linux/UNIX/Mac. For example, if you have two applications, myR13App and myR2006bApp, you could produce the following scripts using the library paths specified in the appropriate Compiler documentation.

This procedure assumes familiarity with Batch files or shell scripts. For more information, consult your operating system documentation. The example scripts below must be configured with the appropriate paths for your Compiler versions and operating system and are not ready to execute.

For example, for 32-bit Windows:

runMyR13App.bat:

 set PATH=$MGLROOT\bin\win32;%PATH%

 C:\work\myR13App.exe

where $MGLROOT is the installation of the R13 Math and Graphics Library (MGL). Including %PATH% on the set PATH line includes the previous value of that variable.

runMyR2006bApp.bat:

 set PATH=$MCRROOT\$VERSION\runtime\win32;%PATH%
 C:\work\myR2006bApp.exe

where $MCRROOT is the installation directory of the appropriate version of the Compiler 4.x MCR, and $VERSION is the version such as v75. Including %PATH% on the set PATH line includes the previous value of that variable.

For 32-bit Linux:

runMyR13App.csh:

 #!/bin/csh
 setenv LD_LIBRARY_PATH $MGLROOT/bin/glnx86:$LD_LIBRARY_PATH
 /user/mylogin/myR13App

where $MGLROOT is the installation of the R13 Math and Graphics Library (MGL). Including $LD_LIBRARY_PATH (with an actual $) in the setenv LD_LIBRARY_PATH line includes the previous value of that variable.

runMyR2006bApp.csh:

 #!/bin/csh
 setenv LD_LIBRARY_PATH $MCRROOT/$VERSION/runtime/glnx86:$MCRROOT/$VERSION/sys/os/glnx86:$MCRROOT/$VERSION/sys/java/jre/glnx86/jre1.5.0/lib/i386/native_threads:$MCRROOT/$VERSION/sys/java/jre/glnx86/jre1.5.0/lib/i386/server:$MCRROOT/$VERSION/sys/java/jre/glnx86/jre1.5.0/lib/i386:$LD_LIBRARY_PATH
 setenv XAPPLRESDIR $MCRROOT/$VERSION/X11/app-defaults
 /user/mylogin/myR2006bApp

where $MCRROOT is the installation directory of the appropriate version of the Compiler 4.x MCR, and $VERSION is the version such as v75. Including $LD_LIBRARY_PATH (with an actual $) in the setenv LD_LIBRARY_PATH line includes the previous value of that variable.

Related Solutions

MATLAB: Do I receive an error when I execute a stand-alone application outside of MATLAB on Linux

This happens if the MATLABROOT information is not added properly in the system PATH and LD_LIBRARY_PATH environmental variables.

The following command are required on the Linux machine to add the required platform-specific directories to your dynamic library path:

setenv LD_LIBRARY_PATH 
     matlabroot/sys/os/glnx86: 
     matlabroot/bin/glnx86: 
     matlabroot/sys/java/jre/glnx86/jre1.6.0/lib/i386/native_threads: 
     matlabroot/sys/java/jre/glnx86/jre1.6.0/lib/i386/server: 
     matlabroot/sys/java/jre/glnx86/jre1.6.0/lib/i386:
setenv XAPPLRESDIR matlabroot/X11/app-defaults

Please note that for readability, the following commands appear on separate lines, but you must enter each setenv command on one line. Also, note that the setenv command is specific to the C shell (csh).

More information on these settings can be obtained from the following URL:

 <http://www.mathworks.com/access/helpdesk/help/toolbox/compiler/bqrw460-1.html>

Another way is to run the shell script (.sh) file which is created at compile time for the stand-alone application. This will also set the MATLABROOT information properly in the system PATH.

For instance, you can type the following at the Linux prompt:

./run_deployedApplicationName.sh /usr/local/mcr/v76 inputArg1 inputArg2

Where '/usr/local/mcr/v76' is the path to the root directory of your installation of the MCR or MATLAB.

MATLAB: Is there a checklist to successfully deploy an application/ library on a system using MATLAB Compiler Runtime

MATLAB Deployment Checklist

===========================

Use this checklist to successfully deploy your application, component,

or library.

You can distribute a MATLAB Compiler-generated standalone application,

component, or library to any target machine with the same operating

system as the machine on which the application was compiled

(the "source" development machine).

For more information, see the documentation for the MATLAB Compiler at:

http://www.mathworks.com/access/helpdesk/help/toolbox/compiler/

1. Ensure that the MATLAB Compiler Runtime (MCR) is installed on target

   machines, and ensure you have installed the correct version. To verify 
   this, do the following: 
    A. Attempt to verify the MCR exists on your system.
    The MCR usually resides in these locations on these platforms:
    Operating System        Path to MCR
    ================        ===========
    Windows              C:\Program Files\MATLAB\MATLAB Compiler Runtime\v78
    Mac                  Applications/MATLAB/MATLAB_Compiler_Runtime/v78 
    Linux/Solaris        *** No predetermined installation location ***
                         Contact your system administrator.  
        NOTE: For information about the installation process and the MCR, 
              type "help MCR" or "help mcrinstaller" at the MATLAB 
              command prompt.

2. Add the MCR directory to the path specified by the target system's

   environment variable. 
    A. Locate the name of the environment variable to set, using the table 
       below:
    Operating System        Environment Variable
    ================        ====================
    Windows                PATH
    Linux                  LD_LIBRARY_PATH
    Solaris                LD_LIBRARY_PATH
    Mac                    DYLD_LIBRARY_PATH
    B. Set the path by doing one of the following:
        On Windows systems:
        * Add the MCR directory to the environment variable by opening a 
        command prompt and issuing the DOS command, specifying either 
        win32 or win64:
            set PATH=C:\Program Files\MATLAB\MATLAB Compiler Runtime\v78\runtime\{win32|win64};%PATH% 
        Alternately, for Windows, add the following pathname:
            C:\Program Files\MATLAB\MATLAB Compiler Runtime\v78\runtime\{win32|win64}
        to the PATH environment variable, specifying either win32 or win64, 
        by doing the following:
            1. Select the My Computer icon on your desktop.
            2. Right-click the icon and select Properties from the menu.
            3. Select the Advanced tab.
            4. Click Environment Variables.  
        On UNIX systems:
        * Add the MCR directory to the environment variable by issuing 
            the following commands:
        Linux
            setenv LD_LIBRARY_PATH
                <mcr_root>/v78/runtime/glnx86:
                <mcr_root>/v78/sys/os/glnx86:
                <mcr_root>/v78/sys/java/jre/glnx86/jre1.6.0/lib/i386/native_threads:
                <mcr_root>/v78/sys/java/jre/glnx86/jre1.6.0/lib/i386/server:
                <mcr_root>/v78/sys/java/jre/glnx86/jre1.6.0/lib/i386
            setenv XAPPLRESDIR <mcr_root>/v78/X11/app-defaults
        Solaris64
            setenv LD_LIBRARY_PATH /usr/lib/lwp:
                <mcr_root>/v78/runtime/sol64:
                <mcr_root>/v78/sys/os/sol64:
                <mcr_root>/v78/sys/java/jre/sol64/jre1.6.0/lib/sparcv9/native_threads:
                <mcr_root>/v78/sys/java/jre/sol64/jre1.6.0/lib/sparcv9/server:
                <mcr_root>/v78/sys/java/jre/sol64/jre1.6.0/lib/sparcv9
            setenv XAPPLRESDIR <mcr_root>/v78/X11/app-defaults
        Linux x86-64
            setenv LD_LIBRARY_PATH
                <mcr_root>/v78/runtime/glnxa64:
                <mcr_root>/v78/sys/os/glnxa64:
                <mcr_root>/v78/sys/java/jre/glnxa64/jre1.6.0/lib/amd64/native_threads:
                <mcr_root>/v78/sys/java/jre/glnxa64/jre1.6.0/lib/amd64/server:
                <mcr_root>/v78/sys/java/jre/glnxa64/jre1.6.0/lib/amd64 
            setenv XAPPLRESDIR <mcr_root>/v78/X11/app-defaults
        Mac
            setenv DYLD_LIBRARY_PATH
                <mcr_root>/version/runtime/maci:
                <mcr_root>/version/sys/os/maci:
                <mcr_root>/version/bin/maci:
                /System/Library/Frameworks/JavaVM.framework/JavaVM:
                /System/Library/Frameworks/JavaVM.framework/Libraries
            setenv XAPPLRESDIR <mcr_root>/version/X11/app-defaults

Best Answer

Related Solutions

MATLAB: Do I receive an error when I execute a stand-alone application outside of MATLAB on Linux

MATLAB: Is there a checklist to successfully deploy an application/ library on a system using MATLAB Compiler Runtime

Related Question