Copyright © 2020 Maplesoft, a division of Waterloo Maple Inc.
Copyright © 2020 Maplesoft, a division of Waterloo Maple Inc.
Note: The Grid Computing Toolbox installation provides an option for MPI Cluster installation. For details on Using the Grid Computing Toolbox with MPI see Using Grid MPI.txt.
For 32-bit Windows 7, Windows 8.1, and Windows 10 installation using a network license, read this section. For 64-bit Windows 7, Windows Server 2012, Windows 8.1, Windows 10, and Windows Server 2016 installation using a network license, see 64-bit Windows Installation Using a Network License.
To install Grid Computing Toolbox 2020 on your Windows operating system using a network license, read and complete the following tasks.
To identify your Maple release:
To update to the latest Maple release:
From the Tools menu, select Check for Updates and follow the instructions. If that option is dimmed, obtain the update from the downloads section of the Maplesoft website.
Double-click GridComputingToolbox2020WindowsX86Installer.exe from where you downloaded the file.
By default, Grid Computing Toolbox is installed to the following location:
C:\Program Files\Maple 2020\toolbox\Grid
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
To install Grid Computing Toolbox 2020 on your Windows operating system using a network license, read and complete the following tasks.
To identify your Maple release:
To update to the latest Maple release:
From the Tools menu, select Check for Updates and follow the instructions. If that option is dimmed, obtain the update from the downloads section of the Maplesoft website.
Double-click GridComputingToolbox2020WindowsX64Installer.exe from where you downloaded the file.
By default, Grid Computing Toolbox is installed to the following location:
C:\Program Files\Maple 2020\toolbox\Grid
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
For Macintosh® installation instructions, read this section.
To install Grid Computing Toolbox 2020 on your Macintosh operating system, read and complete the following tasks:
To identify your Maple release:
To update to the latest Maple release:
From the Tools menu, select Check for Updates and follow the instructions. If that option is dimmed, obtain the update from the downloads section of the Maplesoft website.
Double-click GridComputingToolbox2020MacInstaller.dmg from where you downloaded the file, then double-click GridComputingToolbox2020MacInstaller.
By default, Grid Computing Toolbox is installed to the following location:
/Library/Frameworks/Maple.framework/Versions/2020/toolbox/Grid
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
To install Grid Computing Toolbox 2020 on your 64-bit Linux® operating system, read and complete the following tasks.
To identify your Maple release:
To update to the latest Maple release:
From the Tools menu, select Check for Updates and follow the instructions. If that option is dimmed, obtain the update from the downloads section of the Maplesoft website.
Run GridComputingToolbox2020LinuxX64Installer.run from where you downloaded the file.
By default, Grid Computing Toolbox is installed to the following location:
$HOME/maple2020/toolbox/Grid
During installation, a maple2020.desktop file is created in the bin directory of your Grid Computing Toolbox 2020 installation. If you request the installer to have a shortcut placed on your desktop, this file is also created in the ~/Desktop directory. If you wish to have a shortcut placed in your Applications menu, the maple2020.desktop file can be copied to /usr/share/applications (which may require root access) or ~/.local/share/applications.
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Before starting the Windows Network version of Grid Computing Toolbox 2020, you must obtain your license file and start the license manager by completing the following tasks.
Network licenses for Grid Computing Toolbox and other Maplesoft products are registered using the Network Tools program.
Grid Computing Toolbox 2020 requires a Grid Computing Toolbox 2020 license file to operate. License files for earlier versions of Grid Computing Toolbox do not work with Grid Computing Toolbox 2020. To obtain your license file, you must use the Maple Network Tools activation program or activate off-line by following the instructions at http://www.maplesoft.com/contact/webforms/offlineactivation/. Ensure that you can connect to the Internet as activation requires an Internet connection. If your computer does not have an Internet connection, please contact Maplesoft customer service.
The C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows directory contains license manager daemons (lmgrd and maplelmg) required to run Grid Computing Toolbox, as well as utilities to assist you in installing and configuring FlexNet Publisher for your system.
If you intend to use a Novell® server, see Novell Networks.
To set up and start the license manager daemons on a Windows Network Server:
Service Name | Enter a name for the service (optional) |
Path to the lmgrd.exe file | C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows\lmgrd.exe |
Path to the license file | C:\Program Files\Maple Network Tools\activate\Grid2020.lic |
Path to the debug log file: Enter the path to the directory containing the debug log file. You must create this file manually (log.txt is the manually created file in the example below), as it is not automatically generated. | C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows\log.txt |
You can now use Grid Computing Toolbox 2020.
To run multiple Maplesoft products (including Grid Computing Toolbox), you must place all license files in the same directory. If you have other FlexNet Publisher license files stored in one central location, you can store your Maplesoft product license files there as well.
Complete the following tasks:
Using Windows Explorer, move all of the license files to a common directory, for example, C:\Program Files\Maple Network Tools\activate.
Service Name | Enter a name for the service (optional) |
Path to the lmgrd.exe file | C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows\lmgrd.exe |
Path to the license file Note: The path to the license file should not contain a terminating backslash | C:\Program Files\Maple Network Tools\activate |
Path to the debug log file: Enter the path to the directory containing the debug log file. You must create this file manually (log.txt is the manually created file in the example below), as it is not automatically generated. | C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows\log.txt |
You can now use your network licensed Maplesoft products.
FlexNet Publisher 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.
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Before starting the Mac OS® X Network version of Grid Computing Toolbox 2020, you must obtain your license file and start the license manager by completing the following tasks.
Network licenses for Grid Computing Toolbox and other Maplesoft products are registered using the Network Tools program.
Grid Computing Toolbox 2020 requires a Grid Computing Toolbox 2020 license file to operate. License files for earlier versions of Grid Computing Toolbox do not work with Grid Computing Toolbox 2020. To obtain your license file, you must use the Maple Network Tools activation program or activate off-line by following the instructions at http://www.maplesoft.com/contact/webforms/offlineactivation/. Ensure that you can connect to the Internet as activation requires an Internet connection. If your computer does not have an Internet connection, please contact Maplesoft customer service.
Before you can use Grid Computing Toolbox 2020, you must start the license server. It is recommended that you do not run lmgrd as root because any process run by root is a potential security risk.
./lmgrd -c license_file_path -l debug_log &
where license_file_path is the full path and filename of the network license file (by default, /Users/<username>/Applications/Maple_Network_Tools/activate/Grid2020.lic), and debug_log is the name of a file to which debugging information is written. The -l option (letter l, not the number 1 (one)) creates the file.
If you have any problems starting the license server in the system boot up files, refer to http://www.flexerasoftware.com.
You can now use Grid Computing Toolbox 2020.
To run multiple Maplesoft products (including Grid Computing Toolbox), you must place all license files in the same directory. If you have other FlexNet Publisher license files stored in one central location, you can store your Maplesoft product license files there as well.
Complete the following tasks:
Go to the location of the FlexNet Publisher utilities that are currently being used. For Grid Computing Toolbox 2020, the default location is /Users/<username>/Applications/Maple_Network_Tools/FLEXlm/11.13.1.2/. Enter the command:
./lmdown
Copy all the Grid Computing Toolbox network license files to /Users/<username>/Applications/Maple_Network_Tools/activate.
Note: Point to the directory only, not an actual license file.
./lmgrd -c license_file_path -l debug_log
where license_file_path is the full path to the directory containing the license files and debug_log is the name of a file to which debugging information is written. The -l option (letter l, not the number 1 (one)) creates the file.
You can now use your network licensed Maplesoft products.
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Before starting the Linux Network version of Grid Computing Toolbox 2020, you must obtain your license file and start the license manager by completing the following tasks.
Network licenses for Grid Computing Toolbox and other Maplesoft products are registered using the Network Tools program.
Grid Computing Toolbox 2020 requires a Grid Computing Toolbox 2020 license file to operate. License files for earlier versions of Grid Computing Toolbox do not work with Grid Computing Toolbox 2020. To obtain your license file, you must use the Maple Network Tools activation program or activate off-line by following the instructions at http://www.maplesoft.com/contact/webforms/offlineactivation/. Ensure that you can connect to the Internet as activation requires an Internet connection. If your computer does not have an Internet connection, please contact Maplesoft customer service.
Before you can use Grid Computing Toolbox 2020, you must start the license server. It is recommended that you do not run lmgrd as root because any process run by root is a potential security risk.
Using the C Shell
To start the license manager daemon (lmgrd), enter the following command at the prompt,
./lmgrd -c license_file_path -l debug_log & |
where license_file_path is the full path and filename of the network license file (by default, $HOME/MapleNetworkTools/activate/Grid2020.lic) and debug_log is the name of a file to which debugging information is written. The -l option (letter l, not the number 1 (one)) creates the file.
Using the Korn or Bourne Shell
To start the license manager daemon (lmgrd), enter the following command at the prompt:
nohup lmgrd -c license_file_path -l debug_log 2>&1 & |
Run Daemons 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; lmgrd_path -c license_file_path -l log_path\' |
where username is a non-privileged user; lmgrd_path is the correct path to the lmgrd file, license_file_path is the full path of the network license file (by default, $HOME/MapleNetworkTools/activate/Grid2020.lic), and log_path is the debug log file path. It is recommended that the network license file be called Grid2020.lic.
Help for Starting the License Server
If you have any problems starting the license server in the UNIX system boot up files, refer to http://www.flexerasoftware.com/.
You can now use Grid Computing Toolbox 2020.
To run multiple Maplesoft products (including Grid Computing Toolbox), you must place all license files in the same directory. If you have other FlexNet Publisher license files stored in one central location, you can store Maplesoft product license files there as well.
Complete the following tasks:
Go to the location of the FlexNet Publisher utilities that are currently being used. For Grid Computing Toolbox 2020, the default location is /usr/local/MapleNetworkTools/FLEXlm/11.13.1.2/. Enter the command:
./lmdown |
Copy all of the Grid Computing Toolbox network license files to one folder, for example, $HOME/MapleNetworkTools/activate.
Note: Point to the directory only, not an actual license file.
./lmgrd -c license_file_path -l debug_log
where license_file_path is the full path to the directory containing the license files and debug_log is the name of a file to which debugging information is written. The -l option (letter l, not the number 1 (one)) creates the file.
You can now use your network licensed Maplesoft products.
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Named Network Users run Grid Computing Toolbox on their own client machines. These client machines are connected to the license server over the network. The Network Named User licensing option allows system administrators to strictly enforce which users, or client machines, may run Grid Computing Toolbox.
When you install Maple Network Tools, an options file (.opt) is automatically created in the $Maple Network Tools/activate directory.
Note: By default, the vendor daemon looks for the options file (maplelmg.opt) in the same directory that contains the license file used by the license server manager.
To set up Named Network User licensing, perform the following steps:
To manually edit the options file, perform the following steps:
INCLUDE Maple USER User1
INCLUDE Maple USER User2
INCLUDE Maple USER User3
INCLUDE Maple USER User4
INCLUDE MapleExcel USER User4
INCLUDE Grid2020 USER User4
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
The default settings are stored in the file:
The properties file contains settings in the format key=value where the possible keys are listed as follows:
Note: Commenting out a parameter using the # character will cause the default value for that key to be used.
Key | Description | Default |
grid.broadcast | The IP address mask that will define an Internet subnet. A Grid Server, when running, will broadcast its availability using UDP broadcasts. The mask determines which machines it will broadcast to. For example if all Grid Servers are on IP addresses 10.10.50.x, then a suitable mask will be 10.10.50.255. This will cause a message to be sent to every machine on the 10.10.50. network. If machines are distributed over a wider IP range, such as 10.10.50.x, 10.10.55.x, and 10.10.90.x, then a mask of 10.10.255.255 must be used to send to all 10.10.x.y addresses. | 10.10.255.255 |
grid.broadcastport | The UDP AutoDiscovery port that each server will broadcast on to find other Grid servers. To turn off UDP AutoDiscovery, set the port to zero (0). | 4400 |
grid.broadcastdelay | The time in seconds between UDP messages. | 60 |
grid.debug | This controls whether extra information is written to the log files. | false |
grid.DeadlockDelay | The time, in seconds, the running nodes can be stalled during an ongoing computation. While a computation is in progress, the Master node, node 0, will query the state of executing nodes. If any node fails to indicate progress over a period longer than this parameter, the grid computations will be halted and an error returned. This parameter must be in the range 1 to 60 seconds. | 10 |
grid.license | The path to the Grid license file. If the path is a relative path, such as the default value license/Grid.dat, then it is taken relative to the Grid Computing Toolbox directory. | license/Grid.dat |
grid.logfile | The path to a file to receive logging information. If the path is a relative path, such as logs/logging.txt, then it is taken relative to the Grid Computing Toolbox directory. Windows Note: Users of Windows should read the note following this Table. | logs/gridlog.txt |
grid.nodes | The name of file that lists the names of Grid servers, one per line to be used when Maple code is submitted by the launcher script. Generally this name should be left blank in the properties file and specified on the command line. See Batch processing in the Maple Help System for details on how the node list is used. |
|
grid.numcpus | The number of CPUs to use on this machine. Specifying a value less than 1 will cause the system to attempt to query the machine for the number of CPUs and assign a node for each. | 1 |
grid.maple | The full path to the command-line version of Maple to be used by the grid node(s) on this machine. For example, on Linux, it would be set to /usr/local/maple/bin/maple. This path is set by the installer and should not be altered. |
|
grid.port | The port that the server on this machine will use to receive messages from other nodes via the Send and Receive commands. If more than 1 CPU is being used, numcpus > 1, then CPU 0 will use this port, CPU 1 will use port + 1, CPU 2 will use port +2, etc. | 2000 |
Note for Windows: In order to get logging to work on Windows platforms 7 or 8.1, Windows Server 2008 R2, and Windows Server 2012 R2, you need to either:
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Version | CPU | Recommended RAM | Hard Disk |
Windows 7 | Intel Pentium III 1 GHz | 4 GB | 4 GB |
Windows 8.1 | Intel Pentium III 1 GHz | 4 GB | 4 GB |
Windows 10 | Intel Pentium III 1 GHz | 4 GB | 4 GB |
Version | CPU | Recommended RAM | Hard Disk |
Windows 7 | AMD X86_64 1 GHz Intel Xeon, Intel 64 | 4 GB | 4 GB |
Windows Server 2016 | AMD X86_64 1 GHz Intel Xeon, Intel 64 | 4 GB | 4 GB |
Windows 8.1 | AMD X86_64 1 GHz Intel Xeon, Intel 64 | 4 GB | 4 GB |
Windows 10 | AMD X86_64 1 GHz Intel Xeon, Intel 64 | 4 GB | 4 GB |
Windows Server 2019 | AMD X86_64 1 GHz Intel Xeon, Intel 64 | 4 GB | 4 GB |
Vendor | CPU | Operating System | Version | Recommended RAM | Hard Disk |
Apple | 64-bit Intel | OS X | 10.12, 10.13, 10.14, 10.15 | 4 GB | 4 GB |
Vendor | Operating System Version | CPU | Recommended RAM | Hard Disk | Additional required packages |
Red Hat Enterprise Linux | 7.7, 8.0 | Intel 64 or AMD X86_64 | 4 GB | 4 GB | redhat-lsb |
SUSE Linux Enterprise Desktop | 15 | Intel 64 or AMD X86_64 | 4 GB | 4 GB | lsb |
Ubuntu | 18.04 LTS, 19.10 | Intel 64 or AMD X86_64 | 4 GB | 4 GB | lsb-base, lsb-core |
Return to the top of the Grid Computing Toolbox 2020 Installation and Licensing Guide.
Note: Maple uses the Flexera Software Corporation FlexNet Publisher as its license manager. This document contains all the information you require for a standard Maple installation. For more information, refer to the FlexNet Publisher documentation at http://www.flexerasoftware.com/.
Maple, Maplesoft, and Waterloo Maple are trademarks of Waterloo Maple Inc.
Intel is a registered trademark of Intel Corporation.
Microsoft, Windows, Windows Server, Excel, and Internet Explorer are registered trademarks of Microsoft Corporation.
Macintosh and Mac OS are registered trademarks of Apple Computer, Inc.
NVIDIA is a registered trademark of NVIDIA Corporation.
AMD, ATI, AMD Catalyst, and Catalyst are either trademarks or registered trademarks of Advanced Micro Devices, Inc.
Java and JRE are registered trademarks of Oracle and/or its affiliates.
FLEXlm and FlexNet are registered trademarks of Flexera Software Corporation.
Linux is a registered trademark of Linus Torvalds.
Watcom is a trademark of Sybase, Inc.
All other brand names or product names are trademarks or registered trademarks of their respective companies.