Maple™ Toolbox for MATLAB®

Installation and Getting Started Instructions

Maplesoft, a division of Waterloo Maple Inc.

Version 10.0

To install and use Maple Toolbox for MATLAB, complete the following steps.

Pre-Installation Instructions and System Requirements

Ensure that you are connected to the Internet.

This product requires Maple 10.04 or later. To identify your Maple release:

  1. Start Maple.
  2. On Windows® and Linux®, from the Help menu, select About Maple. On Macintosh®, from the Maple 10 menu, select About Maple 10. The About dialog indicates the release number.

To update to the latest Maple release:

This product requires MATLAB versions 7 (R14) or 7.2 (R2006a) on Windows®, Linux®, and Macintosh® operating systems. It is also possible to use MATLAB version 6.5 (R13), with additional installation instructions.

Single User Installation Instructions

Windows Single User

  1. Navigate to the MapleToolboxforMATLAB.exe file you downloaded and double-click the file.
  2. Follow the on-screen instructions. Maple Toolbox for MATLAB will be installed in toolbox\MapleToolboxForMatlab in your Maple 10 directory.
  3. When prompted, enter the purchase code you were emailed and other required information to activate.

Linux Single User

  1. Change directory to the location of the MapleToolboxforMATLAB.bin file you downloaded and run the file with the command ./MapleToolboxforMATLAB.bin.
  2. Follow the on-screen instructions. Maple Toolbox for MATLAB will be installed in toolbox\MapleToolboxForMatlab in your Maple 10 directory.
  3. When prompted, enter the purchase code you were emailed and other required information to activate.

Linux 64-bit Single User

  1. Change directory to the location of the MapleToolboxforMATLABforX86_64.bin file you downloaded and run the file with the command ./MapleToolboxforMATLABforX86_64.bin.
  2. Follow the on-screen instructions. Maple Toolbox for MATLAB will be installed in toolbox\MapleToolboxForMatlab in your Maple 10 directory.
  3. When prompted, enter the purchase code you were emailed and other required information to activate.

Macintosh Single User

  1. Navigate to the MapleToolboxforMATLAB.zip file you downloaded. To decompress MapleToolboxforMATLAB.zip, double-click it. To launch the installer, double-click the MapleToolboxforMATLAB.app file.
  2. Follow the on-screen instructions. Maple Toolbox for MATLAB will be installed in toolbox\MapleToolboxForMatlab in your Maple 10 directory.
  3. When prompted, enter the purchase code you were emailed and other required information to activate.

Network Installation Instructions

Windows Network

  1. Navigate to the MapleToolboxforMATLABNetwork.exe file you downloaded and double-click the file.
  2. Follow the on-screen instructions. You must have administrator privileges to install.
  3. Follow the instructions for Windows Network Activation.

Linux Network

  1. Change directory to the location of the MapleToolboxforMATLABNetwork.bin file you downloaded and run the file with the command ./MapleToolboxforMATLABNetwork.bin.
  2. Follow the on-screen instructions.
  3. Follow the instructions for Linux and UNIX Network Activation.

Linux 64-bit Network

  1. Change directory to the location of the MapleToolboxforMATLABNetworkforX86_64.bin file you downloaded and run the file with the command ./MapleToolboxforMATLABNetworkforX86_64.bin.
  2. Follow the on-screen instructions.
  3. Follow the instructions for Linux and UNIX Network Activation.

Macintosh Network

  1. Navigate to the MapleToolboxforMATLABNetwork.zip file you downloaded. To decompress MapleToolboxforMATLABNetwork.zip, double-click it. To launch the installer, double-click the MapleToolboxforMATLABNetwork.app file.
  2. Follow the on-screen instructions.
  3. Follow the instructions for Macintosh Network Activation.

Solaris Network

  1. Change directory to the location of the MapleToolboxforMATLABforSolaris.bin file you downloaded and run the file with the command ./MapleToolboxforMATLABforSolaris.bin.
  2. Follow the on-screen instructions.
  3. Follow the instructions for Linux and UNIX Network Activation.

