From owner-freebsd-doc Sun Feb 20 23:10: 9 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id DDF9837C1A6 for ; Sun, 20 Feb 2000 23:10:00 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id XAA89802; Sun, 20 Feb 2000 23:10:00 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from mac.daddy.net (disco.cdrom.com [204.216.28.175]) by hub.freebsd.org (Postfix) with ESMTP id ADC7337BBD1 for ; Sun, 20 Feb 2000 23:01:25 -0800 (PST) (envelope-from murray@mac.daddy.net) Received: (from murray@localhost) by mac.daddy.net (8.9.3/8.9.2) id WAA79700; Sun, 20 Feb 2000 22:44:29 -0800 (PST) (envelope-from murray) Message-Id: <200002210644.WAA79700@mac.daddy.net> Date: Sun, 20 Feb 2000 22:44:29 -0800 (PST) From: murray@cdrom.com Reply-To: murray@cdrom.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/16859: Update for Handbook/LinuxEmu/Mathematica Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >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 @@ How to Install Mathematica on FreeBSD - Contributed by &a.rich; and &a.chuck; - - This document shows how to install the Linux binary distribution of - Mathematica 2.2 on FreeBSD 2.1. - - 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. - - 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. + This document describes the process of installing the Linux +version of Mathematica 4.0 onto a FreeBSD 3.X system. + + 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. + The Linux version of Mathematica or Mathematica for Students + can be ordered directly from Wolfram at + http://www.wolfram.com + - Unpacking the Mathematica distribution - - 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 LINUX.TAR. You can, for example, - unpack this into /usr/local/Mathematica: - - &prompt.root; cd /usr/local -&prompt.root; mkdir Mathematica -&prompt.root; cd Mathematica -&prompt.root; tar -xvf /cdrom/LINUX.TAR - + Branding the Linux binaries + The Linux binaries are located in the + Unix 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 brandelf(1) before running + the installer : + + + &prompt.root; mount /cdrom + &prompt.root; cp -rp /cdrom/Unix/ + /localdir/ + &prompt.root; brandelf -t Linux + /localdir/Files/SystemFiles/Kernel/Binaries/Linux/* + &prompt.root; brandelf -t Linux + /localdir/Files/SystemFiles/FrontEnd/Binaries/Linux/* + &prompt.root; brandelf -t Linux + /localdir/Files/SystemFiles/Installation/Binaries/Linux/* + &prompt.root: cd + /localdir/Installers/Linux/ + &prompt.root: ./MathInstaller + + + + + Obtaining your Mathematica Password @@ -730,136 +741,21 @@ Once you have installed the Linux compatibility runtime libraries and unpacked Mathematica you can obtain the “machine ID” by running the program mathinfo in the - Install directory. + Install directory. This machine ID is based solely on the MAC + address of your first ethernet card. - &prompt.root; cd /usr/local/Mathematica/Install + &prompt.root; cd /localdir/Files/SystemFiles/Installation/Binaries/Linux &prompt.root; mathinfo -LINUX: 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented -richc.isdn.bcm.tmc.edu 9845-03452-90255 +disco.cdrom.com 7115-70839-20412 - So, for example, the “machine ID” of - richc is 9845-03452-90255. 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. - 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 - mathpass file. - - You can do this by invoking: - - &prompt.root; cd /usr/local/Mathematica/Install -&prompt.root; math.install - - 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 - math.install fails, that is OK; you can simply edit - the file mathpass in this same directory to - correct the info manually. - - After getting past the password, math.install - 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 math.install 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 math.install program. The - directories we chose to create beforehand and specify to - math.install were: - - - - - - /usr/local/Mathematica/bin - for binaries - - - - /usr/local/Mathematica/man/man1 - for man pages - - - - /usr/local/Mathematica/lib/X11 - for the XKeysymb file - - - - - - You can also tell it to use /tmp/math.record - for the system record file, where it puts logs of sessions. After - this math.install will continue on to unpacking - things and placing everything where it should go. - - 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 - /usr/local/Mathematica/FrontEnd directory and - execute the xfe.install 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 math.install. When it finishes, there - should be a new shell script in - /usr/local/Mathematica/bin called - mathematica. - - Lastly, you need to modify each of the shell scripts that - Mathematica has installed. At the beginning of every shell script in - /usr/local/Mathematica/bin add the following - line: - - &prompt.user; XKEYSYMDB=/usr/local/Mathematica/lib/X11/XKeysymDB; export XKEYSYMDB - - This tells Mathematica were to find its own - version of the key mapping file XKeysymDB. - Without this you will get pages of error messages about missing - key mappings. - - On 2.1-STABLE you need to add the following as well: - - &prompt.user; RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF - - This tells Mathematica to use the Linux version of - host.conf. This file has a different syntax - from FreeBSD's host.conf, so you will - get an error message about /etc/host.conf if you - leave this out. - - You might also want to modify your - /etc/manpath.config file to read the new man - directory, and you may need to edit your ~/.cshrc - file to add /usr/local/Mathematica/bin to your - path. - - That is about all it takes. With this you should be able to type - mathematica 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! + 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. - - Bugs - - The Notebook front end is known to hang sometimes when reading - notebook files with an error messages similar to: - - File .../Untitled-1.mb appears to be broken for OMPR.257.0 - - 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 math is - unaffected by this bug. - Acknowledgments >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message