Block Importer™ for Simulink®

Installation and Getting Started Instructions

Maplesoft, a division of Waterloo Maple Inc.

Release 11.0

To install and use Block Importer™ for Simulink®, select the appropriate installation for your operating system.

After installing Block Importer for Simulink, review the following information:

• Getting Started

For a complete list of system requirements, see Appendix: System Requirements.

Windows Single User Installation

During the installation, you will need your purchase code (send to you in an email).

To install Block Importer for Simulink on your Windows operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer

Pre-installation Instructions

1. Check the Windows System Requirements.
2. On Windows 2003, Windows 2000, and Windows XP Professional, log on as administrator or ensure that you have administrator privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Help menu, select About Maple. The About Maple 11 dialog indicates the release number.
      
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
   
6. Close all programs.

Install Block Importer

1. Ensure that you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
   • Navigate to the BlockImporter_Windows.exe file you downloaded and double-click the file.
   • Place the Block Importer for Simulink CD in the CD-ROM drive. If the installation program does not begin automatically, locate and double-click D:\Windows\SingleUser\BlockImporter_Windows.exe (where D is the CD-ROM drive that contains the Block Importer for Simulink CD).
3. Follow the on-screen instructions. You can install Block Importer for Simulink in either of the following locations.
   • Personal copy
     C:\Documents and Settings\$USERNAME\maple\toolbox\11\BlockImporter
   • Single machine multi-user copy
     C:\Program Files\Maple 11\toolbox\BlockImporter
4. When prompted, enter the purchase code you were emailed and other required information to activate.
5. If you activated successfully, you are ready to use Block Importer. If you had problems activating or chose not to activate during the installation, see Single User Activation.

Linux Single User Installation

During the installation, you will need your purchase code (send to you in an email).

To install Block Importer for Simulink on your 32-bit Linux operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer
  

Pre-installation Instructions

1. Check the Linux System Requirements.
2. Log on to the account that will own the Maple files. Ensure you have appropriate read and write privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Help menu, select About Maple. The About Maple 11 dialog indicates the release number.
      
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
6. Close all programs.

Install Block Importer

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
   • Change directory to the location of the BlockImporter_Linux.bin file you downloaded and run the file with the command ./BlockImporter_Linux.bin.
   • Run BlockImporter_Linux.bin located on the Block Importer for Simulink CD in the Linux/SingleUser folder. To run the installer in console mode, use the -i console option.
     
3. Follow the on-screen instructions. You can install Block Importer for Simulink in either of the following locations.
   • Personal copy
     /home/$USERNAME/maple/toolbox/11/BlockImporter
   • Single machine multi-user copy
     /home/$USERNAME/maple11/toolbox/BlockImporter
4. When prompted, enter the purchase code you were emailed and other required information to activate.
5. If you activated successfully, you are ready to use Block Importer. If you had problems activating or chose not to activate during the installation, see Single User Activation.

Macintosh Single User Installation

During the installation, you will need your purchase code (send to you in an email).

To install Block Importer for Simulink on your Macintosh operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer

Pre-Installation Instructions

1. Check the Macintosh System Requirements.
2. Ensure that you have administrator privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Maple 11 menu, select About Maple 11. The About dialog indicates the release number.
      
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
6. Close all programs.

Install Block Importer

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
   • Navigate to the BlockImporter_Mac.zip file you downloaded. Double-click the file to decompress it. To launch the installer, double-click the BlockImporter_Mac.app file.
   • Place the Block Importer for Simulink CD into the CD-ROM drive. On the desktop, double-click the Block Importer for Simulink icon.
     
3. Follow the on-screen instructions. You can install Block Importer for Simulink in either of the following locations.
   • Personal copy
     /Users/$USERNAME/maple/toolbox/11/BlockImporter
   • Single machine multi-user copy
     /Library/Frameworks/Maple.framework/Versions/11/toolbox/BlockImporter
4. When prompted, enter the purchase code you were emailed and other required information to activate.
5. If you activated successfully, you are ready to use Block Importer. If you had problems activating or chose not to activate during the installation, see Single User Activation.

Single User Activation

