MapleMBSE 2019 Installation and Licensing Guide


MapleMBSE 2019 Installation and Licensing Guide
MapleMBSE 2019 Installation Using a Single User License
Activating Single User Versions
MapleMBSE 2019 Installation Using a Network License
Silent (Unattended) Installation
Configure the License Manager
Setting Up SSL Authentication for MapleMBSE
Getting Started With MapleMBSE
System Requirements
Trademarks

MapleMBSE 2019 Installation and Licensing Guide

MapleMBSE 2019 Installation Using a Single User License

Single User License Installation

Follow these instructions for both 64-bit and 32-bit versions of MapleMBSE™ 2019.

During the installation, you will need your purchase code, generally sent to you in an email.

To install MapleMBSE 2019 on your Windows operating system, read and complete the following tasks

Pre-Installation Instructions

  1. Check the System Requirements for your operating system.
  1. Log on as an administrator or log on to an account, with appropriate read and write privileges, that will own the MapleMBSE files.
  1. Ensure that you are connected to the Internet. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
  1. Close all programs.

Install MapleMBSE 2019 Using a Single User License

  1. Ensure that you have reviewed the Pre-installation Instructions.
  1. Choose one of the following two options to launch the installer:
  • From DVD
  1. Place the install disc in the DVD-ROM drive.
  1. Locate and double-click MapleMBSE2019.0WindowsInstaller.exe from the install disc.
  • From download

Double-click MapleMBSE2019.0WindowsInstaller.exe from where you downloaded the file.

  1. Follow the on-screen instructions.
  1. If you are asked to select either a 32-bit or 64-bit version of MapleMBSE, select the version that matches the version of Excel® that you will be using with MapleMBSE 2019.

Note: You will be asked to select a version if either of the following conditions are detected:

  • You have both 32-bit and 64-bit versions of Excel installed, or
  • You do not have Excel installed.

If you do not have Excel installed, MapleMBSE 2019 will still be installed. However, you will not be able to use MapleMBSE 2019 until you install Excel.

By default, MapleMBSE is installed to the following locations, depending on your architecture:

  • 64-bit: C:\Program Files\MapleMBSE 2019
  • 32-bit: C:\Program Files (x86)\MapleMBSE 2019
  1. In the Choose The Type of Licensing screen, select Single User License.
  1. When prompted, enter the purchase code and the required information to complete activation.
  1. If you activated successfully, you are ready to use MapleMBSE 2019. If you had problems activating or chose not to activate during the installation, see Activating Single User Versions.

Activating Single User Versions

MapleMBSE requires a license file to operate. License files for earlier versions will not work with MapleMBSE 2019. You must activate the single user versions of MapleMBSE 2019 to obtain your license file. If you are running a single user installer, you can activate during the installation process. If you do not activate during the installation process, follow the steps below.

Note: Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.

  1. Do the following to launch the Maplesoft Activation window:
  1. Select Start > (All) Programs > MapleMBSE 2019 > Tools.
  1. Right-click Activate MapleMBSE 2019 and select Run as administrator.
  1. Enter your purchase code.
  1. If you are activating behind a proxy server, select Yes, and then enter the proxy server information.
  1. Click Next.
  1. You will be prompted to enter additional information. Click Next when this is complete.

A license (.dat) file will be saved in the license folder of your MapleMBSE 2019 installation. If you experience difficulties with activation, check our FAQs page at http://www.maplesoft.com/support/Faqs/Activation.

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

MapleMBSE 2019 Installation Using a Network License

Network License Installation

Follow these instructions for both 64-bit and 32-bit versions of MapleMBSE 2019.

To install MapleMBSE 2019 on your Windows operating system using a network license, read and complete the following tasks.

Pre-Installation Instructions

  1. Check the System Requirements for your operating system.
  1. Log on as an administrator or log on to an account, with appropriate read and write privileges, that will own the MapleMBSE files.
  1. Ensure that you are connected to the Internet. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
  1. Close all programs.

Install MapleMBSE 2019 Using a Network License

  1. Ensure that you have reviewed the Pre-installation Instructions.
  1. Choose one of the following two options to launch the installer:
  • From DVD
  1. Place the install disc in the DVD-ROM drive.
  1. Locate and double-click MapleMBSE2019.0WindowsInstaller.exe from the install disc.
  • From download

Double-click MapleMBSE2019.0WindowsInstaller.exe from where you downloaded the file.

  1. Follow the on-screen instructions.
  1. If you are asked to select either a 32-bit or 64-bit version of MapleMBSE, select the version that matches the version of Excel® that you will be using with MapleMBSE 2019.

