BUSINESS SOFTWARE, INC. (BSI) CONFIDENTIAL AND PROPRIETARY INFORMATION

Machine Key License Installation

A host site web machine key is required for your server or workstation from BSI.  A server key and a client key are required as of TaxFactory  9.0.b

Follow the instructions below to obtain the key.

1. Go to http://www.bsi.com/.

2. Login to the MyBSI Portal Login based on your relationship with BSI.

3. Click My Support.

4. Under the desired product, click Product Documentation > Technical Documentation.

   Tip: To create a machine key for CGI, click Machine Key Code Access Instructions and follow the instructions.

5. Click Maintain Machine Key. The Maintain Machine Key page provides the ability to add, delete, and save machine keys. Click Help for detailed instructions on maintaining the machine key.

Note: To obtain a host site machine key from the MyBSI Portal web site, the following information is required :

1. • Release Version

     Select the release version for which the machine key is being created.

      

   • Platform

     Select the platform for which the machine key is being created.

      

   • Host Name

     Select the host name of the machine for which the machine key is being created.

   • Host ID

     Select the host ID (serial number) of the machine for which the machine key is being created. This field is required for non-Intel platforms only. This field is left blank for all Intel platforms.

    

2. Save the machine key as a file.
   1. For the browser-based version, the machine key file must be saved on the XML server or Common Gateway Interface (CGI).
   2. For the client/server version, the machine key file must be saved on the server and/or PC working directory.  Until further notice, a separate machine key is required to be created and installed for the server and each workstation connected to the TaxFactory  database. As of TaxFactory  version 1.0.b, workstations no longer require license keys.
3. Follow instructions for installing the machine key. See Installing a the machine key below.

Installing a Machine Key

Note: All non-Windows machine keys are case sensitive.

Any machine, server or workstation, that accesses the TaxFactory  database must have a machine key installed.

1. Before uploading the install license, the machine key must be saved as a file on the CGI server and/or PC working directory.
   
   Note: If not installed, the generated machine key will be invalid after a period of five days. However once installed, it will not need to be reinstalled as long as the TaxFactory  database is not reinstalled.

   Access a Machine Key

   A host site machine key must be obtained from the MyBSI web site before an install license can be uploaded.*  

   Note: If not installed, the generated machine key will be invalid after a period of five days. However once installed, it will not need to be reinstalled as long as the BSI TaxFactory database is not reinstalled.

2. The license is installed with the tf10lic tool using a command line. The tf10lic tool is shipped with the product in both the client and server components.

3. Execute the command: tf10lic -i filename.
   
   See Also: iSeries Machine Key Installation  UNIX Machine Key Installation
   
   This must be executed from the specific machine that the machine key was created for.  If the machine key file is not located in the same location as the tf10lic command file, you will need include the appropriate path for the location of this file.

A message will display indicating that the license installed successfully.  Below the message, the Host Name, Host ID or Serial number, and TF10 Database are displayed.

* To identify your system's Host Name, Host ID or Serial number execute the tf10lic command with the '-v' option.  The information returned contains the text that you must enter when creating your unique machine key.  This information is case-sensitive and requires any spaces, where applicable.

Note: On systems without a proper Host ID, please do not specify one. Solaris, AIX, and iSeries have an identifiable Host ID. Linux (intel based), Windows and DEC lack a Host ID on the system, so they don't have a Host ID.
 

For example: $ uname -a
  AIX RS6K2 1 5 000C6F0F4C00

^Hostname ^Host serial number.  Where hostname is RS6k2 and where host serial number is 000C6F0F4000.

The Windows server host name can be obtained from the DOS command prompt on the server with the "hostname" command.

For example: c:\hostname
 NTSERVER1

The iSeries server Host ID can be obtained from the command prompt on the server with the "dspsysval" command and "QSRLNBR" parameter.  You can also use the tf10lic command with the '-v' parameter to identify both the iSeries Host Name and Host ID values.

For example: dspsysval parm(qsrlnbr)
  -OR-
 call pgm(tf10lic) parm('-v')

©Copyright 2021 Business Software, Inc
Unpublished - Rights Reserved Under the Copyright Laws of the United States