Troubleshooting

This chapter describes how to troubleshoot common problems caused by an incorrect installation properties file.

1. Overview

You can identify any errors occurring during TACF installation through the following three ways.

  • Open the ${OPENFRAME_HOME}/UninstallerData/log/install_tacf.log file with a text editor.

  • Check the error logs generated during manual script execution after TACF installation.

  • Check the server (ofrsasvr) status logs displayed during OpenFrame startup check.

  1. For more information about creating installation properties file, refer to Creating Installation Properties Files.

  2. For more information about error codes, refer to OpenFrame Error Message Reference Guide.

2. Error Types and Solutions

This section describes different types of frequent errors that may occur during TACF installation because of an incorrect installation properties file or license file, and how to resolve them.

2.1. License File

If the license file is missing or corrupted, the following error occurs.

  • Problem

    A missing or corrupt license file causes an error in executing the ofrsasvr server, and the server status appears as NRDY when checking the server by running tmadmin. In this case, you can find the following error logs in the ofrsasvr<execution_date>.err file, under the ${OPENFRAME_HOME}/core/log/ulog directory.

    [2020-03-17T14:28:06.751807] [OFRSASVR(15022)         ] [U] [CHK0001] /home/oframe7/OpenFrame/license/lictacf.dat file open fail: 2
[2020-03-17T14:28:06.751862] [OFRSASVR(15022)         ] [E] [SFX1003E] safx_initialize() fail: -28010
15022.142806:(I) SVR3016 SVR ofrsasvr (5/37) tpsvrinit fail. [SVR0031]

    Run tmadmin and then the si command to check the server status. For more information, refer to Installation Verification.

  • Troubleshooting

    View the log file for the server process to identify the possible causes of the error.

2.2. Database

This section describes how to troubleshoot when invalid database connection information is specified, or the tablespace in the database for TACF is missing or invalid.

  • Problem

    • Invalid database connection information

      If invalid TSAM connection information is specified for "TACF Configuration" in the installation properties file, the following error (TBR-2048) occurs when executing the data set creation script.

      tbSQL 6

TmaxData Corporation Copyright (c) 2008-. All rights reserved.

TBR-2048: Data source was not found.

    • Missing tablespace in the database for TACF or invalid tablespace name

      If an invalid tablespace is specified in the "TACF Configuration" section or the tablespace does not exist in the database, and the installer is executed, the following error (TBR-7071) occurs when executing the data set creating script.

      sqlerr -  Specified tablespace 'TACF00' was not found.    (SQLSTATE=72000, NativeError:-7073)

  • Troubleshooting

    Go to the "TACF Configuration" section of the installation properties file to check the environment settings, enter the correct information, and then reinstall TACF. For more information, refer to TACF Configuration.

    Error codes starting with 'TBR-' are Tibero error codes. When such errors occur, contact Tibero Technical Support or use some tools such as tberr for any help.