Note: You will be asked to select a version if either of the following conditions are detected:

  • You have both 32-bit and 64-bit versions of Excel installed, or
  • You do not have Excel installed.

If you do not have Excel installed, MapleMBSE 2019 will still be installed. However, you will not be able to use MapleMBSE 2019 until you install Excel.

By default, MapleMBSE is installed to the following locations, depending on your architecture:

  • 64-bit: C:\Program Files\MapleMBSE 2019
  • 32-bit: C:\Program Files (x86)\MapleMBSE 2019
  1. In the Choose The Type of Licensing screen, select Network License.
  1. Do one of the following, depending on whether you have a single or redundant license server setup.
  • If you have a single license server setup:
  1. Select Single Server, and then click Next.
  1. Enter the name or IP address of the license server in License server.
  1. Enter the port number of the license server in Port number.
  1. Click Next.
  • If you have a redundant license server setup:
  1. Select Redundant Server, and then click Next.
  1. Enter the names or IP addresses of the license servers in License server 1, License server 2, and License server 3.
  1. Enter the port numbers of the license servers in Port number 1, Port number 2, and Port number 3.
  1. Click Next.
  1. MapleMBSE 2019 is now installed. Prior to using MapleMBSE 2019, you need to Configure the License Manager.

Silent (Unattended) Installation

It is possible to install the network version of MapleMBSE using an unattended mode option. There are two ways to perform an unattended installation of MapleMBSE:

  • Using options specified directly in the command line
  • Using an option file.

Using options specified directly in the command line

You can run an unattended installation without an option file by specifying the installation options directly in the command line. To run the unatttended installation this way, do the following:

32-Bit and 64-Bit Windows

  1. Open a command prompt window.
  1. Browse to the directory in which your MapleMBSE install file is located.
  1. Run the unattended installation process using the following syntax MapleMBSE2019.0WindowsInstaller.exe --option optionvalue. For example, use the command MapleMBSE2019.0WindowsInstaller.exe --mode unattended to install MapleMBSE in unattended mode.

Using an Option File

32-Bit and 64-Bit Windows

  1. Check the System Requirements for your operating system.
  1. Close all programs, particularly any previous release of MapleMBSE.
  1. Log on as administrator or ensure that you have administrator privileges.
  1. Create an option file.

You can create your own options.txt file using the following example as a template:

mode=unattended

installdir=C:\Program Files\MapleMBSE 2019

defaultapp=1

desktopshortcut=1

licenseType=network

serverName=myServerName

portNumber=27000

  1. Open a command prompt window.
  1. Browse to the directory in which your MapleMBSE2019.0WindowsInstaller.exe file is located.
  1. Run the silent installation process with the command MapleMBSE2019.0WindowsInstaller.exe --optionfile <optionfile>, where <optionfile> is the name of the option file.

Note: If you created your option file in a directory other than the directory in which the MapleMBSE2019.0WindowsInstaller.exe file is located, you must specify the path to the option file when you run this command.

Available Installation Options

Option Name

Description

Allowed Values

Default Value

help

Display the list of valid options

 

 

version

Display product information

 

 

unattendedmodeui

Unattended Mode UI

none minimal minimalWithDialogs

none

optionfile

Name of option file

string

 

debuglevel

Debug information level of verbosity

0 1 2 3 4

2

mode

Installation mode

win32 unattended

win32

debugtrace

debugtrace

string

 

installer-language

 

en ja

en

installdir

Installation Directory

string

C:\Program Files\MapleMBSE 2019

MapleMBSEVersion

32-bit or 64-bit version of MapleMBSE

x86 x64

x86

defaultapp

Make MapleMBSE 2019 the default application for .MSE files

0 or 1

1

desktopshortcut

Install desktop shortcut

0 or 1

1

licenseType

Type of Licensing

single network

single

singleOrRedundant

Single or redundant server setup

single redundant

single

serverName

License server

string

 

portNumber

Port number on license server

numeric

27000

serverName1

License server 1

string

 

portNumber1

Port number on license server 1

numeric

27000

serverName2

License server 2

string

 

portNumber2

Port number on license server 2

numeric

27001

serverName3

License server 3

string

 

portNumber3

Port number on license server 3

numeric

27002

Additional Information

  • You are not provided with any feedback when you run the installer in this mode
  • While you can install the single-user version of MapleMBSE silently, it is not possible to activate the product at this time. After the silent installation of the single user version of MapleMBSE 2019 is complete, from the Start menu, select All Programs, then MapleMBSE 2019, then Tools and then Activate MapleMBSE 2019.

