Maple 6 Installation and Licensing Guide

Release 6.01

Waterloo Maple Inc.

This file explains how to install Maple 6, and how to set up the Maple license manager.

Installation Procedures

Licensing Procedures

Starting Maple

Appendix: System Requirements


Installation Procedures

The Maple 6 CD contains the files needed to install any version of Maple. The installation procedure is different for each operating system.

Windows Installation
Macintosh Installation
UNIX and Linux Installation

Windows Installation

Before you install Maple 6, do the following:

If an earlier version of Maple other than Maple 6 is on the computer, you do not have to uninstall it, but you should install Maple 6 in a different location than the older version of Maple.

The installation program differs depending on whether you have a single user or a network version of Maple 6 for Windows. The single user version of Maple 6 is intended for use on stand-alone machines or on machines where networking is not an issue. The installation program detects the specific Windows platform on the machine and installs the appropriate files. Note that the single user version can be set to Multiple User profile Mode. This enables two or more people to use the same installation of Maple on one computer and each have their own default settings. For installation information, see Windows Single User Installation.

The network version of Maple 6 for Windows is intended for use in a networking environment. Normally, the main copy of Maple 6 is installed on a server and includes files that are required for Windows 95, Windows 98, Windows NT, and Windows 2000. The server can have any of these versions, but Maple works best when served out on Windows NT or Windows 2000. The client installation is obtained from the server installation. It creates shortcuts on the clients pointing to the server, selecting the files that are appropriate for the client version. For installation information, see Windows Network Installation.

Windows Single User Installation

To install Maple 6 for Windows:

  1. Make sure that you have followed the preliminary steps described in Windows Installation.
  2. On the Maple 6 CD, locate and double-click the following file (where D is the drive that contains the Maple 6 CD-ROM): D:\Windows\SingleUser\Setup.exe.
  3. The installation program will be launched. Follow the on-screen instructions.

Maple 6 is installed. If you previously had a working version of Maple 6 installed and you replaced it with Maple 6.01 in the same location, you can start Maple and begin using it. If you installed Maple 6.01 to a different location than your previous installation of Maple 6, you must copy the License.dat file from the old License folder and into your new Maple License folder. If you did not have Maple 6 installed before, you must now install the license file, as described in Windows Single User Licensing.

Back to Installation Procedures; Top of Page

Windows Network Installation

The following are the instructions for the standard network installation, which installs Maple on a server that the client machines can access.

  1. Make sure that you have followed the preliminary steps described in Windows Installation.
  2. Select a writable share location on the server on which to install Maple 6.
  3. On the Maple 6 CD, locate and double-click the following file (where D is the drive that contains the Maple 6 CD-ROM): D:\Windows\Network\Setup.exe.
  4. The installation program is launched. Follow the on-screen instructions.
  5. When asked about user profiles, first select a Profile Setting. You would normally select Multiple User Profiles. This option allows each user to save Maple preferences separately.
  6. Next, in the same dialog box, specify a location in which to save those preferences. You must do this even if you have selected Single User Profile mode. Use a universal naming convention (UNC) directory location instead of a specific drive letter. (For example, if drive H: is mapped to a server named Server1, use \\Server1\Chem\Maple6\Users rather than H:\Chem\Maple6\Users.) You can call the folder anything (it does not have to be called Users), and the folder can be any shared, writable location.
  7. When asked about the location of your License Manager Server, enter a server name in a format that is acceptable to your network. It should be a server host name or an IP address. If you are installing Maple 6.01 over Maple 6, you can skip over the remaining installation steps, but you still have to restart the license server. For details, see Restarting License Daemons.
  8. Go to each client computer on the network. Start the client setup program by double-clicking the Setup.exe icon located in the Client folder within the server's Maple folder.
  9. Follow the on-screen instructions for the client setup. On the client side, the Program Folder you choose dictates where the program icons are placed on the client machine. The default is Maple 6.

