Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Overview

This document describes troubleshooting for each type of problem that may occur when users attempt to install ALTIBASE products.

Problems not listed in the document may occur and the type of occurrence may differ depending on the version of ALTIBASE.

For problems that are no described in this document, please send an email to support@altibase.com with a description of the occurrence conditions and the ALTIBASE trace log files ('trc' directory under the ALTIBASE installation path).

  • Altibase version 5.5.1 or later
Icon

For errors and improvements related to this document, please contact the technical support portal or technical support center.

 

Troubleshooting in common environments

This section describes the list of types of problems that may occur during the installation with corrective solutions.

Unable to interpret Binary

  • The ALTIBASE package is compiled and distributed according to the supported CPU classification. 

  • This can occur if the user tries to download and install the ALTIBASe package that does not match the CPU of the device where the user wants to install ALTIBASE.com
  • To check whether the installed executable file is normal, simply use the altibase -v command.
  • The error message in the example below is the most common error situation. In addition to this, other error messages such as library compatibility can be returned.
Example 1: When the CPU of the device and the ALTIBASe package do not match
  • Solution: Reinstall the pack for the CPU of the device.

Environment variable not registered

 

  • In order to connect ALTIBASE in sysdba mode, the path where ALTIBASe is installed must be registered in a variable named "ALTIBASE_HOME'.
  • If this variable is not registered, the following error occurs.
  • Solution: Register the ALTIBASE installation path with the value of the variable named 'ALTIBASE_HOME'.

Problem with user's file privileges

  • When installing and creating a database, it must be connected in the sysdba.
  • At this time access to sysdba mode is possible only with the user who installed ALTIBASE.
  • Solution: Try again as the user who installed ALTIBASE, or change the owner's privileges of all files under the ALTIABSE installation path to the current user.

Absence of altibase.properties file

  • This problem occurs when there is no altibase.properfies file in the 'conf' directory under the ALTIBASE installation path.
  • Solution: 'altibase.properties.sample' file for first-time users is provided in the 'conf' directory under the ALTIBASE installation path. Edit this file and the altibase.properties file to suit the environment.

Absence of license file

 

  • This problem occurs when proceeding without creating a license file in the 'conf' directory under the ALTIBASE installation path.
  • Solution: Based on the license issued from ALTIBASe, a license file should be created in the corresponding location.

License error

  • MAC ADDRESS may be changed for reasons such as changing the network card of the device. Or, the wrong license may been issued because the license issuance information was incorrectly sent to ALTIBASE.
  • Solution: If the hostid or Mac Address when the license is issued is different from the information of the target device, the license must be reissued.

Expired License error

This problem occurs when the issued license has expired.

Property value error

  • This problem occurs when the value specified in the altibase.properties file or the value specified with the environment variable in the 'conf' directory under the ALTIBASE installation path is incorrect.
When the currently set value is out of range
If the currently set value is impossible to convert the data type
When the same property is duplicated
  • Solution: Check the problem property and correct it to a normal value.

Writing file error

  • Writing file error can be caused by a number of problem factors
  • The disk may not have enough free space, or the directory may have omitted privileges.
  • Solution: check the free space on the disk and the privileges of the directory.

Skipping the database creation procedure

  • In order to start Altibase in service mode, the database creation procedure must be preceded.
  • This problem occurs when the user omits this procedure and starts the server in a shell prompt, starts in iSQL, or starts ALTIBASE as a service in the WINDOWS environment.
  • Usually, when ALTIBASE starts up, the loganchor file is retrieved for the first time, so an error message indicating that the file does not exist is returned.
  • Solution: Perform database creation procedure.

Listener port bind failure

  • This problem occurs when the ALTIBASE process fails to bind the TCP port to be used.
  • Solution: Find the case that the port cannot be bound, and then solve it. 
    If another application is preempted, the application or the port used for ALTIBASE must be changed.

Replication port bind failure

  • This problem occurs when the ALTIBASE replication thread fails in the step of binding the port to be used.
  • Solution: Find the cause that the port cannot be bound, then solve it.
    If another application is preempted, the application or the port used for ALTIBASE must be changed.

 


 

 

 

 

 

 

 

 

 


  • No labels