Additional Installation Instructions for MATLAB 6.5

The changes to the path made in this section must be undone if you decide to uninstall Maple Toolbox for MATLAB.

  1. Follow the installation instructions for your platform.
  2. Unzip the <MATLAB>\help\toolbox\maple\help.jar file into the <MATLAB>\help\toolbox\maple directory.
  3. Start MATLAB and make the following changes using the pathtool command.
  4. Save these path changes and restart MATLAB for them to take effect.

MATLAB 6.5 should now recognize your Maple Toolbox for MATLAB 6.5 installation.

Single User Activation

Maple Toolbox for MATLAB requires activation. You can activate during the installation process or later. If you do not activate during the installation process, complete the following steps to activate.

Windows Single User

  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. From Windows Explorer, navigate to the location of your Maple Toolbox for MATLAB installation. The default location is C:\Program Files\Maple 10\toolbox\MapleToolboxForMatlab.
  3. Go to the license folder and double-click the activation.bat file.
  4. Enter your purchase code. If you are activating behind a proxy server, ensure that you enter this information before clicking Next.
  5. Enter additional information. Click Next.
  6. A license file (MapleToolboxForMatlab.dat) is saved in the license folder of your installation. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.

Linux Single User

  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. Change directory to the location of your Maple Toolbox for MATLAB installation. The default location is /home/usr/Maple10/toolbox/MapleToolboxForMatlab.
  3. Run the activation script located in the license directory of your installation.
  4. Enter your purchase code. If you are activating behind a proxy server, ensure that you enter this information before clicking Next.
  5. Enter additional information. Click Next.
  6. A license file (MapleToolboxForMatlab.dat) is saved in the license folder of your installation. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.

Macintosh Single User

  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. From the terminal, find the location of your Maple Toolbox for MATLAB installation. The default location is /Library/Frameworks/Maple.framework/Versions/10/toolbox/MapleToolboxForMatlab.
  3. Run the activation script located in the license folder of your installation.
  4. Enter your purchase code. If you are activating behind a proxy server, ensure that you enter this information before clicking Next.
  5. Enter additional information. Click Next.
  6. A license file (MapleToolboxForMatlab.dat) is saved in the license folder of your installation. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.

Network Licensing and Activation

Windows Network

Complete the following tasks:
 
Task 1: Activate the Maple Toolbox for MATLAB Network license file
  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. From the Start menu, select Programs>Maple 10>Tools>Activate Maple 10.
  3. Enter your Maple Toolbox for MATLAB purchase code, hostname and hostid* of your license server. If you are activating behind a proxy server, make sure to enter this information before clicking Next.
  4. Enter additional information. Click Next.
  5. A license file (MapleToolboxForMatlab.lic) is saved in the license folder of your Maple 10 installation. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.

Task 2: Stop the License Manager

  1. From the Start menu, select Programs>Maple 10>Tools >LMTools. The LMLTools dialog opens.
  2. Under the Service/License File tab, click Configuration using Services.
  3. Click the Config Services tab. From the Server Name list, select the service currently being used.
  4. Click the Start/Stop/Read tab, then click Stop Server.

Task 3: Start the License Manager Daemons

  1. From the Start menu, select Programs >Maple 10 >Tools >LMTools. The LMLTools dialog opens.
  2. Under the Service/License File tab, click Configuration using Services.
  3. Click the Config Services tab.
  4. In the Config Services property sheet, enter or browse for the following:
Path to the lmgrd.exe file C:\Program Files\Maple 10\FLEXlm\windows\lmgrd.exe
Path to the license file

Enter the path to the directory containing all of the Maple license files. Point to the directory only, not an actual license file.