You must now configure the license files and start the license manager daemons started, as described in Windows Network Licensing.

Back to Installation Procedures; Top of Page

Macintosh Installation

Before installing the Macintosh version, do the following.

The installation program is the same for both the single user version and the network version of Maple 6 for Macintosh, but the network version has a few extra steps.

Macintosh Single User Installation

To install a single user version of Maple 6 for Macintosh:

  1. Open the Maple 6 CD icon.
  2. Double-click the Maple 6 Installer icon.
  3. A splash screen is displayed. Click Continue.
  4. The Maple Read Me First! file is displayed. When you have finished with it, click Continue.
  5. In the Maple Installer dialog box, select the disk and folder in which to install Maple 6. (By default, the installer uses a folder named Maple 6 on your startup disk.) Click Install.
  6. Near the end of the installation process, the Maple 6 Install Options dialog box appears.
  1. At the final installation prompt, click Quit.
  2. If Apple OpenGL 1.1.2 is not already installed on your startup hard drive, the Apple OpenGL installer is launched automatically. Follow the on-screen instructions to install Apple OpenGL.
  3. Maple 6 is now installed. If you are upgrading from Maple 6 to Maple 6.01, copy the Maple 6 Sys Preferences, Maple 6 Preferences, and Maple 6 Init Preferences files from the Preferences folder in the System Folder to the Global Preferences folder in the installed Maple folder.

If you have not already done so, we recommend that you register the program. To do so, go to http://register.maplesoft.com. Follow the instructions on that Web site.

Back to Installation Procedures; Top of Page

Macintosh Network Installation

  1. On the network server, install Maple by completing the steps described in the previous section, Macintosh Single User Installation. Install in a location on the server that is consistent with other applications that are being shared. (For details, see your network administrator.)
  2. Each client machine must have Apple OpenGL. If any do not, you can install it from the Maple CD by opening the Macintosh folder on the CD icon and double-clicking Install OpenGL.

If you want, you can create an alias for Maple on the client machines.

Back to Installation Procedures; Top of Page

UNIX and Linux Installation

No special single user version of Maple exists for UNIX or Linux. The number of users is controlled by the license file.

Before installing Maple for UNIX or Linux, check the system requirements. If an earlier version of Maple 6 is already installed on the computer, we recommend that you stop the license manager daemons before installing Maple 6.01. If you choose not to, you may get some warnings during installation, or certain files that should be deleted will not be. To stop the license daemon, issue the following command in the Maple 6 flexLM directory for your platform. (This utility can also be found on the Maple 6 CD.)

lmdown -c network.lic

where network.lic is the network license file that Waterloo Maple Inc. sent you for the earlier release of Maple 6.

  1. Log on to the account that will own the Maple files. This is usually the root account.
  2. Run the Maple 6 INSTALL script, located on the Maple 6 CD in the UNIX directory. (In some cases, the script may be called install.) Follow the on-screen instructions.
  3. When asked in which directory to install Maple, 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.
  4. If you are installing Maple 6.01 over Maple 6, existing license files are found and preserved.
  5. You will be asked which platforms of UNIX or Linux you want to install. If you are installing onto a network server, install Maple for every platform on which it is to run.

When installation is complete, you may have to edit the scripts in the bin directory to configure Maple to run. For example, for some platforms, you may have to uncomment certain lines in the maple script. You also have to edit the script to enable the MATLAB link. The script contains comments to guide you.

If you installed Maple 6.01 over a working copy of Maple 6, you must now restart the license daemon, as described in UNIX and Linux Licensing. If you wrote a script to start the license daemon at boot time, you will probably have to modify the path to the license manager daemon. (For example, you may have to change flexLM to the now correct FLEXlm.) Then you can start Maple.

If you did not install Maple 6.01 over an earlier version of Maple 6, you now have to install and configure the Maple license manager, as described in UNIX and Linux Licensing.

