Πίνακας περιεχομένων

  1. Εισαγωγή

  2. Επισκόπηση των απαιτήσεων εγκατάστασης Dolibarr

  3. Πρόβλημα 1: Κενή σελίδα μετά την εκκίνηση του προγράμματος εγκατάστασης

  4. Πρόβλημα 2: Ασυμβατότητα έκδοσης PHP

  5. Πρόβλημα 3: Λείπουν επεκτάσεις PHP

  6. Πρόβλημα 4: Προβλήματα δικαιωμάτων αρχείων

  7. Πρόβλημα 5: Σφάλματα σύνδεσης βάσης δεδομένων

  8. Πρόβλημα 6: Ελλιπής Οδηγός Εγκατάστασης

  9. Πρόβλημα 7: Το install.lock δεν δημιουργήθηκε

  10. Πρόβλημα 8: Το αρχείο Conf.php δεν είναι εγγράψιμο

  11. Πρόβλημα 9: Σφάλματα ρύθμισης παραμέτρων Apache ή Nginx

  12. Πρόβλημα 10: Προβλήματα επανεγγραφής URL και .htaccess

  13. Πρόβλημα 11: Χρονικά όρια κατά την εγκατάσταση

  14. Πρόβλημα 12: Αποτυχίες εγκατάστασης πακέτου γλώσσας

  15. Πρόβλημα 13: Σφάλματα HTTPS ή SSL

  16. Πρόβλημα 14: Προβλήματα με περιβάλλοντα κοινόχρηστης φιλοξενίας

  17. Πρόβλημα 15: Βρόχος επανεγκατάστασης

  18. Εργαλεία για την αντιμετώπιση προβλημάτων εγκατάστασης

  19. Βέλτιστες πρακτικές για την αποτροπή σφαλμάτων εγκατάστασης

  20. Συμπέρασμα

1. Εισαγωγή

Το Dolibarr είναι μια ισχυρή και ευέλικτη λύση ERP/CRM, αλλά όπως κάθε εφαρμογή που βασίζεται στο web, η διαδικασία εγκατάστασής της μπορεί μερικές φορές να παρεμποδιστεί από τη διαμόρφωση του διακομιστή, τις ελλείπουσες εξαρτήσεις ή τα λάθη κατά την εγκατάσταση. Αυτό το άρθρο παρουσιάζει μια λεπτομερή ανάλυση των πιο συνηθισμένων προβλημάτων εγκατάστασης που αντιμετωπίζουν οι χρήστες και παρέχει εφαρμόσιμες λύσεις.

2. Επισκόπηση των απαιτήσεων εγκατάστασης του Dolibarr

Πριν ξεκινήσετε, βεβαιωθείτε ότι ο διακομιστής πληροί τις ακόλουθες απαιτήσεις:

  • PHP 7.4 έως 8.2

  • MySQL 5.7+ ή MariaDB 10+

  • Apache/Nginx με ενεργοποιημένο το mod_rewrite

  • Απαιτούμενες επεκτάσεις PHP: pdo_mysql, gd, intl, zip, curl, json, mbstring, fileinfo

  • Εγγράψιμοι κατάλογοι: htdocs/conf/, documents/, και install/

Η εγκατάσταση του Dolibarr περιλαμβάνει την μεταφόρτωση του πακέτου και την εκτέλεση του /install/ script, ρύθμιση παραμέτρων της βάσης δεδομένων και οριστικοποίηση της εγκατάστασης.

3. Πρόβλημα 1: Κενή σελίδα μετά την εκκίνηση του προγράμματος εγκατάστασης

συμπτώματα:

  • Πλοήγηση σε /install/ αποδίδει μια λευκή ή κενή οθόνη.

Αιτίες:

  • Σφάλμα PHP ή ανεπανόρθωτη εξαίρεση.

