> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 volumes που είναι προσαρτημένοι μέσα στα κοντέινερ 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: Can't initialize Background Jobs`, το πλήρες αποτέλεσμα θα μοιάζει κάπως έτσι: {% code title="Παράδειγμα καταγραφής Redis" %} ``` 1:M 11 Feb 2024 15:19:22.609 # Server initialized 1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs. 1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo ``` {% endcode %} Αυτό μπορεί να σχετίζεται με την έκδοση του Docker που χρησιμοποιείται αυτή τη στιγμή. Η αναβάθμιση σε έκδοση >= 20.10.10 θα πρέπει να επιλύσει αυτό το ζήτημα. Για περισσότερες πληροφορίες, δείτε το upstream ζήτημα του 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://ayakaleaf-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.