Maple 8 Installation and Licensing Guide

Release 8, Waterloo Maple Inc.

Select the appropriate installation:

After installing Maple, review the following information:

For a complete list of system requirements, see:



Windows Single User Installation

During the installation, you will need your serial number (located on the license envelope or CD jewel case).

To install Maple 8 on your Windows operating systems, read and complete the following tasks:

Pre-installation Instructions

  1. Close all programs, particularly Excel and any previous release of Maple.
  2. On Windows 2000, Windows NT, and Windows XP Professional, log on as administrator or have administrator privileges.

Install Maple

  1. Ensure that you have reviewed the pre-installation instructions.
  2. Place the Maple 8 CD into the CD-ROM drive. If the installation program automatically starts, go to step 4.
  3. On the Maple 8 CD, locate and double-click D:\Windows\Windows\WindowsSetup.exe (where D is the CD-ROM drive that contains the Maple 8 CD).
  4. Follow the on-screen instructions.

You are ready to use Maple 8.
Register the program by visiting http://register.maplesoft.com.

Return to the Top of the Document.


Linux Single User Installation

During the installation, you will need your serial number (located on the license envelope or CD jewel case).

To install Maple 8 on your Linux operating systems, read and complete the following tasks:

Pre-installation Instructions

  1. Check the Linux Single User System Requirements.
  2. Make sure you have appropriate read and write privileges.
  3. Log on to the account that will own the Maple files. This is usually the root account.

Install Maple

  1. Ensure that you have reviewed the pre-installation instructions.
  2. Run the installMapleLinuxSU, located on the Maple 8 CD.
  3. Follow the on-screen instructions.
  4. When asked in which directory to install Maple, select a directory for 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 in /usr/local/maple8, where local is the user's home directory.

You are ready to use Maple 8.
Register the program by visiting http://register.maplesoft.com.

Return to the Top of the Document.


Windows Network Installation

To install Maple 8 on your Windows Network operating systems, read and complete the following tasks:

If necessary, review Alternative Installation.

Pre-installation Instructions

  1. Close all programs, particularly Excel and any previous release of Maple.
  2. On Windows 2000, Windows NT, and Windows XP Professional, log on as administrator or have administrator privileges.

Install the Windows Network Version

  1. Ensure that you have reviewed the pre-installation instructions.
  2. Place the Maple 8 CD into the CD-ROM drive. If the installation program automatically starts, go to step 4.
  3. On the Maple 8 CD, locate and double-click D:\Windows\Windows\WindowsSetup.exe (where D is the CD-ROM drive that contains the Maple 8 CD). Important: The user profile directory must be located in a shared, writeable location on the server.
  4. Follow the on-screen instructions.
  5. Once Maple 8 is installed successfully on the server, repeat steps 6 to 8 as required.
  6. Go to each client computer on the network.
  7. Navigate to the server where you installed Maple 8.
  8. To start the client setup program, locate and double-click Maple 8\Client\WinClientSetup.exe. Maple 8 is installed.

Select Network Licensing

If the license server is to be run in Windows, follow the instructions in:

If the license server is to be run in UNIX or Linux, follow the instructions in:

Windows Network Licensing

Select one of the licensing schemes:

Maple 8 Only

The FLEXlm/Windows directory, installed in the Maple 8 folder and on the Maple 8 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.

Requirements
You will require a network license file, called maple8.lic by default. If you already have information from Waterloo Maple about this license file, visit http://register.maplesoft.com and follow the instructions. Waterloo Maple will email the license file. If you do not have access to the Internet or email, contact your Waterloo Maple sales representative at 1.800. 267. 6583. When you receive the network license file, save it in a temporary, accessible location.

Complete the following tasks:

Task 1: Configure the License Files

To configure the license files on a Windows Network Server:

  1. From the FLEXlm/Windows folder, double-click Network_License_Installer.exe.
  2. In the new license file field of the Maple Network License Installer dialog box, enter or browse for the name and location of the network license file (by default, maple8.lic) that you received from Waterloo Maple Inc.
  3. If you entered a Server Name on installation, it appears in the Name field. You can use that name, enter a new name, or provide an IP Address.
  4. In the Destination and name of license file field, enter or browse for the location and filename under which to save the license file. (C:\Program Files\Maple 8\FLEXlm\Windows\maple8.lic is recommended).
  5. Click OK.

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

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

