package main import ( "context" "encoding/json" "errors" "flag" "fmt" "io" "os" "time" "pageswiki/internal/dr" ) // All role changes are operator-only and offline. Never expose this as a // domain-admin API: a data directory contains multiple campuses and domains. func runDR(args []string, out io.Writer) error { backend, err := configuredDatabaseBackend() if err != nil { return err } if backend != "sqlite" { return errors.New("DR commands require the SQLite backend; use PostgreSQL backup/restore for native instances") } const usage = "pageswiki dr {init|status|snapshot|verify|restore|promote|resume-workers} [flags]\nUse COMMAND --help. Snapshot requires all writers stopped; promotion requires external fencing." if len(args) == 0 || args[0] == "--help" { _, err := fmt.Fprintln(out, usage) return err } cmd := args[0] switch cmd { case "init", "status", "snapshot", "verify", "restore", "promote", "resume-workers": default: return errors.New(usage) } f := flag.NewFlagSet("dr "+cmd, flag.ContinueOnError) f.SetOutput(out) defaultDir := os.Getenv("PAGESWIKI_DATA_DIR") if defaultDir == "" { defaultDir = "./data" } dir := f.String("data-dir", defaultDir, "instance data directory") var output, snapshot, hash, target, fenced, reference *string var stopped, loss, reviewed *bool switch cmd { case "resume-workers": reviewed = f.Bool("reviewed-restored-jobs", false, "attest restored queues and federation state have been reviewed for replay/duplicate effects") case "snapshot": output = f.String("output", "", "new snapshot directory outside data directory") stopped = f.Bool("writers-stopped", false, "attest ALL servers, CLIs and external writers are stopped") case "verify", "restore": snapshot = f.String("snapshot", "", "snapshot directory") hash = f.String("manifest-sha256", "", "manifest SHA-256 received over an authenticated channel") if cmd == "restore" { target = f.String("target", "", "new, nonexistent data directory (always standby)") } case "promote": fenced = f.String("fenced-node", "", "exact former primary node UUID") reference = f.String("fence-reference", "", "operator evidence/ticket for verified power/storage/network fencing") loss = f.Bool("accept-data-loss", false, "accept loss of writes since the snapshot cutoff") } if err := f.Parse(args[1:]); err != nil { if errors.Is(err, flag.ErrHelp) { return nil } return err } if f.NArg() != 0 { return errors.New("unexpected positional arguments") } encode := func(v any) error { e := json.NewEncoder(out); e.SetIndent("", " "); return e.Encode(v) } ctx := context.Background() switch cmd { case "resume-workers": c, err := dr.ResumeWorkers(*dir, *reviewed) if err != nil { return err } return encode(c) case "init": c, err := dr.Init(*dir) if err != nil { return err } return encode(c) case "status": c, err := dr.Load(*dir) if err != nil { return err } return encode(struct { Node *dr.Config `json:"node"` StandbyReadable bool `json:"standby_readable"` }{c, c != nil && c.Readable(time.Now())}) case "snapshot": if *output == "" || !*stopped { return errors.New("snapshot requires --output and --writers-stopped; stop every writer first") } m, sum, err := dr.Snapshot(ctx, *dir, *output) if err != nil { return err } return encode(struct { Manifest *dr.Manifest `json:"manifest"` SHA256 string `json:"manifest_sha256"` }{m, sum}) case "verify": if *snapshot == "" { return errors.New("--snapshot is required") } m, err := dr.Verify(ctx, *snapshot, *hash) if err != nil { return err } return encode(m) case "restore": if *snapshot == "" || *target == "" { return errors.New("--snapshot and --target are required") } c, err := dr.Restore(ctx, *snapshot, *hash, *target) if err != nil { return err } return encode(c) case "promote": c, err := dr.Promote(*dir, *fenced, *reference, *loss) if err != nil { return err } return encode(c) } return errors.New("unknown DR command") }