Maple 6 UNIX version Read Me This file describes the following topics: System Requirements Installation Instructions License and Registration Contents of the Maple Directory Command Line Maple MATLAB Link Notes System Requirements ------------------- Before beginning the installation of Maple 6, check that your computer fulfills the minimum requirements. A CD-ROM drive is also required on all platforms. SunSPARC * Any SPARC processors * 75 MB free hard disk space * 32 MB available RAM * Solaris 2.6 or 7 Solaris on x86 * Intel-based Pentium 90 * 75 MB free hard disk space * 32 MB available RAM * Solaris 2.6 or 7 SGI R4000+ * Any processors * 80 MB free hard disk space * 32 MB available RAM * SGI IRIX 6.5 HP/9000 * Any PA-RISC processors * 75 MB free hard disk space * 32 MB available RAM * HP-UX 10.20 IBM RS/6000 * Any RS/6000 processors * 80 MB free hard disk space * 32 MB available RAM * AIX 4.3 DEC Alpha * Any Alpha AXP processors * 70 MB free hard disk space * 64 MB available RAM * Digital UNIX 4.0E or Compaq True 64 (4.0F) Linux on x86 * Intel-based Pentium 90 * 75 MB free disk space * 32 MB available RAM * Linux 2.2 kernel, RedHat 6.0 or 6.1, or SuSE 6.1 or 6.2 distribution When using the X11/Motif graphical interface from an X terminal, we recommend a device capable of supporting at least 8-bit pseudo-color at 640x480 resolution. Installation Instructions ------------------------- For more information, please refer to the printed Maple Installation Guide. 1. Log on to the account that will own the Maple files. This is usually the root account. 2. Maple 6 is distributed on a CD. In a temporary directory, extract the Maple setup from the CD. tar -xvf /cdrom/maple.$SYS.tar where cdrom reflects the file system on which your CD-ROM drive is mounted, and $SYS is your UNIX or Linux platform (such as DECUNIX). You will end up with two files: INSTALL and setup.tar. 3. Run the INSTALL shell script, and follow the on-screen instructions. 4. When asked in which directory you want to install, select a directory to which you have write access. If you are creating a new directory, make sure that you have write access to the parent directory. By default, Maple installs into /usr/local/maple. License and Registration ------------------------ FLEXlm 7.0 is used as Maple's License Manager. For complete information on how to set it up, please refer to the FLEXlm End User Manual that is located in the FLEXlm directory within your Maple 6 installed directory. (A more searchable version of this Manual is available at http://www.globetrotter.com/TOC.htm.) Some recommendations and instructions are provided in this section. The license directory under the installed Maple directory includes a file called license.dat. You also need a network license file (whose name is customizable). If you have already received the network license file, we recommend that you copy it into the FLEXlm directory under the Maple directory. If you have not already received the network license file, go to http://register.maplesoft.com and follow the instructions there. Shortly thereafter, you will receive a network license file by e-mail. (Alternatively, you can go directly to that Web site by starting Maple and clicking Register in the dialog box that appears.) If you do not have access to the Internet or to e-mail, call Waterloo Maple at 519-747-2373, and ask for License File Registration. You will have to open both of the license files (license.dat and the network license file) and make sure that the SERVER line in each matches (and is correct). Both license files contain comments to assist you in this, and the FLEXlm End User Manual also provides more information. The FLEXlm directory on the Maple 6 CD contains a different directory for each platform. These directories contain daemons (lmgrd.exe and maplelmg.exe) that you need to run Maple, as well as a utility (lmutil.exe) that assists you in configuring FLEXlm for your system. We recommend that you copy these files into the FLEXlm directory under the installed Maple directory. A Maple 6 Startup dialog box appears whenever the license files are not properly configured (and when other startup problems occur). In that dialog box, click "Details" to get more information. Refer to the FLEXlm End User Manual for full license file information. Contents of the Maple Directory ------------------------------- The installation procedure requires 70 to 80 MB of disk space (depending on your UNIX platform) and, by default, places the Maple 6 files in /usr/local/maple. In this directory, you should see the following files and directories: readme.txt This file cmdline.txt A description of Command Line Maple latex.txt Information about formatting and printing Maple worksheets as LaTeX mint.txt Description of the Mint Maple syntax checker updtsrc.txt Information on updating source code to Maple 6 afm Directory that contains font information bin.$SYS Directory that contains the Maple system files (where $SYS is your UNIX or Linux operating system) etc Directory that includes the style files for LaTeX FLEXlm Directory that contains the FLEXlm End User Manual lib Directory that contains the Maple 6 library files license Directory that contains a Maple license file man Directory that contains man pages samples Directory that contains sample code for use with Chapter 6 of the Programming Guide, which deals with modules. scripts Directory that contains the Maple binaries test Directory that contains files for testing the installation X11_defaults Settings for X terminals Command Line Maple ------------------ Maple 6 provides a command line interface. This is a small, efficient interface to the full Maple mathematical engine. It is particularly useful when tackling large problems on slower computers or on computers with limited memory. On any UNIX or Linux platform, Command Line Maple can be accessed by going to the bin directory underneath your chosen Maple install directory. At the prompt, type "maple" to run the Maple shell script. More information about the command line interface is available in the text file cmdline.txt. If you have any problems starting Command Line Maple, run the regular worksheet version of Maple, and read the information in the Maple 6 Startup dialog box to find out what the problem is. MATLAB Link ----------- For information on how to link Maple to MATLAB, refer to the ?Matlab,setup help page. Note that the Maple-MATLAB link is not supported on Linux nor on Solaris x86. Notes ----- Tips for Efficient Use on Machines with Less Memory * Avoid turning on the "use scalable fonts" option. This option is turned off by default, but it can be turned on with the "Maple6.AllowFontScaling" resource. When the option is off, Maple performs faster, but does not allow zooming on worksheets. See the note about scalable fonts under "General Problems". General Problems * When you open a worksheet that contains code that was written in Release 5.x of Maple, the built-in updtsrc feature updates the code for use in Maple 6. The worksheet is parsed one statement at a time. Each statement is syntactically checked before any updating is done, and any lines that are syntactically wrong are not converted. To get around this problem, run the worksheet through the standalone updtsrc utility. For more information about that utility, see the updtsrc.txt file. * If the context-sensitive menu plot command is used to create a smartplot (see ?smartplot) on a display with fewer than 16 colors, an error message appears. Functions can still be constructed by using the plot and plot3d commands. See ?plot or ?plot3d for a list of the command syntax and options. * Under some window managers, the palettes may disappear under the main application window. If this occurs, set "Palettes Stick To Glass=true" in the "[Palettes]" section of the .xmaple6rc file in the user's home directory. * In dialog boxes for some window managers, the drop-down menu that lists files disappears when you move the mouse onto the list. To correct the problem, set the X11 resource "Maple6.*.twmHandlingOn:" to "True" in your X11 defaults file. * The cursor may not display properly when you switch the focus to the Maple GUI window by clicking in window manager programs that pass the click event on to the application program. Mwm users can avoid this by setting the "Mwm*passSelectButton" resource option to "False". * When you open more than one worksheet, the "Page Up" and "Page Down" keys sometimes still controls the worksheet that was previously in focus. Click in the new worksheet window to ensure that the focus has been properly transferred. * An "illegal mnemonic" message indicates a server-dependent problem. It does not affect your work in Maple. For example, X Toolkit Warning: Name: menuitem Class: XmToggleButtonGadget Illegal mnemonic character; Could not convert X KEYSYM to a keycode * Modeless dialog boxes are not decorated by some window managers, thus they cannot be moved without using the window manager's main menu. Some window managers have a resource setting like "decorateTransients" that can be used to provide decorations on these dialog boxes. * Plots and three-dimensional animations are heavy users of X server pixmap resources. Closing worksheets with many plots can reduce the server's memory load. * When "scalable fonts" is turned off, you may notice that text does not increase in size when worksheets are magnified above 200%. By turning scalable fonts on, the fonts are slower and look poor, but magnification to 300% and 400% is possible. SGI-specific Problems Closing the Styles dialog box by clicking Done may crash the application if you are using the twm window manager. HP-specific Problems * If you see these messages on startup: /usr/lib/dld.sl: Unresolved symbol: $global$ (data) from /usr/lib/libCsup.1 /usr/lib/dld.sl: Unresolved symbol: __dld_list (data) from /usr/lib/libCsup.1 /usr/lib/dld.sl: Unresolved module for symbol: __shlinit (code) from /usr/lib/libCsup.1 then you have to install a patch from Hewlett-Packard to update your runtime libraries to version A.01.21. The patch is PHSS_17872. For more information, see http://www.hp.com/esy/lang/cpp/rels.html#10x. * Menu bar colors are sometimes not set properly for the window manager in use. Linux-specific Problems On some versions of Linux, xmaple crashes if the display is set by using the command "xmaple -display :0.0". If this occurs, use the IP number instead of the hostname; for example, "xmaple -display :0.0". For further assistance, please contact your Maple Technical Support Representative. Type "?support,technical" at the Maple prompt for contact information.