Files
dbbackup/bin/README.md
Alexander Renz 22915102d4
All checks were successful
CI/CD / Test (push) Successful in 1m17s
CI/CD / Lint (push) Successful in 1m24s
CI/CD / Build & Release (push) Has been skipped
CRITICAL FIX: Eliminate all hardcoded /tmp paths - respect WorkDir configuration
This is a critical bugfix release addressing multiple hardcoded temporary directory paths
that prevented proper use of the WorkDir configuration option.

PROBLEM:
Users configuring WorkDir (e.g., /u01/dba/tmp) for systems with small root filesystems
still experienced failures because critical operations hardcoded /tmp instead of respecting
the configured WorkDir. This made the WorkDir option essentially non-functional.

FIXED LOCATIONS:
1. internal/restore/engine.go:632 - CRITICAL: Used BackupDir instead of WorkDir for extraction
2. cmd/restore.go:354,834 - CLI restore/diagnose commands ignored WorkDir
3. cmd/migrate.go:208,347 - Migration commands hardcoded /tmp
4. internal/migrate/engine.go:120 - Migration engine ignored WorkDir
5. internal/config/config.go:224 - SwapFilePath hardcoded /tmp
6. internal/config/config.go:519 - Backup directory fallback hardcoded /tmp
7. internal/tui/restore_exec.go:161 - Debug logs hardcoded /tmp
8. internal/tui/settings.go:805 - Directory browser default hardcoded /tmp
9. internal/tui/restore_preview.go:474 - Display message hardcoded /tmp

NEW FEATURES:
- Added Config.GetEffectiveWorkDir() helper method
- WorkDir now respects WORK_DIR environment variable
- All temp operations now consistently use configured WorkDir with /tmp fallback

IMPACT:
- Restores on systems with small root disks now work properly with WorkDir configured
- Admins can control disk space usage for all temporary operations
- Debug logs, extraction dirs, swap files all respect WorkDir setting

Version: 3.42.1 (Critical Fix Release)
2026-01-07 20:41:53 +01:00

2.4 KiB

DB Backup Tool - Pre-compiled Binaries

This directory contains pre-compiled binaries for the DB Backup Tool across multiple platforms and architectures.

Build Information

  • Version: 3.42.1
  • Build Time: 2026-01-07_19:40:21_UTC
  • Git Commit: 3653ced

Recent Updates (v1.1.0)

  • Fixed TUI progress display with line-by-line output
  • Added interactive configuration settings menu
  • Improved menu navigation and responsiveness
  • Enhanced completion status handling
  • Better CPU detection and optimization
  • Silent mode support for TUI operations

Available Binaries

Linux

  • dbbackup_linux_amd64 - Linux 64-bit (Intel/AMD)
  • dbbackup_linux_arm64 - Linux 64-bit (ARM)
  • dbbackup_linux_arm_armv7 - Linux 32-bit (ARMv7)

macOS

  • dbbackup_darwin_amd64 - macOS 64-bit (Intel)
  • dbbackup_darwin_arm64 - macOS 64-bit (Apple Silicon)

Windows

  • dbbackup_windows_amd64.exe - Windows 64-bit (Intel/AMD)
  • dbbackup_windows_arm64.exe - Windows 64-bit (ARM)

BSD Systems

  • dbbackup_freebsd_amd64 - FreeBSD 64-bit
  • dbbackup_openbsd_amd64 - OpenBSD 64-bit
  • dbbackup_netbsd_amd64 - NetBSD 64-bit

Usage

  1. Download the appropriate binary for your platform
  2. Make it executable (Unix-like systems): chmod +x dbbackup_*
  3. Run: ./dbbackup_* --help

Interactive Mode

Launch the interactive TUI menu for easy configuration and operation:

# Interactive mode with TUI menu
./dbbackup_linux_amd64

# Features:
# - Interactive configuration settings
# - Real-time progress display
# - Operation history and status
# - CPU detection and optimization

Command Line Mode

Direct command line usage with line-by-line progress:

# Show CPU information and optimization settings
./dbbackup_linux_amd64 cpu

# Auto-optimize for your hardware
./dbbackup_linux_amd64 backup cluster --auto-detect-cores

# Manual CPU configuration  
./dbbackup_linux_amd64 backup single mydb --jobs 8 --dump-jobs 4

# Line-by-line progress output
./dbbackup_linux_amd64 backup cluster --progress-type line

CPU Detection

All binaries include advanced CPU detection capabilities:

  • Automatic core detection for optimal parallelism
  • Support for different workload types (CPU-intensive, I/O-intensive, balanced)
  • Platform-specific optimizations for Linux, macOS, and Windows
  • Interactive CPU configuration in TUI mode

Support

For issues or questions, please refer to the main project documentation.