xBit diagnostic data and log collection

xBit diagnostic data and log collection can be performed with the below tool

xBit Onprem status collector

Prerequisites

Both Platforms

  • Docker 20.10+ installed and running
  • xBit containers with labels: com.xbitdcm.service=[application|database|mailer]
  • 500 MB free disk space

Linux/macOS

  • Bash 4.0+
  • Docker permissions or sudo access

Windows

  • PowerShell 5.1+
  • Execution policy: RemoteSigned or higher
  • Docker Desktop running

Usage

Linux/macOS

cd xbit_onprem_status_collector/linux/
bash xbit_status_collector.sh

Windows

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
cd xbit_onprem_status_collector\windows
.\xbit_status_collector.ps1

Output

Creates compressed archive containing: - Docker container status - Application, mailer, and database logs - Database config table export

Location: - Linux/macOS: /tmp/xbit_status_YYYY-MM-DD.tar.gz - Windows: Downloads\xbit_status_YYYY-MM-DD.zip

Troubleshooting

Issue Solution
Permission denied (Linux) Add user to docker group: sudo usermod -aG docker $USER
Container not found Verify containers are running: docker ps
Execution policy error (Windows) Run: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Database password error Update DATABASE_PASSWORD variable in script