Help Center/ GaussDB/ Distributed_8.x/ Configuring Running Parameters/ GUC Parameters/ File Location
Updated on 2024-06-03 GMT+08:00
View PDF

File Location

After a database has been installed, three configuration files (gaussdb.conf, gs_hba.conf, and gs_ident.conf) are automatically generated and saved in the data directory. You can use the methods described in this section to change the names and save paths of these configuration files.

When changing the storage directory of a configuration file, set data_directory in gaussdb.conf to the actual data directory.

If a configuration file is incorrectly modified, the database will be seriously affected. Do not modify the configuration files mentioned in this section after installation.

data_directory

Parameter description: Specifies the GaussDB data directory. Only the sysadmin user can access this parameter. You can set this parameter using one of the following methods:

  • Set it when you install the GaussDB.
  • This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

Value range: a string, consisting of one or more characters.

Default value: Specify this parameter during installation. If this parameter is not specified during installation, the database is not initialized by default.

config_file

Parameter description: Specifies the configuration file (gaussdb.conf) of the primary node.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

Value range: a string, consisting of one or more characters.

Default value: gaussdb.conf (The absolute directory of this file may be displayed in the actual situation.)

hba_file

Parameter description: Specifies the configuration file (gs_hba.conf) for host-based authentication (HBA). This parameter can be specified only in the gaussdb.conf file and can be accessed only by the sysadmin user.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

Value range: a string.

Default value: gs_hba.conf (The absolute directory of this file may be displayed in the actual situation.)

ident_file

Parameter description: Specifies the name of the configuration file (gs_ident.conf) for client authentication. Only the sysadmin user can access this parameter.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

Value range: a string

Default value: gs_ident.conf (The absolute directory of this file may be displayed in the actual situation.)

external_pid_file

Parameter description: Specifies the extra PID file that can be used by the server management program. Only the sysadmin user can access this parameter.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

This parameter takes effect only after the database restarts.

Value range: a string.

Default value: empty

Parent topic: GUC Parameters