Λύσεις:

  • Ενεργοποίηση αναφοράς σφαλμάτων σε php.ini: display_errors = On

  • Ελέγξτε τα αρχεία καταγραφής του διακομιστή ιστού (/var/log/apache2/error.log or /var/log/nginx/error.log)

  • Βεβαιωθείτε ότι έχουν εγκατασταθεί οι απαραίτητες ενότητες PHP

  • Χρησιμοποιήστε διαφορετική έκδοση PHP εάν η τρέχουσα έχει σφάλματα

4. Πρόβλημα 2: Ασυμβατότητα έκδοσης PHP

συμπτώματα:

  • Απαρχαιωμένες προειδοποιήσεις ή σφάλματα λειτουργίας.

Αιτίες:

  • Χρησιμοποιείται μια μη υποστηριζόμενη έκδοση PHP.

Λύσεις:

  • Χρησιμοποιήστε PHP 7.4 έως 8.2, σύμφωνα με τον πίνακα συμβατότητας του Dolibarr

  • Εγκαταστήστε την κατάλληλη έκδοση χρησιμοποιώντας τον διαχειριστή πακέτων του διακομιστή σας ή εργαλεία όπως phpbrew or update-alternatives

  • Επανεκκινήστε τον διακομιστή ιστού μετά την αλλαγή έκδοσης PHP

5. Πρόβλημα 3: Λείπουν επεκτάσεις PHP

συμπτώματα:

  • Ο εγκαταστάτης αναφέρει ελλείπουσες ενότητες (π.χ., intl, curl).

Αιτίες:

  • Οι απαιτούμενες επεκτάσεις PHP δεν είναι εγκατεστημένες ή δεν είναι ενεργοποιημένες.

Λύσεις:

  • Εγκατάσταση επεκτάσεων μέσω του διαχειριστή πακέτων: sudo apt install php-intl php-curl php-gd php-mbstring

  • Έλεγχος phpinfo() για επιβεβαίωση

  • Επανεκκινήστε το Apache ή το Nginx μετά τις αλλαγές

6. Πρόβλημα 4: Προβλήματα με τα δικαιώματα αρχείων

συμπτώματα:

  • Το αρχείο διαμόρφωσης δεν αποθηκεύτηκε

  • Οι μεταφορτώσεις δεν λειτουργούν

Αιτίες:

  • Λανθασμένα δικαιώματα εγγραφής σε απαιτούμενους φακέλους

Λύσεις:

  • Ορισμός ιδιοκτησίας: chown -R www-data:www-data /var/www/html/dolibarr

  • Ορισμός δικαιωμάτων: chmod -R 755 /var/www/html/dolibarr

  • Βεβαιωθείτε ότι το SELinux ή το AppArmor δεν εμποδίζουν την πρόσβαση εγγραφής

7. Πρόβλημα 5: Σφάλματα σύνδεσης βάσης δεδομένων

συμπτώματα:

  • «Δεν ήταν δυνατή η σύνδεση με τη βάση δεδομένων» κατά τη διάρκεια της εγκατάστασης

Αιτίες:

  • Λάθος όνομα κεντρικού υπολογιστή, όνομα χρήστη ή κωδικός πρόσβασης

  • Η υπηρεσία MySQL δεν εκτελείται

  • Ο χρήστης δεν έχει δικαιώματα CREATE

Λύσεις:

  • Επαληθεύστε την υπηρεσία MySQL με systemctl status mysql

  • Ελέγξτε τα διαπιστευτήρια στο πρόγραμμα εγκατάστασης Dolibarr

  • Χορήγηση δικαιωμάτων: GRANT ALL ON dolibarr.* TO 'user'@'localhost' IDENTIFIED BY 'password';

8. Πρόβλημα 6: Ελλιπής Οδηγός Εγκατάστασης

συμπτώματα:

  • Η εγκατάσταση κολλάει ή επαναφορτώνει το ίδιο βήμα

Αιτίες:

  • Πρόβλημα συνεδρίας PHP ή προσωρινής μνήμης

  • Χρονικό όριο λήξης προγράμματος περιήγησης ή διακομιστή

