10.4. Installing MapleTM

Contributed by Aaron Kaplan.
Thanks to Robert Getschmann.

MapleTM is a commercial mathematics program similar to Mathematica(R). You must purchase this software from http://www.maplesoft.com/ and then register there for a license file. To install this software on FreeBSD, please follow these simple steps.

  1. Execute the INSTALL shell script from the product distribution. Choose the "RedHat" option when prompted by the installation program. A typical installation directory might be /usr/local/maple.

  2. If you have not done so, order a license for MapleTM from Maple Waterloo Software (http://register.maplesoft.com/) and copy it to /usr/local/maple/license/license.dat.

  3. Install the FLEXlm license manager by running the INSTALL_LIC install shell script that comes with MapleTM. Specify the primary hostname for your machine for the license server.

  4. Patch the /usr/local/maple/bin/maple.system.type file with the following:

       ----- snip ------------------
    *** maple.system.type.orig      Sun Jul  8 16:35:33 2001
    --- maple.system.type   Sun Jul  8 16:35:51 2001
    *** 72,77 ****
    --- 72,78 ----
              # the IBM RS/6000 AIX case
    +     "FreeBSD"|\
              # the Linux/x86 case
            # We have two Linux implementations, one for Red Hat and
       ----- snip end of patch -----

    Please note that after the "FreeBSD"|\ no other whitespace should be present.

    This patch instructs MapleTM to recognize "FreeBSD" as a type of Linux system. The bin/maple shell script calls the bin/maple.system.type shell script which in turn calls uname -a to find out the operating system name. Depending on the OS name it will find out which binaries to use.

  5. Start the license server.

    The following script, installed as /usr/local/etc/rc.d/lmgrd.sh is a convenient way to start up lmgrd:

       ----- snip ------------
    #! /bin/sh
    export PATH
    case "$1" in
    	lmgrd -c ${LICENSE_FILE} 2>> ${LOG} 1>&2
    	echo -n " lmgrd"
    	lmgrd -c ${LICENSE_FILE} -x lmdown 2>> ${LOG} 1>&2
    	echo "Usage: `basename $0` {start|stop}" 1>&2
    	exit 64
    exit 0
       ----- snip ------------
  6. Test-start MapleTM:

    % cd /usr/local/maple/bin
    % ./xmaple

    You should be up and running. Make sure to write Maplesoft to let them know you would like a native FreeBSD version!

10.4.1. Common Pitfalls

  • The FLEXlm license manager can be a difficult tool to work with. Additional documentation on the subject can be found at http://www.globetrotter.com/.

  • lmgrd is known to be very picky about the license file and to core dump if there are any problems. A correct license file should look like this:

    # =======================================================
    # License File for UNIX Installations ("Pointer File")
    # =======================================================
    SERVER chillig ANY
    VENDOR maplelmg
    FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
             PLATFORMS=i86_r ISSUER="Waterloo Maple Inc." \
             ISSUED=11-may-2000 NOTICE=" Technische Universitat Wien" \


    Serial number and key 'X''ed out. chillig is a hostname.

    Editing the license file works as long as you do not touch the "FEATURE" line (which is protected by the license key).

All FreeBSD documents are available for download at http://ftp.FreeBSD.org/pub/FreeBSD/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.