This guide is an evolving document. Please help make it better. If you have any additions, suggestions or corrections, please mail me.
The installation of maple can be frustrating, especially on a unix machine. This document is an attempt to make it a bit easier.
This document is not a "complete" anything. It will not tell you, step by painful step, how to click the continue button. Nor will it cover most things that are listed in the Maple Installation and Licensing Guide. (See the wonderfully terse Install.html on the cdrom plus any *.txt files in the various installation directories for those bits). This document will cover the small number of installations I performed and will hint on how to do others. The unix section is far and away the most detailed.
I'm willing to assist people at CSU who are having installation problems, but my current obligations already far surpass my current time constraints. If you are having problems, please mail me with as much relevant detail as possible (platform, what things you tried (in detail!), any error messages (verbatim), etc.) and please be patient. Requests for help in the next 5 minutes because you absolutely, positively need to have maple up and running will be cheerfully ignored.
Maple is licensed by CSU for CSU machines only. Only departments that contributed to the Happy Maple License Pot (tm) for this year are permitted to use the software. Please contact Diane Noren at Ramtech if you wish to use Maple at CSU.
Faculty and staff from departments that contributed have home-use rights (that is, they may install and use Maple on their home computers for the duration of their employment) but students, alas, do not. Maplesoft does offer a student version of Maple, which is identical to the non-student version. The limitations are that the student version "is to be used for personal study/homework purposes only, and not for any kind of teaching, tutoring, or for-profit activities." Please contact Maplesoft or Diane Noren at Ramtech for pricing.
Maple 13 for Windows, Mac OSX, Linux and Solaris is available from RamTech. One DVD contains all OS versions.
The system requirements for Maple 13 are here.
Sadly, Maple (since version 10) requires activation. If you cannot activate the program, it will not run. At the end of the Maple install, the program will ask you if you wish to activate. It will also ask for a first and last name and an email address, although those fields don't seem to matter.
If the machine you are installing Maple 13 on is not connected to the net, you can go to the Maple Offline Activation Page on another computer and fill in the bits and (hopefully) they will send you what you need via email. It's much easier to be connected though, as there is usually no fuss.
For those of you who think this silliness isn't worth it, see The Comprehensive R Archive Network for R, an S-plus like program that is nicely Gnu-ed.
There are three different activation numbers: one for CSU single-user use, one for CSU network use and one for home use. Please make sure you use the correct one when going through the activation silliness.
There isn't much to the Mac install. Insert the cdrom, click on the Maple installer and off you go (after typing in the Administrator password). When the installer is finished, it will ask for the activation code, name, email address and country. The activation code matters, the other fields do not.
If d: is your cdrom drive, the setup program is in d:\Windows\Disk1\InstData\VM and is called Maple13WindowsInstaller.exe. There is also a d:\Windows64 directory for 64-bit Windows installs. However, the program will autorun if your machine is configured to do so. It sometimes takes a bit of time to start on some machines, so please be patient. There is a readme file and an Install.html file in the d:\windows directory if you are interested in details.
The install is mostly follow-your-nose, but you have two choices to make.
First, do you want a full, minimal or custom install? Full is Maple + the Watcom C compiler, minimal is Maple without the compiler and custom allows the choice of either of these, along with the bizarre choice of installing just the Watcom C compiler. Most users will probably choose minimal, although the Watcom C compiler is necessary if you wish to use the Maple Compiler.
Second, do you want a single-user or network license? Unless you will be setting up a license server somewhere, you'll probably choose a single-user license.
Finally, you get to activate the silly thing and type in your first and last name, an email address and select your country. The activation code matters, the rest do not. After a reboot, you should be good to go.
There are two interfaces to maple that are installed. One is called "standard", uses java and is more memory intensive, the other is called "classic worksheet" and should be more familiar to users of previous versions. Please run ?compatibility after running maple for the first time to see the differences and to learn about all the bad things that can happen if you use the standard interface and then switch to classic.
For Maple 13, the install no longer drops an icon for Classic Worksheet on the desktop. Get to it from the Start Menu or create an icon that points to c:\Program Files\Maple 13\bin.win\cwmaple.exe.
This installation is a hybrid of the PC and unix installations. It is a unix installation in that you must mount the cdrom (see the unix section), cd to wherever you mounted it and and then run:
Like the windows version, maple and xmaple come in two flavors: standard and classic. standard uses java and is more memory intensive, "classic worksheet" should be more familiar to users of previous versions. Please run ?compatibility after running maple for the first time to see the differences and to learn about all the bad things that can happen if you use the standard interface and then switch to classic. Starting maple or xmaple will bring up the standard interface, starting either with the -cw option will bring up the classic interface.
The unix installation isn't terribly hard, but it can be tricky and vexing when compared to the windows and mac installations. Keep in mind that there are really two sets of programs that get installed:
For the first network installation and for all standalone installations, you need both sets of programs. When maple is invoked, it needs to query a license server to check out a license before it runs, so you must have a license server running for maple to work. Once you have a working license server, all other network installations can simply query the working one.
Two notes: the way I did this does not necessarily follow the Maple Guide. Caveat Installer. Also, it assumes you have root on the machine.
Here's how I set up my machine. Typed commands are in bold.
This can be more daunting than it sounds. Some unix machines have an automount feature, in which case it will be automatically mounted in /mnt/cdrom, /CDROM, /cdrom or similar. Otherwise, you'll have to determine the syntax yourself (On Solaris, cfgadm -a may give you a hint.) Here are a couple that work for me:
linux: mount -o ro -t iso9660 /dev/cdrom /mnt/cdrom
solaris: mount -o ro -F hsfs /dev/dsk/c1t2d0s0 /mnt
This starts up a java-interface thingee that looks a lot like the installation bits for windows. This means you will need to have some sort of X-windows bits running to install it. Oh boy!
For the record, you can also add -i console to get a command line version of the install.
The install script will ask where you want the install to go (/usr/local/maple13, as above, for example). The next choice is "Single User" or "Network" License. Choose Network, but leave the license server bit blank or now; we'll clean up things later. Click next and wait a bit.
Now we have a Maple installation, but no license server as yet. Go back to your mount point:
and run one of the following:
Next, the installer will ask where you want to install the "Maple Network Tools." I like /usr/local/maple13/flexlm, so that's where I put it.
Now, a bit of ownership and permission cleanup:
This is to make sure that all of the files are owned by root. Nothing is setuid, so no worries. You may also want to do:
to clean up the permissions.
Next, you need to make a dummy account to run the license manager under. flexlm has had security holes in the past, so if you choose to ignore this advice, you do so at your own risk. I've called my user "maple" with * as the encrypted password (i.e. no password will ever work) and /usr/local/bin/tcsh as the shell. Salt to taste.
Now we are back to the making-puppies-cry problem of activation. You must activate maple to get the maple13.lic file you need to run the license daemon.
It will then ask for some info.
Play the next bit straight. Put in genuine values for First Name, Last Name, Email address and Country, but you may wish to uncheck the bits that will cause Maplesoft to periodically send you html-laden email. Finally, choose the number of licenses you need. 25 is probably more than enough for all but the largest departments. (Please don't use all the licenses; my guess is that the first clown that isn't careful will make all future activation attempts futile.) Finally, click Next. When you are done, you will have a Maple13.lic file.
I prefer to keep the license file in the FLEXlm directory, so:
Next, make maple the owner of the file.
Next create a log file, again owned by maple:
Next, put the following in /etc/rc3.d/S99local (solaris), /etc/rc.d/rc.local (linux) or in any file that gets executed on bootup:
# # Maple 13 license daemon # if [ -f /usr/local/maple13/flexlm/FLEXlm/lmgrd ]; then /bin/su maple -c '/usr/local/maple13/flexlm/FLEXlm/lmgrd -c /usr/local/maple13/flexlm/FLEXlm/Maple13.lic -l /var/log/maple13.log' fiSadly, this doesn't work on Solaris 9 and perhaps 10. You'll see idiot error messages like this in the log file:
14:25:02 (maplelmg) Vendor daemon can't talk to lmgrd (Cannot read data from license server (-16,287:22 "Invalid argument")) 14:25:02 (lmgrd) Vendor daemon died with status 39 14:25:02 (lmgrd) Since this is an unknown status, lmgrd willSo, instead, use this:
# # Maple 13 license daemon # if [ -f /usr/local/etc/maple.startup ]; then /usr/local/etc/maple.startup fiwith /usr/local/etc/maple.startup containing this:
#!/bin/sh ulimit -n 1024 ulimit -H -n 1024 if [ -f /usr/local/maple13/flexlm/FLEXlm/lmgrd ]; then /bin/su maple -c '/usr/local/maple13/flexlm/FLEXlm/lmgrd -c /usr/local/maple13/flexlm/FLEXlm/Maple13.lic -l /var/log/maple13.log' fi
At this point, you can either reboot the machine (bad) or simply run the above command as root (better). If all goes well, you'll see an lmgrd and an maplelmg, both running as user maple if you look at the process list.
We're in the home stretch now. Assume that your machine is called unixbox and that "unixbox" is the machine that the license server daemon is running on. Remove all the lines in /usr/local/maple13/license/license.dat and replace them with:
SERVER IP-address-of-unixbox ANY USE_SERVER
That's it. When you now run /usr/local/maple13/bin/maple or /usr/local/maple13/bin/xmaple, it should start up and life should be happy. After you get the maple license manager working on unixbox, all other maple installations do not need any flexlm configuration; perform the install, skip all the flexlm stuff, edit the license.dat to point to the license server (unixbox) and Bob's your Uncle.
I have not tried to set up the FLEXlm server stuff on a PC, although I'm sure it's possible and it's probably easier than the unix/mac version. It appears to work in a similar fashion to the unix install: the network installation code is used for activation on the server and then the clients look at the server to pull licenses. No activation is needed on the clients.