Table of Contents SECTION I - GENERAL INFORMATION ........................7 About AVANU® ..................................7 WebMux User Manual................................ 7 Audience ........................................7 Notice of Rights ....................................... 7 Notice of Liability ..................................... 7 Trademarks ........................................ 7 Update Information ....................................8 Packing List ....................................8 Contact Information ................................
Page 3
Hardware Setup - Collect Information............................. 30 Hardware Setup - Network Environment ..........................30 Initial Setup Though LCD Panel ..........................30 The LCD Setup Screens ................................. 31 Factory Reset: ....................................... 39 Fixing Configuration Mistakes..............................39 Bond All Interfaces Setup ................................39 Setting Up the Management Port ..............................
Page 4
Routing Table ..................................69 Reconfigure ................................... 71 Security ....................................72 Security ........................................72 Change Password ....................................73 Change PIN......................................74 AAD (Automatic Attack Detection) ............................75 Flood Control ......................................76 Flood Control Display ..................................76 Flood Control History..................................77 Miscellaneous ..................................77 Show Events ......................................
Page 5
Modify Service ....................................108 Save .......................................... 109 Health......................................109 Timeouts ........................................ 109 Frequency ......................................110 Custom ........................................110 HTTP ........................................113 SECTION VII – SSL MANAGEMENT ........................114 SSL Keys ....................................114 Generating a CSR ................................116 Importing Your Existing Private Key and Certificate ..................118 SECTION VIII - HOW TO ADD A LOOPBACK ADAPTER ................119 Installing the Microsoft®...
AVANews, AVE, BAM, BlogWithUs, DNSMux, Inspired to Innovate, MAP, and WebMux are trademarks of AVANU, Inc. AVANU states that we are using any and all trademarked names in an editorial fashion and to the benefit of the trademark owner with no intention of infringement of the trademark.
Update Information AVANU will always work to insure that the data contained in any WebMux documents are kept up to date. As such, please visit our website at www.avanu.com/documents to retrieve the latest version of our documents. All products and specifications are subject to change without notice.
SECTION II - WEBMUX MAIN COMPONENTS Front View Switches and Indicator Lights Power This switch toggles power on and off. To power off, the switch must be pressed and held for 5 seconds. However, it is recommended that you do not regularly use this power switch to shut down the unit.
It will take about a minute for the WebMux to completely reboot and begin reporting activity in the LCD display. This will not reset your settings. It is for forcing restarts. To perform a factory reset refer to the Factory Reset part in Section IV for LCD instructions reference.
Page 11
RS-232 port is available for serial console connections as well as for modem-dependent services, such as paging—where Internet-based services may be limited for security purposes. To connect to this port using a serial communications terminal, set the communications software for 115200 baud, 8 bit, Parity none, 1 stop bit. MGMT port is a Gigabit Ethernet LAN connection that enables management (GUI and command- line) to be limited to a separate port and network.
SECTION III - WEBMUX TOPOLOGY OVERVIEW WebMux Topology Modes Two-Armed Network Address Translation/NAT Mode Two-Armed Transparent Mode One- Armed Single Network Mode One-Armed Direct Server Return/DSR IPv4 and IPv6 work in all the modes. Each mode has its advantages and disadvantages. In NAT mode, the farm IP address is on the router LAN/Internet side that will be used to as the access point for the site.
For example, to configure a farm (or virtual farm) to serve www.avanu.com: First, Server 1 and Server 2 would each need the website www.avanu.com configured on them and HTTP/HTTPS services started; and Second, a farm on the WebMux is defined with Server 1 and Server 2 in it. The servers...
Page 14
and standby server. In either case, if Server 1 goes down, Webux will redirect all traffic to Server 2.
Page 15
Two-Armed NAT Mode (Single WebMux) In this example, One WebMux unit is used One WebMux interface (internet) connects to the router LAN. The other interface (server) connects to the server LAN The WebMux translates the router LAN IP addresses to private Class C addresses. In this example, the netmask is 255.555.255.0.
Page 16
Changes to the server: Set their IP addresses to the 192.168.199.xxx subnet and make their default gateway point to 192.168.199.1. If a service on the server (HTTP/S, FTP, etc.) is listening on a specific IP address, please make sure the service is configured to listen on the new IP address.
Page 17
Two-Armed NAT Mode (Redundant WebMux Installation) In this example, Two WebMux units are used. One is the primary and the other is the secondary. They connect together with an Ethernet cable (straight or crossover) or through a hub or switch.
Page 18
The default gateway for all the servers is 10.1.1.1 Farm 1 IP address is 205.133.156.200 Servers 1 and 2 serve Farm 1 Farm 2 IP address is 205.133.156.210 Servers 2 and 3 serve Farm 2 ...
Two-Armed Transparent Mode Transparent Mode is a WebMux configuration that allows you to keep the existing IP addresses of your servers. Like Direct Server Return Mode (explained later), the servers and the WebMux will be on the same IP network segment. However, physically, the servers will be connected to the WebMux in the same way they would be for NAT mode: on the server LAN port.
Page 20
can communicate with the servers IP directly as if the WebMux was not there, and vice versa. When creating a farm, choose a unique IP for the farm address in the network, and then add the server IP address under that farm. Load balancing occurs when the “Farm IP” is accessed instead of the servers’...
One-Armed Single Network Mode The WebMux supports two kinds of “One-Armed” modes: Single Network Mode and Direct Server Return (DSR) Mode. For Single Network Mode, there are no changes required for the network topology or server IP addresses. Requests from clients go to the farm address on the WebMux, which will in turn go to the servers through load balancing methods.
One-Armed Direct Server Return/DSR In Direct Server Return (DSR) Mode, only the server LAN is connected to the network. Internet traffic or local connections can both be directly sent to the WebMux, which forwards the packets to the proper server(s). The server(s) routes the return traffic back to the remote or local clients directly.
Page 23
One-Armed Direct Server Return/DSR Mode (Installation without IP Address Change) The above diagram is an example about how to configure the WebMux in DSR Mode without changing the IP addresses of the web servers and other servers that already exist on the network.
For DSR Mode to work properly, the loopback adapter must route the return traffic through the real network interface. In other words, the loopback adapter cannot have the gateway specified. Information on how to add a “How to Add a Loopback loopback adapter on servers can be found in the Adapter”...
software/client is indeed IPv6 capable or is the correct IPv6 version to use before assuming that your network is not working. Also, when adding an IPv6 address to your server’s NIC (network interface card), your server’s OS might not automatically add a default gateway in its routing table for the IPv6 address. Please double check the routing tables and make sure the proper entries are there.
explicitly click the save button on the main console page of the primary unit when changes are made. Changes will not propagate to the secondary unit until this is done. There are a few things to keep in mind when you have two units paired in a high availability configuration.
probes. Otherwise, a failover will occur and if the secondary unit is unable to get a response from the default gateway as well, both units can potentially become inactive. d) Multiple uplink gateways/next hop farms. The WebMux will not failover to the secondary unit as long as there is one active gateway available.
Page 28
e) Multiple uplink gateways/nexthop farm. (See the explanation in NAT mode)
For example, http://www.you.com can be one virtual server farm; https://www.me.com is another farm, and ftp://ftp.avanu.com is the third farm. The first farm works on a set of servers on port 80, the second farm consists of another set of servers on port 443, and the third farm works on a set of servers on port 21.
The WebMux has four modes: Two-Armed Network Address Translation/NAT Mode, Two-Arm Transparent Mode, One-Armed Single Network Mode, and One-Armed Direct Server Return/DSR Mode. In NAT mode, the WebMux units are connected to both Router LAN and Server LAN. At least one WebMux is needed to define the Router LAN and the Server LAN. We will explain other modes in detail in later chapters.
The IP addresses in the following examples are general examples and are not meant for literal use in an actual setup Turn on the WebMux by pushing the power-on button in the front of the WebMux momentarily. You will see the version number on the LCD panel like this: After the unit has fully booted, you will see a scrolling instruction screen.
Page 32
Is this a Primary WebMux? If this is the Primary, answer Yes. If this is the Secondary WebMux, answer NO. Please note, you must still do the initial configuration on the secondary unit as well. Primary WebMux Information This question is not asked for the Secondary WebMux. Is this WebMux running solo without a backup WebMux? If the Primary WebMux is running in a standalone configuration (see sample configuration—...
Page 33
This is not true in Transparent, Single Network, or Direct Server Return modes. Using the same router LAN IP both units will create duplicate IPs. Enter Router LAN Network IP Address Mask: This is the network mask of the Router LAN network. It is usually 255.255.255.0 for Class C networks.
Page 34
This is the optional VLAN ID tag that will be used for the Router LAN (Internet) interface. You may enter values from 1 – 4067. The cursor position will only go from 0 to 9. To enter a value greater than a single digit, press the left arrow button to move the cursor to the next digit.
Page 35
This will be the IP address of the WebMux on the network so that you can use a web browser to manage it. Although the “server” and “internet” ports are interchangeable in transparent mode, it is recommended that you stick with a labeling scheme and connect the port labeled “internet”...
Page 36
In an installation with a primary and secondary WebMux, one unique IP address is required for each WebMux interface that connects to the Server LAN. Those two unique IP addresses are in addition to the farm IP address that is floating between the primary and secondary WebMux.
Page 37
Enter External Gateway: This is the common setup for NAT, Transparent, Single Network and Direct Server Return modes. This is an address on the firewall or router local interface. In NAT mode, the WebMux needs to know this to route the server replies back to the clients. Although in Direct Server Return Mode this is not being used to route return traffic back to the Internet clients, the WebMux uses this IP address to check the connectivity of the external network on this gateway or through this gateway to the ISP side routers.
Page 38
This is the HTTPS port number for accessing Management Console in secure mode. The factory default port number is 35, and one could choose to use any unused port below 1024 or port number above 1024 for this. Using a port number above 1024 will require you to set up an “admin farm IP”.
default at 50. Valid values are from 0 to 100. The setting is activated when you press the check mark button. Going back to this screen will bring the value back to the default of 50. Factory Reset: Pressing the “down” button or the check mark button from the “LCD Brightness” screen will bring you to the factory reset option.
Page 40
In the following example, we will be configuring a WebMux in NAT Mode using the “Bond rtr/svr NI” option enabled: RTR LAN IP: 192.168.12.21 RTR LAN mask: 255.255.255.0 SVR LAN IP: 192.168.11.21 SVR LAN mask: 255.255.255.0 RTR LAN vlan id: 100 SVR LAN vlan id: 200 Bond svr/rtr NI? YES SVR LAN gateway IP: 192.168.11.1...
device connected to port 7, 8, 9, or 10 (and assuming that it already has a 192.168.11.0/24 address), you should now be able to ping the WebMux svr LAN IP address of 192.168.11.21. Setting Up the Management Port The management port on the WebMux is a dedicated interface on its own subnet. If you have a DHCP server on your network, an IP address will automatically be assigned to this interface when you plug it in to the network.
Initial Setup Through a Web Browser Web GUI Initialization Interface: You may want to change the basic settings for the WebMux through the web Graphical User Interface (web GUI), for example, when the WebMux located in a hosting center across the country.
Page 43
Click the mouse into a field or use the TAB key to move the cursor into a field to see the current values. The user may change it based on new information obtained from ISP or network engineers. Once you press on the submit button, the WebMux will save all the changes to its internal solid state storage and reboot itself with the new value.
WebMux Reconfigure Screen (an alternate way): You can also access these setting from the regular management console in the “reconfigure” screen of the “network” section of the menu. SECTION V – Management Console for more details on accessing the regular management console.
Page 45
The configuration wizards are intended to be for first time setup and one time use. Once you have configured the WebMux via the configuration wizard, additional configuration modifications should be done via the WebMux management GUI. Each wizard will contain its own set of detailed instructions.
Page 46
WebMux has rebooted and comes back online, you can log in to the regular WebMux GUI and make modifications to the resulting configurations.
Command Line Interface (CLI) Accessing the CLI The CLI commands are intended for main initialization and simple diagnostics. You can use ssh or telnet to access the CLI commands to help troubleshoot network problems or server problems. There are maximum two diagnostic ports. By default they are 77:87. The first one will be SSH and second one will be Telnet.
Please enter WebMux's host name without domain [default "webmux"]: . . . and so on. CLI Commands List There are more commands available in CLI: about - displays WebMux model, serial number, and firmware version information. arp - manipulate the system ARP cache arping - ping <address>...
Page 49
getallsettings - save all WebMux settings from WebMux to your PC getconfig - save all farm/server settings from WebMux to your PC hwclock - displays current hardware date and time. Allows you to adjust hardware date and time ifconfig - display and configure a network interface(s) ip - TCP/IP interface configuration and routing utility ip - command for configuring network interfaces and network settings.
sysinit - allows you to create a custom startup script. (Useful for making custom iptables rules reboot permanent, etc) See the “Adding Commands to WebMux Startup Sequence” section for details. takeover - utility to temporarily disable secondary WebMux takeover. Useful when doing firmware updates on paired systems.
$ sysinit —help usage: sysinit [—help] [—quiet] [—write] —help print help —quiet skip prompts and confirmation —write write stdin to superuser’s sysinit script table (without parameter will read existing table) The superuser’s sysinit table may contain any commands that are allowed at the superuser’s command prompt. At system startup, it will be run after networking has been started.
WebMux is connected must also be configured correctly to use these tags. (When additional networks are configured for the WebMux using the superuser’s command line utility nwconfig, you may also arrange for their VLAN tagging at that time). Besides configuring the WebMux to use VLAN tags, the switches to which the WebMux is connected must be configured to use these tags.
Page 53
With multiple uplink, you can configure the WebMux to use multiple ISPs and gateways. The WebMux uses source based routing to be sure that packets that came in from one ISP will return through the same ISP. All uplinks are useable simultaneously. Once you have configured farms on both networks, the WebMux will monitor the default gateways of the different uplinks and failover to any available ISPs should one ISP go down.
Page 54
-L|—list [PATTERN … ] list existing additional network configurations whose name match the given pattern(s). If no pattern is given, list all additional network configurations. -m|—netmask NETMASK network mask for the network is NETWORK, e.g., 255.255.255.0 -n|—network NETWORK address of the network is NETWORK, e.g., 192.168.14.0 -r|—router-vid VID VLAN ID for the network for the router in transparent mode -s|—server-vid VID...
Page 55
Even though the WebMux allows for this kind of configuration, it is generally not recommended. We suggest that all separate networks be on separate VLAN IDs. Also, you cannot create an additional network with a VLAN ID unless the original network is also configured with a VLAN ID.
Page 56
It is important to remember that when you are running a setup involving SSL termination that you must point your servers’ default gateway back to the WebMux. In the original network configuration, you had an option to create a “server LAN gateway IP.” The servers used this IP address as their default gateway IP.
This pane also contains clickable elements. The “menu” element will hide or show the menu pane (pane 2). Clicking on the “AVANU WebMux” logo will open a new browser window to the www.avanu.com site.
Page 58
Pane 4 is the navigation pane. The navigation pane contains back, forward, and reload buttons that behave like the browser’s back, forward, and reload buttons. However, these navigation buttons only affect pane 3 (the console page). Whereas, the browser’s navigation buttons might affect the whole browser screen.
Logging into the WebMux Web GUI Login Page: Start a web browser from your management workstation. Set URL to https://webmuxip:webmuxport/ webmuxip is the IP address of the WebMux on the server LAN. webmuxport is the management port address of the WebMux. The default ports are 24 for an unsecured connection, and 35 for the secured connection.
PASSWORD superuser superuser webmux webmux It is recommended to change the passwords periodically. No new user ID can be added, with exception of using a TACACS+ or LDAP server Login: After entering the correct password, click Login. For first time setup, please login as superuser and go to the Network Admin screen, within the Network menu section.
Page 61
already have some farms and servers configured, you can do the following things from the main status screen: Adjusting Health Check Timeout for Each Service Clicking on the service type (under the service column) for the farm will take you to the “modify service timeout”...
The main status screen updates every 5 seconds. When the mouse is hovered over it or if you touch that part of the screen on a touch screen, the updating will pause until you move the mouse elsewhere or touch another part of the web GUI. The second item in the “main”...
Show Graphs To monitor the traffic history, memory and CPU usage, the WebMux maintains some of its statistics information in the memory during running. The WebMux is able to keep a maximum of 2 weeks worth of activity history. This history of information is able to persist past reboots. Time Period to Display Adjust the the time span of the history you would like to view by selecting from the drop down menu:...
Farm Management SECTION VI for details about this menu section. Health SECTION VI for details about this menu section. Network Network Admin After completing the initial WebMux configuration, you will want to configure these settings next. These settings can always be changed later in the future as needed. Note that some setting will require a reboot of the WebMux to take effect.
Page 65
unit’s complete IPv6 address will be fec0::192.168.12.21 (or fec0::c0a8:c15). For additional “IPv6 Considerations” in SECTION III – WEBMUX information reference the section on TOPOLOGY OVERVIEW in this User Manual. DNS Server(s) IPv4 address(es) The WebMux will attempt to resolve names for settings such as the email server for email notifications and front network verification (if an FQDN of an external site is used instead of your external gateway/firewall IP).
Page 66
LEVEL SEARCH KEY DESCRIPTION INFO STATS LCD display messages NOTICE LOGIN Successful browser login/logout NOTICE SETUP Significant access and changes to setup and configuration items NOTICE EVENT Same as paper/mail messages WARNING LOGIN Unsuccessful browser login Server Gateway IP Address This setting is the same setting from the “server LAN gateway IP”...
Page 67
Since any IP address on the WebMux (including farm IPs) listen on the control port, a non-standard port has been selected for the management port. If you have a farm IP using port 35 as well, the WebMux will not be able to determine if the incoming connection is destined for the management console or for network traffic management.
Page 68
Act as IP Router If YES is selected, the WebMux router LAN IP can be used to route IP packets to the private server LAN side. The WebMux will not act as a firewall in this mode. If NO is selected, the WebMux will NOT route incoming IP packets through the WebMux. Only connections to farms will be able to reach services in the server LAN side.
the best value for most cases. The larger the persistence timeout value, the less chance the user connection will get sent to a different server. Keep in mind that by keeping a lot of connections in the WebMux memory, the maximum number of available connections for new clients will drop.
Page 70
Routes displayed that are “grayed out” cannot be modified. To add a route, make sure “make indicated changes” is selected in the drop down menu, click the “add” checkbox, and fill in the remaining fields. Click the “submit” button. Your new route should appear along with a “delete” checkbox.
Reconfigure The Reconfigure button will bring you to the initial network settings page. Additional details about “Initial Setup Through a Web Browser” section in SECTION IV – this can be found under the CONFIGURING THE WEBMUX in this User Manual.
Security Security Allowed Remote Host IPs The WebMux Web Management Administrative Console only allow logins from these IP addresses to establish a management session. You can allow access from more than one IP address by specifying all the allowed IP addresses separated by a “:” (except use “,” as the separator for IPv6 addresses).
LDAP server IPv4 URL Access to the WebMux GUI or CLI can be authenticated by an OpenLDAP server. Enter the LDAP location as a URL, such as ldap://192.168.12.1:389. LDAP domain Enter the LDAP domain in this field. Connection Warning Threshold The WebMux monitors the number of connections established.
New Password Enter the new password for the selected login level. New Password Again Enter the same password as in the previous box. If this does not match the password entered in the previous field, you will get a notification page stating so and you will need to try again.
AAD (Automatic Attack Detection) The Automatic Attach Detection (AAD) security feature controls how many concurrent open TCP connections from a single source IP address is allowed to connect. TCP Connection Attack Threshold This will set the maximum number of concurrent connections a client can make before the WebMux will consider it an attack.
Flood Control The Flood Control security feature limits the maximum allowable packet transfer rate for any single IP address connecting through the WebMux. Packet Rate This will control the packets per second rate that will be allowed. Packet Threshold Some attacks are done in bursts rather than large streams. While the packet rate parameter will control the maximum allowable steady rate of packets, the packet threshold detects the maximum allowable packet bursts.
Flood Control History The Flood Control History screen will show all the past and current blocked and released IP addresses. Miscellaneous Show Events This page will show you the history of WebMux events such as detection of server dead status. Events will be saved past reboots.
Backup/Restore Backup This feature allows the saved configuration to be saved as a file on the local computer you are using to access the WebMux web interface. Be sure you have saved your farm configurations from the main screen before exporting your configuration to ensure that you are getting your most recent changes.
Set Clock Click the “set clock” link in the drop down menu and proceed to the page that controls the clock settings. The time and date of the WebMux can then be set. Please note that the WebMux internally uses GMT time zone, not your local time zone, per W3C/HTTP protocol. If the time zone is not set correctly, the browser access could be denied due to “cookie”...
Page 80
3. Set the time manually using the form: Month Enter the number of the month, 1 through 12. Leading zeroes are not necessary. Day of the Month Enter the day of the month, 1 through 31. Year Enter the year. Enter all 4 digits. Hour Enter the hour of the day.
Upgrade To upgrade the WebMux firmware, you will first need to contact WebMux support at techsupport@avanu.com and request for the latest firmware image. Save that image to your local computer and use the Browse button to find that file. After you have selected the file, click...
Wizards This will take you to the configuration wizards index page: The configuration wizards are intended to be a first time and one time use feature. These wizards will set all the main settings for the WebMux (IP addresses, dispatch method, farm and servers, etc.) all in one shot.
TCPdump The tcpdump page allows you to do a simple packet capture session through the web interface. Tcpdump is a useful utility for network traffic diagnotics. You can use this to check if hosts are passing through the WebMux or to check if the WebMux is sending packets to the proper distination, among other things.
Page 84
IP address Specify the IP address of the host you want to capture. Port number Specify the port you want to filter for. Count This will stop the capture when this number of packets have been reached Timeout in seconds This will stop the capture when the timeout period (in seconds) has been reached.
Login This will bring you back to the login screen should you wish to quickly switch user accounts. THIS DOES NOT LOG OUT YOUR CURRENT SESSION. When you log in as a different user, the old session will end. However, we normally recommend that you correctly end your current session by using the Logout from the drop down menu.
Reboot Changes to “TACACS+ server configuration,” “server gateway address,” “server farm network mask,” “WebMux http control port,” “WebMux https control port,” “WebMux SNMP UDP Port,” “WebMux SNMP Community,” “WebMux diagnostic ports,” “least significant bits,” “forwarding policy,” “front network verification,” and “persistence timeout”, many other fields that are marked with an asterisk (*) require a reboot for the new configuration to take effect.
Help Online Manual This will open a new windows to take you to the www.avanu.com support pages. About WebMux This will take you to the “about” screen of the WebMux. Here you will see information about your WebMux unit, such as the firmware version, the model number, the serial number, etc.
SECTION VI – FARM MANAGAMENT AND HEALTH Farm Management Add Farm This screen is where you create your farms and select your options for load balancing. Some fields may be displayed or hidden depending on what options you might select. Label This is for your visual reference to be displayed on the main console for the farm entry.
Page 89
IP address of www.mydomain.com is 205.188.166.10, then the Farm IP address is also 205.188.166.10. The WebMux will then forward requests to the farm address to the web server address in your DMZ or internal network. Virtual Host Name For web servers that are serving name based virtual hosts, this field will be important for the WebMux to perform a correct health check.
Page 90
that farm serves all the virtual farms, the WebMux expects the problem with one server in one URL will affect all the URLs in that farm. Another situation: the server that serves HTTP virtual sites is using a single private IP address already before load balancing.
Page 91
Please choose “Generic TCP” and specify port number, if service is not listed below. If multiple ports to be used, please also select “Generic TCP” and specify port number “0.” SERVICE PROTOCOL COMMON PORT # DNS – Domain Name Service FTP –...
Page 92
Weighted round robin—persistent Weighted fastest response Weighted fastest response—persistent HTTP to HTTPS redirect (see SECTION IX for more information about this feature) SSL Termination You must first import your private key and certificate in the SSL Key Management screen. SECTION VII –...
Page 93
originating connection was HTTPS or HTTP. This may be important if the application on the server requires that kind of information. You can turn on “tag SSL-terminated HTTP requests.” By selecting “Yes,” the decrypted traffic to the servers will have the added MIME header “X-WebMux-SSL-termination: true.”...
Page 94
SNAT Enable SNAT for the farm. SNAT means that all requests being load balanced through the farm will have the source IP that comes from the WebMux rather than the original requesting client. HTTP Server Response Comparison String When a string is entered in this field, WebMux HTTP Health Check will search the first 1024 bytes in the HTML content.
Add Server In the Modify Farm screen click on the “Add Server” button to add a new server to this farm. Or you can select the radio button of the farm from the main screen and click on the “Add Server” button on the left.
This is for scheduling priority weight. Valid integer numbers are between 1 and 100. A server that has a weight of 2 will be directed twice as much traffic as a server with a weight of 1. A special zero weight setting is provided for a graceful shutdown of a server. When the weight is changed to zero, the WebMux will not send new connections, but will maintain all current connections to the server.
Page 97
The “Modify Farm” screen looks like this. Some of the fields will be hidden or displayed depending on some of your selections. Farm IP Address and Port Number The farm IP and port that is being modified will be displayed. These fields are set in the “Add Farm”...
Page 98
Least connections Least connections - persistent Round robin Round robin—persistent Weighted least connections Weighted least connections—persistent Weighted round robin Weighted round robin—persistent Weighted fastest response Weighted fastest response—persistent SSL Termination You can enable or change the SSL key/certificate pair used for this farm.
When a string is entered in this field, WebMux HTTP Health Check will search the first 1024 bytes in the HTML content. String is a case sensitive match. HTTP Server URI By default, the WebMux health check checks default page of the server. If specifying a URI here, the WebMux will use this URI instead of the default page do health check.
Page 100
Destination server IP address and port number: The IP and port of the selected server is displayed. These parameters are set in the “Add Server” screen. Once set, these fields cannot be modified. To correct this setting, delete the server and add a new one. Label: The label can be changed at any time.
Standby The server will be put into STANDBY, or backup, mode after it is added. The WebMux will change a STANDBY server to ACTIVE when one or more ACTIVE servers fail. The weights will also have an effect on the number of standby servers that are activated.
Page 102
Farm IP and Port This displays the current farm you are modifying. These fields are set in the “Add Farm” screen. Once set, they are not changeable. If they must be changed, delete the farm and then add a new one. IP Address Add an IP address to the current farm configuration.
Specify a port number that doesn’t duplicate any existing IP/port combinations. A port number of “all” will enable all port ranges, but excluding any already existing ports associated with the specified IP address. Please see the note at the end of this section regarding the behaviors of the additional IP/port in conjunction with SSL termination.
Refer to the previeous “Add MAP” section for details about the fields. Delete MAP™ This link carries out an action that requires you to first select a MAP by clicking on the radio button for the MAP in the Main Status screen. Once you have selected a MAP radio button, you can click on this link to delete it from the farm.
Page 105
IP Address: The main WebMux IP address will automatically used if you leave this field blank. This address will be what the WebMux will use as its source IP when checking the health status of the gateway IP address. Label: You can enter a label for reference purposes.
Page 106
Click on the “Add Gateway” button to add more gateways IPs to your gateway farm. IP Address: Enter the IP address of your gateway. Label: The label here is used only for reference purposes. Weight: This is for scheduling priority weight. Valid integer numbers are between 1 and 100. Run State: Active - The gateway will be put into service immediately after it is added.
Page 107
it goes out of service. When the original gateway comes back in service, it will stay Standby mode until manually setting its run state to Active again through the browser interface. This will give system administrators time to fix the system or reboot the gateway once some software/hardware update is completed.
The setting in this page will determine how long or how short the WebMux will wait to be able to verify if the gateway IP is still valid or not. You can disable the checking altogether by setting the timeout value to 0 or you can set the “front network verification” protocol to “none” in the Network Admin section within this User Manual.
Save This link will be highlighted when you have made a configuration change that has not been saved. Clicking this link also forces a paired set of WebMux in HA configuration to synchronize your saved settings. A message will also be displayed and highlighted in the Main Status screen to let you know that an “unsaved in-memory configuration”...
Frequency The health check frequency is the interval in which the WebMux sends out health check probes. In some cases, you might find that the WebMux is probing your servers too often. You can modify the frequency period here. Note, however, that increasing the frequency too much will make the WebMux take longer to mark a server dead or alive.
Page 111
within 15 seconds or the server is considered dead. The custom defined service also allows for CGI code responses that allow the server to change its own weight and announce such change to a remote syslog daemon. Sample Custom CGI Code The custom cgi-bin checking program may be written in Java, VB, C, or Perl, for example, or it may be a WB or shell script.
Page 112
When the WebMux sends its health check, it will provide information in a query string that can be passed to your custom health check script. For example, the actual request from the WebMux will include the query string: /custom?farm=<IP>:<PORT>&server=<IP>:<PORT>&alive=1&standby=0&fav orite=0&lastresort=0&weight=1 “farm”...
Ignore Contents of Custom Check Page This option will disable checking the output of your custom health check script and merely checks if the script file exists on your server. If you have this setting set to yes, you can bypass creating any kind of scripting altogether and just make sure you have a valid file at the location specified in the URI for custom service check field.
SECTION VII – SSL MANAGEMENT SSL Keys This screen is where you can manage your SSL keys and certificates that are used for SSL termination. This is also where you can specify cipher restrictions. The WebMux supports SSL V2, SSL V3, and TLS V1 with RSA key length from 512, 1024, 2048, 4096, and 8192-bit.
Page 115
Key length can be from 512 to 8192. RSA key length 1024 is also called 128 bit strong encryption. At the bottom of the screen you will see the option to choose encryption protocols allowed. This will enable you to restrict SSL connections that do not follow the minimum protocol. If there are already active farms using SSL Termination, then changing this setting will require you to reboot the WebMux to activate changes.
Generating a CSR If you plan to generate new keys, click on the drop down box above the private key window to select the “use newly generated” item with the desired key length, and then click on the “Submit” button. This process is also known as “generating a CSR” or “generating a Certificate Signing Request.”...
Page 117
Please refer to our support site for instructions: http://www.avanu.com/webmux_ssl_certificate You can get OpenSSL for Windows® at: http://www.slproweb.com/products/Win32OpenSSL.html Contact the AVANU technical support department at techsupport@avanu.com for further assistance if problems should arise or for help with executing this process. ...
Importing Your Existing Private Key and Certificate If you already have an existing key and certificate in PEM format, importing them into the WebMux is as easy as cutting and pasting the text into the proper fields. Select an unused key number from the SSL termination management page, for example: Open your key PEM file in a text editor and copy the text starting with -----BEGIN RSA PRIVATE KEY----- all the way to -----END RSA PRIVATE KEY----- (be sure to include BOTH the header and footer).
SECTION VIII - HOW TO ADD A LOOPBACK ADAPTER For Direct Server Return Mode, a loopback adapter (Windows) or setting of similar function (*nix OS) is required. Installing the Microsoft® Loopback Adapter (pre-Windows 8/Server 2012) Click Add Hardware -> Add a new device -> No, I want to select the hardware from a list, and select Microsoft®...
Page 120
Highlight the root device (the PC name). Under the “Action” menu, select “Add legacy hardware”. On the next screen, select “Install the hardware that I manually select from a list (Advanced): Then, select “Network adapters” and click the Next button:...
Page 121
On the next screen, select “Microsoft” on the left pane and “Microsoft KM-TEST Loopback Adapter” on the right pane: Proceed throught the installation process:...
Click the “Finish” button when complete: Configuring the Microsoft® Loopback Adapter (Windows 8/Server 2012 and newer) Open the “Network and Sharing Center” from the Control Panel. Find the “Change adapter settings” link on the left side of the window.
Page 123
In the “Network Connections” window, right click on the Virtual Loopback Adapter (Microsoft KM-TEST Loopback Adapter) and select “Properties”. In the next window, highlight “Internet Protocol Version 4 (TCP/IPv4)” and click on the “Properties” button. In the “Internet Protocol Version 4 (TCP/IPv4) Properties“ screen, enter the FARM IP that the server belongs to and the subnet mask.
Click on the “Advanced” button, then open the “WINS” tab. Make sure “Enable LMHOSTS lookup” is not selected and “Disable NetBIOS over TCP/IP” is selected. Click the OK buttons to submit the changes. Finally, set the Weakhost Settings to complete the installation. Weakhost Settings for Windows Server 2008 and Newer Beginning with Windows®...
To verify the status of your interfaces: netsh interface ipv4 show interfaces level=verbose For Linux®, SUSE® Enterprise Linux®, Hewlett Packard® HP/UX®, FreeBSD®, Oracle® Solaris®, and Apple® Servers perform the following for: Linux® 2.4/2.6 Systems: Log in as root, and add this command to the bootup script: iptables -t nat -A PREROUTING -d <farm_ip>...
Hewlett Packard® HP/UX® 11.00 and 11i: Please make sure PHNE_26771 and related patches applied first. Login as root, and this command to the bootup script: ifconfig lo0:1 farm_ip_address up FreeBSD®: ifconfig l®o0 inet farm_ip_address netmask 255.255.255.255 alias Oracle® Solaris®: ifconfig lo0:1 FARM_IP_ADDR ifconfig lo0:1 FARM_IP_ADDR FARM_IP_ADDR ifconfig lo0:1 netmask 255.255.255.255 ifconfig lo0:1 up...
SECTION IX – HTTP TO HTTPS REDIRECT In some cases, you may need the WebMux to redirect a client coming in via HTTP to HTTPS without having to create rewrite rules on the real servers. The way this feature works is you first have one farm (the “redirect”...
URI Redirect Prefix The prefix will be appended to the front of the original domain name. For example, if you specificy the prefix as “hostname.” and the original URI is http://domainname.com, the rewritten URI will be https://hostname.domainname.com. URI Redirect Suffix The suffix will be append to the end of the URI.
SECTION X – SAMPLE CONFIGURATIONS AND WORKSHEETS Initial Configuration Worksheets Configuration Before WebMux Installation EQUIPMENT IP ADDRESS Internet Router (or Firewall) Address Webserver(s) Default Gateway Web Site IP Addresses Configuration After WebMux Installation ENTRY QUESTION PRIMARY SECONDARY Host Name Domain Name NAT, Transparent, Single Network, or Direct Server Return Router LAN Information (NAT ONLY)
Web Site IP Addresses 205.133.156.200 Configuration After WebMux Installation QUESTION ENTRY Host Name webmux Domain Name avanu.com NAT, Transparent, Single Network, or Direct Server Return Router LAN Information Router LAN WebMux Proxy IP Address 205.133.156.200 Router LAN Network IP Address Mask 255.255.255.0...
205.133.156.1 Web Site IP Addresses 205.133.156.200 Configuration After WebMux Installation QUESTION ENTRY Host Name webmux Domain Name avanu.com NAT, Transparent, Single Network or Direct Server Return Transparent Bridge Information Bridge IP Address 205.133.156.210 Bridge IP Network Mask 255.255.255.0 WebMux farm IP Address 205.133.156.200...
Page 132
Configuration After WebMux Installation QUESTION ENTRY Host Name webmux Domain Name avanu.com NAT, Transparent, Single Network or Direct Server Return Direct Server Return WebMux Server LAN Information Server LAN WebMux IP Address 10.1.2.254 (any) Server LAN WebMux IP Address Mask 255.255.0.0...
Configuration After WebMux Installation ENTRY QUESTION Primary Secondary Host Name webmux1 webmux2 Domain Name avanu.com avanu.com NAT, Transparent, Single Network, or Direct Server Return Router LAN Information Router LAN WebMux Proxy IP Address 205.133.156.200 205.133.156.200 Router LAN Network IP Address Mask 255.255.255.0 255.255.255.0...
SECTION XI – FREQUENTLY ASKED QUESTIONS – FAQs I can’t log in with my browser. It always says you are not logged in. To use your browser to manage the WebMux, it must be set to accept all cookies. Because the cookie is set to expire in 8 hours, you also need to make sure your system clock set correctly using GMT.
Page 135
Your servers are trying to resolve the WebMux unit’s IP address to a name so it could log them into log file. This may delay the server’s ability to reply to the WebMux health check probes. To avoid this problem, set the servers not resolve the IP addresses. You can also try adding all the IP address to the /etc/hosts file on your servers.
Page 136
Why didn’t the secondary WebMux take over when I powered down Primary WebMux? Possible reasons: 1) The two WebMux units are not running on the same version of firmware, or 2) The secondary WebMux not only monitors the primary WebMux, but a few other things as well.
Restocking fees may apply Customer or point of purchase must contact AVANU to disclose reason for return prior to thirty-days (30) of receiving product Upon approval, a RMA number will be issued by AVANU’s Customer Service for the return and must be visible on the outside shipping container ...
Page 138
Premium Annual Service Program (First year must be purchased with the WebMux product or within the first 30-days of purchase. AVANU has the right to request a proof of purchase document. Renewals must be before the expiration period coverage to prevent additional recertification cost;...
Page 139
The Limited Warranty is a specified, fixed period commencing on the date of purchase from AVANU. The date on the sales receipt is the date of purchase unless AVANU or your point of purchase informs you otherwise in writing.
Page 140
The Support provision covers product configuration and basic remote installation support up to the first sixty-days (60) from purchase date (AVANU has the right to request a proof of purchase document). Technical support applies to WebMux performance only and current version firmware updates.
Page 141
AVANU approval and an issued RMA number are required for all warranty repair, service, or sales returns. AVANU has the right to refuse any shipment without a RMA number. * AVANU has the right to offer promotional programs at any time where the Limited Product...
Need help?
Do you have a question about the WebMux A425 and is the answer not in the manual?
Questions and answers