> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/el/ypostiriksi/troubleshooting.md). # Αντιμετώπιση προβλημάτων {% hint style="info" %} Αν χρησιμοποιείτε μια παλαιότερη έκδοση, παρακαλώ χρησιμοποιήστε `sharelatex` αντί για `Overleaf` στα ονόματα διαδρομών. {% endhint %}
Εκτέλεση του Overleaf με σύστημα αρχείων NFS Η προσάρτηση ενός συστήματος αρχείων NFS σε ένα κοντέινερ Overleaf είναι τεχνικά δυνατή, αλλά δεν συνιστάται και μπορεί να οδηγήσει σε διαφορετικούς τύπους σφαλμάτων απόδοσης. Ένα συνηθισμένο σφάλμα που βλέπετε κατά τη μεταγλώττιση είναι: ``` EBUSY: ο πόρος είναι απασχολημένος ή κλειδωμένος, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441' ``` Συγκεκριμένα, αποτρέπουμε τη χρήση συστημάτων αρχείων που βασίζονται σε NFS για παροδικά δεδομένα, όπως οι κατάλογοι που χρησιμοποιούνται για δεδομένα μεταγλώττισης. Συνιστούμε τη χρήση ενός τοπικού δίσκου scratch, κατά προτίμηση ενός τοπικού SSD, για τους ακόλουθους καταλόγους. Για `docker-compose` βασισμένες ρυθμίσεις, προτείνουμε απλώς την αντικατάσταση του bind-mount από το NFS, κάτι που αποφεύγει την αλλαγή διαδρομών στην εφαρμογή. Ακολουθεί ένα παράδειγμα ενός `docker-compose` αποσπάσματος διαμόρφωσης με τη χρήση ενός δίσκου scratch που είναι προσαρτημένος στο `/scratch`: {% code title="απόσπασμα docker-compose" %} ```yaml services: sharelatex: environment: SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/ volumes: - nfs:/var/lib/overleaf/data - /scratch/cache/:/var/lib/overleaf/data/cache - /scratch/compiles/:/var/lib/overleaf/data/compiles - /scratch/output/:/var/lib/overleaf/data/output - /scratch/tmp/:/var/lib/overleaf/tmp ``` {% endcode %} Δεν υπάρχει ανάγκη να μεταφέρετε τυχόν υπάρχοντα αρχεία από το NFS στη νέα τους θέση μετά την ενημέρωση. Ο μεταγλωττιστής LaTeX μπορεί να αναδημιουργήσει όλα τα αρχεία με μια πλήρη νέα μεταγλώττιση. Για περισσότερες λεπτομέρειες δείτε:
Η εκτέλεση του Overleaf σε Windows ή macOS έχει ως αποτέλεσμα να μην εκκινεί η υπηρεσία `mongo` Αν εκτελείτε το Overleaf σε Windows ή macOS, η `mongo` υπηρεσία ενδέχεται να αποτύχει να επανεκκινηθεί, με σφάλμα: {% code title="Παράδειγμα σφάλματος" %} ``` Αποτυχία εκκίνησης του WiredTiger σε οποιαδήποτε έκδοση συμβατότητας. Αιτία: 1: Δεν επιτρέπεται η λειτουργία ``` {% endcode %} Για να αποφευχθεί αυτό το σφάλμα, τα δεδομένα πρέπει να αποθηκεύονται σε έναν τόμο και όχι σε έναν κατάλογο προσαρτημένο με bind (βλ. το `mongo` τεκμηρίωση της εικόνας για περισσότερες λεπτομέρειες: ). Για να αποθηκεύσετε δεδομένα μέσα σε τόμους Docker που είναι προσαρτημένοι στα κοντέινερ MongoDB και Redis, προσθέστε τα παρακάτω στο `config/docker-compose.override.yml` (δημιουργήστε αυτό το αρχείο αν δεν υπάρχει ακόμη): {% code title="config/docker-compose.override.yml" %} ```yaml volumes: mongo-data: redis-data: services: mongo: volumes: - mongo-data:/data/db redis: volumes: - redis-data:/data ``` {% endcode %} Για περισσότερες πληροφορίες δείτε:
Η αναβάθμιση σε Redis 6.2 έχει ως αποτέλεσμα βρόχο επανεκκίνησης Χρησιμοποιήστε την `docker logs redis` εντολή για να εμφανίσετε ένα αντίγραφο των αρχείων καταγραφής. Αν δείτε τη γραμμή `Fatal: Δεν είναι δυνατή η αρχικοποίηση Background Jobs`, η πλήρης έξοδος θα μοιάζει κάπως έτσι: {% code title="Παράδειγμα αρχείου καταγραφής Redis" %} ``` 1:M 11 Φεβ 2024 15:19:22.609 # Ο διακομιστής αρχικοποιήθηκε 1:M 11 Φεβ 2024 15:19:22.609 # Fatal: Δεν είναι δυνατή η αρχικοποίηση Background Jobs. 1:C 11 Φεβ 2024 15:19:26.055 # oO0OoO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0OoO0Oo ``` {% endcode %} Αυτό μπορεί να σχετίζεται με την έκδοση του Docker που χρησιμοποιείται αυτή τη στιγμή. Η ενημέρωση σε έκδοση >= 20.10.10 θα πρέπει να επιλύσει αυτό το ζήτημα. Για περισσότερες πληροφορίες, δείτε το upstream issue του Redis: Αναφορά:
Λανθασμένος προσανατολισμός των εικόνων προεπισκόπησης/μικρογραφιών της γκαλερί προτύπων Κατά καιρούς, οι εικόνες προεπισκόπησης/μικρογραφιών που δημιουργούνται από το Server Pro μπορεί να δημιουργηθούν με λανθασμένο προσανατολισμό και να απαιτούν χειροκίνητη παρέμβαση για τη διόρθωσή τους. Αυτές οι εικόνες αποθηκεύονται στο `/var/lib/overleaf/data/template_files/` (>= 5.0.3) και `/var/lib/sharelatex/data/template_files/` (παλαιότερα). Συνιστούμε να δημιουργήσετε αντίγραφο ασφαλείας αυτού του φακέλου πριν κάνετε οποιεσδήποτε αλλαγές. Θα χρειαστεί να ακολουθήσετε τα παρακάτω βήματα για κάθε επηρεαζόμενο πρότυπο: Βρείτε το αναγνωριστικό του προτύπουΜεταβείτε στη συλλογή προτύπων της παρουσίας σας (/templates/all), ανοίξτε ένα επηρεαζόμενο πρότυπο και αντιγράψτε το αναγνωριστικό από τη διεύθυνση URL (για παράδειγμα: την εντολή διόρθωσηςΕκτελέστε την ακόλουθη εντολή από τον Docker host (αντικαταστήστε το αναγνωριστικό του προτύπου με αυτό που αντιγράψατε και ενημερώστε τη διαδρομή αν χρειάζεται):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}" Αναφορά:
Επαληθεύστε ότι έχετε ενεργοποιήσει τις κλήσεις συστήματος. Για το pdflatex, αυτό είναι 'pdflatex -shell-escape'. Το `\write18` η εντολή είναι απενεργοποιημένη από προεπιλογή στην Community Edition, επειδή όλες οι μεταγλωττίσεις συμβαίνουν μέσα στο ίδιο `sharelatex` κοντέινερ· αυτή είναι η ασφαλέστερη προεπιλογή. Αν θέλετε να την ενεργοποιήσετε για το pdflatex, δημιουργήστε ένα `latexmkrc` αρχείο στη ρίζα του έργου σας με το ακόλουθο περιεχόμενο: {% code title="latexmkrc" %} ```perl $pdflatex = 'pdflatex --shell-escape'; ``` {% endcode %} Στη συνέχεια δοκιμάστε να κάνετε νέα μεταγλώττιση. Αναφορά:
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/el/ypostiriksi/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.