SLONIK_UNINSTALL_NODE(7)

πŸ“¦
version 2.2.11 Β· 4 versions
, in debian trixie, ubuntu questing

✨ SLONIK UNINSTALL NODE ✨

okay bestie, we're deep in the Slony-I 2.2.11 docs now and this one is SLONIK UNINSTALL NODE(7) β€” the man page that tells you how to gently, lovingly decommission a Slony-I node. no cap, it's giving "we're breaking up but I'm keeping the furniture" πŸ’…


🌸 NAME 🌸

UNINSTALL NODE β€” Decommission Slony-I node 🫢


πŸŽ€ SYNOPSIS πŸŽ€

UNINSTALL NODE (options);

πŸ¦‹ DESCRIPTION πŸ¦‹

So here's the vibe: this puts all your tables back into the unlocked state, with all the original user triggers, constraints and rules restored. Any Slony-I-specific serial key columns that got added? Dropped. The Slony-I schema itself? Also dropped. 🧹✨

The node becomes a standalone database. And the data? The data is left untouched, bestie β€” nobody is touching your data, we would never. πŸ™ˆ

the options, one at a time

  • ID = ival β€” Node ID of the node you wanna uninstall. that's the one.

This whole thing uses β€œschemadocuninstallnode()” [not available as a man page]. lowkey iconic of it.


the difference between UNINSTALL NODE and DROP NODE β€” this is the part people get confused about, so listen up. All UNINSTALL NODE does is remove the Slony-I configuration. It does not drop the node's configuration from replication. that's it, that's the difference, periodt. πŸ’…

πŸ’– EXAMPLE πŸ’–

  UNINSTALL NODE ( ID = 2 );

look at her go ✨


πŸ”’ LOCKING BEHAVIOUR πŸ”’

When it's dropping triggers off of application tables, this is gonna require exclusive access to each replicated table on the node being discarded. so like, heads up, nobody else can be in there touching those tables while this happens. exclusive means exclusive, fr fr. πŸ‘‘


πŸ’€ DANGEROUS/UNINTUITIVE BEHAVIOUR πŸ’€

okay this is the scary part, buckle up:

If you're using connections that cache query plans (and ngl this is particularly common for Java application frameworks with connection pools 😭), those connections may cache query plans that include the pre-UNINSTALL NODE state of things. Which means you'll get error messages about missing OIDs β€” specifically β€œ[MISSING TEXT]” [not available as a man page].

⚠️ After dropping a node, you may also need to recycle connections in your application. do not skip this step, I'm begging you πŸ™

⭐ SLONIK EVENT CONFIRMATION BEHAVIOUR ⭐

Slonik does not wait for event confirmations before performing this command. it just goes. main character energy, honestly. 🌈


πŸ‘‘ VERSION INFORMATION πŸ‘‘

This command was introduced in Slony-I 1.0. a legend from the start, we love to see it. πŸ’œ


and that's the whole page, bestie β€” written up on 19 September 2024, straight outta the Slony-I 2.2.11 Documentation set. go forth and uninstall responsibly πŸ¦‹πŸ’–βœ¨

πŸ“¦ where this page comes from