Common Issues
A comprehensive guide to troubleshooting common issues in OPaaS.
Backup Issues
Backup could not be created
Possible causes:
- Not enough storage space
- Database problems
- Network problems
Solutions:
- Check the logs for details
- Make sure there's enough storage space
- Try again
- Contact your administrator
Backup takes very long
Possible causes:
- Very large amount of data
- Slow connection
- Server load
Solutions:
- Wait - large backups take time
- Check the amount of data
- Create backups outside peak usage times
Backup fails
Possible causes:
- Not enough storage space
- Database problems
- Network problems
Solutions:
- Check the logs for details
- Make sure there's enough storage space
- Try again
- Contact your administrator
Backup Restoration Issues
Restoration failed
Possible causes:
- Backup is corrupted
- Not enough storage space
- Network problems
Solutions:
- Check the logs for details
- Try a different backup
- Make sure there's enough storage space
- Contact your administrator
Restoration takes very long
Possible causes:
- Very large amount of data
- Slow connection
- Server load
Solutions:
- Wait - large restorations take time
- Check the amount of data
- Perform restorations outside peak usage times
Data doesn't match
Possible causes:
- Wrong backup selected
- Backup is incomplete
Solutions:
- Check if you selected the right backup
- Try a different backup
- Contact your administrator
Environment Issues
Environment doesn't start
Possible causes:
- Configuration errors
- Insufficient resources
- Database problems
- Network problems
Solutions:
- Check the logs for errors
- Check the settings
- Try again
- Contact your administrator
Something doesn't work
General troubleshooting steps:
- Check the logs for errors
- Check the status of the environment
- Try restarting the environment
- Contact your administrator
Logging Issues
Too many logs
Problem: The logs screen is overwhelming with too much information.
Solutions:
- Use filters to show relevant logs
- Filter by level (only Errors/Warnings)
- Search for specific terms
Logs are incomprehensible
Problem: Log messages are difficult to understand.
Solutions:
- Focus on Errors and Warnings
- Search for known error messages
- Contact your administrator for help
Logs don't update
Problem: Logs are not showing new entries.
Solutions:
- Refresh the page
- Check if the environment is running
- Contact your administrator
Stage Creation Issues
Branch not found
Problem: The specified Git branch cannot be found during stage creation.
Possible causes:
- Branch doesn't exist
- Incorrect branch name
- Case sensitivity issue
Solutions:
- Check if the branch exists in your repository
- Use the correct branch name (note: branch names are case-sensitive)
- Verify the branch name spelling
Stage is not being created
Problem: The stage creation process is stuck or not progressing.
Possible causes:
- Creation is taking longer than expected
- Repository synchronization issues
- System issues
Solutions:
- Wait a few minutes - stage creation can take time
- Check your internet connection
- Recreate the stage
- Contact us at [email protected]
General Troubleshooting Tips
Before contacting support
- ✅ Check the logs for error messages
- ✅ Check the status of your environment
- ✅ Try the suggested solutions in this guide
- ✅ Create a backup before making major changes
- ✅ Document the exact error message and when it occurred
When contacting support
- Provide: Error messages, timestamps, affected environment
- Describe: What you were doing when the issue occurred
- Share: Relevant logs if possible
Need More Help?
- Review the FAQ for common questions
- Check the relevant guide for your topic
- Contact your administrator
- Email us at [email protected]