Troubleshooting Guide

Common issues and solutions for Decconz Multi-ERP Suite. Use this guide to resolve problems quickly.

Important

Always backup your data before attempting troubleshooting steps. Contact support if you're unsure about any procedure.

Common Issues

Installation Problems

Issue Solution Severity
Blank white page after installation Check PHP error log, enable debug mode, verify file permissions Medium
Database connection failed Verify database credentials, check MySQL service, ensure database exists High
500 Internal Server Error Check Apache/Nginx error logs, verify .htaccess configuration Medium
Missing PHP extensions Install required extensions: pdo, mbstring, curl, gd, zip Low

Performance Issues

Performance Optimization Commands
# Clear cache
php artisan cache:clear
php artisan config:clear
php artisan view:clear

# Optimize autoload
composer dump-autoload -o

# Database optimization
php artisan optimize
php artisan db:optimize

# Check system resources
free -h  # Check RAM
df -h    # Check disk space
top      # Check CPU usage

# Increase PHP memory limit
echo 'memory_limit = 512M' >> /etc/php/7.4/fpm/php.ini
systemctl restart php7.4-fpm

Database Issues

Database Repair Commands
-- Check database status
SHOW STATUS LIKE 'Threads_connected';
SHOW PROCESSLIST;

-- Repair tables
REPAIR TABLE users, invoices, products;

-- Optimize tables
OPTIMIZE TABLE journal_entries, stock_transactions, audit_logs;

-- Reset auto-increment
ALTER TABLE sessions AUTO_INCREMENT = 1;

-- Check foreign key constraints
SELECT 
    TABLE_NAME,
    COLUMN_NAME,
    CONSTRAINT_NAME,
    REFERENCED_TABLE_NAME,
    REFERENCED_COLUMN_NAME
FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
WHERE TABLE_SCHEMA = 'decconz_erp'
    AND REFERENCED_TABLE_NAME IS NOT NULL;

Email Configuration

Email Configuration Check
// Check email configuration
// config/mail.php
return [
    'default' => env('MAIL_MAILER', 'smtp'),
    'mailers' => [
        'smtp' => [
            'transport' => 'smtp',
            'host' => env('MAIL_HOST', 'smtp.gmail.com'),
            'port' => env('MAIL_PORT', 587),
            'encryption' => env('MAIL_ENCRYPTION', 'tls'),
            'username' => env('MAIL_USERNAME'),
            'password' => env('MAIL_PASSWORD'),
            'timeout' => null,
            'auth_mode' => null,
        ],
    ],
    'from' => [
        'address' => env('MAIL_FROM_ADDRESS', 'noreply@decconz-erp.com'),
        'name' => env('MAIL_FROM_NAME', 'Decconz ERP'),
    ],
];

// Test email sending
php artisan mail:test user@example.com

Debugging Tools

Enable Debug Mode
// .env file configuration
APP_DEBUG=true
APP_ENV=local

LOG_CHANNEL=stack
LOG_LEVEL=debug

# Detailed error logging
APP_LOG=errorlog
APP_LOG_LEVEL=debug

// Debug routes for testing
Route::get('/debug/session', function() {
    return session()->all();
});

Route::get('/debug/config/{key}', function($key) {
    return config($key);
});

Route::get('/debug/db', function() {
    return DB::connection()->getPdo();
});

Contact Support

When to Contact Support

  • Critical data loss or corruption
  • Security breaches or unauthorized access
  • System-wide performance degradation
  • Bug reports with reproduction steps
  • Feature requests or suggestions

Support Channels: Email: support@decconz-erp.com | Phone: +1 (800) 555-1234 | Community Forum