<sect1 id="linuxemu-matlab">

    <sect1info>

      <authorgroup>

	<author>

	  <firstname>Dan</firstname>

	  <surname>Pelleg</surname>

	  <contrib>Contributed by </contrib>

	</author>

	<!-- daniel+handbook@pelleg.org -->

      </authorgroup>

    </sect1info>

    <title>Installing MATLAB</title>

    <indexterm>

      <primary>applications</primary>

      <secondary><application>MATLAB</application></secondary>

    </indexterm>

    <para>This document describes the process of installing the Linux

      version of <application>MATLAB version 6.5</application> onto

      a FreeBSD system.  It works quite well, with the exception of the Java

      Virtual Machine (see below).</para>

    <para>The Linux version of <application>MATLAB</application> can be

    ordered directly from MathWorks at <ulink

    url="http://www.mathworks.com"></ulink>. Make sure you also get the

      license file or instructions how to create it.</para>

    <sect2>

      <title>Installing MATLAB</title>

      <para>To install MATLAB, do the following:

      <procedure>

        <step>

        <para>Insert the installation CD and mount

        it.  Become <username>root</username>, as recommended by the install

        script.  To start the installation script type:</para>

        <screen>&prompt.root; <userinput>/compat/linux/bin/sh /cdrom/install</userinput></screen>

        <tip>

          <para>The installer is graphical.  If you get errors about not

            being able to open a display, type "<userinput>setenv HOME

              ~<replaceable>USER</replaceable>"</userinput>, where

            <replaceable>USER</replaceable> is the user you did a

            <command>su</command> as.</para>

          </tip>

        </step>

        <step>

          <para>

            When asked for the <application>MATLAB</application> root directory, type:

            <userinput>/compat/linux/usr/local/matlab</userinput>.

          </para>

          <tip>

            <para> For easier typing on the rest of the installation process, type

              this at your shell:

              <command>set MATLAB=/compat/linux/usr/local/matlab</command>

            </para>

          </tip>

        </step>

        <step>

          <para>Edit the license file as instructed when

            obtaining the <application>MATLAB</application> license.

          </para>

          <tip>

            <para> You can prepare this file in advance using your

              favorite editor, and copy it to

              <filename>$MATLAB/etc/license.dat</filename> before the

              installer asks you to edit it.

            </para>

          </tip>

        </step>

        <step>

          <para>

            Complete the installation process.

          </para>

        </step>

      </procedure>

      <para>At this point your <application>MATLAB</application>

      installation is complete.  The following steps apply "glue" to connect

      it to your FreeBSD system.

      </para>

    </sect2>

    <sect2>

      <title>License manager startup</title>

      <procedure>

        <step>

          <para>Create symlinks for the license manager scripts:</para>

        <screen>&prompt.root; <userinput>ln -s $MATLAB/etc/lmboot /usr/local/etc/lmboot_TMW</userinput>

&prompt.root; <userinput>ln -s $MATLAB/etc/lmdown /usr/local/etc/lmdown_TMW</userinput></screen>

        </step>

        <step>

          <para>Create a startup file at

            <filename>/usr/local/etc/rc.d/flexlm.sh</filename>. The example

            below is a modified version of the distributed

            <filename>$MATLAB/etc/rc.lm.glnx86</filename>.  The changes are

            file locations, and startup of the license manager under

            Linux emulation.</para>

            <programlisting>#!/bin/sh

case "$1" in

  start)

        if [ -f /usr/local/etc/lmboot_TMW ]; then

              /compat/linux/bin/sh /usr/local/etc/lmboot_TMW -u <replaceable>username</replaceable> && echo 'MATLAB_lmgrd'

        fi

        ;;

  stop)

	if [ -f /usr/local/etc/lmdown_TMW ]; then

            /compat/linux/bin/sh /usr/local/etc/lmdown_TMW  > /dev/null 2>&1

	fi

        ;;

  *)

	echo "Usage: $0 {start|stop}"

	exit 1

	;;

esac

exit 0</programlisting>

            <important>

              <para>The file must be made executable:</para>

                <screen>&prompt.root; <userinput>chmod +x /usr/local/etc/rc.d/flexlm.sh</userinput></screen>

            </important>

            <important>

              <para> You must replace <replaceable>username</replaceable>

              above with the name of a valid user on your system (and not

              root).

              </para>

            </important>

        </step>

        <step>

          <para>Start the license manager: <command>/usr/local/etc/rc.d/flexlm.sh start</command>

          </para></step>

      </procedure>

    </sect2>

    <sect2>

      <title>Creating a MATLAB startup script</title>

      <procedure>

        <step>

          <para>Place the following startup script in

            <filename>/usr/local/bin/matlab</filename>:

          </para>

          <programlisting>#!/bin/sh

/compat/linux/bin/sh /compat/linux/usr/local/matlab/bin/matlab "$@"</programlisting>

        </step>

        <step>

          <para> Type: <command>chmod +x /usr/local/bin/matlab</command>.

            </para>

        </step>

      </procedure>

    </sect2>

    <sect2>

      <title>Using MATLAB</title>

      <para>At this point you are ready to type <command>matlab</command>

        and start using it.  Note that the version of

        <application>Java</application> shipped with

        <application>MATLAB</application> does not work under

        FreeBSD.  Therefore you will have to start

        <application>MATLAB</application> with either the

        <option>-nojvm</option> or the <option>-nodesktop</option>

        switch.

      </para>

    </sect2>

  </sect1>