Back to Installation Procedures; Top of Page


Licensing Procedures

Under Windows, UNIX, and Linux, the Maple 6 license manager must be installed and correctly configured before you can use Maple. (Maple 6 for Macintosh does not require a license manager.)

Windows Single User Licensing
Windows Network Licensing
UNIX and Linux Licensing

Windows Single User Licensing

If you have already obtained a license file called License.dat from Waterloo Maple Inc., copy that file into the License folder in your Maple folder. You can then start and use Maple 6.

If you do not have information from Waterloo Maple Inc. about your license file, go to http://register.maplesoft.com. Follow the instructions at that site. When you have the License.dat file, copy it into the License folder in your Maple folder.

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.

Back to Licensing Procedures; Top of Page

Windows Network Licensing

The FLEXlm/Windows directory in the installed Maple 6 folder and on the Maple 6 CD contains a directory for each platform. These directories contain license manager daemons (Lmgrd and Maplelmg) required to run Maple, as well as utilities to assist you in installing and configuring FLEXlm for your system.

You will require a network license file, called Network.lic by default. If you have already have information from Waterloo Maple Inc. about this license file, go to http://register.maplesoft.com. Follow the instructions at that site.

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.

When you receive the network license file, save it in a temporary, accessible location.

Then you must configure the license files on the Maple server.

  1. Make sure that you know the exact server name or IP address of the server on which you will run the Maple license manager. This should be the same name you supplied during the Maple installation, but the tool will allow you to specify a new one if needed.
  2. From the FLEXlm/Windows folder, start the Install Network License executable.
  3. In new license file field of the Maple Network License Installer dialog box, type or browse for the name and location of the network license file (by default, Network.lic) that you received from Waterloo Maple.
  4. If you entered a Server Name on installation, it appears in the Name field. You can use that, or type in a new name, or select IP Address and type that instead.
  5. In the Destination and name of license file field, type or browse for the location and file name to save the license file under. (We suggest FLEXlm/Network.lic in the Maple folder.) Click OK.

The network license file is copied to the specified location. It and the License.dat file in the License folder are configured with the appropriate server name.

Note: You can also use the Install Network License utility to change the name of your server (if, for example, you move Maple to a new server machine). In this case, the new license file and the Destination and name of license file would be the same. You can also use this utility to update your license file should Waterloo Maple Inc. send you a new one. In this case the new license file would be the new one that Waterloo Maple Inc. sends, and the Destination would be where the existing license file is located (both path and file name).

Next you must set up the license manager daemons as a service, and start them. To do this on a Windows server (if it is a Novell server, see notes below), you require the Lmtools executable, located in the FLEXlm/Windows folder in your installed Maple folder, as well as on the Maple 6 CD.

  1. If the FLEXlm/Windows folder is not already on the license manager server, copy it from the Maple folder or the Maple 6 CD.
  2. Start the Lmtools executable.
  3. In the Service/License file category, click Configuration using Services.
  4. Click the Configure Services tab.
    In the Configure Services property sheet:
  5. Type or Browse for the Path to the lmgrd.exe file and the Path to the license file (for example, FLEXlm/Network.lic).
  6. Though not required, we recommend that you use a log file for the debug information. In the Path to the debug log file field, type or Browse for its location, and type a file name.
  7. On Windows NT and Windows 2000, select the Use Services check box. This sets up the daemons as a service. (This option is not needed to start the daemons under Windows 95 and Windows 98, so it is not available for selection on those platforms.)
  8. If you want the daemons to start at boot time, select the Start Server at Power Up check box.
  9. Click Save Service. When prompted to save the servers, click Yes.
  10. Click the Start/Stop/Reread tab. In that property sheet, click Start Server. This starts the license manager daemons.

You can now start Maple.

Note: The licenses can be served from any supported platform on the network. If you will serve the licenses from UNIX, please see the UNIX section.

Restarting License Daemons

