Database Integration Toolbox 
Installation and Getting Started Instructions

Maplesoft, a division of Waterloo Maple Inc.

Release 11.0

To install and use the Database Integration Toolbox, select the appropriate installation for your operating system.

After installing Database Integration, 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 Database Integration on your Windows operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration

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. Close all programs.

Install Database Integration

1. Ensure that you have reviewed the Pre-installation Instructions.
2. To begin installing Database Integration, choose one of the following:
   • Navigate to the DatabaseIntegration_Windows.exe file you downloaded and double-click the file.
   • Place the Database Integration CD in the CD-ROM drive. If the installation program does not begin automatically, locate and double-click D:\Windows\SingleUser\DatabaseIntegration_Windows.exe (where D is the CD-ROM drive that contains the Database Integration Toolbox  CD).
     
3. Follow the on-screen instructions. You can install Database Integration Toolbox in either of the following locations.
   • Personal copy
     C:\Documents and Settings\$USERNAME\maple\toolbox\11\Database
   • Single machine multi-user copy
     C:\Program Files\Maple 11\toolbox\Database
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 Database Integration. If you had problems activating or chose not to activate during the installation, see Windows Single User Activation.

Linux Single User Installation

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

To install Database Integration on your 32-bit Linux operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration
  

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. Close all programs.

Install Database Integration

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Database Integration, choose one of the following:
   • Change directory to the location of the DatabaseIntegration_Linux.bin file you downloaded and run the file with the command ./DatabaseIntegration_Linux.bin.
   • On the Database Integration Toolbox  CD, locate DatabaseIntegration_Linux.bin in the Linux/SingleUser folder. Run the file with the command ./DatabaseIntegration_Linux.bin.
3. Follow the on-screen instructions. You can install Database Integration Toolbox in either of the following locations.
   • Personal copy
     /home/$USERNAME/maple/toolbox/11/Database
   • Single machine multi-user copy
     /home/$USERNAME/maple11/toolbox/Database
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 Database Integration. If you had problems activating or chose not to activate during the installation, see Linux Single User Activation.

Macintosh Single User Installation

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

To install Database Integration on your Macintosh operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration

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. Close all programs.

Install Database Integration

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Database Integration, choose one of the following:
   • Navigate to the DatabaseIntegration_Mac.zip file you downloaded. To decompress DatabaseIntegration_Mac.zip, double-click it. To launch the installer, double-click the DatabaseIntegration.app file.
   • Place the Database Integration CD into the CD-ROM drive. On the desktop, double-click the Database Integration icon.
3. Follow the on-screen instructions. You can install Database Integration Toolbox  in either of the following locations.
   • Personal copy
     /Users/$USERNAME/maple/toolbox/11/Database
   • Single machine multi-user copy
     /Library/Frameworks/Maple.framework/Versions/11/toolbox/Database
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 Database Integration. If you had problems activating or chose not to activate during the installation, see Macintosh Single User Activation.

Single User Activation

The Database Integration Toolbox  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 Activation

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.
2. From Windows Explorer, find the location of your Database Integration Toolbox  installation. The two default locations are:
• c:\Documents and Setting\$USERNAME\maple\toolbox\11\Database
• c:\Program Files\Maple 11\toolbox\Database
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 (Database.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 Activation

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.
2. Change directory to the location of your Database Integration Toolbox installation. The two default locations are:
• /home/$USERNAME/maple/toolbox/11/Database
• /home/$USERNAME/maple11/toolbox/Database
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 and click Next.
6. A license file (Database.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 Activation

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.
2. From the terminal, find the location of your Database Integration Toolbox installation. The two default locations are:
• /Users/$USERNAME/maple/toolbox/11/Database
• /Library/Frameworks/Maple.framework/Versions/11/toolbox/Database
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 (Database.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.

Windows Installation Using a Network License

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

• Pre-installation Instructions
• Install Database Integration 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. Close all programs.

Install Database Integration to the Client Machines

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

Linux Network Using a Network License

To install Database Integration on your Linux operating systems, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration 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. Close all programs.

Install Database Integration to the Client Machines

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Database Integration, choose one of the following:
   • Change directory to the location of the DatabaseIntegration_LinuxNet.bin file you downloaded and run the file with the command ./DatabaseIntegration_LinuxNet.bin.
   • On the Database Integration Toolbox  CD, locate DatabaseIntegration_LinuxNet.bin in the Linux/Network folder. Run the file with the command ./DatabaseIntegration_LinuxNet.bin.
3. Follow the on-screen instructions.
   
4. Follow the instructions for Linux Network Activation.

Macintosh Network Using a Network License

To install Database Integration on your Macintosh operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration 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. Close all programs.

Install Database Integration to the Client Machines

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

Sun Solaris Installation Using a Network License

To install Database Integration on your Sun Solaris operating system, read and complete the following tasks.

• Pre-installation Instructions
• Install Database Integration to the Client Machines
• Linux and UNIX Network Activation

Pre-Installation Instructions

1. Check the Sun Solaris 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. Close all programs.

Install Database Integration to the Client Machines

1. Ensure you have reviewed the Pre-installation Instructions.
2. To begin installing Database Integration, choose one of the following:
   • Change directory to the location of the DatabaseIntegration_Sun.bin file you downloaded and run the file with the command ./DatabaseIntegration_Sun.bin.
   • Run DatabaseIntegration_Sun.bin located on the Database Integration CD in the Solaris/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 and UNIX Network Activation

Network Licensing and Activation

Windows Network Licensing and Activation

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.
2. Find the location of your Database Integration Toolbox installation. By default, c:\Program Files\Maple 11\toolbox\Database.
3. Go to the license folder and double-click the activation.bat file.
4. Enter your Database Integration Toolbox 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 (Database.lic) is saved in the license folder of your Database Integration installation, c:\Program Files\Maple 11\toolbox\Database\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 Database.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 Database Integration Toolbox.

UNIX and Linux Network

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.
2. Run the activation script located in the license directory of your Database Integraion installation, by default /home/$USERNAME/maple11/toolbox/Database/license.
3. Enter your Database Integration Toolbox 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 (Database.lic) is saved in the license folder of your Database Integration installation, /home/$USERNAME/maple11/toolbox/Database/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 Database.lic license file to /home/$USERNAMEname/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/$USERNAMEname/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/$USERNAMEname/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/$USERNAMEname/Maple_Network_tools/activate.
Note: Point to the directory only, not an actual license file.

Macintosh Network

• Task 1: Activate the Database Integration Toolbox Network license file
• Task 2: Move the license file
• Task 3: Stop the License Manager
• Task 4: Start the License Manager Daemons

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.
2. From the terminal, run the activation script located in the license directory of your Database Integration installation, by default /Library/Frameworks/Maple.framework/Versions/11/toolbox/Database/license.
   
3. Enter your Database Integration Toolbox 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 (Database.lic) is saved the license directory of your Database Integration installation, /Library/Frameworks/Maple.framework/Versions/11/toolbox/Database/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 Database.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

This product can only be used in the Standard Worksheet Interface.

Windows

1. Start Maple 11 Standard.
2. For more information on the Database Integration toolbox, enter ?Database.

Linux

1. Start Maple 11 Standard.
2. For more information on the Database Integration toolbox, enter ?Database.
   

Macintosh

1. Start Maple 11 Standard.
2. For more information on the Database Integration toolbox, enter ?Database.
   

Appendix: System Requirements

Before installing Database Integration, ensure that your computer fulfills the minimum system requirements for your operating system.

Windows System Requirements
Macintosh System Requirements
32-bit Linux User System Requirements
Sun Solaris System Requirements

Windows System Requirements

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

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