Establish the Home Directory

Thoroughbred Basic requires a home directory. How you establish the home directory depends on whether you are installing or upgrading Thoroughbred Basic.

For an installation

To install Thoroughbred Basic, you can use the following procedure:

1. To create the home directory, you can use:

   mkdir /directory[[/directory] . . .]

   directory is a valid directory name. By convention, the Thoroughbred Basic home directory is

   /usr/lib/basic. If you require a different home directory, there are only two restrictions:

• The directory path you select must be a valid path. It must follow the naming standards set by your operating system.
• You must not install Thoroughbred Basic in the root directory. The installation procedure will create a .profile file. If you install Thoroughbred Basic in the root directory, you will overwrite the .profile file common to many UNIX systems.

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.

2. To move to the home directory, you can use:

   cd /directory[[/directory] . . .]

For an upgrade

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

• If you plan to test Thoroughbred Basic before you make it part of your production system, you can:

  1. Use the mkdir command to create a new home directory for Thoroughbred Basic files.

  2. Use the cd command to move to the new home directory.

     Your current production system will be unaffected by the upgrade. However, you must maintain a distinction between the current production system and the new system. Files saved under the current Thoroughbred Basic may not run under earlier versions of Thoroughbred Basic.

• If you plan to copy over your current Thoroughbred Basic files, you can:

  1. Use the cd command to move to the current Thoroughbred Basic home directory.
  2. Use site procedures to back up your application and data files. Although the upgrade procedure will not affect any files you have created, you may want to take this precaution.
  3. Use site procedures to back up the IPLINPUT and TERMINAL files from the home directory. From the UTILS subdirectory, which is below the home directory, back up the TCONFIGW, TCONFIG8, and TCONFIG files; you may not have all three of these files so back up as many as you find. The upgrade procedure will overwrite these system files, which define how Thoroughbred Basic interacts with your hardware and operating system.
  4. Remove the tbredbas.nn file from the /usr/lib/basic directory if at least one of the following conditions is true:

  • You are increasing the maximum number of users in the same version of Thoroughbred Basic. For example, if you already have Thoroughbred Basic on your system and this upgrade will increase the maximum number of users from 32 to 128 you must remove the tbredbas.nn file.

  • You are changing the current Thoroughbred Basic serial number.

    Only Thoroughbred Basic files will be replaced during the upgrade procedure.

Note: Before trying to downgrade any Thoroughbred product, contact your Thoroughbred Sales Representative.

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