os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update Mathematica section for Mathematica 5.X

Browse source 
(This should be useless the day when the Mathematica port will be
available.)

Based on Boris Hollas <boris.hollas@uni-ulm.de> submission.
This commit is contained in:
Marc Fonvieille 2006-01-08 20:22:13 +00:00
parent 1c6ce94470
commit d991f199fe
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=26810
1 changed files with 66 additions and 56 deletions

122
en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
View file

@ -347,16 +347,9 @@ multi on</programlisting>
<sect1info>
<authorgroup>
<author>
<firstname>Murray</firstname>
<surname>Stokely</surname>
<contrib>Updated for Mathematica 4.X by </contrib>
</author>
</authorgroup>
<authorgroup>
<author>
<firstname>Bojan</firstname>
<surname>Bistrovic</surname>
<contrib>Merged with work by </contrib>
<firstname>Boris</firstname>
<surname>Hollas</surname>
<contrib>Updated for Mathematica 5.X by </contrib>
</author>
</authorgroup>
</sect1info>
@ -368,79 +361,96 @@ multi on</programlisting>
</indexterm>
<para>This document describes the process of installing the Linux
version of <application>&mathematica; 4.X</application> onto
version of <application>&mathematica; 5.X</application> onto
a FreeBSD system.</para>
<para>The Linux version of <application>&mathematica;</application>
runs perfectly under FreeBSD
however the binaries shipped by Wolfram need to be branded so that
FreeBSD knows to use the Linux ABI to execute them.</para>
<para>The Linux version of <application>&mathematica;</application>
or <application>&mathematica; for Students</application> can
be ordered directly from Wolfram at
<ulink url="http://www.wolfram.com/"></ulink>.</para>
<sect2>
<title>Branding the Linux Binaries</title>
<title>Running the &mathematica; Installer</title>
<para>The Linux binaries are located in the <filename>Unix</filename>
directory of the <application>&mathematica;</application> CDROM
distributed by Wolfram. You
need to copy this directory tree to your local hard drive so that
you can brand the Linux binaries with &man.brandelf.1; before
running the installer:</para>
<screen>&prompt.root; <userinput>mount /cdrom</userinput>
&prompt.root; <userinput>cp -rp /cdrom/Unix/ /localdir/</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/Kernel/Binaries/Linux/*</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/FrontEnd/Binaries/Linux/*</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/Installation/Binaries/Linux/*</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/Graphics/Binaries/Linux/*</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/Converters/Binaries/Linux/*</userinput>
&prompt.root; <userinput>brandelf -t Linux /localdir/Files/SystemFiles/LicenseManager/Binaries/Linux/mathlm</userinput>
&prompt.root; <userinput>cd /localdir/Installers/Linux/</userinput>
&prompt.root; <userinput>./MathInstaller</userinput></screen>
<para>Alternatively, you can simply set the default ELF brand
<para>First, you have to tell &os; that
<application>&mathematica;</application>'s Linux
binaries use the Linux ABI. The easiest way to do so is to
set the default ELF brand
to Linux for all unbranded binaries with the command:</para>
<screen>&prompt.root; <userinput>sysctl kern.fallback_elf_brand=3</userinput></screen>
<para>This will make FreeBSD assume that unbranded ELF binaries
<para>This will make &os; assume that unbranded ELF binaries
use the Linux ABI and so you should be able to run the
installer straight from the CDROM.</para>
<para>Now, copy the file <filename>MathInstaller</filename> to
your hard drive:</para>
<screen>&prompt.root; <userinput>mount /cdrom</userinput>
&prompt.root; <userinput>cp /cdrom/Unix/Installers/Linux/MathInstaller /localdir/</userinput></screen>
<para>and in this file, replace <literal>/bin/sh</literal> in
the first line by <literal>/compat/linux/bin/sh</literal>.
This makes sure that the installer is executed by the Linux
version of &man.sh.1;. Next, replace all occurrences of
<literal>Linux)</literal> by <literal>FreeBSD)</literal> with
a text editor or the script below in the next section. This
tells the <application>&mathematica;</application> installer,
who calls <command>uname -s</command> to determine the
operating system, to treat &os; as a Linux-like operating
system. Invoking <command>MathInstaller</command> will now
install <application>&mathematica;</application>.</para>
</sect2>
<sect2>
<title>Modifying the &mathematica; Executables</title>
<para>The shell scripts that
<application>&mathematica;</application> created during
installation have to be modified before you can use them. If
you chose <filename role="directory">/usr/local/bin</filename>
as the directory to place the
<application>&mathematica;</application> executables in, you
will find symlinks in this directory to files called
<filename>math</filename>, <filename>mathematica</filename>,
<filename>Mathematica</filename>, and
<filename>MathKernel</filename>. In each of these, replace
<literal>Linux)</literal> by <literal>FreeBSD)</literal> with
a text editor or the following shell script:</para>
<programlisting>#!/bin/sh
cd /usr/local/bin
for i in math mathematica Mathematica MathKernel
do sed 's/Linux)/FreeBSD)/g' $i &gt; $i.tmp
sed 's/\/bin\/sh/\/compat\/linux\/bin\/sh/g' $i.tmp &gt; $i
rm $i.tmp
chmod a+x $i
done</programlisting>
</sect2>
<sect2>
<title>Obtaining Your &mathematica; Password</title>
<para>Before you can run <application>&mathematica;</application>
you will have to obtain a
password from Wolfram that corresponds to your <quote>machine
ID</quote>.</para>
<indexterm>
<primary>Ethernet</primary>
<secondary>MAC address</secondary>
</indexterm>
<para>Once you have installed the Linux compatibility runtime
libraries and unpacked <application>&mathematica;</application>
you can obtain the
<quote>machine ID</quote> by running the program
<command>mathinfo</command> in the installation directory. This
machine ID is based solely on the MAC address of your first
Ethernet card.</para>
<screen>&prompt.root; <userinput>cd /localdir/Files/SystemFiles/Installation/Binaries/Linux</userinput>
&prompt.root; <userinput>mathinfo</userinput>
disco.example.com 7115-70839-20412</screen>
<para>When you start <application>&mathematica;</application>
for the first time, you will be asked for a password. If you
have not yet obtained a password from Wolfram, run the program
<command>mathinfo</command> in the installation directory to
obtain your <quote>machine ID</quote>. This machine ID is
based solely on the MAC address of your first Ethernet card,
so you cannot run your copy of
<application>&mathematica;</application> on different
machines.</para>
<para>When you register with Wolfram, either by email, phone or fax,
you will give them the <quote>machine ID</quote> and they will
respond with a corresponding password consisting of groups of
numbers. You can then enter this information when you attempt to
run <application>&mathematica;</application> for the first time
exactly as you would for any other
<application>&mathematica;</application> platform.</para>
numbers.</para>
</sect2>
<sect2>