Undertow mod_cluster proxy: Basic setup in Wildfly 10

by karm 8 years ago

GNU/Linux ◆ xterm-256color ◆ bash 10545 views

Overview

The simplest possible setup with Undertow mod_cluster proxy Wildfly 10 laod balancer and two Wildfly 10 workers.

Balancer

we configure advertising socket binding; the UDP multicast address and port the balacner advertises its precence on
we configure Undertow mod_cluster filter
we add this filter to Undertow’s http host so as it can receive mod_cluster protocol messages from worker nodes; note that this is not secure. In a production environment we would have a dedicated, secured host configured in Undertow so as we receive mod_cluster special messages only from trusted networks.

Workers

there is no configuration needed but for adjusting mod_cluster socket binding, so as worker nodes know the UDP address:port where the balancer advertises its presence
one worker has two and the other has a one web application deployed
note that the balancer correctly forwards requests to the one node that offers that particular application context
note that with the application that is deployed on both nodes a failover is possible
watch JSESSIONIDs and jvmRoutes in the curl output to get the gist of the functionality

Cheers -K- http://modcluster.io

More by karm

untitled 00:09

by karm 5 years ago

mod_cluster compiled with system's httpd [Linux] 17:54

by karm 8 years ago

Generate project with MicroProfile Starter 03:06

by karm 5 years ago

Microprofile starter devel workflow 01:37

by karm 6 years ago

See all

You can download this recording in asciicast v1 format, as a .json file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 48420.json

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/48420.json',
      document.getElementById('player'),
      { cols: 99, rows: 26 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/48420 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.