# How to create a listener?

**To create a listener, follow the steps below:**

**Step 1:** [Login](https://customer.acecloudhosting.com/index.php?m=ace_product_register_addon\&action=login) to your account.

**Step 2:** Navigate to **Networks** and then click on **Load Balancer**.

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FtPCq1PIDvoRHc5kM1nlF%2Fimage.png?alt=media&#x26;token=43f23b48-b3ee-4b63-bd95-54764edc0e65" alt=""><figcaption></figcaption></figure>

**Step 3:** Choose the load balancer for which you want to create the listener and click on the load balancer nam&#x65;**.**

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FQEpbo9XDYSbYssuy7mlI%2Fimage.png?alt=media&#x26;token=cb3607ed-9325-4ebb-a04a-35dd2be89ac1" alt=""><figcaption></figcaption></figure>

**Step 4:** Navigate to the **Listeners** tab and click **Create Listener**.

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FJsvdVTa8vSIhP8cRNaBF%2Fimage.png?alt=media&#x26;token=e6509b0b-17ed-46d4-99b5-2879b7e5ec12" alt=""><figcaption></figcaption></figure>

**Step 5:** Enter the **Listener Details** and click **Next.**

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2F7EOsdDlZgRWGWc5GAAdW%2Fimage.png?alt=media&#x26;token=c8446f35-c0a8-4443-9ef4-0cffb626aba9" alt=""><figcaption></figcaption></figure>

| **Field**                      | **Description**                                                                                                                                                                                           |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Listener Name\*                | Enter the name of the Listener.                                                                                                                                                                           |
| Listener Description           | Enter the description of the Listener.                                                                                                                                                                    |
| Listener Protocol\*            | <p>Select a protocol for the listener from the below options:</p><ol start="1"><li>HTTP</li><li>HTTPS</li><li>TERMINATED\_HTTPS</li></ol>                                                                 |
| Listener Port\*                | The protocol port number for the resource. The default is 1.                                                                                                                                              |
| Client Data Timeout (in ms)    | Enter client inactivity timeout in milliseconds. The default is 50000.                                                                                                                                    |
| TCP Inspect Timeout (in ms)    | Enter time, in milliseconds, to wait for additional TCP packets for content inspection. The default is 0.                                                                                                 |
| Member Connect Timeout (in ms) | Enter member connection timeout in milliseconds. The default is 5000.                                                                                                                                     |
| Member Data Timeout (in ms)    | Enter member inactivity timeout in milliseconds. The default is 50000.                                                                                                                                    |
| Allowed CIDRs                  | Enter a list of IPv4, IPv6 or mix of both CIDRs.                                                                                                                                                          |
| Connection Limit\*             | The maximum number of connections permitted for this listener. Default value is -1 which represents infinite connections.                                                                                 |
| TLS Cipher String\*            | Enter List of ciphers in OpenSSL format and it should be colon-separated.                                                                                                                                 |
| Insert Headers                 | <p>Select the headers to insert into the request before it is sent to the member from the below option:</p><ol start="1"><li>X-Forwarded-For</li><li>X-Forwarded-Port</li><li>X-Forwarded-Proto</li></ol> |

**Step 6:** Enter **Pool Details**, **Server Monitor Health** details, and click **Next.**

**Note:**

1. If you have not created a **Listener**, you will not be able to create a **Pool** and **Monitor**.
2. If you have not created a **Pool**, you will not be able to create a **Monitor**.
3. If you do not want to create a **Pool** and **Monitor,** disable the toggle and click **Next**.

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FLXDIoIRCqhRy9PkbCc8b%2Fimage.png?alt=media&#x26;token=e97882be-c2ba-47b0-8c3e-4ea609b36014" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FkLfeq4W9SMRtsCIQb9HZ%2Fimage.png?alt=media&#x26;token=b973954b-1e01-436f-b59b-a181f15d10b7" alt=""><figcaption></figcaption></figure>

| **Field**           | **Description**                                                                                                                                                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pool Name\*         | Enter the name of the Pool.                                                                                                                                                                                                                     |
| Pool Description    | Enter the description of the pool.                                                                                                                                                                                                              |
| Pool Algorithm\*    | <p>Select the load balancing algorithm for the pool from the below options:</p><ol start="1"><li>Least connections</li><li>Round robin</li><li>Source IP</li></ol>                                                                              |
| Pool Protocol\*     | <p>Select a protocol for the pool from the below options:</p><ol start="1"><li>HTTPS</li><li>PROXY</li><li>PROXYV2</li><li>TCP</li></ol>                                                                                                        |
| TLS Enabled         | <ul><li>Select <strong>YES</strong> to enable TLS, enabling it will help member to use TLS encryption.</li><li>Select <strong>NO</strong> to disable TLS.</li></ul>                                                                             |
| TLS Cipher String   | Enter List of ciphers in OpenSSL format and it should be colon-separated.                                                                                                                                                                       |
| Session Persistence | <p>Select a JSON object specifying the session persistence for the pool from the below options:</p><ol start="1"><li>HTTP Cookie</li><li>APP Cookie</li><li>Source IP</li></ol>                                                                 |
| Cookie Name\*       | Enter the name of the cookie to use for session persistence.                                                                                                                                                                                    |
| Monitor Name\*      | Enter the name of the Health Monitor.                                                                                                                                                                                                           |
| Monitor Protocol\*  | <p>Select a protocol for the health monitor from the below options:</p><ol start="1"><li>HTTP</li><li>HTTPS</li><li>PING</li><li>TCP</li><li>TLS-HELLO</li><li>UDP-CONNECT</li><li>SCTP</li></ol>                                               |
| Max Retries Down\*  | Enter the number of allowed check failures before changing the operating status of the member to ERROR. A valid value is from 1 to 10. The default is 3.                                                                                        |
| Delay (in sec.)\*   | Enter the interval, in seconds, between health checks. The default is 10.                                                                                                                                                                       |
| Max Retries\*       | Enter the number of successful checks before changing the operating status of the member to ONLINE. The default is 1.                                                                                                                           |
| Timeout (in sec.)\* | The time, in seconds, after which a health check times out. The default is 5.                                                                                                                                                                   |
| HTTP Method         | <p>Select the HTTP method that the health monitor uses for requests from the below options:</p><ol start="1"><li>GET</li><li>HEAD</li><li>POST</li><li>PUT</li><li>DELETE</li><li>TRACE</li><li>OPTIONS</li><li>PATCH</li><li>CONNECT</li></ol> |
| Expected Codes\*    | Enter the HTTP status codes expected in response from the member to declare it healthy. The default is 200.                                                                                                                                     |
| URL Path\*          | Enter the HTTP URL path of the request sent by the monitor to test the health of a member. Must be a string that begins with a forward slash. The default URL path is /.                                                                        |

**Step 7**: Enter **the Backend Server** details and click **Next**.

**Note:**

1. If you have not created a **Pool**, you will not be able to create a **Backend Server**.
2. If you do not want to create a **Backend Server,** disable the toggle and click **Next**.

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FYQU8A9lHKCGUUeF9ns9g%2Fimage.png?alt=media&#x26;token=68e5ff92-3981-4e02-9204-ad6fdf723e51" alt=""><figcaption></figcaption></figure>

| **Field**         | **Description**                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Add Servers\*     | Select the servers from the dropdown.                                                                                                 |
| Specific IP       | Enter the specific IP you want to Add and click on **Add** button.                                                                    |
| Name              | Name of the server.                                                                                                                   |
| IP Address        | IP address of the server.                                                                                                             |
| Associated Subnet | Name of the subnet, associated with the server.                                                                                       |
| Specific Port\*   | Enter the specific port you want to add.                                                                                              |
| Monitor Address   | Enter an alternate IP address used for health monitoring a member.                                                                    |
| Monitor Port      | Enter an alternate protocol port used for health monitoring a member.                                                                 |
| Weight            | Enter the weight of a member determines the portion of requests or connections it services compared to the other members of the pool. |

**Step 8:** Review your load balancer details and click the **Create** button.

<figure><img src="https://2627469859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4xe4XNC0Kdt8dOCWNCOa%2Fuploads%2FnCWATbwkPTFIdouqo0Ch%2Fimage.png?alt=media&#x26;token=31dcdd27-f507-4a79-9350-22b5485505f7" alt=""><figcaption></figcaption></figure>