Task 2: Start the License Manager Daemons

If you intend to use a Novell server, see Novell Networks.

Requirements
For the following instructions, you require the lmtools executable, located in the FLEXlm/Windows folder in your Maple folder. If the FLEXlm/Windows folder is not already on the license manager server, copy it from the Maple folder or the Maple 8 CD.

To set up and start the license manager daemons on a Windows Network Server:

  1. Double-click lmtools.exe.
  2. Under the Service/License File tab, click Configuration using Services.
  3. Click the Configure Services tab.
  4. In the Configure Services property sheet, enter or browse for the Path to the lmgrd.exe file and the Path to the license file (for example, C:\Program Files\Maple 8\FLEXlm\Windows\maple8.lic). If you had a previous version of Maple installed, the default may still point to the old location.
  5. Though not required, we recommend that you use a log file for the debug information. In the Path to the debug log file field, enter or browse for its location and enter a filename. (We suggest C:\Program Files\Maple 8\FLEXlm\Windows)
  6. For Windows NT and Windows 2000, select the Use Services check box to set up the daemons as a service. (This option is not needed to start the daemons under Windows 95, Windows 98, or Windows ME so it is not available for selection on those platforms.)
  7. If you want the daemons to start at boot time, select the Start Server at Power Up check box.
  8. Click Save Service. When prompted to save the service, click Yes.
  9. Click the Start/Stop/Reread tab. In that property sheet, click Start Server to start the license manager daemons.

You can now use Maple 8.
Return to the Top of the Document.

Windows Network Licensing Maple 8 and Previous Versions of Maple

To run previous releases of Maple and Maple 8, you must put all the license files in the same directory as the Maple 8 license file. (Or, if you have other license files stored in one central location, you can store the Maple 6, 7, and 8 license files there as well.) Follow these instructions for Windows Network Licensing for Maple 8 and Previous Versions of Maple. Note: This does not apply to releases prior to Maple 6.

Complete the following tasks:

Task 1: Stop the License Manager

  1. Go to the directory where the FLEXlm Daemons are being run.
  2. Double-click lmtools.exe.
  3. Under the Service/License File tab, click Configuration using Services.
  4. Click the Configure Services tab. From the Server Name list, select the service currently being used.
  5. Click the Start/Stop/Read tab, then click Stop Server.

Task 2: Move all Maple License Files to a Common Directory

  1. Go to the location of the FLEXlm utilities for Maple 8. For Maple 8, the default location is C:\Program Files\Maple 8\FLEXlm\Windows.
  2. Double-click Network_License_Installer.exe.
  3. In the New license file sent by Waterloo Maple Inc section, enter the path to the network license file or browse to the location. For Maple 8, the default location is C:\Program Files\Maple 8\FLEXlm\maple8.lic.
  4. In the Server Information section, enter the host name of the license server or select IP Address and enter the IP address of the license server.
  5. In the Destination and name of license file section, enter the path where all the Maple license files are to be located. The default is C:\Program Files\Maple 8\FLEXlm\Windows\maple8.lic.
  6. Click OK.
  7. Repeat steps 1 to 6 for all Maple network license files you have.

Task 3: Start the License Manager Daemons

  1. Go to C:\Program Files\Maple 8\FLEXlm\Windows. Double-click lmtools.exe.
  2. Under the Service/License File tab, click Configuration using Services.
  3. Click the Configure Services tab.
  4. In the Configure Services property sheet, enter or browse for the Path to the lmgrd.exe file. The default location is C:\Program Files\Maple 8\FLEXlm\Windows\lmgrd.exe.
  5. Enter the path to the directory containing all Maple license files. The default location is C:\Program Files\Maple 8\FLEXlm\Windows.
    Note:
    Point to the directory only, not an actual license file.
  6. Though not required, it is recommended that you use a log file for the debug information. In the Path to the debug log file field, enter or browse for its location and enter a filename. (A suggested filename is  C:\Program Files\Maple 8\FLEXlm\Windows)
  7. For Windows NT, Windows 2000, and Windows XP Professional, select the Use Services check box to set up the daemons as a service. (This option is not required to start the daemons under Windows 95, Windows 98, Windows ME, or Windows XP Home.)
  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 service, click Yes.
  10. Select the Start/Stop/Reread tab, click Start Server to start the license manager daemons.

You can now use Maple 8 and previous versions of Maple.
Return to the Top of the Document

