<para><emphasis>Contributed by &a.rich; and &a.chuck;</emphasis></para>

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

version of Mathematica 4.0 onto a FreeBSD 3.X system.</para>

    <para>This document shows how to install the Linux binary distribution of

      Mathematica 2.2 on FreeBSD 2.1.</para>

    <para>The Linux version of Mathematica runs perfectly under

      FreeBSD however the binaries shipped by Wolfram need to be

    <para>Mathematica supports Linux but not FreeBSD as it stands.  So once

      branded so that FreeBSD knows to use the Linux ABI to execute

      you have configured your system for Linux compatibility you have most of

      them.</para>

      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>

      <title>Unpacking the Mathematica distribution</title>

      <title>Branding the Linux binaries</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>

	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>

LINUX: 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented

disco.cdrom.com 7115-70839-20412</screen>

richc.isdn.bcm.tmc.edu   9845-03452-90255</screen>

	a corresponding password consisting of groups of numbers.  You need to

	a corresponding password consisting of groups of numbers.  You

	add them both along with the machine name and license number in your

	can then enter this information when you attempt to run

	<filename>mathpass</filename> file.</para>

	Mathematica for the first time exactly as you would for any

	other Mathematica platform.</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>