1. Overview
  2. Admin Guides
  3. Installation
  4. Yurbi Docker Container Maintenance

Yurbi Docker Container Maintenance

Overview

This guide covers essential maintenance tasks for Yurbi Docker containers, including restarting services and collecting log files for support cases.

Prerequisites

  • SSH access to the Docker host
  • User account with sudo privileges
  • Docker installed and running

Container Information

Yurbi runs in two main containers:

  • yurbi-app: UI/API service (image: app-yurbi:latest)
  • yurbi-master: Backend services (image: app-yurbi-master:latest)

1. Check Container Status

View all running Yurbi containers:

sudo docker ps --filter name=yurbi

This shows container names, status, and port mappings.

2. Restart Yurbi Services

Restart Both Containers

sudo docker restart yurbi-app
sudo docker restart yurbi-master

Verify Restart and Monitor Logs

sudo docker ps --filter name=yurbi
sudo docker logs -f yurbi-app

Press Ctrl+C to exit log monitoring.

3. Collect Log Files for Support

Step 1: Create Log Archives

Extract logs from both containers to your home directory:

sudo docker exec yurbi-app tar -C /var/yurbi -czf - logs > ~/yurbi-app-logs.tar.gz
sudo docker exec yurbi-master tar -C /var/yurbi -czf - logs > ~/yurbi-master-logs.tar.gz

Step 2: Verify Log Collection

tar -tzf ~/yurbi-app-logs.tar.gz | head
tar -tzf ~/yurbi-master-logs.tar.gz | head

Step 3: Provide to Support

The collected files (yurbi-app-logs.tar.gz and yurbi-master-logs.tar.gz) can now be attached to your support case.

4. Troubleshooting with Fresh Logs

When working with support to reproduce an issue, follow these steps:

Clear Existing Logs

sudo docker exec yurbi-app sh -lc 'rm -rf /var/yurbi/logs/* /var/yurbi/logs/.* 2>/dev/null || true'
sudo docker exec yurbi-master sh -lc 'rm -rf /var/yurbi/logs/* /var/yurbi/logs/.* 2>/dev/null || true'

Restart Services

sudo docker restart yurbi-app
sudo docker restart yurbi-master

Reproduce the Issue

Perform the steps that cause the problem.

Collect Fresh Logs

sudo docker exec yurbi-app tar -C /var/yurbi -czf - logs > ~/yurbi-app-logs-fresh.tar.gz
sudo docker exec yurbi-master tar -C /var/yurbi -czf - logs > ~/yurbi-master-logs-fresh.tar.gz

5. Additional Useful Commands

View Recent Container Logs

sudo docker logs --since=10m yurbi-app
sudo docker logs --since=10m yurbi-master

List Log Files Inside Container

sudo docker exec yurbi-app sh -lc 'ls -lah /var/yurbi/logs'
sudo docker exec yurbi-master sh -lc 'ls -lah /var/yurbi/logs'

Copy Individual Log Files

sudo docker cp yurbi-app:/var/yurbi/logs/app.log ~/app.log

Quick Reference

Task Command
Check container status sudo docker ps --filter name=yurbi
Restart both containers sudo docker restart yurbi-app yurbi-master
Collect all logs sudo docker exec yurbi-app tar -C /var/yurbi -czf - logs > ~/yurbi-app-logs.tar.gz
View recent logs sudo docker logs --since=10m yurbi-app
Clear log files sudo docker exec yurbi-app sh -lc 'rm -rf /var/yurbi/logs/* /var/yurbi/logs/.* 2>/dev/null || true'

Need Help?

If containers fail to start or you encounter permission errors, contact Yurbi support with the collected log files and details about the issue.