Λύσεις:

  • Διαγράψτε τα cookies του προγράμματος περιήγησης και επανεκκινήστε την εγκατάσταση

  • Αύξηση χρονικού ορίου PHP σε php.ini: max_execution_time = 120

  • Χρησιμοποιήστε διαφορετικό πρόγραμμα περιήγησης

9. Πρόβλημα 7: Το install.lock δεν δημιουργήθηκε

συμπτώματα:

  • Το πρόγραμμα εγκατάστασης εκτελείται ακόμα και μετά την ολοκλήρωση της εγκατάστασης

Αιτίες:

  • Ο χρήστης του διακομιστή ιστού δεν έχει δικαίωμα δημιουργίας install.lock

Λύσεις:

  • Δημιουργία με μη αυτόματο τρόπο /htdocs/install.lock

  • Ορισμός δικαιωμάτων: touch install.lock && chmod 644 install.lock

  • Επιβεβαίωση ότι το αρχείο είναι αναγνώσιμο από τον διακομιστή ιστού

10. Πρόβλημα 8: Το αρχείο Conf.php δεν είναι εγγράψιμο

συμπτώματα:

  • Σφάλμα «δεν είναι δυνατή η εγγραφή του conf.php»

Αιτίες:

  • Το αρχείο δεν είναι εγγράψιμο κατά τη διάρκεια της ρύθμισης

Λύσεις:

  • σετ conf.php σε εγγράψιμο: chmod 666 htdocs/conf/conf.php

  • Μετά την εγκατάσταση, επαναφέρετέ το σε λειτουργία μόνο για ανάγνωση: chmod 444 conf.php

11. Πρόβλημα 9: Σφάλματα ρύθμισης παραμέτρων Apache ή Nginx

συμπτώματα:

  • Σφάλματα 403 Απαγορευμένο ή 404 Δεν βρέθηκε

Αιτίες:

  • Λανθασμένα διαμορφωμένος εικονικός κεντρικός υπολογιστής ή λείπουν κανόνες επανεγγραφής

Λύσεις:

  • Επαληθεύστε τις ρυθμίσεις DocumentRoot και Directory στο apache2.conf

  • Ενεργοποίηση mod_rewrite: a2enmod rewrite

  • Πρόσθεση AllowOverride All στη διαμόρφωση του Apache

  • Για το Nginx, βεβαιωθείτε try_files $uri $uri/ /index.php?$query_string; Χρησιμοποιείται

12. Πρόβλημα 10: Προβλήματα επανεγγραφής URL και .htaccess

συμπτώματα:

  • Οι φιλικές διευθύνσεις URL δεν λειτουργούν

  • Οι σύνδεσμοι μενού είναι χαλασμένοι

Αιτίες:

  • mod_rewrite δεν είναι ενεργοποιημένο ή .htaccess αγνοείται

Λύσεις:

  • Ενεργοποίηση Apache mod_rewrite

  • Επιτρέψτε .htaccess παρακάμπτει Directory config

  • Δοκιμή με: http://yourdomain/dolibarr/admin/index.php (άμεση διεύθυνση URL)

13. Πρόβλημα 11: Λήξη χρονικών ορίων κατά την εγκατάσταση

συμπτώματα:

  • Η διαδικασία εγκατάστασης διαρκεί πολύ και αποτυγχάνει

Αιτίες:

  • Αργή βάση δεδομένων

  • Χρονικό όριο εκτέλεσης PHP

Λύσεις:

  • Αυξάνουν max_execution_time και memory_limit in php.ini

  • Παρακολούθηση φόρτου διακομιστή και βελτιστοποίηση MySQL

14. Πρόβλημα 12: Αποτυχίες εγκατάστασης πακέτου γλώσσας

συμπτώματα:

  • Η επιλογή γλώσσας αποτυγχάνει ή εμφανίζονται σφάλματα

Αιτίες:

  • Προβλήματα σύνδεσης στο Διαδίκτυο ή δικαιωμάτων πρόσβασης σε αρχεία