In some cases you may have to restart the license manager daemons.

This section explains how to restart the daemons.

  1. From the FLEXlm/Windows folder, start the Lmtools executable.
  2. Under the Service/License tab, click Configuration using Services.
  3. Click the Configure Services tab.
  4. Make sure that the Service Name is correct.
  5. If you had an earlier version of Maple 6 installed, the Path to the lmgrd.exe file shown by default may still point to the old location. In this case, update the Path to the new one.
  6. Click the Start/Stop/Read tab.
  7. Click Start Server.

The daemons are now restarted, and Maple 6 can be used.

Novell Networks

FLEXlm does not run on Novell or IPX/SPX. To get around this problem on any networks that are running exclusively in a Novell environment, you must do the following:

  1. Install TCP/IP on all client machines.
  2. Select a Windows computer that has TCP/IP installed to act as a license server, and run the license daemons on it.

Alternative Installation

The supported network installation has Maple installed on a server, with client machines accessing Maple through shortcuts. Activating Maple from a client machine loads the Maple executable into the memory of the client machine. Network speed is generally an issue only when functions are accessed for the first time in a given session.

Where network speed is a limiting factor, you may choose to install Maple on each computer in the network, and manage the license centrally through the license manager server. If you use this second approach, you should use the network installation on each client machine so that the User profiles are properly created. Supply the same server name for each client. Because this is not a usual installation, if you choose it, you then have to configure the license files by hand. Should you require more information and assistance, contact technical support. For contact information, see http://www.maplesoft.com/support/index.html.

Back to Licensing Procedures; Top of Page

UNIX and Linux Licensing

The FLEXlm directory in the installed Maple 6 directory, as well as on the Maple 6 CD, contains a directory for each platform. These directories contain daemons (lmgrd and maplelmg) that you require to run Maple, as well an INSTALL_LIC script to assist you in installing and configuring FLEXlm on UNIX for your system. If you want to serve licenses from Windows, please see Windows Network Licensing.

The license directory in your Maple 6 directory contains a license.dat file. You will require a network license file, called network.lic by default. If you do not already have information from Waterloo Maple Inc. about your license file, go to http://register.maplesoft.com. Follow the instructions at that site. (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.)

When you receive the network license file, save it in a temporary, accessible location.

Then, you must configure the license.dat and network license files on the Maple server.

  1. Run the INSTALL_LIC script, located on the Maple 6 CD in the UNIX directory.
  2. When prompted, enter the path to the network license file that you received from Waterloo Maple Inc. The default file name is network.lic, so if that is the name you saved the file under, it is sufficient to give the directory path. If you saved the license file under a different name, give the full path including the file name.
  3. When prompted, specify the directory in which to store the network license file. The default is /usr/local/maple/FLEXlm with the file name network.lic assumed; press Enter to accept the default.
  4. When prompted, enter the name or IP address of the license server.

The license files are then installed and configured.

Note: You can also use this script to change the name of your server (if, for example, you change the license server machine). In this case, you should answer each question by pointing to the same license file. You can also use it to update your license file should Waterloo Maple Inc. send you a new one. In this case the network license file would be the new one that Waterloo Maple Inc. sends, and the directory in which to store the file would be where the existing file is located (both path and file name).

Before Maple can be used, the license server must be started. (It is recommended that lmgrd not be run as root, since any process run by root is a potential security risk.) If you are running in the C shell, use the following command to start the license manager daemon (lmgrd):

% lmgrd_path -c license_file_path -l debug_log &

If you are using either the Korn or the Bourne shell, execute the following command:

$ nohup lmgrd_path -c license_file_path -l debug_log 2>&1 &

where

lmgrd_path is the full file name of lmgrd;
license_file_path is the full file name of the network license file (by default, /usr/local/maple/FLEXlm/network.lic); and
debug_log is the name of a file that debugging information will be written to. This command will create the file. This option used is the letter l, not the number 1.