Silently Uninstalling MapleMBSE

  1. To perform a silent uninstallation of MapleMBSE, at a command prompt, run the uninstall command, located in the <MapleMBSE Install Folder>/uninstall directory, as follows:

<MapleMBSE Install Folder>/uninstall/uninstall -- mode unattended

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

Configure the License Manager

Configure the License Manager for Windows

Before starting the Windows Network version of MapleMBSE 2019, you must obtain your license file and start the license manager by completing the following tasks.

  1. Choose one of the following:

Install FlexNet Publisher and Activation Utilities

  1. Choose one of the following:
  1. On Windows 32-bit, double-click the NetworkToolsWindowsX86Installer.exe file from the install disc or from where you downloaded the file.
  1. On Windows 64-bit, double-click the NetworkToolsWindowsX64Installer.exe file from the install disc or from where you downloaded the file.
  1. Close all programs, particularly Microsoft® Excel® and any previous release of MapleMBSE.
  1. Follow the on-screen instructions.

Activate a Network License

Network licenses for MapleMBSE and other Maplesoft products are registered using the Network Tools program.

MapleMBSE 2019 requires a MapleMBSE 2019 license file to operate. License files for earlier versions of MapleMBSE do not work with MapleMBSE 2019. 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.

  1. Depending on your version of Windows, do one of the following:
  • If you are using Windows 8.1, from Start screen swipe up from the middle of the screen or alternatively, move the mouse to the bottom left of the screen and click the downward arrow that appears. Under the Maple Network Tools heading, right-click on the Activate Maple tile. Next, click the Run as administrator icon.
  • For all other supported versions of Windows, from the Start menu, select (All) Programs > Maple Network Tools > Activate Maple.

Note: If you are using Windows 7, right-click Activate Maple and select Run as administrator.

  1. You will be prompted to enter your 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.
  1. You will be prompted to enter additional information including the number of licenses you are activating. Click Next when this is complete.
  1. A license file, MapleMBSE2019.lic, will be saved to the C:\Program Files\Maple Network Tools\activate folder. You will need this license file in the next step.

Start the License Manager for MapleMBSE 2019 Only

The C:\Program Files\Maple Network Tools\FLEXlm\11.13.1.2\windows directory contains license manager daemons (lmgrd and Maplelmg) required to run MapleMBSE, as well as utilities to assist you in installing and configuring FlexNet Publisher for your system.

Start the License Manager Daemons

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:

  1. From the Start menu, select (All) Programs>Maple Network Tools>LMTools11.13.1.2. Note: If you are using Windows 8.1, from Start screen swipe up from the middle of the screen or alternatively, move the mouse to the bottom left of the screen and click the downward arrow that appears. Under the Maple Network Tools heading, click LMTools11.13.1.2
  1. Under the Service/License File tab, click Configuration using Services.
  1. Click the Config Services tab.
  1. In the Config Services property sheet, enter or browse to the following files:

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\MapleMBSE2019.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

  1. To set up the daemons as a service (recommended), select the Use Services check box.
  1. To start the daemons at boot time (recommended), select the Start Server at Power Up check box.
  1. Click Save Service. When prompted to save the service, click Yes.
  1. Click the Start/Stop/Reread tab. In that property sheet, click Start Server to start the license manager daemons.

You can now use MapleMBSE 2019.

Start the License Manager for Multiple Maplesoft Products

To run multiple Maplesoft products (including MapleMBSE), 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:

Stop the License Manager
  1. Go to the directory of the FlexNet Publisher utilities that are currently being used and double-click lmtools.exe. Alternatively, in the Start menu, select (All) Programs>Maple Network Tools>LMTools11.13.1.2 Note: On Windows 8.1, from Start screen swipe up from the middle of the screen or alternatively, move the mouse to the bottom left of the screen and click the downward arrow that appears. Under the Maple Network Tools heading, click LMTools11.13.1.2
  1. Under the Service/License File tab, click Configuration using Services.
  1. Click the Config Services tab. From the Server Name list, select the service currently being used.
  1. Click the Start/Stop/Reread tab, then click Stop Server.
Move all Maplesoft Product License Files to a Common Directory

Using Windows Explorer, move all of the license files to a common directory, for example, C:\Program Files\Maple Network Tools\activate.

