- Add a section about Linux MATLAB installation and use [1]

- I added various trademarks needed in trademarks.ent but I did not
used them in the section.  They should be added when the trademarks
tagging will be definitively defined.

PR:		docs/55652 [1]
Submitted by:	Dan Pelleg <daniel+handbook@pelleg.org> [1]
This commit is contained in:
Marc Fonvieille 2003-08-19 08:16:14 +00:00
parent e057274ed3
commit 9de7704c20
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=17922
2 changed files with 187 additions and 1 deletions

View file

@ -665,6 +665,185 @@ FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
</sect2>
</sect1>
<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 &os; system. It works quite well, with the exception of the
<application>Java Virtual Machine</application> (see
<xref linkend="matlab-using">).</para>
<para>The Linux version of <application>MATLAB</application> can be
ordered directly from The 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 <application>MATLAB</application>, do the
following:</para>
<procedure>
<step>
<para>Insert the installation CD and mount it.
Become <username>root</username>, as recommended by the
installation 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
<command>setenv HOME ~<replaceable>USER</replaceable></command>,
where <replaceable>USER</replaceable> is the user you did a
&man.su.1; 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 prompt:
<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
<quote>glue</quote> to connect it to your &os; 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> &amp;&amp; echo 'MATLAB_lmgrd'
fi
;;
stop)
if [ -f /usr/local/etc/lmdown_TMW ]; then
/compat/linux/bin/sh /usr/local/etc/lmdown_TMW &gt; /dev/null 2&gt;&amp;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>
<para>You must also replace
<replaceable>username</replaceable> above with the name
of a valid user on your system (and not
<username>root</username>).</para>
</important>
</step>
<step>
<para>Start the license manager withe the command:
<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>Then type the command
<command>chmod +x /usr/local/bin/matlab</command>.</para>
</step>
</procedure>
</sect2>
<sect2 id="matlab-using">
<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
&os;. Therefore you will have to start
<application>MATLAB</application> with either the
<option>-nojvm</option> or the <option>-nodesktop</option>
switch.</para>
</sect2>
</sect1>
<sect1 id="linuxemu-oracle">
<sect1info>
<authorgroup>

View file

@ -175,7 +175,9 @@
Sun Microsystems, Inc. in the United States and other
countries.</para>">
<!ENTITY java "<trademark>Java</trademark>">
<!ENTITY java.virtual.machine "<trademark>Java Virtual Machine</trademark>">
<!ENTITY jdk "<trademark>JDK</trademark>">
<!ENTITY jvm "<trademark>JVM</trademark>">
<!ENTITY staroffice "<trademark>StarOffice</trademark>">
<!ENTITY solaris "<trademark>Solaris</trademark>">
<!ENTITY sunos "<trademark>SunOS</trademark>">
@ -185,13 +187,18 @@
trademarks of Symantec Corporation in the United States and other
countries.</para>">
<!-- http://www.mathworks.com/company/trademarks.shtml -->
<!ENTITY tm-attrib.themathworks "<para>MATLAB is a registered trademark
of The MathWorks, Inc.</para>">
<!ENTITY matlab "<trademark class='registered'>MATLAB</trademark>">
<!-- http://www.qualcomm.com/main/legal.html -->
<!ENTITY tm-attrib.qualcomm "<para>QUALCOMM and Eudora are registered
trademarks of QUALCOMM Incorporated.</para>">
<!ENTITY eudora "<trademark class='registered'>Eudora</trademark>">
<!-- http://www.maplesoft.com/trademarks.shtml -->
<!ENTITY tm-attrib.waterloomaple "<para>Waterloo Maple and Maple
<!ENTITY tm-attrib.waterloomaple "<para>Waterloo Maple and Maple are
trademarks or registered trademarks of Waterloo Maple Inc.</para>">
<!-- http://www.wolfram.com/company/terms.html -->