Troubleshooting

Solutions to common Simuzo issues and problems.

General Debugging

Check Service Status

# simuzo-stats
systemctl status simuzo-stats

# simuzo-audit
systemctl status simuzo-audit

# simuzo-mysql-governor
systemctl status simuzo-mysql-governor

Check Logs

# Main logs
tail -f /var/simuzo/logs/simuzo.log

# Filesystem logs
tail -f /var/simuzo/logs/simuzofs.log

# Audit logs
tail -f /var/simuzo/logs/audit.jsonl

Verify cGroups

# Check cgroups v2 support
grep cgroup2 /proc/filesystems

# Check cgroups mounted
mount | grep cgroup

# List active cgroups
ls /sys/fs/cgroup/simuzo/

Resource Limits Issues

Users Not Getting Limits

1. Check user has a plan assigned
2. Verify cGroups v2 is enabled: ls /sys/fs/cgroup/simuzo/
3. Check cGroup limits: cat /sys/fs/cgroup/simuzo/{user}/cpu.max
4. Review logs: /var/simuzo/logs/simuzo.log

cGroups v2 Not Available

1. Check kernel version: uname -r (need kernel 4.18+)
2. Verify cgroups mounted: mount | grep cgroup
3. Enable in GRUB cmdline:

   # Add to GRUB: cgroup_no_v1=all cgroup_enable=memory cgroup2
   update-grub
   reboot

SimuzoFS Issues

User Cannot Access Files

1. Check jail exists: ls /var/simuzo/fs/{username}/
2. Verify PAM config: cat /etc/pam.d/simuzo
3. Check simuzofs-ld.so: ls -la /usr/local/simuzo/bin/simuzofs-ld.so
4. Test jail: /usr/local/simuzo/bin/simuzofs-cmd test {username}

Jail Initialization Fails

1. Check disk space: df -h /var/simuzo/fs
2. Verify user exists: id {username}
3. Check permissions on /var/simuzo/fs
4. Review logs: /var/simuzo/logs/simuzofs.log

MySQL Governor Issues

Governor Not Working

1. Check service: systemctl status simuzo-mysql-governor
2. Verify dbmap: cat /var/run/simuzo/dbmap
3. Check performance_schema: mysql -e "SHOW VARIABLES LIKE 'performance_schema';"
4. Enable if needed: mysql -e "SET GLOBAL performance_schema = ON;"

No Throttling Despite High Usage

1. Verify user in dbmap
2. Check cGroup limits exist: ls /sys/fs/cgroup/simuzo-db/{user}/
3. Verify database cGroups mounted

Statistics Issues

Stats Not Updating

1. Check service: systemctl status simuzo-stats
2. Verify file: ls -la /run/simuzo/stats.json
3. Check collection interval in Settings
4. Restart service: systemctl restart simuzo-stats

Missing Historical Data

1. Check retention settings
2. Verify database connectivity
3. Check disk space
4. Review collection logs

Podman Issues

Containers Not Starting

1. Check podman service: systemctl status podman
2. Check podman logs: journalctl -u podman
3. Verify user has permission
4. Check container logs via Podman Manager

Performance Issues

High CPU Usage

1. Identify source: top or htop
2. Check for runaway processes
3. Review user resource usage
4. Consider increasing server resources

High Memory Usage

1. Check memory: free -h
2. Check cached data: df -h
3. Clear cache if needed
4. Monitor user memory limits

Getting Help

If issues persist:

1. Collect relevant logs
2. Document error messages
3. Note steps to reproduce
4. Contact support at https://simuzo.deskuss.com/