Novell Networks

FLEXlm does not run on Novell or IPX/SPX. Follow these instructions to install the license manager on any network that is exclusively a Novell environment.
  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 approach, you should use the Windows Network Licensing on each client machine so that the user profiles are created properly. Use the same server name for each client. This installation is not standard, if you choose it, you have to configure the license files manually. For more information and assistance, contact technical support at support@maplesoft.com.

Return to the Top of the Document.


UNIX and Linux Network Installation

To install Maple 8 on your Windows Network operating systems, read and complete the following tasks:

Pre-installation Instructions

  1. Make sure you have appropriate read and write privileges.
  2. Make sure that your system recognizes Rock Ridge extensions.
  3. If you are installing Maple for the first time, go to UNIX Installation and Linux Multi-user Installation. Otherwise, proceed to Stop the License Manager Daemons.

Stop the License Manager Daemons

Important: If this is a first time installation, proceed to UNIX Installation and Linux Multi-user Installation.
  1. Change directory to where the license manager is currently running.
  2. At the prompt, enter lmdown_path -c /network.lic_path where lmdown_path is the full path and filename to the FLEXlm utility called lmdown and network.lic_path is the full path and filename to the network.lic license file that is being used.
  3. If the network.lic license file and Maple were installed in the default locations, the license file will be located in the /usr/local/maple/FLEXlm directory.

Install the UNIX and Linux Multi-user Version

  1. Log on to the account that will own the Maple files. This is usually the root account.
  2. Mount the Maple 8 CD-ROM.
  3. Run installMaple from the root directory of the CD.
  4. Follow the on-screen instructions. Maple 8 is installed.

Select Network Licensing

If the license server is to be run in UNIX or Linux, follow the instructions in:

If the license server is to be run in Windows, follow the instructions in:

Important: When the installation is complete, review the scripts in the bin directory and edit where necessary to configure Maple. For example, you must edit the script to enable the MATLAB link. The scripts contain comments to guide you.

UNIX and Linux Network Licensing

Select one of the licensing schemes:

Maple 8 Only

Complete the following tasks:

Task 1: Install the License File

The licenses can be served from any supported platform on the network. If you intend to serve licenses from Windows, see Windows Network Licensing.

Requirements
You will require a network license file, called maple8.lic by default. If you already have information from Waterloo Maple about this license file, visit http://register.maplesoft.com and follow the instructions. Waterloo Maple will email the license file. If you do not have access to the Internet or to email, contact your Waterloo Maple sales representative at 1. 800. 2670. 6583. When you receive the network license file, save it in a temporary, accessible location.

To configure the license file:
  1. From the FLEXlm\UNIX directory, run the INSTALL_LIC script.
  2. Follow the on-screen instructions

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

Task 2: Start the License Manager Daemons

Before you can use Maple 8, you must start the license server.  It is recommended that you do not run lmgrd as root since any process run by root is a potential security risk.

Using the C Shell
If you are running in the C shell, enter the following command at the prompt to start the license manager daemon (lmgrd):

lmgrd_path -c license_file_path -l debug_log &



where lmgrd_path is the full filename and path of lmgrd; license_file_path is the full filename and path of the network license file (by default, /usr/local/maple/FLEXlm/maple8.lic); and debug_log is the name of a file to which debugging information is written. This command creates the file. The option used is the letter l, not the number 1 (one).

Running the License Manager
If Maple was installed in the default location and you are running the license manager on a Linux system, enter the following command at the prompt to start the license manager daemon:

/usr/local/maple/FLEXlm/UNIX/LINUX/lmgrd -c /usr/local/maple/FLEXlm/maple8.lic -l /usr/local/maple/FLEXlm/logfile 

Using the Korn or Bourne Shell
If you are using either the Korn or Bourne shell, enter the following command at the prompt:

nohup lmgrd_path -c license_file_path -l debug_log 2>&1 &
Daemons Run on Startup
To have the daemons run on startup, edit the appropriate boot script (such as /etc/rc.boot, /etc/rc.local, or /etc/rc2.d/Sxxxx). For example, if you run lmgrd as a boot startup script, you can run it as a regular user by using the following su command at the prompt:

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

where username is a nonprivileged user; path is the correct path to lmgrd, network license file, and the debug log file; and license_file is the network license file. It is recommended that the network license file be called maple8.lic.

