Troubleshooting

Troubleshooting

Common issues and solutions for OpenEduCat administrators and users.

Overview

This section covers frequently encountered problems and their solutions across OpenEduCat modules.

Quick Links

Category	Common Issues
Login Issues	Cannot login, password reset
Student Records	Missing data, enrollment errors
Attendance	Sync issues, missing records
Grades	Calculation errors, missing grades
Fees	Payment failures, invoice issues
Reports	Generation errors, blank reports

Login Issues

Cannot Login

Symptoms: Login page rejects credentials

Solutions:

1. Verify username/email is correct
2. Check CAPS LOCK is off
3. Clear browser cache
4. Try password reset
5. Contact admin if locked out

Password Reset Not Working

Symptoms: Reset email not received

Solutions:

1. Check spam/junk folder
2. Verify email address is correct
3. Wait 5 minutes and retry
4. Contact admin for manual reset

Student Records

Student Not Found

Symptoms: Student missing from lists

Solutions:

1. Check enrollment status is active
2. Verify course/batch filters
3. Search by student ID instead of name
4. Check archived records

Enrollment Errors

Symptoms: Cannot enroll student

Solutions:

1. Verify course has capacity
2. Check prerequisite completion
3. Ensure fees are paid (if required)
4. Verify admission is confirmed

Attendance

Attendance Not Syncing

Symptoms: Biometric data not appearing

Solutions:

1. Check device connectivity
2. Verify sync schedule is active
3. Manually trigger sync
4. Check device logs for errors

Missing Attendance Records

Symptoms: Attendance not recorded

Solutions:

1. Verify attendance sheet exists
2. Check faculty assignment
3. Confirm class schedule
4. Review attendance permissions

Grades

Grades Not Calculating

Symptoms: GPA shows 0 or blank

Solutions:

1. Verify grade scale is assigned
2. Check all grades are entered
3. Confirm grade types include GPA
4. Recalculate gradebook

Wrong Grade Displayed

Symptoms: Incorrect letter grade

Solutions:

1. Check grade scale ranges
2. Verify percentage is correct
3. Look for overlapping ranges
4. Check rounding settings

Fees

Payment Failed

Symptoms: Online payment not processing

Solutions:

1. Check payment gateway status
2. Verify API credentials
3. Test with different card
4. Check transaction logs

Invoice Not Generated

Symptoms: Fee invoice missing

Solutions:

1. Verify fee structure exists
2. Check student enrollment
3. Confirm fee period settings
4. Generate manually if needed

Reports

Report Blank

Symptoms: Report generates with no data

Solutions:

1. Check date range includes data
2. Remove restrictive filters
3. Verify data exists in system
4. Check report permissions

Report Generation Error

Symptoms: Error message when generating

Solutions:

1. Check PDF library installed
2. Verify template exists
3. Check server memory
4. Try smaller data range

Performance Issues

System Running Slow

Solutions:

1. Clear browser cache
2. Check server resources
3. Optimize database queries
4. Review scheduled jobs

Timeout Errors

Solutions:

1. Increase timeout settings
2. Process smaller batches
3. Schedule heavy operations off-peak
4. Check network connectivity

Getting Help

Before Contacting Support

Gather this information:

1. Error message (screenshot if possible)
2. Steps to reproduce
3. Browser and version
4. User role and permissions
5. When the issue started

Contact Methods

Method	Response Time
Help Desk	4 hours
Email Support	24 hours
Phone	Immediate
Community Forum	Varies

Additional Resources

• System Requirements
• User Manual
• FAQ
• Release Notes

---

Need more help? Contact your system administrator or visit the OpenEduCat community forum.