Λύσεις:

  • Λήψη πακέτων χειροκίνητα από την πύλη μετάφρασης Dolibarr

  • Εξαγάγετε τα σε /htdocs/langs/

  • Επαληθεύστε τα σωστά ονόματα φακέλων (π.χ. fr_FR, en_US)

15. Πρόβλημα 13: Σφάλματα HTTPS ή SSL

συμπτώματα:

  • Το πρόγραμμα περιήγησης προειδοποιεί για μη ασφαλή σύνδεση

  • Ορισμένοι σύνδεσμοι δεν λειτουργούν μέσω HTTPS

Αιτίες:

  • Το SSL δεν έχει ρυθμιστεί σωστά

Λύσεις:

  • Εγκατάσταση πιστοποιητικού SSL (Let's Encrypt, κ.λπ.)

  • Ενημερώστε τη διεύθυνση URL του Dolibarr στο conf.php σε https://

  • Αναγκαστική ανακατεύθυνση HTTPS σε .htaccess

16. Πρόβλημα 14: Προβλήματα με περιβάλλοντα κοινόχρηστης φιλοξενίας

συμπτώματα:

  • Περιορισμένη έκδοση PHP ή επεκτάσεις

  • Σφάλματα δικαιωμάτων

Αιτίες:

  • Περιορισμοί παρόχου φιλοξενίας

Λύσεις:

  • Επιλέξτε έναν πάροχο με υποστήριξη για προσαρμοσμένες ρυθμίσεις PHP

  • Χρήση .user.ini or .htaccess για να ορίσετε τιμές PHP

  • Επιλέξτε VPS ή διακομιστή cloud για πλήρη έλεγχο

17. Πρόβλημα 15: Βρόχος επανεγκατάστασης

συμπτώματα:

  • Ο οδηγός εγκατάστασης επανεκκινείται μετά την ολοκλήρωσή του

Αιτίες:

  • Η συνεδρία χάθηκε ή το install.lock λείπει

Λύσεις:

  • Διαγράψτε τα cookies του προγράμματος περιήγησης

  • Επαλήθευση install.lock υπάρχει και είναι ευανάγνωστο

  • Ελέγξτε ξανά τη διαδρομή του συστήματος αρχείων στη διαμόρφωση

18. Εργαλεία για την αντιμετώπιση προβλημάτων εγκατάστασης

  • phpinfo() για λεπτομέρειες περιβάλλοντος PHP

  • Αρχεία καταγραφής σφαλμάτων Apache/Nginx

  • Αρχεία καταγραφής MySQL: /var/log/mysql/error.log

  • Εργαλεία προγραμματιστών προγράμματος περιήγησης (καρτέλες Κονσόλας και Δικτύου)

19. Βέλτιστες πρακτικές για την αποτροπή σφαλμάτων εγκατάστασης

  • Διαβάστε προσεκτικά τον οδηγό εγκατάστασης του Dolibarr

  • Χρήση διακομιστών προετοιμασίας για δοκιμές

  • Διατηρήστε τα πακέτα συστήματος ενημερωμένα

  • Παρακολούθηση πόρων διακομιστή

  • Καταγράψτε τα βήματα εγκατάστασης και τις διαμορφώσεις σας

20. Σύναψη

Η εγκατάσταση του Dolibarr είναι μια απλή διαδικασία όταν πληρούνται οι απαιτήσεις και τα δικαιώματα συστήματος. Ωστόσο, η παράβλεψη μικρών διαμορφώσεων μπορεί να οδηγήσει σε απογοητευτικά σφάλματα. Αυτός ο οδηγός παρέχει ολοκληρωμένες λύσεις στα πιο συνηθισμένα προβλήματα εγκατάστασης, ώστε να μπορείτε να μεταβείτε από την εγκατάσταση στην παραγωγικότητα χωρίς καθυστερήσεις. Ο σωστός σχεδιασμός, τα δικαιώματα και η συμβατότητα του συστήματος είναι οι πυλώνες μιας επιτυχημένης ανάπτυξης.