Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | # |
| 2 | # IP Virtual Server configuration |
| 3 | # |
Jan Engelhardt | a6938a1 | 2007-05-23 14:48:10 -0700 | [diff] [blame] | 4 | menuconfig IP_VS |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 5 | tristate "IP virtual server support (EXPERIMENTAL)" |
Sam Ravnborg | 6a2e9b7 | 2005-07-11 21:13:56 -0700 | [diff] [blame] | 6 | depends on NETFILTER |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 7 | ---help--- |
| 8 | IP Virtual Server support will let you build a high-performance |
| 9 | virtual server based on cluster of two or more real servers. This |
| 10 | option must be enabled for at least one of the clustered computers |
| 11 | that will take care of intercepting incoming connections to a |
| 12 | single IP address and scheduling them to real servers. |
| 13 | |
| 14 | Three request dispatching techniques are implemented, they are |
| 15 | virtual server via NAT, virtual server via tunneling and virtual |
| 16 | server via direct routing. The several scheduling algorithms can |
| 17 | be used to choose which server the connection is directed to, |
| 18 | thus load balancing can be achieved among the servers. For more |
| 19 | information and its administration program, please visit the |
| 20 | following URL: <http://www.linuxvirtualserver.org/>. |
| 21 | |
| 22 | If you want to compile it in kernel, say Y. To compile it as a |
| 23 | module, choose M here. If unsure, say N. |
| 24 | |
Jan Engelhardt | a6938a1 | 2007-05-23 14:48:10 -0700 | [diff] [blame] | 25 | if IP_VS |
| 26 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | config IP_VS_DEBUG |
| 28 | bool "IP virtual server debugging" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | ---help--- |
| 30 | Say Y here if you want to get additional messages useful in |
| 31 | debugging the IP virtual server code. You can change the debug |
| 32 | level in /proc/sys/net/ipv4/vs/debug_level |
| 33 | |
| 34 | config IP_VS_TAB_BITS |
| 35 | int "IPVS connection table size (the Nth power of 2)" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 36 | default "12" |
| 37 | ---help--- |
| 38 | The IPVS connection hash table uses the chaining scheme to handle |
| 39 | hash collisions. Using a big IPVS connection hash table will greatly |
| 40 | reduce conflicts when there are hundreds of thousands of connections |
| 41 | in the hash table. |
| 42 | |
| 43 | Note the table size must be power of 2. The table size will be the |
| 44 | value of 2 to the your input number power. The number to choose is |
| 45 | from 8 to 20, the default number is 12, which means the table size |
| 46 | is 4096. Don't input the number too small, otherwise you will lose |
| 47 | performance on it. You can adapt the table size yourself, according |
| 48 | to your virtual server application. It is good to set the table size |
| 49 | not far less than the number of connections per second multiplying |
| 50 | average lasting time of connection in the table. For example, your |
| 51 | virtual server gets 200 connections per second, the connection lasts |
| 52 | for 200 seconds in average in the connection table, the table size |
| 53 | should be not far less than 200x200, it is good to set the table |
| 54 | size 32768 (2**15). |
| 55 | |
| 56 | Another note that each connection occupies 128 bytes effectively and |
| 57 | each hash entry uses 8 bytes, so you can estimate how much memory is |
| 58 | needed for your box. |
| 59 | |
| 60 | comment "IPVS transport protocol load balancing support" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 61 | |
| 62 | config IP_VS_PROTO_TCP |
| 63 | bool "TCP load balancing support" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | ---help--- |
| 65 | This option enables support for load balancing TCP transport |
| 66 | protocol. Say Y if unsure. |
| 67 | |
| 68 | config IP_VS_PROTO_UDP |
| 69 | bool "UDP load balancing support" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 70 | ---help--- |
| 71 | This option enables support for load balancing UDP transport |
| 72 | protocol. Say Y if unsure. |
| 73 | |
| 74 | config IP_VS_PROTO_ESP |
| 75 | bool "ESP load balancing support" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 76 | ---help--- |
Matt LaPlante | 44c0920 | 2006-10-03 22:34:14 +0200 | [diff] [blame] | 77 | This option enables support for load balancing ESP (Encapsulation |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 78 | Security Payload) transport protocol. Say Y if unsure. |
| 79 | |
| 80 | config IP_VS_PROTO_AH |
| 81 | bool "AH load balancing support" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 82 | ---help--- |
| 83 | This option enables support for load balancing AH (Authentication |
| 84 | Header) transport protocol. Say Y if unsure. |
| 85 | |
| 86 | comment "IPVS scheduler" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 87 | |
| 88 | config IP_VS_RR |
| 89 | tristate "round-robin scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 90 | ---help--- |
| 91 | The robin-robin scheduling algorithm simply directs network |
| 92 | connections to different real servers in a round-robin manner. |
| 93 | |
| 94 | If you want to compile it in kernel, say Y. To compile it as a |
| 95 | module, choose M here. If unsure, say N. |
| 96 | |
| 97 | config IP_VS_WRR |
| 98 | tristate "weighted round-robin scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 99 | ---help--- |
| 100 | The weighted robin-robin scheduling algorithm directs network |
| 101 | connections to different real servers based on server weights |
| 102 | in a round-robin manner. Servers with higher weights receive |
| 103 | new connections first than those with less weights, and servers |
| 104 | with higher weights get more connections than those with less |
| 105 | weights and servers with equal weights get equal connections. |
| 106 | |
| 107 | If you want to compile it in kernel, say Y. To compile it as a |
| 108 | module, choose M here. If unsure, say N. |
| 109 | |
| 110 | config IP_VS_LC |
| 111 | tristate "least-connection scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | ---help--- |
| 113 | The least-connection scheduling algorithm directs network |
| 114 | connections to the server with the least number of active |
| 115 | connections. |
| 116 | |
| 117 | If you want to compile it in kernel, say Y. To compile it as a |
| 118 | module, choose M here. If unsure, say N. |
| 119 | |
| 120 | config IP_VS_WLC |
| 121 | tristate "weighted least-connection scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 122 | ---help--- |
| 123 | The weighted least-connection scheduling algorithm directs network |
| 124 | connections to the server with the least active connections |
| 125 | normalized by the server weight. |
| 126 | |
| 127 | If you want to compile it in kernel, say Y. To compile it as a |
| 128 | module, choose M here. If unsure, say N. |
| 129 | |
| 130 | config IP_VS_LBLC |
| 131 | tristate "locality-based least-connection scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 132 | ---help--- |
| 133 | The locality-based least-connection scheduling algorithm is for |
| 134 | destination IP load balancing. It is usually used in cache cluster. |
| 135 | This algorithm usually directs packet destined for an IP address to |
| 136 | its server if the server is alive and under load. If the server is |
| 137 | overloaded (its active connection numbers is larger than its weight) |
| 138 | and there is a server in its half load, then allocate the weighted |
| 139 | least-connection server to this IP address. |
| 140 | |
| 141 | If you want to compile it in kernel, say Y. To compile it as a |
| 142 | module, choose M here. If unsure, say N. |
| 143 | |
| 144 | config IP_VS_LBLCR |
| 145 | tristate "locality-based least-connection with replication scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | ---help--- |
| 147 | The locality-based least-connection with replication scheduling |
| 148 | algorithm is also for destination IP load balancing. It is |
| 149 | usually used in cache cluster. It differs from the LBLC scheduling |
| 150 | as follows: the load balancer maintains mappings from a target |
| 151 | to a set of server nodes that can serve the target. Requests for |
| 152 | a target are assigned to the least-connection node in the target's |
| 153 | server set. If all the node in the server set are over loaded, |
| 154 | it picks up a least-connection node in the cluster and adds it |
| 155 | in the sever set for the target. If the server set has not been |
| 156 | modified for the specified time, the most loaded node is removed |
| 157 | from the server set, in order to avoid high degree of replication. |
| 158 | |
| 159 | If you want to compile it in kernel, say Y. To compile it as a |
| 160 | module, choose M here. If unsure, say N. |
| 161 | |
| 162 | config IP_VS_DH |
| 163 | tristate "destination hashing scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 164 | ---help--- |
| 165 | The destination hashing scheduling algorithm assigns network |
| 166 | connections to the servers through looking up a statically assigned |
| 167 | hash table by their destination IP addresses. |
| 168 | |
| 169 | If you want to compile it in kernel, say Y. To compile it as a |
| 170 | module, choose M here. If unsure, say N. |
| 171 | |
| 172 | config IP_VS_SH |
| 173 | tristate "source hashing scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 174 | ---help--- |
| 175 | The source hashing scheduling algorithm assigns network |
| 176 | connections to the servers through looking up a statically assigned |
| 177 | hash table by their source IP addresses. |
| 178 | |
| 179 | If you want to compile it in kernel, say Y. To compile it as a |
| 180 | module, choose M here. If unsure, say N. |
| 181 | |
| 182 | config IP_VS_SED |
| 183 | tristate "shortest expected delay scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 184 | ---help--- |
| 185 | The shortest expected delay scheduling algorithm assigns network |
| 186 | connections to the server with the shortest expected delay. The |
| 187 | expected delay that the job will experience is (Ci + 1) / Ui if |
| 188 | sent to the ith server, in which Ci is the number of connections |
Matt LaPlante | cab0089 | 2006-10-03 22:36:44 +0200 | [diff] [blame] | 189 | on the ith server and Ui is the fixed service rate (weight) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 190 | of the ith server. |
| 191 | |
| 192 | If you want to compile it in kernel, say Y. To compile it as a |
| 193 | module, choose M here. If unsure, say N. |
| 194 | |
| 195 | config IP_VS_NQ |
| 196 | tristate "never queue scheduling" |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 197 | ---help--- |
| 198 | The never queue scheduling algorithm adopts a two-speed model. |
| 199 | When there is an idle server available, the job will be sent to |
| 200 | the idle server, instead of waiting for a fast one. When there |
| 201 | is no idle server available, the job will be sent to the server |
| 202 | that minimize its expected delay (The Shortest Expected Delay |
| 203 | scheduling algorithm). |
| 204 | |
| 205 | If you want to compile it in kernel, say Y. To compile it as a |
| 206 | module, choose M here. If unsure, say N. |
| 207 | |
| 208 | comment 'IPVS application helper' |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 209 | |
| 210 | config IP_VS_FTP |
| 211 | tristate "FTP protocol helper" |
Jan Engelhardt | a6938a1 | 2007-05-23 14:48:10 -0700 | [diff] [blame] | 212 | depends on IP_VS_PROTO_TCP |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 213 | ---help--- |
| 214 | FTP is a protocol that transfers IP address and/or port number in |
| 215 | the payload. In the virtual server via Network Address Translation, |
| 216 | the IP address and port number of real servers cannot be sent to |
| 217 | clients in ftp connections directly, so FTP protocol helper is |
| 218 | required for tracking the connection and mangling it back to that of |
| 219 | virtual service. |
| 220 | |
| 221 | If you want to compile it in kernel, say Y. To compile it as a |
| 222 | module, choose M here. If unsure, say N. |
| 223 | |
Jan Engelhardt | a6938a1 | 2007-05-23 14:48:10 -0700 | [diff] [blame] | 224 | endif # IP_VS |