Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-linuxemu-maple.mdwn
1 \r
2 \r
3 ## 22.4 Installing Maple™ \r
4 \r
5 ***Contributed by Aaron Kaplan. ******Thanks to Robert Getschmann. ***\r
6 \r
7  **Maple™**  is a commercial mathematics program similar to  **Mathematica®** . You must purchase this software from http://www.maplesoft.com/ and then register there for a license file. To install this software on DragonFly, please follow these simple steps.\r
8 \r
9  **Warning:** This description applies to FreeBSD, for which it was originally written. This may or may not apply to DragonFly at this point; while FreeBSD 4.x features usually translate over to DragonFly well, your mileage may vary.\r
10 \r
11   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`.\r
12   1. If you have not done so, order a license for  **Maple**  from Maple Waterloo Software (http://register.maplesoft.com/) and copy it to `/usr/local/maple/license/license.dat`.\r
13   1. Install the  **FLEXlm**  license manager by running the `INSTALL_LIC` install shell script that comes with  **Maple** . Specify the primary hostname for your machine for the license server.\r
14   1. Patch the `/usr/local/maple/bin/maple.system.type` file with the following:\r
15       \r
16          ----- snip ------------------\r
17     
18 *** maple.system.type.orig      Sun Jul  8 16:35:33 2001\r
19       --- maple.system.type   Sun Jul  8 16:35:51 2001\r
20     
21 ***************\r
22     
23 *** 72,77 ****\r
24       --- 72,78 ----\r
25                 # the IBM RS/6000 AIX case\r
26                 MAPLE_BIN="bin.IBM_RISC_UNIX"\r
27                 ;;\r
28       +     "DragonFly"|\\r
29             "Linux")\r
30                 # the Linux/x86 case\r
31               # We have two Linux implementations, one for Red Hat and\r
32          ----- snip end of patch -----\r
33   \r
34   Please note that after the `"DragonFly"|\` no other whitespace should be present.\r
35   This patch instructs  **Maple**  to recognize ***DragonFly*** 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.\r
36   1. Start the license server.\r
37   The following script, installed as `/usr/local/etc/rc.d/lmgrd.sh` is a convenient way to start up `lmgrd`:\r
38       \r
39          ----- snip ------------\r
40       #! /bin/sh\r
41       PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin\r
42       PATH=${PATH}:/usr/local/maple/bin:/usr/local/maple/FLEXlm/UNIX/LINUX\r
43       export PATH\r
44       LICENSE_FILE=/usr/local/maple/license/license.dat\r
45       LOG=/var/log/lmgrd.log\r
46       case "$1" in\r
47       start)\r
48         lmgrd -c ${LICENSE_FILE} 2>> ${LOG} 1>&2\r
49         echo -n " lmgrd"\r
50         ;;\r
51       stop)\r
52         lmgrd -c ${LICENSE_FILE} -x lmdown 2>> ${LOG} 1>&2\r
53         ;;\r
54     
55 *)\r
56         echo "Usage: `basename $0` {start|stop}" 1>&2\r
57         exit 64\r
58         ;;\r
59       esac\r
60       exit 0\r
61          ----- snip ------------\r
62   \r
63   1. Test-start  **Maple** :\r
64       \r
65       % cd /usr/local/maple/bin\r
66       % ./xmaple\r
67   \r
68   You should be up and running. Make sure to write Maplesoft to let them know you would like a native DragonFly version!\r
69 \r
70 ### 22.4.1 Common Pitfalls \r
71 \r
72
73 * 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/.\r
74
75 * `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:\r
76       \r
77       # ######################################################=\r
78       # License File for UNIX Installations ("Pointer File")\r
79       # ######################################################=\r
80       SERVER chillig ANY\r
81       #USE_SERVER\r
82       VENDOR maplelmg\r
83       FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \\r
84                PLATFORMS#i86_r ISSUER"Waterloo Maple Inc." \\r
85                ISSUED#11-may-2000 NOTICE" Technische Universitat Wien" \\r
86                SN=XXXXXXXXX\r
87   \r
88    **Note:** Serial number and key 'X***ed out. `chillig` is a hostname.\r
89   Editing the license file works as long as you do not touch the ***FEATURE*** line (which is protected by the license key).\r
90 \r
91 \r
92 \r
93 CategoryHandbook\r
94 CategoryHandbook-linuxcompatibility\r