m2dev-server/docs/server-management.md

Server Management

This document describes the current Debian-side control plane for the production Metin runtime.

Inventory

The channel topology now lives in one versioned file:

• deploy/channel-inventory.json

It defines:

• auth and DB listener ports
• channel ids
• per-core public ports and P2P ports
• whether a channel is public/client-visible
• whether a special channel should always be included by management tooling

This inventory is now the source used by:

• channel_inventory.py
• channels.py compatibility exports
• install.py
• deploy/systemd/install_systemd.py
• metinctl

metinctl

The Debian deployment installs:

• /usr/local/bin/metinctl

metinctl is a lightweight operational CLI for:

• viewing inventory
• listing managed units
• checking service status
• listing declared ports
• restarting the whole stack or specific channels/instances
• viewing logs
• running the root-only headless healthcheck

Examples

Show inventory:

metinctl inventory

Show current unit state:

metinctl status

Show declared ports and whether they are currently listening:

metinctl ports --live

Restart only channel 1 cores:

metinctl restart channel:1

Restart one specific game instance:

metinctl restart instance:channel1_core2

Tail auth logs:

metinctl logs auth -n 200 -f

Run the end-to-end healthcheck:

metinctl healthcheck

systemd installer behavior

deploy/systemd/install_systemd.py now uses the same inventory and installs metinctl.

It also reconciles enabled game instance units against the selected channels:

• selected game units are enabled
• stale game units are disabled
• if --restart is passed, stale game units are disabled with --now

This makes channel enablement declarative instead of depending on whatever happened to be enabled previously.