C:\Program Files\Maple 10\license
Path to the debug log file C:\Program Files\Maple 10\FLEXlm\windows\log.txt

  1. For Windows 2003, Windows 2000, Windows NT, and Windows XP Professional, select the Use Services check box (recommended) to set up the daemons as a service. (This option is not required to start the daemons under Windows 98, Windows ME, or Windows XP Home.)
  2. To set the daemons to start at boot time (recommended), select the Start Server at Power Up check box.
  3. Enter a name for your service and click Save Service. When prompted to save the service, click Yes.
  4. Select the Start/Stop/Reread tab, click Start Server to start the license manager daemons.
You can now use Maple Toolbox for MATLAB.

Linux and UNIX Network

Complete the following tasks:
Task 1: Activate the Maple Toolbox for MATLAB Network license file
  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. Change directory to the location of your Maple 10 installation.
  3. Run the activation script located in the bin directory of your installation.
  4. Enter your Maple Toolbox for MATLAB purchase code, hostname and hostid* of your license server. If you are activating behind a proxy server, ensure that you enter this information before clicking Next.
  5. Enter additional information. Click Next.
  6. A license file (MapleToolboxForMatlab.lic) is saved in the license folder of your Maple 10 installation. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.
Task 2: Stop the License Manager
  1. Go to the location of the FLEXlm utilities that are currently being used. For Maple 10, the default location is /usr/local/maple10/FLEXlm/UNIX/$PLATFORM where $PLATFORM corresponds to the operating system running the license manager.
  2. Enter the command
    ./lmdown
Task 3: Start the License Manager Daemons
  1. On 64-bit Linux platforms, you must enter the following command before starting the license manager daemon:
    Using the C shell: setenv LD_ASSUME_KERNEL 2.4.1
    Using the Korn or Bourne shell: export LD_ASSUME_KERNEL=2.4.1
  2. Navigate to the location of the FLEXlm utilities for your operating system. By default, /usr/local/maple10/FLEXlm/UNIX/$PLATFORM where $PLATFORM corresponds to the operating system running the license manager.
  3. To start the license manager, enter the following command:

./lmgrd -c /license_file_path -l /debug_log

where license_file_path is the full path to the directory containing the license files, by default /usr/local/maple10/license.
Note: Point to the directory only, not an actual license file.

You can now use Maple Toolbox for MATLAB.

Macintosh Network

Complete the following tasks:
Task 1: Activate the Maple Toolbox for MATLAB Network license file

  1. Ensure that you are connected to the Internet. Activation requires an Internet connection (if the computer on which you want to install the application does not have an Internet connection, see http://www.maplesoft.com/support/Faqs/Activation).
  2. From the terminal run the activation script located in /Library/Frameworks/Maple.framework/Versions/10/bin.
  3. Enter your Maple Toolbox for MATLAB purchase code, hostname and hostid* of your license server.  If you are activating behind a proxy server, ensure that you enter this information before clicking Next.
  4. Enter additional information. Click Next.
  5. A license file (MapleToolboxForMatlab.lic) is saved in /Library/Frameworks/Maple.framework/Versions/10/license. If you experience difficulties with activation, follow the instructions in the readme.txt file in the license folder of your installation. For more information on activation, visit the FAQs page at http://www.maplesoft.com/support/faqs/index.aspx.
Task 2: Stop the License Manager
  1. From the terminal go to the location of the FLEXlm utilities that are currently being used. For Maple 10, the default location is /Applications/Maple 10/FLEXlm/UNIX/MAC
  2. Enter the command

    ./lmdown

Task 3: Start the License Manager Daemons

To start the license manager, enter the following command:

./lmgrd -c /license_file_path -l /debug_log

where license_file_path is the full path to the directory containing the license files, by default /Library/Frameworks/Maple.framework/Versions/10/license.
Note: Point to the directory only, not an actual license file.

    You can now use Maple Toolbox for MATLAB.

Getting Started

        To open the main Maple Toolbox for MATLAB help page, start MATLAB and enter the following command.

doc maple_overview

 

Trademarks

Maple, Maplesoft, and Waterloo Maple are trademarks of Waterloo Maple Inc.

MATLAB is a registered trademark of The Mathworks, Inc.

All other brand names or product names are trademarks or registered trademarks of their respective companies.