Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

How to Install or Upgrade Thoroughbred Basic (Expert)

If you need more information, please refer to the Detailed Installation and Upgrade chapter in this manual.

1. Login root
Use site procedures to login as root at the system console.
2. Clear your system
If you have Thoroughbred Basic installed on your system, verify that all tasks and users have exited.
3. Check your hardware
Minimal hardware configuration requires at least 6M of available disk storage.
4. Establish the home directory

To install Thoroughbred Basic for the first time, you can use the mkdir command to create a home directory. By convention, the Thoroughbred Basic home directory is /usr/lib/basic, but you can specify any valid path with one exception: you must not install Thoroughbred Basic in the root directory. After you create the home directory, use the cd command to move there.

Note: Thoroughbred Basic will create the /usr/lib/basic directory as a depository for some of its system files. All other files will be placed in the home directory you specify.

To upgrade Thoroughbred Basic, you can use one of the following procedures:

  • If you plan to have two versions of Thoroughbred Basic on the same system, you can create a new home directory for the new Thoroughbred Basic, then move to the new home directory.
  • If you plan to copy over your current Thoroughbred Basic files, you can move to the current Thoroughbred Basic home directory, back up your application and data files and back up the TERMINAL and IPLINPUT files. From the UTILS subdirectory, back up the TCONFIGW, TCONFIG8, and TCONFIG files; you may not have all three of these files.
  • You must remove the tbredbas.nn file from the /usr/lib/basic directory if you are increasing the maximum number of users in the same version of Thoroughbred Basic or you are changing the current Thoroughbred Basic serial number.

Only Thoroughbred Basic files will be replaced during the upgrade.

  1. Set directory and file permissions

    Use the umask 0 command to maintain the current set of permissions for your users and yourself.

6. Copy the files

UNIX/Linux Installations are accomplished using cpio. Sample cpio commands are as follows:

cpio –icvBmud < TSI_ENV

Note: Depending on your product you will enter TSI_ENV or TSI_OW.
Note: Use –ivBmud if you are installing Linux

7. Check your system and environment
Before you install or upgrade Thoroughbred Basic you can examine your system to find out how many file locks are available, how many operating system file channels exist, and so on. You can use ./install -e where -e stands for environment. With this parameter the install utility will not install or upgrade Thoroughbred Basic.
8. Begin the installation or upgrade
You can use ./install -w, where -w stands for warning, to generate system information or warnings as you install or upgrade Thoroughbred Basic. If you don't want to generate system information or warnings use ./install.
9. Establish your system console
The install utility will generate screens and messages you can use to define your system console so that Thoroughbred Basic can most efficiently use its display capabilities.
10. Test the system
Make sure that both root and user logins can run Thoroughbred Basic. After you finish this task, login as root.
11. Get an Activation Key from Thoroughbred Software International
If you do not activate Thoroughbred Basic, you have thirty days to validate your system. After thirty days, site use of Thoroughbred Basic will be restricted. Contact Thoroughbred Software for an Activation Key or go to www.tbred.com and select the Activation link to get your Activation Key online.
12. Customize and tune your system
You can use the information in the Thoroughbred Basic Customization and Tuning Guides to tailor Thoroughbred Basic to meet site requirements. The manuals contain information on how to configure terminals, how to manipulate directories, how to specify printers, how to enable ghost tasks, and how to modify system files.
13. Restore your system
The installation or upgrade is complete. You can use site procedures to inform everyone that Thoroughbred Basic is available.

From the Thoroughbred Basic for UNIX and Linux Installation Guide, version 8.9.1. Open this page in the PDF