To have the daemons run on startup, you can edit the appropriate boot script, which may be /etc/rc.boot, /etc/rc.local, /etc/rc2.d/Sxxxx, and so on. For example, if you run lmgrd as a boot startup script, you can run it as a regular user by using the su command:

su username -c 'umask 022; path/lmgrd -c path/license_file -l path/log'

where

username is a non-privileged user,
path is the correct path to lmgrd, network license file, and the debug log file, and
license_file is the network license file, which we recommend be called network.lic.

If you have any problems starting the license server in the UNIX system bootup files, refer to the GLOBEtrotter FAQs at http://www.globetrotter.com/flxlmfaq/TOC.htm.

Back to Licensing Procedures; Top of Page


Starting Maple

"Standard" Maple is a version of Maple with a graphical user interface. The first standard Maple session opens with an introductory page that directs you to new features, updates, and example worksheets. Subsequent Maple 6 sessions start with a new, blank worksheet.

To start Maple 6 for Windows in standard mode:

To start Maple 6 for Macintosh in standard mode:

  1. Double-click the Maple 6 application icon on the Macintosh hard drive.
  2. If requested, type in your User ID and click Log On. If you have entered a new ID, you will have to confirm its creation.

To start Maple 6 for UNIX or Linux in standard mode:

You can also use Command Line Maple. For more information, see the text file cmdline.txt or Command Line Readme, located in your Maple folder.

Maple can also be run in parallel server mode, in which each worksheet is an independent session. For more information, see the help page ?worksheet,managing,configuring (Advanced Features, configure Maple in the Help Browser).

On Windows, Maple 6 has an add-in to Microsoft Excel 2000. For more information, see the text file excel.txt, located in your Maple folder.

Top of Page


Appendix: System Requirements

Before installing Maple 6, ensure that your computer fulfills the minimum systems requirements for your operating system.

Windows System Requirements
Macintosh System Requirements
UNIX and Linux System Requirements

Windows System Requirements

Back to Windows installation; Top of Page

Macintosh System Requirements

Back to Macintosh installation; Top of Page

UNIX and Linux System Requirements

Vendor Hardware Platform RAM Disk space
Sun SPARC or Intel-based Pentium 90 or better Solaris 2.6 or 7 32 MB 75 MB
HP HP/9000; any PA-RISC processor HP-UX 10.20 32 MB 75 MB
SGI R4000+; any processor SGI IRIX 6.5 32 MB 80 MB
IBM any RS/6000 processors AIX 4.3 32 MB 80 MB
DEC any Alpha AXP processors Digital UNIX 4.0E or Compaq True 64 (4.0F) 64 MB 70 MB
Red Hat Intel-based Pentium 90 or better Linux 2.2 kernel Red Hat 6.0 or 6.1 distribution 32 MB 75 MB
SuSE Intel-based Pentium 90 or better Linux 2.2 kernel SuSE 6.1 or 6.2 distribution 32 MB 75 MB

Back to UNIX and Linux Installation; Top of Page

Note: Maple uses GLOBEtrotter Software Inc.'s FLEXlm as its license manager. This document contains all of the information you require for a standard Maple installation, but for more information you can refer to GLOBEtrotter's documentation at http://www.globetrotter.com/TOC.htm.

MAPLE and MAPLE V are registered trademarks of Waterloo Maple Inc.
WATERLOO MAPLE is a trademark of Waterloo Maple Inc.
Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation.
Apple, Mac, Macintosh, Power Macintosh, and Power Mac are registered trademarks of Apple Computer Inc.
UNIX is a registered trademark of X/Open Company, Ltd.
OpenGL is a registered trademark of Silicon Graphics Inc.
MATLAB is a registered trademark of The MathWorks, Inc.
FLEXlm is a registered trademark of GLOBEtrotter Software, Inc.
All other brand names or product names are trademarks or registered trademarks of their respective companies.