MATLAB Compiler

Deploying Components to Other Machines

To deploy your component to a target machine that does not have the same version of MATLAB installed as your development machine (or any version of MATLAB for that matter), you need to package the components and configure the target machines as follows.

Note    <mcr_root> refers to the complete path where the MCR library archive files are installed on your machine. Since <mcr_root> is version specific, you also need to include <ver>, which you can determine after you install the MCR.

Windows

• Your component, i.e., the stand-alone executable or shared library
• The CTF archive that the Compiler creates for your component (<component_name>.ctf)
• MCRInstaller.exe(This file is located in the <matlabroot>\toolbox\compiler\deploy\win32 directory.)

On the target machine, do the following:

1. Install the MCR by running MCRInstaller.exe. During the installation process, you will be prompted for a directory in which to install the MCR, for example, C:\MCR.
2. Copy the component and CTF archive to your application root directory, for example, C:\approot.
3. Add the following directory to your system path:

1. <mcr_root>\<ver>\runtime\win32

Note    On Windows XP, this directory is automatically added to your path.

4. Test the component.

UNIX

• Your component, i.e., the stand-alone executable or shared library
• The CTF archive that the Compiler creates for your component (<component_name>.ctf)
• MCRInstaller.zip

To create MCRInstaller.zip, execute the following command at the MATLAB command prompt.

• buildmcr
  

This command puts MCRInstaller.zip in the directory <matlabroot>/toolbox/compiler/deploy/<ARCH>, where <ARCH> is your system architecture, Linux = glnx86, Solaris = sol2, x86-64 = glnxa64, and HP = hpux. If you do not have write access to this directory, you can specify the destination directory as an input to buildmcr.

On the target machine, do the following:

1. Install the MCR by unzipping MCRInstaller.zip in a directory, for example, /home/<user>/MCR. You may choose any directory except <matlabroot> or any directory below <matlabroot>.
2. Copy the component and CTF archive to your application root directory, for example, /home/<user>/approot.
3. Add the following platform-specific directories to your dynamic library path.

Note    For readability, the following commands appear on separate lines, but you must enter each setenv command on one line.

Linux.   

• setenv LD_LIBRARY_PATH
      <mcr_root>/<ver>/runtime/glnx86:
      <mcr_root>/<ver>/sys/os/glnx86:
      <mcr_root>/<ver>/sys/java/jre/glnx86/jre1.5.0/lib/i386/native_threads:
      <mcr_root>/<ver>/sys/java/jre/glnx86/jre1.5.0/lib/i386/client:
      <mcr_root>/<ver>/sys/java/jre/glnx86/jre1.5.0/lib/i386:
  setenv XAPPLRESDIR <mcr_root>/<ver>/X11/app-defaults
  

Solaris.   

• setenv LD_LIBRARY_PATH
      /usr/lib/lwp:
      <mcr_root>/<ver>/runtime/sol2:
      <mcr_root>/<ver>/sys/os/sol2:
      <mcr_root>/<ver>/sys/java/jre/sol2/jre1.5.0/lib/sparc/native_threads:
      <mcr_root>/<ver>/sys/java/jre/sol2/jre1.5.0/lib/sparc/client:
      <mcr_root>/<ver>/sys/java/jre/sol2/jre1.5.0/lib/sparc:
  setenv XAPPLRESDIR <mcr_root>/<ver>/X11/app-defaults
  

Linux x86-64.   

• setenv LD_LIBRARY_PATH
      <mcr_root>/<ver>/runtime/glnxa64:
      <mcr_root>/<ver>/sys/os/glnxa64:
      <mcr_root>/<ver>/sys/java/jre/glnxa64/jre1.4.2/lib/amd64/native_threads:
      <mcr_root>/<ver>/sys/java/jre/glnxa64/jre1.4.2/lib/amd64/client:
      <mcr_root>/<ver>/sys/java/jre/glnxa64/jre1.4.2/lib/amd64:
  setenv XAPPLRESDIR <mcr_root>/<ver>/X11/app-defaults
  

HP-UX.   

• setenv SHLIB_PATH
      <mcr_root>/<ver>/runtime/hpux:
      <mcr_root>/<ver>/sys/os/hpux:
      <mcr_root>/<ver>/bin/hpux:
      <mcr_root>/<ver>/sys/java/jre/hpux/jre1.4.1/lib/PA_RISC2.0/server:
      <mcr_root>/<ver>/sys/java/jre/hpux/jre1.4.1/lib/PA_RISC2.0
  setenv LD_PRELOAD
  <mcr_root>/<ver>/sys/java/jre/hpux/jre1.4.1/lib/PA_RISC2.0/server/libjvm.sl
  setenv XAPPLRESDIR <mcr_root>/<ver>/X11/app-defaults
  

4. Test the component.

Compiling a Stand-Alone Application

Limitations and Restrictions

© 1994-2005 The MathWorks, Inc.