BASIS Installation Guide for NetWare Operating Systems ****************************************************** Last Update: December 1, 2000 Part 1: Installing BASIS License Manager Part 2: Installing Visual PRO/5 License(s) Part 3: Emergency Licensing Procedures Process Description ******************* Visual PRO/5® and PRO/5 Data Server® for NetWare revision 2.11 and higher use FLEXlm licensing software. The FLEXlm End User Manual is included in the provided online documentation. It can be accessed from the FLEXlm End User Manual entry in the table of contents. The Globetrotter Software Web site (www.globetrotter.com) contains an Adobe Acrobat version of the manual, as well as an online version that has full-text search capability. The process of installing these NetWare-based BASIS products requires: o Installing and setting up the BASIS License Manager (BLM). o Requesting the individual product licenses from BASIS. o Installing the individual product licenses once you have received them from BASIS. o Installing the products, which includes some configuration of the product. This document contains the procedures for accomplishing this process and for obtaining temporary licenses in the event of an emergency. Part 4 explains some important terms concerning BASIS licenses. What You Will Need ****************** If you purchased a BASIS product and received product media, you will need the License Registration Form included for each product. If you have a BASIS product revision 2.00 to 2.05 and are updating from our Web site to revision 2.10 or higher, you will need your existing serial number and activation key. If you downloaded a demonstration copy from our Web site, you will have received the demonstration license file as part of the download process. Known Issues ************ Lmtools.exe and lmutil.exe do not currently work on workstations that cannot connect to the license server with TCP/IP. BASIS.NLM creates a FLEXlm directory (if one does not already exist) on the SYS volume when it starts up. It does not put any files in this directory. This directory can be deleted while the license manager is not running. Novell Netware Requirements Long file names are only supported on NetWare 4.11 or later. Long file name support on NetWare 4.11 requires CLIB.NLM version 4.11j or later. Version 4.11j of CLIB.NLM can be obtained by installing IntranetWare Support Pack 4 or later and can be downloaded from http://www.novell.com/. **************************************** Part 1: Installing BASIS License Manager **************************************** STEP 1. Install the BASIS Product Locate your BASIS License Manager. The BASIS License Manager is distributed on media and from the Internet. 1 If you are installing from media, locate and insert it into the drive. If you are downloading the product from the BASIS ftp site, unzip the self-extracting ZIP file into a temporary directory. 2 Locate your license authorization form you received from BASIS with your product or by fax. This information is entered during the registration process. 3 Run setup.exe. STEP 2. Request the Permanent License NOTE: If the License Registration wizard is not currently running, double-click on the reglic shortcut located in the SYS:\BASIS\BLM directory. 1 At the BASIS License Registration Wizard check the applicable box, and click Next to continue. 2 Enter the Host ID of the NetWare server that will be running the BASIS License Manager. To get the Host ID, type CONFIG at the NetWare server console prompt and locate the Node Address for the first network card listed. Click Next to continue. 3 Complete the License Registration Information. CONTACT INFORMATION Enter the information listed in the Contact Information section. This information is optional unless you want your license delivered to you by fax or e-mail. This information will only be used to contact you in case of an e-mail or fax transmission error. PRODUCT LICENSE INFORMATION In the Product Information section, enter the serial number and license authorization number exactly as they appear on the License Registration Form that came with your BASIS product. Optionally, enter a host name. Though not required, it provides an easy way to associate a product serial number and host ID with an individual computer. Click Next to continue to the License Registration and Delivery Methods dialog. 4 Click Next to continue. 5 Select the Registration Method. Indicate how you will be sending the license information to BASIS. Select Web Browser, E-Mail, Phone, Fax or Other. WEB BROWSER This is the fastest and therefore the preferred method. EMAIL The license request will be automatically sent to BASIS by e-mail. If you are working on a machine that does not have e-mail capability, you must select another method. If you are at a remote site that tends to experience delays in delivering e-mail, you may experience the same delay with the licensing process. In this situation, try registering by fax as well. PHONE This is an automated telephone registration system. Dial +1.505.338.4171 and follow the instructions. Fax capability is required for the automated system to return a permanent license. FAX This option will save your licensing information to a text file in a special format for our automatic fax-reading software. Print the text file for use in a fax machine, fax the license to BASIS at 1.505.338.4178. Be certain the fax is sent right-side up, inserting the top edge first. Increase the size of the characters as much as possible without having text run outside the margins or take more than one page. (16-point type is the minimum.) Clean, enlarged photocopies work well, however any marks, streaks or handwritten notes on the page will make it difficult for our automated system to interpret the text correctly. OTHER OTHER is a manual backup system and should be used only if the e-mail and fax methods are unavailable or do not work. OTHER allows you to save the registration information in a human-readable format to a file that can be moved to another machine with e-mail or printer access. Then, fax the information to 1.505.345.5082 (NOT our automated fax number) or e-mail the file to license@basis.com, and we will manually generate your permanent license. 6 Select the License File Delivery Method, and indicate how you want BASIS to return your license file. If Web Browser is selected as the registration method, e-mail or fax delivery methods are not available. Your license file will be immediately delivered to you by the Web. EMAIL If you select the e-mail option, the license file will be delivered to the e-mail address you specify. When you receive your license by e-mail, save this file to your system according to the e-mail instructions. You will need to specify a path to this file later in the installation. FAX If you select the fax option, the license information will be delivered to the fax number you specify. You will be prompted to enter this information when you install the BASIS product license. 7 Click Next to continue and accept the registration information verification by clicking OK. If you selected E-mail Address or Fax Number in the Registration Method section but did not enter your name and phone number into the Contact Information section, an Emergency Contact Information dialog will appear. This information is required and will only be used to contact you in case of an e-mail or fax transmission error. If you selected Other as the registration method, a Save As dialog appears. Enter the destination path for the registration file and click Save. Move this registration file to a machine with Internet or printer access. E-mail it to BASIS for an immediate reply, or print this file and fax it to BASIS for a reply during BASIS' operating hours of Monday through Friday, 8:00 a.m. to 5:00 p.m., Mountain time (-0700GMT). The permanent license will be returned by e-mail or fax, whichever you selected as the License Delivery Method. 8 Continue to register for as many licenses as needed. 9 Follow the instructions in the Registration Notification dialog. Click Next to continue. 10 To proceed with the license installation, click Yes in the Would You Like to Install a BASIS License? dialog. STEP 3. Install a License When BASIS receives the registration information, your permanent license information is generated and returned to you by the delivery method you previously selected in the registration dialog. This process should take no more than a few minutes. If after 30 minutes you still have not received the permanent license information, please try all remaining delivery methods. If you are still unable to receive your permanent license, install the temporary license printed at the bottom of the BASIS License Registration Form until you receive the permanent license. For additional assistance from BASIS Technical Support can be obtained during normal business hours at 1.505.345.5021 or send an e-mail to license-support@basis.com. NOTE: If the License Installation Wizard is not currently running, double-click on the instlic shortcut located in the SYS:\BASIS\BLM directory. 1 Do one of the following: 1a If you received the license file by Web browser or e-mail, enter the path name of the license file you saved or use the "Browse..." option to locate the file. 1b If you received the license information by fax, select the Enter License Information radio button and fill in all eight text boxes as listed on the BASIS form. 2 Select Next to complete this installation. The BASIS license is now installed. ****************************************** Part 2: Installing Visual PRO/5 License(s) ****************************************** Note: Begin at Step 3 if using a BASIS License Manager STEP 1. Install the BASIS Product 1 Locate your BASIS product. BASIS products are distributed on media and from the Internet. If you are installing from media, locate and insert it into the drive now. If you are downloading the product from the BASIS ftp site, unzip the self-extracting ZIP file into a temporary directory. 2 Locate the license authorization form you received from BASIS with your product or by fax. This information is entered during the registration process. 3 Run setup.exe. STEP 2. Request the Permanent License NOTE: If the License Registration Wizard is not currently running, it can be started from the Windows Start button. Locate the BASIS product for which you are installing a license. Select "Register for a BASIS License." 1 At the BASIS License Registration Wizard check an appropriate box. Click Next to continue. 2 Complete the License Registration Information. Enter the information listed in the Contact Information section. This is optional, unless you want your license delivered to you by fax or e-mail. This information will only be used to contact you in case of an e-mail or fax transmission error. Complete the Product License Information. In the Product Information section, enter the Serial Number and License Authorization Number exactly as they appear on the License Registration Form that came with your BASIS product. Optionally, enter a host name. Though not required, it provides an easy way to associate a product serial number and host ID with an individual computer. 3 Click Next to continue. 4 Select the Registration Method Indicate how you will be sending the license information to BASIS. Select Web Browser, E-Mail, Phone, Fax or Other. WEB BROWSER This is the fastest and therefore the preferred method. EMAIL The license request will be automatically sent to BASIS by e-mail. If you are working on a machine that does not have e-mail capability, you must select another method. If you are at a remote site that tends to experience delays in delivering e-mail, you may experience the same delay with the licensing process. In this situation, try registering by fax as well. PHONE This option is our automated telephone registration system. In the United States, dial 1.505.338.4171 and follow the instructions as prompted. Outside the U.S., dial the U.S. country code plus the above number and follow the instructions. You must have fax capability to use this option. The system will prompt you for a fax number to which it will send your permanent license. FAX This option will save your licensing information to a text file in a special format for our automatic fax-reading software. Print out the text file and fax the license to 1.505.338.4178. Ensure the fax is sent right-side up, inserting the top edge first. Increase the size of the characters as possible without having text run outside the margins or using more than one page. (16-point type is the minimum.) Clean, enlarged photocopies work well, however any marks, streaks or handwritten notes on the page will make it difficult for our automated system to interpret the text correctly. OTHER This is a manual backup system and should be used only if the e-mail and fax methods are unavailable or do not work. OTHER allows you to save the registration information in a human-readable format to a file that can be moved to another machine with e-mail or printer access. Fax the information to 1.505.345.5082 (NOT our automated fax number), or e-mail the file to license@basis.com, and we will manually generate your permanent license. 5 Select the License File Delivery Method (how you want BASIS to return your license file). Under License File Delivery Method, indicate how you want BASIS to return your license file. If you selected the Web Browser to be the registration method, the e-mail or fax delivery methods are not available. Your license file will be immediately delivered to you by the Web. EMAIL If you select the e-mail option, the license file will be delivered to the e-mail address specified. When you receive your license by e-mail, save this file to your system, as per the e-mail instructions. You will need to specify a path to this file later in the installation. FAX If you select the fax option, the license information will be delivered to the fax number specified. You will be prompted to enter this information when you install the BASIS product license. 6 Click Next to continue and accept the registration information verification by clicking OK. 6a If you selected E-mail Address or Fax Number in the Registration Method section but did not enter your name and phone number into the Contact Information section, an Emergency Contact Information dialog will appear. This information is required and will only be used to contact you in case of an e-mail or fax transmission error. 6b If you selected Other as the registration method, a Save As dialog appears. Enter the destination path for the registration file and click Save. Move this registration file to a machine with Internet or printer access. E-mail it to BASIS for an immediate reply, or print this file and fax it to BASIS for a reply during BASIS' operating hours of Monday through Friday, 8:00 a.m. to 5:00 p.m., Mountain time (-0700GMT). The permanent license will be returned by e-mail or fax, whichever you selected as the License Delivery Method. 7 Continue to register for as many licenses as needed. 8 Follow the instructions in the Registration Notification dialog. Click Next to continue. 9 To proceed with the license installation, click Yes in the Would you like to install a BASIS license? dialog. STEP 3. Install a License When BASIS receives the registration information, your permanent license information is generated and returned to you by the delivery method you previously selected in the registration dialog. This process should take no more than a few minutes. If after 30 minutes you still have not received the permanent license information, try all remaining delivery methods. If you are still unable to receive your permanent license, install the temporary license printed at the bottom of the BASIS License Registration Form until you receive the permanent license. Additional assistance can be obtained from BASIS Technical Support during normal business hours at 1.505.345.5021, or send an e-mail to license-support@basis.com. 1 Select the type of license installation and click Next to continue. NOTE: If the License Installation wizard is not currently running, it can be started from the Windows Start button. Click Programs to locate the BASIS product for which you are installing a license. Select Install a BASIS License. 2 Complete one of the following for each of the three radio button options: 2a Install A Single-User BASIS Visual PRO/5 License On This Machine. If you received the license file by Web browser or e-mail, enter the path name of the license file you saved or use the "Browse..." option to locate the file. If you received the license information by fax, select the Enter License Information radio button and fill in all eight text boxes as listed on the BASIS form. 2b Configure this application to use the BASIS License Manager. If you purchased a multiuser license with your BASIS product, select this radio button and fill in the text box below with the name of the machine on which you will run the BASIS License Manager. Select Next to continue. Specify the protocol to use to communicate with the BASIS License Manager for NetWare. If IPX/SPX is specified, you must specify the Node Address and Network Number for the server (not the network card), which can be found by typing CONFIG at the Novell server console, or by running your NetWare administration utility. 2c Configure this application to use BASIS Data Server License. If you will be using a PRO/5 Data Server, select this radio button and fill in the text box below with the name of the machine on which the Data Server is installed. Select Next to continue. Specify the protocol to use to communicate with the BASIS License Manager for NetWare. If IPX/SPX is specified, you must specify the Node Address and Network Number for the server (not the network card), which can be found by typing CONFIG at the Novell server console, or by running your NetWare administration utility. 3 Select Next, then either select Yes to install another license, or No to complete the installation. Selecting No displays the LOAD line that can be copied into the AUTOEXEC.NCF to load the BLM NLM. For example: Load basis -l sys\BASIS\blm\blmgr.txt -c SYS\BASIS\[lic_file_name] For more than one license file, the -c syntax is: -c SYS\BASIS\[lic_file_name];SYS\BASIS\[lic_file_name] The -l [log file] option can be omitted to have the log messages displayed on the server console instead of being recorded in a log file. 4 The BASIS license is now installed. ************************************** Part 3: Emergency Licensing Procedures ************************************** 60-Day Nag-Free License: If you received BASIS product media, and if for any reason the above procedures fail to return a permanent license to you, you can immediately run nag-free by installing a 60-day temporary license. This license is valid for 60 days from the date of purchase from BASIS and you do not need to contact BASIS to install it. To install a 60-day temporary license, repeat the steps in Part 2. Manually enter the emergency license information on the License Registration Form included with your product media. Once you have the 60-day temporary license running, call BASIS to request generation of another permanent license. Immediate Seven-Day Nag-Free License: If at any time your system experiences a failure that invalidates your license, you can install a seven-day temporary license. To install a seven-day temporary license, repeat the steps in Part 2. When additional requests are entered for the same serial number and authorization number, our automated system will generate a seven-day temporary license. Once you have the seven-day temporary license running, call BASIS to request generation of another permanent license. NOTE: If you have difficulty receiving the BASIS-generated permanent license information and have unsuccessfully attempted the request by fax, e-mail, and Web,select the Other option. This allows you to save the license registration information, so it can be e-mailed from another machine or faxed. If this still is unsuccessful, install the temporary license until the permanent license is received. ----------------------------------------------------------------- Copyright (C) l985-2002 BASIS International Ltd. All rights reserved. BBx(R), Visual PRO/5(R), PRO/5(R), PRO/5 Data Server(R), GUIBuilder(R), ResBuilder(R), BASIS ODBC Driver(R), DDBuilder(R) and BBj(R) are registered trademarks of BASIS International Ltd. All other product names and brand names are service marks and/or trademarks or registered trademarks of their respective companies.