Document Type | Technical Information
Category | Administration
Applicable Product Version | Tibero 7.2.3
Document Number | TADTI147
Overview
This guide explains how to configure IPv6 in Tibero and how to set up dual stack to use both IPv6 and IPv4 simultaneously.
Test Environment Configuration
- Server Name: Tibero
- OS version: CentOS Stream release 10 (Coughlan)
- DB Version: Tibero 7.2.3
Method
Definition of IPv6
IPv6, which stands for Internet Protocol Version 6, is the next-generation internet protocol proposed to solve various limitations of IPv4 such as address exhaustion, scalability, and automatic host address configuration.
IPv6 uses a 128-bit address scheme and is generally represented in hexadecimal and colons (:) to enhance readability.
All of the IPv6 notations shown below represent the same address. In typical Linux environments, you can check the IPv6 address using the ifconfig -a command.
--All represent the same IPv6 address
2001:0DB8:0000:0000:0000:0000:1428:57ab
2001:0DB8:0000:0000:0000::1428:57ab
2001:0DB8:0:0:0:0:1428:57ab
2001:0DB8:0::0:1428:57ab
2001:0DB8::1428:57ab
--IPv6 address checked with ifconfig -a
[tibero@node1 ~/tibero7/client/config]$ ifconfig -a
enp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
inet 172.20.10.6 netmask 255.255.255.240 broadcast 172.20.10.15
inet6 fe80::a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x20<link>
inet6 2001:2d8:634f:fdb6:a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x0<global>
inet6 2001:2d8:6349:fae8:a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x0<global>
ether 08:00:27:69:9c:dd txqueuelen 1000 (Ethernet)
RX packets 2574 bytes 321059 (313.5 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 1788 bytes 329516 (321.7 KiB)
TX errors 0 dropped 7 overruns 0 carrier 0 collisions 0
lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536
inet 127.0.0.1 netmask 255.0.0.0
inet6 ::1 prefixlen 128 scopeid 0x10<host>
loop txqueuelen 1000 (Local Loopback)
RX packets 95 bytes 11598 (11.3 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 95 bytes 11598 (11.3 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
Tibero IPv6-Related Patches
However, in the tested 7.2.3 version, configuration is possible without any separate patches. --Patch list 189619f => changed to 194325j 134584a 202908a => not distributable 200548a => not distributable 189619a_jdbc
How to Configure IPv6
You need to edit the Tibero environment file and the tbdsn.tbr file that holds connection information.
--tip
# tip file generated from /home/tibero/tibero7/config/tip.template (2025. 12. 15. (Mon) 13:42:02 KST)
#-------------------------------------------------------------------------------
#
# RDBMS initialization parameter
#
#-------------------------------------------------------------------------------
DB_NAME=node1
LISTENER_PORT=8629
CONTROL_FILES="/home/tibero/tbdata/c1.ctl"
DB_CREATE_FILE_DEST="/home/tibero/tbdata"
LOG_ARCHIVE_DEST="/home/tibero/tbarch"
MAX_SESSION_COUNT=20
TOTAL_SHM_SIZE=2G
MEMORY_TARGET=3G
WTHR_PER_PEP=1
LISTENER_IP=fe80::a00:27ff:fe69:9cdd%enp0s3
IP_VERSION=6
--tbdsn.tbr
node1_v6=(
(INSTANCE=(HOST=fe80::a00:27ff:fe69:9cdd)
(PORT=8629)
(IP_VERSION=6)
(DB_NAME=node1)
)
)
IPv6 Connection Test
When IPv6 is configured, you cannot connect using the existing IPv4 connection information (port conflict).
--Test server IP information
[tibero@node1 ~/tibero7/client/config]$ ifconfig -a
enp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
inet 172.20.10.6 netmask 255.255.255.240 broadcast 172.20.10.15
inet6 fe80::a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x20<link>
inet6 2001:2d8:634f:fdb6:a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x0<global>
inet6 2001:2d8:6349:fae8:a00:27ff:fe69:9cdd prefixlen 64 scopeid 0x0<global>
ether 08:00:27:69:9c:dd txqueuelen 1000 (Ethernet)
RX packets 2574 bytes 321059 (313.5 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 1788 bytes 329516 (321.7 KiB)
TX errors 0 dropped 7 overruns 0 carrier 0 collisions 0
lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536
inet 127.0.0.1 netmask 255.0.0.0
inet6 ::1 prefixlen 128 scopeid 0x10<host>
loop txqueuelen 1000 (Local Loopback)
RX packets 95 bytes 11598 (11.3 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 95 bytes 11598 (11.3 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
--Test server tbdsn.tbr information
[tibero@node1 ~/tibero7/client/config]$ cat tbdsn.tbr
#-------------------------------------------------
# /home/tibero/tibero7/client/config/tbdsn.tbr
# Network Configuration File.
# Generated by gen_tip.sh at 2025. 12. 15. (Mon) 13:42:03 KST
node1=(
(INSTANCE=(HOST=localhost)
(PORT=8629)
(DB_NAME=node1)
)
)
node1_v6=(
(INSTANCE=(HOST=fe80::a00:27ff:fe69:9cdd)
(PORT=8629)
(IP_VERSION=6)
(DB_NAME=node1)
)
)
--IPv6 connection test
[tibero@node1 ~/tibero7/client/config]$ tbsql sys/tibero@node1_v6
tbSQL 7
TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
Connected to Tibero using node1_v6.
SQL> select * from v$database;
DBID NAME DB_CREATE_DATE
---------- ---------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
CF_CREATE_DATE CURRENT_TSN OPEN_MODE PROTECTION_MODE RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------- -------------------- --------------- ------------
RESETLOG_DATE PREV_RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- -----------------
PREV_RESETLOG_DATE DATABASE_ROLE STANDBY_BECAME_PRIMARY_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------------- --------------------------
STANDBY_BECAME_PRIMARY_DATE LOG_MODE FORCE_LOGGING CKPT_TSN
-------------------------------------------------------------------------------------------------------------------------------- ------------ ----------------- ----------
CKPT_DATE CPU_NAME PLATFORM_NAME
-------------------------------------------------------------------------------------------------------------------------------- -------------------------------- --------------------------------
CPU_MODEL
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
OS_UPTIME CM_OBSERVER
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -----------
91488347 node1 2025/12/16
2025/12/16 46316 READ WRITE UNPROTECTED 45289
2025/12/16 45122
2025/12/16 PRIMARY 0
ARCHIVELOG NO 46268
2025/12/17 X86 LINUX_X86_64
12th Gen Intel(R) Core(TM) i5-1240P
15:50:46 up 5:15, 4 users, load average: 0.01, 0.05, 0.07 DISABLED
1 row selected.
SQL> quit
Disconnected.
--IPv4 connection test
[tibero@node1 ~/tibero7/client/config]$ tbsql sys/tibero@node1
tbSQL 7
TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
TBR-2131: Generic I/O error.
SQL> quit
How to Set Up Dual Stack for IPv4 and IPv6
You need to edit the Tibero environment file and the tbdsn.tbr file that holds connection information.
For the existing IPv4 connection information in the tbdsn.tbr file, change the IP field from localhost to the actual IP value.
--tip
# tip file generated from /home/tibero/tibero7/config/tip.template (2025. 12. 15. (Mon) 13:42:02 KST)
#-------------------------------------------------------------------------------
#
# RDBMS initialization parameter
#
#-------------------------------------------------------------------------------
DB_NAME=node1
LISTENER_PORT=8629
CONTROL_FILES="/home/tibero/tbdata/c1.ctl"
DB_CREATE_FILE_DEST="/home/tibero/tbdata"
LOG_ARCHIVE_DEST="/home/tibero/tbarch"
MAX_SESSION_COUNT=20
TOTAL_SHM_SIZE=2G
MEMORY_TARGET=3G
WTHR_PER_PEP=1
LISTENER_IP=172.20.10.6
LOCAL_CLUSTER_IP_VERSION=4
IP_VERSION=10
LISTENER_IP_6=fe80::a00:27ff:fe69:9cdd%enp0s3
LISTENER_PORT_6=28629
--tbdsn.tbr
#-------------------------------------------------
# /home/tibero/tibero7/client/config/tbdsn.tbr
# Network Configuration File.
# Generated by gen_tip.sh at 2025. 12. 15. (Mon) 13:42:03 KST
node1=(
(INSTANCE=(HOST=172.20.10.6)
(PORT=8629)
(DB_NAME=node1)
)
)
node1_v6=(
(INSTANCE=(HOST=fe80::a00:27ff:fe69:9cdd)
(PORT=28629)
(IP_VERSION=6)
(DB_NAME=node1)
)
)Boot Screen and Connection Test for Dual Stack Configuration
[tibero@node1 ~/tibero7/client/config]$ tbboot
Change core dump dir to /home/tibero/tibero7/bin/prof.
/usr/bin/pstack or /usr/bin/gstack is required to dump the callstack.
****************************************************
* The following path was not found.
* /usr/bin/pstack or /usr/bin/gstack
* pstack or gstack is required to dump the callstack.
****************************************************
Listener IPv4 port = 8629
Listener IPv6 port = 28629
Tibero 7
TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
Tibero instance started up (NORMAL mode).
[tibero@node1 ~/tibero7/client/config]$ tbsql sys/tibero@node1
tbSQL 7
TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
Connected to Tibero using node1.
SQL> select * from v$database;
DBID NAME DB_CREATE_DATE
---------- ---------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
CF_CREATE_DATE CURRENT_TSN OPEN_MODE PROTECTION_MODE RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------- -------------------- --------------- ------------
RESETLOG_DATE PREV_RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- -----------------
PREV_RESETLOG_DATE DATABASE_ROLE STANDBY_BECAME_PRIMARY_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------------- --------------------------
STANDBY_BECAME_PRIMARY_DATE LOG_MODE FORCE_LOGGING CKPT_TSN
-------------------------------------------------------------------------------------------------------------------------------- ------------ ----------------- ----------
CKPT_DATE CPU_NAME PLATFORM_NAME
-------------------------------------------------------------------------------------------------------------------------------- -------------------------------- --------------------------------
CPU_MODEL
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
OS_UPTIME CM_OBSERVER
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -----------
91488347 node1 2025/12/16
2025/12/16 46513 READ WRITE UNPROTECTED 45289
2025/12/16 45122
2025/12/16 PRIMARY 0
ARCHIVELOG NO 46468
2025/12/17 X86 LINUX_X86_64
12th Gen Intel(R) Core(TM) i5-1240P
15:56:25 up 5:20, 4 users, load average: 0.42, 0.16, 0.09 DISABLED
1 row selected.
SQL> quit
Disconnected.
[tibero@node1 ~/tibero7/client/config]$ tbsql sys/tibero@node1_v6
tbSQL 7
TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
Connected to Tibero using node1_v6.
SQL> select * from v$database;
DBID NAME DB_CREATE_DATE
---------- ---------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
CF_CREATE_DATE CURRENT_TSN OPEN_MODE PROTECTION_MODE RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------- -------------------- --------------- ------------
RESETLOG_DATE PREV_RESETLOG_TSN
-------------------------------------------------------------------------------------------------------------------------------- -----------------
PREV_RESETLOG_DATE DATABASE_ROLE STANDBY_BECAME_PRIMARY_TSN
-------------------------------------------------------------------------------------------------------------------------------- ----------------- --------------------------
STANDBY_BECAME_PRIMARY_DATE LOG_MODE FORCE_LOGGING CKPT_TSN
-------------------------------------------------------------------------------------------------------------------------------- ------------ ----------------- ----------
CKPT_DATE CPU_NAME PLATFORM_NAME
-------------------------------------------------------------------------------------------------------------------------------- -------------------------------- --------------------------------
CPU_MODEL
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
OS_UPTIME CM_OBSERVER
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -----------
91488347 node1 2025/12/16
2025/12/16 46516 READ WRITE UNPROTECTED 45289
2025/12/16 45122
2025/12/16 PRIMARY 0
ARCHIVELOG NO 46468
2025/12/17 X86 LINUX_X86_64
12th Gen Intel(R) Core(TM) i5-1240P
15:56:34 up 5:21, 4 users, load average: 0.36, 0.15, 0.09 DISABLED
1 row selected.
SQL> quit
Disconnected.Notes When Configuring IPv6
If the IPv6 address is a local IP, you must enter the NIC name after %.
For local IPs, the IP address starts with fe80.
When using IPv6 addresses in some programs like FileZilla, you must specify the IPv6 address inside square brackets ([]).
If both IPv4 and IPv6 are configured as dual, all communications except for the Listener port will use IPv4.
To use the IPv6 feature properly, you must apply all IPv6-related patches for Tibero.
ssh connection example --NIC name not entered [tibero@node1 ~/tibero7/client/config]$ ssh root@fe80::a00:27ff:fe69:9cdd ssh: connect to host fe80::a00:27ff:fe69:9cdd port 22: Invalid argument --NIC name entered [tibero@node1 ~/tibero7/client/config]$ ssh root@fe80::a00:27ff:fe69:9cdd%enp0s3 root@fe80::a00:27ff:fe69:9cdd%enp0s3's password: