Skip to main content

Support

Troubleshooting Common Issues​

Installation Issues​

Issue: Permission denied during installation​

bash


1.# Ubuntu/RHEL8 Solution
2.sudo chown -R $USER:$USER /opt/autogen
3.chmod -R 755 /opt/autogen

Issue: Missing dependencies​


bash

Ubuntu sudo apt install -y python3-dev build-essential RHEL8 sudo dnf groupinstall -y "Development Tools" sudo dnf install -y python3-devel

## Runtime Issues
## Issue: API key not found

1.Check environment file: /etc/autogen/config.env

2.Verify file permissions: chmod 600 /etc/autogen/config.env

3.Restart service: sudo systemctl restart autogen

Issue: Code execution fails

bash

Check work directory permissions

ls -la /tmp/autogen_code sudo chown -R $USER:$USER /tmp/autogen_code

For Docker issues

sudo systemctl status docker sudo usermod -aG docker $USER newgrp docker

## Network Issues
## Issue: Connection timeout

Check firewall settings:

bash

Ubuntu sudo ufw status sudo ufw allow 5000/tcp RHEL8 sudo firewall-cmd --list-all sudo firewall-cmd --add-port=5000/tcp --permanent sudo firewall-cmd --reload

## Log Analysis

## Common Log Locations
1.Application logs: /var/log/autogen/

2.System logs: /var/log/syslog (Ubuntu) or /var/log/messages (RHEL8)

3.Service logs: journalctl -u autogen

## Log Analysis Commands
bash

View recent errors

tail -f /var/log/autogen/error.log

Search for specific issues

grep -i "error|warning|exception" /var/log/autogen/*.log

Check service status

systemctl status autogen journalctl -u autogen --since "1 hour ago"

Monitor resource usage

htop iostat -x 1

## Support Contacts and Resources
## Documentation Resources
- Official AutoGen Documentation: AutoGen — AutoGen 

- GitHub Repository: GitHub - microsoft/autogen: A programming framework for agentic AI 

- Python Package Index: pyautogen 

## Community Support
- GitHub Issues: Report bugs and feature requests

-Discord Community: Real-time discussions

-Stack Overflow: Tag questions with 'autogen'

## Professional Support
For enterprise deployments, consider:

- Microsoft support channels

- Professional consulting services

- Custom implementation support

## Health Check Scripts
bash

/opt/autogen/health_check.sh

#!/bin/bash echo "=== AutoGen Health Check ===" echo "Date: $(date)" echo

Check service status

echo "Service Status:" systemctl is-active autogen && echo "✓ AutoGen service is running" || echo "✗ AutoGen service is not running"

Check Python environment

echo "Python Environment:" source /opt/autogen/autogen-env/bin/activate python -c "import autogen; print('✓ AutoGen module accessible')" 2>/dev/null || echo "✗ AutoGen module not accessible"

Check API connectivity

echo "API Connectivity:" if [ -f "/etc/autogen/config.env" ]; then echo "✓ Configuration file exists" else echo "✗ Configuration file missing" fi

# Check disk space
echo "Disk Space:"
DISK_USAGE=$(df / | awk 'NR==2 {print $5}' | sed 's/%//')
if [ $DISK_USAGE -lt 85 ]; then
    echo "✓ Disk usage: ${DISK_USAGE}%"
else
    echo "⚠ High disk usage: ${DISK_USAGE}%"
fi
# Check memory usage
echo "Memory Usage:"
MEMORY_USAGE=$(free | awk 'NR==2{printf "%.0f", $3*100/$2}')
if [ $MEMORY_USAGE -lt 85 ]; then
    echo "✓ Memory usage: ${MEMORY_USAGE}%"
else
    echo "⚠ High memory usage: ${MEMORY_USAGE}%"
fi
echo "=== Health Check Complete ==="