Block Importer for Simulink 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. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. From Windows Explorer, find the location of your Block Importer for Simulink installation. The two default locations are:
• c:\Documents and Setting\$USERNAME\maple\toolbox\11\BlockImporter
• c:\Program Files\Maple 11\toolbox\BlockImporter
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 and click Next.
6. A license file (BlockImporter.dat) is saved in the license folder of your installation. You can now use Block Importer for Simulink.

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. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. Change directory to the location of your Block Importer for Simulink installation. The two default locations are:
• /home/$USERNAME/maple/toolbox/11/BlockImporter
• /home/$USERNAME/maple11/toolbox/BlockImporter
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 and click Next.
6. A license file (BlockImporter.dat) is saved in the license folder of your installation. You can now use Block Importer for Simulink.

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. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. From the terminal, find the location of your Block Importer for Simulink installation. The two default locations are:
• /Users/$USERNAME/maple/toolbox/11/BlockImporter
• /Library/Frameworks/Maple.framework/Versions/11/toolbox/BlockImporter
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 and click Next.
6. A license file (BlockImporter.dat) is saved in the license folder of your installation. You can now use Block Importer for Simulink.

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.

Windows Installation Using a Network License

To install Block Importer for Simulink on your Windows operating system using a network license, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer to the Client Machines
• Windows Network Activation.

Pre-installation Instructions

1. Check the Windows System Requirements.
2. On Windows 2003, Windows 2000, and Windows XP Professional, log on as administrator or ensure that you have administrator privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Help menu, select About Maple. The About Maple 11 dialog indicates the release number.
      
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
6. Close all programs.

Install Block Importer to the Client Machines

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
   • Navigate to the BlockImporter_WindowsNet.exe file you downloaded and double-click the file.
   • Place the Block Importer for Simulink CD in the CD-ROM drive. If the installation program does not begin automatically, locate and double-click D:\Windows\Network\BlockImporter_WindowsNet.exe (where D is the CD-ROM drive that contains the Block Importer for Simulink CD).
     
3. Follow the on-screen instructions.
   
4. Follow the instructions for Windows Network Activation.

Linux Installation Using a Network License

To install Block Importer for Simulink on your Linux operating systems, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer to the Client Machines
• Linux Network Activation
  

Pre-installation Instructions

1. Check the Linux System Requirements.
2. Log on to the account that will own the Maple files. Ensure you have appropriate read and write privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Help menu, select About Maple. The About Maple 11 dialog indicates the release number.
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
6. Close all programs.

Install Block Importer to the Client Machines

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
   • Change directory to the location of the BlockImporter_LinuxNet.bin file you downloaded and run the file with the command ./BlockImporter_LinuxNet.bin.
   • Run BlockImporter_LinuxNetwork.bin located on the Block Importer for Simulink CD in the Linux/Network folder. To run the installer in console mode, use the -i console option.
     
3. Follow the on-screen instructions.
   
4. Follow the instructions for Linux Network Activation.

Macintosh Installation Using a Network License

To install Block Importer for Simulink on your Macintosh operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Block Importer to the Client Machines
• Macintosh Network Activation.

Pre-Installation Instructions

1. Check the Macintosh System Requirements.
2. Ensure that you have administrator privileges.
3. 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.
4. This product requires Maple 11 or later.
   To identify your Maple release:
   
   1. Start Maple.
   2. From the Maple 11 menu, select About Maple 11. The About dialog indicates the release number.
      
   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 Web site.
5. This product requires MATLAB with the Simulink toolbox. Check the MATLAB Requirements.
6. Close all programs.

Install Block Importer to the Client Machines

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Block Importer, choose one of the following:
• Navigate to the BlockImporter_MacNet.zip file you downloaded. To decompress BlockImporter_MacNet.zip, double-click it. To launch the installer, double-click the BlockImporter_MacNet.app file.
• Place the Block Importer for Simulink CD into the CD-ROM drive. On the desktop, double-click the Block Importer for Simulink icon.
3. Follow the on-screen instructions.
   
4. Follow the instructions for Macintosh Network Activation.
   

Network Licensing and Activation

Windows Network Licensing and Activation

1. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. Find the location of your Block Importer for Simulink installation. By default,
   c:\Program Files\Maple 11\toolbox\BlockImporter.