Start the License Manager Daemons
  1. From the Start menu, select (All) Programs>Maple Network Tools >LMTools11.13.1.2. Note: On Windows 8.1, from Start screen swipe up from the middle of the screen or alternatively, move the mouse to the bottom left of the screen and click the downward arrow that appears. Under the Maple Network Tools heading, click LMTools11.13.1.2
  1. Under the Service/License File tab, click Configuration using Services.
  1. Click the Config Services tab.
  1. In the Config Services property sheet, enter or browse for the following:

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

  1. To set up the daemons as a service (recommended), select the Use Services check box.
  1. To start the daemons at boot time (recommended), select the Start Server at Power Up check box.
  1. Click Save Service. When prompted to save the service, click Yes.
  1. Click the Start/Stop/Reread tab. In that property sheet, click Start Server to start the license manager daemons.

You can now use your network licensed Maplesoft products.

Novell Networks

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.

  1. Install TCP/IP on all client machines.
  1. Select a Windows computer that has TCP/IP installed to act as a license server and run the license daemons using the Start License Manager for MapleMBSE 2019 Only instructions.

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

Setting Up SSL Authentication for MapleMBSE

  1. Create a subdirectory in your MapleMBSE 2019 installation directory called, certs.
  1. Copy your exported Teamwork Cloud SSL key (teamworkcloud.export file) into the newly created certs directory, for each product in the previous step.
  1. Open a command prompt.
  1. Go to the certs directory.
  1. Come up with a password and store it in an ASCII file named cert.pass. Use the same password in steps 6 and 7 below.
  1. Run the following command to create a cert.jks file.
  • keytool -genkey -alias client_cer -keyalg RSA -keysize 2048 -keypass <YOUR PASSWORD> -validity 365 -storetype JKS -keystore cert.jks -storepass <YOUR PASSWORD> \342\200\223v, where <YOUR PASSWORD> is the password you selected in step 5. Enter the information requested.
  1. Import the SSL key from the teamworkcloud server into the cert.jks file by running the following command:
  • keytool -importcert -file <PATH TO YOUR EXPORTED TEAMWORK CLOUD CERTIFICATE> -keystore cert.jks

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

Getting Started With MapleMBSE

To start MapleMBSE, select Start > All Programs > MapleMBSE 2019 > MapleMBSE 2019, and then select the configuration (.MSE file) and model files for your model.

Sample configuration and model files come with MapleMBSE. The location and names of the sample files are:

  • <Install Directory>\Example\MechSheet\MechSheet.tritest.MSE (configuration file)
  • <Install Directory>\Example\MechSheet\MechSheet-sample1.tritest (model file)

To access the user's guide for MapleMBSE:

  1. Select Start > All Programs > MapleMBSE 2019.
  1. Click MapleMBSE 2019 User's Guide.

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

System Requirements

32-bit Windows System Requirements

Version

CPU

Recommended RAM

Hard Disk

Windows 7 Service Pack 1

Core i3-2377M (1.5GHz)

2 GB

10 GB

  • DVD-ROM drive (for DVD installation).
  • 16-bit color at 1024 by 768 (or greater) resolution recommended.
  • Internal TCP/IP connections enabled.
  • System performance may be affected if running below the recommended memory requirement.

64-bit Windows System Requirements

Version

CPU

Recommended RAM

Hard Disk

Windows 7 Service Pack 1

Core i3-2377M (1.5GHz)

2 GB

10 GB

  • DVD-ROM drive (for DVD installation).
  • 16-bit color at 1024 by 768 (or greater) resolution recommended.
  • Internal TCP/IP connections enabled.
  • System performance may be affected if running below the recommended memory requirement.

Excel Requirements

Excel 2010 Service Pack 2, Excel 2013 (updated to latest version) or Excel 2016.

Note: The architecture of your Excel installation (that is, 32-bit or 64-bit) must match the architecture of MapleMBSE that you are installing.

Java Requirements

Oracle® Java® SE Runtime Environment 8.

Note: The architecture of your Java JRE® installation (that is, 32-bit or 64-bit) must match the architecture of MapleMBSE that you are installing.

Rational Rhapsody Requirements (Optional)

Rational® Rhapsody® Version 8.1.2 or Version 8.1.3.

Note: The architecture of your Rational Rhapsody installation (that is, 32-bit or 64-bit) must match the architecture of MapleMBSE that you are installing.

Teamwork Cloud Requirements (Optional)

Teamwork Cloud™ 18.5

Return to the top of the MapleMBSE 2019 Installation and Licensing Guide.

Trademarks

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/.

MapleMBSE, 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.

Oracle, Java, and JRE are registered trademarks of Oracle and/or its affiliates.

IBM, Rational, and Rhapsody are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide.

FLEXlm and FlexNet are registered trademarks of Flexera Software Corporation.

Teamwork Cloud, Cameo Systems Modeler, and MagicDraw are registered trademarks of No Magic, Inc.

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