Help For Starting License Server
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.

You can now use Maple 8.
Return to the Top of the Document

Maple 8 and Previous Versions of Maple

Complete the following tasks:

Task 1: Stop the License Manager

  1. Go to the location of FLEXlm utilities that are currently being used. For Maple 8, the default location is /usr/local/maple8/FLEXlm/UNIX/Platform where Platform is the platform running the license manager.
  2. Enter the command ./lmdown –c /Path_to_network.lic where Path_to_network.lic is the full path and filename for the network license file.

Task 2: Move and Rename Previous Maple License Files

    1. Go to the location of FLEXlm utilities for Maple 8. For Maple 8, the default location is /usr/local/maple/FLEXlm/UNIX.
    2. Run the file INSTALL_LIC.
    3. Move any previous Maple license files (maple6.lic or maple7.lic) to a central location, that is, /usr/local/maple8/FLEXlm/UNIX.

Task 3: Configure the License Manager Daemons

  1. Save the license file from Waterloo Maple to your hard drive.
  2. From /usr/local/maple/FLEXlm/UNIX, run the file INSTALL_LIC.
  3. When prompted, enter the path to the location in which to put the license file. This path should be the same as the one you entered for the previous Maple license files in the Move and Rename Previous Maple License Files section. The default location is /usr/local/maple8/FLEXlm/maple8.lic.
  4. When prompted, enter the hostname of the license server or select IP Address and enter the IP address of the license server. The hostname or IP address must be identical to the one you entered in the Move and Rename Previous Maple License Files section.
  5. When prompted, enter Yes to accept.

Task 4: Start the License Manager Daemons

  1. Go to the directory named the operating system on which you intend to run the license manager. For example, go to the UNIX directory if you intend to run the license manager on UNIX.
  2. When starting license manager daemons, you must enter the path to the directory containing all license files.
    Note:
    Point to the directory only, not an actual license file.
  3. To start the license manager, enter the following command:

    /Path_to_lmgrd -c /Path_to_license_file_directory -l /Path_to_logfile

    where Path_to_license_file_directory is the full path to the directory containing the license files.

You can now use both Maple 8 and previous versions of Maple.
Return to Top of the Document.


How to Start Maple

You can start Maple in different modes. Use the one best suited to your needs.

Standard Maple

Windows

To start Maple 8 for Windows in Standard mode:

  • Double-click the Maple 8 shortcut icon, if available, or select the Maple program from the Start menu. (If you installed Maple in the default location, from the Start menu, select Programs, Maple 8, then Maple 8.)

The Standard version of Maple for Windows has a graphical user interface. The first time you begin the Standard version of Maple, an introductory page directs you to new features, updates, and example worksheets. Subsequent Maple sessions start with a new, blank worksheet.

UNIX or Linux

To start Maple 8 for UNIX or Linux in Standard mode:

  • Modify your command search path to contain your Maple 8 directory (for example, /usr/local/maple/bin) and execute xmaple or execute the full path (for example, /usr/local/maple/bin/xmaple).

Command Line Maple

The Command Line version of Maple has a text-based user interface. While allowing complete access to the mathematical engine, the Command Line version of Maple requires less system resources. For more information, refer to the text file cmdline.txt or Command Line Readme located in your Maple folder.

Parallel Kernel Mode

With the Standard version of Maple, all worksheets share a common kernel, that is, definitions and packages available in one worksheet are available in all other worksheets in that Maple session. On Windows and UNIX, the Parallel Kernel version of Maple allows each worksheet its own independent session.

To start Maple 8 for Windows in Parallel Kernel mode:

  • If you installed Maple in the default location, from the Start menu, select Programs, Maple 8, then Parallel Server Maple 8.

To start Maple 8 for UNIX or Linux in Parallel Kernel mode:

  • Modify your command search path to contain your Maple 8 directory (for example, /usr/local/maple/bin) and execute xmaple –km p or the full path (for example, /usr/local/maple/bin/xmaple –km p).

For more information, refer to ?worksheet,managing,configuring in the Help System.

Excel Add-in

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

Return to Top of the Document.


How to Customize Maple

You can configure Maple to operate in a way that best suits your environment.

How to Change the User Mode or Directory

In Windows, you can run Maple in one of two user profile modes:

User Profile Information

In the Windows version of Maple, the bin.wnt, bin.w9x, or bin.win folder in the Maple folder contains an ASCII text file called Maplesys.ini. Use a text editor to change user profile information in this file.

