diff options
Diffstat (limited to 'en_US.ISO8859-1')
-rw-r--r-- | en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml | 324 |
1 files changed, 160 insertions, 164 deletions
diff --git a/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml b/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml index fed0b12ec2..488273a192 100644 --- a/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml @@ -1,7 +1,7 @@ <!-- The FreeBSD Documentation Project - $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/linuxemu/chapter.sgml,v 1.25 1999/11/07 01:54:50 chris Exp $ + $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/linuxemu/chapter.sgml,v 1.26 1999/12/04 06:19:20 jhb Exp $ --> <chapter id="linuxemu"> @@ -690,184 +690,180 @@ multi on</programlisting> </sect1> <sect1 id="mathematica"> - <title>How to Install Mathematica on FreeBSD</title> - - <para><emphasis>Contributed by &a.rich; and &a.chuck;</emphasis></para> + <title>Mathematica</title> + + <para><emphasis>Contributed by &a.rich; and &a.chuck;. Updated by Bojan + Bistrovic <email>bojanb@physics.odu.edu</email></emphasis></para> <para>This document shows how to install the Linux binary distribution of - Mathematica 2.2 on FreeBSD 2.1.</para> + Mathematica</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> <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> - - <sect2> - <title>Obtaining your Mathematica Password</title> + <title>Installing Mathematica</title> - <para>Before you can run Mathematica you will have to obtain a password - from Wolfram that corresponds to your “machine ID”.</para> - - <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> - - <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</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> - - <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> + <para>Mathematica comes on CD ROM. If you have the student edition your + CD will have versions for Mac, Windows95/NT and Linux. If you have the + professional edition you will have versions for Digital Unix, Solaris, + IRIX, HPUX, AIX, and NeXT as well. If your CDROM is mounted at + <filename>/cdrom</filename> then your installers will be in + <filename>/cdrom/Unix/Installers</filename>.</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> + <note> + <para>Although the student edition has installers for all the Unix + versions, it has binaries for Linux only.</para> + </note> - <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> + <para>You have two Linux directories: <filename>Linux</filename> (ELF + version) and <filename>Linux-aout</filename> (a.out version). Both + installers will work (for that matter all Unix installers will work), + but the difference is what will they install. At this point you must + choose the version you want to install. a.out will work immediately, + while ELF requires branding (see &man.brandelf.1;) of all the binaries. + If you choose to run the ELF install you will need to brand the + installer as well, which will require you to copy the installer to your + hard disk so that you can write to it to brand it.</para> + + <para>The installation is the same whichever one you eventually install. + These examples will show the a.out version being installed.</para> + + <para>To start installation, run:</para> + + <screen>&prompt.root; <userinput>cd /cdrom/Unix/Installers/Linux-aout</userinput> +&prompt.root; <userinput>./MathInstaller</userinput></screen> + + <para>You will have a choice where to install Mathematica 3.0 source + tree (default is <filename>/usr/local/mathematica</filename>) as well + as where to install startup scripts (default is + <filename>/usr/local/bin</filename>). You will be asked to install + password (or skip it). If you choose to install password immediately, + MathInstaller will print out your <quote>MathID</quote> and ask for + password and licence ID needed to run Mathematica.</para> + + <para>You can skip that at this point since you will be asked for it + again when you start mathematica for the first time. Help is + available for every question mathematica asks you. To obtain the + password you will need your <quote>MathID</quote>. If you haven't + written it down, you'll get it by running:</para> + + <screen>&prompt.root; <userinput>./MathInstaller -info</userinput></screen> + + <para>or</para> + + <screen>&prompt.root; <userinput>cd /cdrom/Unix/Files/SystemFiles/Installation/Binaries/Linux-aout</userinput> +&prompt.root; <userinput>./mathinfo</userinput></screen> + + <para>The output will look like + <literal><replaceable>hostname</replaceable> + <replaceable>####</replaceable>-<replaceable>#####</replaceable>-<replaceable>#####</replaceable></literal>, + where + <literal><replaceable>####</replaceable>-<replaceable>#####</replaceable>-<replaceable>#####</replaceable></literal> is your <quote>MathID</quote>. + With this you can obtain your licence at <ulink + url="http://www.wolfram.com/register">http://www.wolfram.com/register</ulink> or if you have a site + licence <ulink + url="http://www.wolfram.com/site">http:/www.wolfram.com/site</ulink>. + You will also need your <quote>$LicenceID</quote> which is written on a + sticker on your CD-ROM folder; it looks like + <literal>L<replaceable>####</replaceable>-<replaceable>####</replaceable></literal> + where <literal><replaceable>#</replaceable></literal> are numbers 0 + through 9. If you have a site licence, you have to ask for + <literal>Single User (Mac/Windows)</literal> type of licence (as stupid + as it looks), not for <literal>Unix</literal>. You will receive your + password by e-mail. If you have already installed mathematica without + the licence, you can install the licence by typing</para> + + <screen>&prompt.root; <userinput>./MathInstaller -pass</userinput></screen> + + <para>Copy the e-mail you received form Wolfram Research (after removing + the header) to + <filename>/usr/local/mathematica/Configuration/Licensing/mathpass</filename> + or simply start mathematica (<command>math</command> for terminal + version, <command>mathematica</command> for X Front End) and it will + ask you for the password and write it in password file.</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> + <title>Running Mathematica from a Linux filesystem</title> + + <para>If you have multi-OS box, and you already installed Mathematica + under Linux, you may want to run it directly from that partition. Here + we assume that you already compiled your kernel with + <literal>EXT2FS</literal> option and mounted your Linux partition at + <filename>/linux</filename>.</para> + + <procedure> + <step> + <para>First you have to copy startup scripts.</para> + + <screen>&prompt.root; <userinput>cp /linux/usr/local/bin/math* /usr/local/bin</userinput></screen> + </step> + + <step> + <para>Next you have to edit the <filename>math</filename>, + <filename>mathematica</filename>, + <filename>Mathematica</filename>, and + <filename>MathKernel</filename> scripts.</para> + + <para>Change the line containing + `<literal>topdir=/usr/local/mathematica</literal> to + <literal>topdir=/linux/usr/local/mathematica</literal>. + </para> + </step> + </procedure> </sect2> - + <sect2> - <title>Acknowledgments</title> - - <para>A well-deserved thanks should go to &a.sos; and &a.peter; who made - Linux mode what it is today, and Michael Smith who drove these - two guys like dogs to get it to the point where it runs Linux binaries - better than Linux! <!-- smiley -->:-)</para> + <title>Running Mathematica front end over a network</title> + + <para>Mathematica uses some special fonts to display characters not + present in standard fonts (integrals, sums, greek letters, etc.). The + X protocol requires these fonts to be installed + <emphasis>locally</emphasis>. This means you will have to copy these + fonts (from the CD or host with mathematica installed) to your local + machine. These fonts are normally stored in + <filename>/usr/local/mathematica/SystemFiles/Fonts</filename> on your + hard disc or in + <filename>/cdrom/Unix/Files/SystemFiles/Fonts</filename> on the CD + ROM. The actual fonts are in the subdirectories + <filename>Type1</filename> and <filename>X</filename>. There are + several ways to use them. One is to copy them in to one of the + existing font directories in + `<filename>/usr/X11R6/lib/X11/fonts/</filename>. This will require + editing the <filename>fonts.dir</filename> file, adding the font names + and changing the number of fonts in the first line. Alternatively (and + probably better) you can copy the directories to + <filename>/usr/X11R6/lib/X11/fonts/</filename>:</para> + + <screen>&prompt.root; <userinput>cd /usr/X11R6/lib/X11/fonts/</userinput> +&prompt.root; <userinput>mkdir X</userinput> +&prompt.root; <userinput>mkdir MathType1</userinput> +&prompt.root; <userinput>cd /usr/local/mathematica/SystemFiles/Fonts/</userinput> +&prompt.root; <userinput>cp X/* /usr/X11R6/lib/X11/fonts/X</userinput> +&prompt.root; <userinput>cp Type1/* /usr/X11R6/lib/X11/fonts/MathType1</userinput></screen> + + <para>Then add them to your font path.</para> + + <screen>&prompt.root; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/X</userinput> +&prompt.root; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/MathType1</userinput> +&prompt.root; <userinput>xset fp rehash</userinput></screen> + + <para>If you are using the XFree86 server, you can have these fonts + loaded automatically by changing the + <filename>/etc/XF86Config</filename> file.</para> + + <para>If you <emphasis>do not</emphasis> already have directory called + <filename>/usr/X11R6/lib/X11/fonts/Type1</filename> you can change the + name of <filename>MathType1</filename> directory in the example above + to <filename>Type1</filename> (you can call them whatever you like for + that matter). This makes your system ready to run Mathematica Front + End over network. This is a general method which works for all + X-servers. If you're using XFree86 (as most FreeBSD and Linux users + are), then it might be easier just to add the line</para> + + <programlisting>FontPath "/usr/X11R6/lib/X11/fonts/MathType1"</programlisting> </sect2> </sect1> |