Add and manage listener

This guide describes how to add a listener to a Direct Server Return Network Load Balancer (DSRNLB) and manage it by viewing the list, modifying settings, and more.

Add listener

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. From the Load balancer list, select the load balancer to which you want to add a listener.

3. In the detail screen, click the Listener tab, then click the Add listener button.

4. In the Add listener popup, select either the TCP or UDP protocol and modify the port if needed.

5. Select a Default forwarding target, then click Add to configure the target group.

info

• After adding the listener, you can link a target group in Listener settings. If the default forwarding target is set to 'Not configured', a connection error may occur when accessing the service. For stable operation, make sure to connect a target group.
  
• The listener’s port must match the port configured on the targets in the connected target group. Additionally, the protocol pair between listener and target group differs from NLB. Refer to the Listener documentation for more details.
• When using a UDP listener, additional configuration is required and only certain operating systems are supported. Refer to Additional configuration for target instance when using UDP listener for further details.

View listener

From the load balancer detail screen, you can view, modify, or delete existing listeners, or add new ones.

View listener list

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Select the load balancer whose listener list you want to view.

3. Click the Listener tab on the detail screen to view the list of connected listeners.

   Item	Description
   Protocol:Port	Protocol and port of the listener
   ID	ID assigned at creation
   Provisioning status	Indicates whether the listener is active, being modified, or being deleted
   Operational status	Indicates whether the listener is currently available
   Minimum TLS version	Security policy used for TLS communication between the client and load balancer - Not applicable for DSRNLB as it does not support TLS listeners
   Default SSL certificate	Certificate used for TLS communication - Not applicable for DSRNLB
   Default action	The default action for traffic received by the listener; fixed as Forward - Displays the name of the target group if linked
   [More] icon	Provides options to configure or delete the listener

View listener details

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Select the load balancer whose listener details you want to view.

3. In the detail screen, click the Listener tab and select the listener to inspect.

   Listener details

   Section	Field	Description
   Properties	Idle timeout	Timeout for idle connections
   	Maximum connections	Displays the set maximum if enabled

Manage listener

Modify target group

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Click the load balancer that contains the listener you want to modify.

3. Click the Listener tab, then click the [More] icon of the listener you want to update.

4. From the [More] menu, select Listener settings.

5. In the Listener settings popup, choose a new target group from the Default forwarding target list and click Save.

info

The listener port must match the port set on the targets in the new target group. If the target group includes targets with mismatched ports, the listener cannot be linked.

Configure maximum connections

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Select the load balancer that contains the listener to modify.

3. In the detail screen, click the Listener tab and select the listener.

4. At the top of the properties section, click Configure maximum connections.

5. In the Configure maximum connections popup, modify the settings as needed.

   • To enforce a limit: enable the setting and enter a value (range: 1–2,147,483,647)
   • To remove the limit: disable the setting

   Configure listener maximum connections

6. Click the Apply button.

Configure idle timeout

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Select the load balancer that contains the listener to modify.

3. In the detail screen, click the Listener tab and select the listener.

4. At the top of the properties section, click Configure properties.

5. In the Configure listener properties popup, modify the idle timeout setting.

   • Idle timeout: Enter a value between 1 and 4000 seconds (default: 50 seconds)

6. Click the Save button.

Delete listener

1. Go to the KakaoCloud Console > Beyond Networking Service > Load Balancing > Load balancer menu.

2. Click the load balancer that contains the listener you want to delete.

3. In the detail screen, click the Listener tab.

4. Click the [More] icon of the listener you want to delete.

5. From the [More] menu, select Delete listener.

6. In the Delete listener popup, enter the confirmation phrase and click Delete.