3. Go to the license folder and double-click the activation.bat file.
4. Enter your Block Importer for Simulink 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.
5. Enter additional information and click Next.
6. A license file (BlockImporter.lic) is saved in the license folder of your BlockImporter for Simulink installation, c:\Program Files\Maple 11\toolbox\BlockImporter\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: Move the license file

1. Move the BlockImporter.lic license file to C:\Program Files\Maple Network Tools\activate.

Task 3: Stop the License Manager

1. From the Start menu, select Programs > Maple Network 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 4: Start the License Manager Daemons

1. From the Start menu, select Programs > Maple Network 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 Network Tools\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 Network Tools\activate
Path to the debug log file	C:\Program Files\Maple Network Tools\FLEXlm\windows\log.txt

5. 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.)
6. To set the daemons to start at boot time (recommended), select the Start Server at Power Up check box.
7. Enter a name for your service and click Save Service. When prompted to save the service, click Yes.
8. Select the Start/Stop/Reread tab, click Start Server to start the license manager daemons.

You can now use Block Importer for Simulink.

UNIX and Linux Network Licensing and Activation

1. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. Run the activation script located in the license directory of your BlockImporter for Simulink installation, by default /home/$USERNAME/maple11/toolbox/BlockImporter/license.
3. Enter your 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 and click Next.
5. A license file (BlockImporter.lic) is saved in the license folder of your BlockImporter for Simulink installation, /home/$USERNAME/maple11/toolbox/BlockImporter/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: Move the license file

1. Move the BlockImporter.lic license file to /home/$USERNAME/Maple_Network_Tools/activate.

Task 3: Stop the License Manager

1. Navigate to the location of the FLEXlm utilities that are currently being used. By default, /home/$USERNAME/Maple_Network_Tools/FLEXlm.
2. Enter the command
   ./lmdown
   

Task 4: 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, /home/$USERNAME/Maple_Network_Tools/FLEXlm.
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 /home/$USERNAME/Maple_Network_Tools/activate.
Note: Point to the directory only, not an actual license file.

Macintosh Network Licensing and Activation

• Task 1: Activate the Block Importer for Simulink Network license file
• Task 2: Move the license file
• Task 3: Stop the License Manager
• Task 4: Start the License Manager Daemons

1. Activation requires an Internet connection. If your computer does not have an Internet connection, please contact your distributor or Maplesoft customer service.
2. From the terminal, run the activation script located in the license directory of your BlockImporter for Simulink installation, by default /Library/Frameworks/Maple.framework/Versions/11/toolbox/BlockImporter/license.
   
3. Enter your 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 and click Next.
5. A license file (BlockImporter.lic) is saved the license directory of your BlockImporter for Simulink installation, /Library/Frameworks/Maple.framework/Versions/11/toolbox/BlockImporter/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: Move the license file

1. Move the BlockImporter.lic license file to /Users/$USERNAME/Applications/Maple_Network_Tools/activate.

Task 3: Stop the License Manager

1. From the terminal, go to the location of the FLEXlm utilities that are currently being used. The default location is /Users/$USERNAME/Applications/Maple_Network_Tools/FLEXlm.
2. Enter the command
   
   ./lmdown
   

Task 4: 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 /Users/$USERNAME/Applications/Maple_Network_Tools/activate.
Note: Point to the directory only, not an actual license file.

Getting Started

Windows

• Double-click the BlockImporter.mw shortcut on your Desktop.

UNIX/Linux

1. Check the stack size. 8 MB is recommended. Unlimited is not recommended.
   in csh:
   limit stacksize

   in bash:
   ulimit -s

2. Set the stack size to 8 MB.
   in csh:
   limit stacksize 8192

   in bash:
   ulimit -s 8192
   

3. Start Maple 11 Standard.
4. Open the BlockBuilder for Simulink.mw file in the BlockBuilder for Simulink installation directory.
   

Macintosh

• Double-click the BlockImporter.mw shortcut on your Desktop.

Appendix: System Requirements

Before installing Block Importer, ensure that your computer fulfills the minimum system requirements for your operating system.

Windows System Requirements
Macintosh System Requirements
32-bit Linux System Requirements


MATLAB Requirements

Windows System Requirements

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

Simulink® is a registered trademark of the Mathworks.

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