MaxAdmin Shutting Down A Service should specify / warn that new session requests are neither accepted nor denied.

When

maxadmin shutdown service

is in progress, MaxScale continues to service current connections but does not accept new ones. This is documented in the knowledge-base here.

The problem is that new connection requests are not denied , nor are they accepted. They simply hang. It would not be a problem if the default ConnectTimeout in Connector/J were not infinite/undefined, but the combination of default behaviors means that clients rather than being actively denied are left in limbo when trying to connect to a MaxScale service in the process of shutting down.

One solution might be to edit the documentation to warn users that MaxScale does not actively refuse new connections when it's in the process of shutting down, instead simply not answering, letting them know that some connectors do not time out unless configured to do so.

Another alternative might be to have the service actively reject new connections when it is in the process of shutting down.