Date: Sun, 20 Feb 2000 22:44:29 -0800 (PST) From: murray@cdrom.com To: FreeBSD-gnats-submit@freebsd.org Subject: docs/16859: Update for Handbook/LinuxEmu/Mathematica Message-ID: <200002210644.WAA79700@mac.daddy.net>
next in thread | raw e-mail | index | archive | help
>Number: 16859
>Category: docs
>Synopsis: This section of the handbook is way out of date
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Sun Feb 20 23:10:00 PST 2000
>Closed-Date:
>Last-Modified:
>Originator: Murray Stokely
>Release: FreeBSD 3.4-STABLE i386
>Organization:
Walnut Creek CDROM
>Environment:
>Description:
The current section of the handbook that talks about installing the
Linux version of Mathematica is grossly outdated. The actual
installation process for modern versions of Mathematica on FreeBSD 3.x
systems is much different (easier) than the current method explained
in the handbook.
>How-To-Repeat:
It looks like some sections of the handbook have a ugly "contributed
by bla bla" line at the top and others do not. Is there a more
centralized place for handbook contributors to be credited?
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /host/ares/usr/home/ncvs/doc/en_US.ISO_8859-1/books/handbook/linuxemu/chapter.sgml,v
retrieving revision 1.26
diff -u -r1.26 chapter.sgml
--- chapter.sgml 1999/12/04 06:19:20 1.26
+++ chapter.sgml 2000/02/21 06:27:57
@@ -692,35 +692,46 @@
<sect1 id="mathematica">
<title>How to Install Mathematica on FreeBSD</title>
- <para><emphasis>Contributed by &a.rich; and &a.chuck;</emphasis></para>
-
- <para>This document shows how to install the Linux binary distribution of
- Mathematica 2.2 on FreeBSD 2.1.</para>
-
- <para>Mathematica supports Linux but not FreeBSD as it stands. So once
- you have configured your system for Linux compatibility you have most of
- what you need to run Mathematica.</para>
-
- <para>For those who already have the student edition of Mathematica for
- DOS the cost of upgrading to the Linux version at the time this was
- written, March 1996, was $45.00. It can be ordered directly from
- Wolfram at (217) 398-6500 and paid for by credit card.</para>
+ <para>This document describes the process of installing the Linux
+version of Mathematica 4.0 onto a FreeBSD 3.X system.</para>
+
+ <para>The Linux version of Mathematica 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 Mathematica or Mathematica for Students
+ can be ordered directly from Wolfram at
+ http://www.wolfram.com</para>;
+
<sect2>
- <title>Unpacking the Mathematica distribution</title>
-
- <para>The binaries are currently distributed by Wolfram on CDROM. The
- CDROM has about a dozen tar files, each of which is a binary
- distribution for one of the supported architectures. The one for
- Linux is named <filename>LINUX.TAR</filename>. You can, for example,
- unpack this into <filename>/usr/local/Mathematica</filename>:</para>
-
- <screen>&prompt.root; <userinput>cd /usr/local</userinput>
-&prompt.root; <userinput>mkdir Mathematica</userinput>
-&prompt.root; <userinput>cd Mathematica</userinput>
-&prompt.root; <userinput>tar -xvf /cdrom/LINUX.TAR</userinput></screen>
- </sect2>
+ <title>Branding the Linux binaries</title>
+ <para>The Linux binaries are located in the
+ <filename>Unix</filename> directory of the Mathematica 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 <filename>brandelf</filename>(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>cd
+ /localdir/Installers/Linux/</userinput>
+ &prompt.root: <userinput>./MathInstaller</userinput>
+
+ </screen>
+
+ </sect2>
+
<sect2>
<title>Obtaining your Mathematica Password</title>
@@ -730,136 +741,21 @@
<para>Once you have installed the Linux compatibility runtime libraries
and unpacked Mathematica you can obtain the “machine
ID” by running the program <command>mathinfo</command> in the
- Install directory.</para>
+ Install directory. This machine ID is based solely on the MAC
+ address of your first ethernet card.</para>
- <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput>
+ <screen>&prompt.root; <userinput>cd /localdir/Files/SystemFiles/Installation/Binaries/Linux</userinput>
&prompt.root; <userinput>mathinfo</userinput>
-LINUX: 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented
-richc.isdn.bcm.tmc.edu 9845-03452-90255</screen>
+disco.cdrom.com 7115-70839-20412</screen>
- <para>So, for example, the “machine ID” of
- <hostid>richc</hostid> is <literal>9845-03452-90255</literal>. You
- can ignore the message about the ioctl that is not implemented. It
- will not prevent Mathematica from running in any way and you can
- safely ignore it, though you will see the message every time you run
- Mathematica.</para>
-
<para>When you register with Wolfram, either by email, phone or fax, you
will give them the “machine ID” and they will respond with
- a corresponding password consisting of groups of numbers. You need to
- add them both along with the machine name and license number in your
- <filename>mathpass</filename> file.</para>
-
- <para>You can do this by invoking:</para>
-
- <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput>
-&prompt.root; <userinput>math.install</userinput></screen>
-
- <para>It will ask you to enter your license number and the Wolfram
- supplied password. If you get them mixed up or for some reason the
- <command>math.install</command> fails, that is OK; you can simply edit
- the file <filename>mathpass</filename> in this same directory to
- correct the info manually.</para>
-
- <para>After getting past the password, <command>math.install</command>
- will ask you if you accept the install defaults provided, or if you
- want to use your own. If you are like us and distrust all install
- programs, you probably want to specify the actual directories.
- Beware. Although the <command>math.install</command> program asks
- you to specify directories, it will not
- create them for you, so you should perhaps have a second window open
- with another shell so that you can create them before you give them to
- the install program. Or, if it fails, you can create the directories
- and then restart the <command>math.install</command> program. The
- directories we chose to create beforehand and specify to
- <command>math.install</command> were:</para>
-
- <informaltable frame="none">
- <tgroup cols="2">
- <tbody>
- <row>
- <entry><filename>/usr/local/Mathematica/bin</filename></entry>
- <entry>for binaries</entry>
- </row>
-
- <row>
- <entry><filename>/usr/local/Mathematica/man/man1</filename></entry>
- <entry>for man pages</entry>
- </row>
-
- <row>
- <entry>/usr/local/Mathematica/lib/X11</entry>
- <entry>for the <filename>XKeysymb</filename> file</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
-
- <para>You can also tell it to use <filename>/tmp/math.record</filename>
- for the system record file, where it puts logs of sessions. After
- this <command>math.install</command> will continue on to unpacking
- things and placing everything where it should go.</para>
-
- <para>The Mathematica Notebook feature is included separately, as the X
- Front End, and you have to install it separately. To get the X Front
- End stuff correctly installed, cd into the
- <filename>/usr/local/Mathematica/FrontEnd</filename> directory and
- execute the <command>xfe.install</command> shell script. You will
- have to tell it where to put things, but you do not have to create any
- directories because it will use the same directories that had been
- created for <command>math.install</command>. When it finishes, there
- should be a new shell script in
- <filename>/usr/local/Mathematica/bin</filename> called
- <filename>mathematica</filename>.</para>
-
- <para>Lastly, you need to modify each of the shell scripts that
- Mathematica has installed. At the beginning of every shell script in
- <filename>/usr/local/Mathematica/bin</filename> add the following
- line:</para>
-
- <screen>&prompt.user; <userinput>XKEYSYMDB=/usr/local/Mathematica/lib/X11/XKeysymDB; export XKEYSYMDB</userinput></screen>
-
- <para>This tells Mathematica were to find its own
- version of the key mapping file <filename>XKeysymDB</filename>.
- Without this you will get pages of error messages about missing
- key mappings.</para>
-
- <para>On 2.1-STABLE you need to add the following as well:</para>
-
- <screen>&prompt.user; <userinput>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF</userinput></screen>
-
- <para>This tells Mathematica to use the Linux version of
- <filename>host.conf</filename>. This file has a different syntax
- from FreeBSD's <filename>host.conf</filename>, so you will
- get an error message about <filename>/etc/host.conf</filename> if you
- leave this out.</para>
-
- <para>You might also want to modify your
- <filename>/etc/manpath.config</filename> file to read the new man
- directory, and you may need to edit your <filename>~/.cshrc</filename>
- file to add <filename>/usr/local/Mathematica/bin</filename> to your
- path.</para>
-
- <para>That is about all it takes. With this you should be able to type
- <command>mathematica</command> and get a really slick looking
- Mathematica Notebook screen up. Mathematica has included the Motif
- user interfaces, but it is compiled in statically, so you do not need
- the Motif libraries. Good luck doing this yourself!</para>
+ a corresponding password consisting of groups of numbers. You
+ can then enter this information when you attempt to run
+ Mathematica for the first time exactly as you would for any
+ other Mathematica platform.</para>
</sect2>
- <sect2>
- <title>Bugs</title>
-
- <para>The Notebook front end is known to hang sometimes when reading
- notebook files with an error messages similar to:</para>
-
- <screen><errorname>File .../Untitled-1.mb appears to be broken for OMPR.257.0</errorname></screen>
-
- <para>We have not found the cause for this, but it only affects the
- Notebook's X Window front end, not the mathematica engine itself. So
- the command line interface invoked by <command>math</command> is
- unaffected by this bug.</para>
- </sect2>
<sect2>
<title>Acknowledgments</title>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200002210644.WAA79700>