How to Change the Working Directory

In the Windows version of Maple, you can change the working directory by creating a shortcut to Maple 8 and assigning it a different directory.

To change the working directory, follow these instructions.

  1. Create a new shortcut for Maple.
  2. Right-click the shortcut icon and select Properties.
  3. Change the Start in field. (For Windows NT, click the Shortcut tab to locate the Start in field.) The directory listed in the Start in field is the working directory when you start Maple using the shortcut key.

At start up, Maple searches the current working directory for a custom initialization file. It stops searching when it finds the file. For more information, see How to Execute Commands Automatically.

How to Execute Commands Automatically

You can configure Maple to automatically execute a series of commands on start up. This approach is especially useful for setting global variables, such as Digits and Order. To do this, create a Maple initialization file. For more information, refer to ?worksheet,reference,initialization in the Maple Help System.

How to Enable the MATLAB Link

MATLAB is an interactive programming language for general scientific and technical computation. If you have installed MATLAB 6, you can enable a link between it and Maple for Windows and most UNIX or Linux platforms. For more information, refer to ?Matlab,setup in the Maple Help System.

Return to Top of the Document.


Appendix: System Requirements

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

Windows System Requirements
Linux Single User Requirements
UNIX and Linux Network System Requirements

Windows Minimum System Requirements

Version
CPU
RAM

Hard Disk
Single User

Hard Disk
Network
Windows NT 4 (with Service Pack 5)
Intel Pentium II 233 MHz or higher or fully compatible

64 MB

150 MB

230 MB

Windows 95 or Windows 98
Intel Pentium II 233 MHz or higher or fully compatible
64 MB
150 MB
230 MB
Windows ME
Intel Pentium II 233 MHz or higher or fully compatible
64 MB
150 MB
230 MB
Windows 2000 Professional
Intel Pentium II 233 MHz or higher or fully compatible
128 MB
150 MB
230 MB
Windows 2000 Server
Intel Pentium II 233 MHz or higher or fully compatible
256 MB
150 MB
230 MB
Windows XP Pro
Intel Pentium II 233 MHz or higher or fully compatible
128 MB
150 MB
230 MB
Windows XP Home
Intel Pentium II 233 MHz or higher or fully compatible
128 MB
150 MB
230 MB

Linux Single User Minimum System Requirements

Kernel Version
glibc Version
CPU

RAM

Hard Disk
2.2.1.2
2.1.2-11

Intel Pentium III 450 MHz or fully compatible

64 MB

170 MB


Tested on

  • CD-ROM drive (for CD installation).
  • X11 R5 or R6. When using the X11/Motif graphical interface from an X terminal, use a device capable of supporting at least 8-bit pseudo-color at 640 by 480 resolution. (24-bit color at 800 by 600 resolution is recommended.)
  • TCP/IP Internet protocol.

UNIX and Linux Network Minimum System Requirements

Vendor

Hardware

Operating System

Version

RAM

Hard Disk

Sun

SPARC

Solaris

2.6

2.7

2.8

64 MB

370 MB

HP

HP9000

HP-UX

11.0 11i

64 MB

370 MB

SGI

R4000+

IRIX

6.5.X

64 MB

370 MB

IBM

RS/6000

AIX

4.3.3.10

64 MB

370 MB

DEC

Alpha

Digital UNIX / Compaq Tru 64

4.0F, 4.0G, 5.0 or later

64 MB

370 MB

RedHat & SuSE Distributions

Intel-based Pentium 450 or better

Linux

Linux Kernel 2.2.12, glibc 2.1.2-11, x86 compatible H/W

64 MB

370 MB

  • CD-ROM drive (for CD installation).
  • X11 R5 or R6. When using the X11/Motif graphical interface from an X terminal, use a device capable of supporting at least 8-bit pseudo-color at 640 by 480 resolution. (24-bit color at 800 by 600 resolution is recommended.)
  • Hard Disk requirements depend on the number of UNIX platforms installed. Each additional platform adds only 120 MB of Hard Disk space.
  • TCP/IP Internet protocol.

Back to Top of the Document

Note: Maple uses the GLOBEtrotter Software Inc. FLEXlm as its license manager. This document contains all of the information you require for a standard Maple installation. For more information, refer to the GLOBEtrotter 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.
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.