> 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/fi/aloitus/requirements/hardware-requirements.md). # Laitteistovaatimukset ## Laitteistovaatimukset Kun mitoitat laitteistoa Overleafin käyttämistä varten, tärkein huomioon otettava tekijä on se, kuinka moni samanaikainen käyttäjä suorittaa käännöksiä. Esimerkiksi, jos sinulla on lisenssi 100 käyttäjälle yhteensä, mutta odotat vain noin 5:n työskentelevän samaan aikaan, minimiasennus riittää. Jos odotat suuremman osan työskentelevän (ja kääntävän) samanaikaisesti, kannattaa harkita palvelimen mitoittamista korkeammilla spekseillä. ### Minimiasennus Vähimmäisvaatimuksena perustoimintoihin noin 5 samanaikaisen käyttäjän kanssa tarvitaan 2 ydintä ja 3 Gt muistia. Tämä vähimmäisvaatimus riittää myös suuremmille ryhmille, joissa samanaikaista käyttöä on vähemmän, tai joissa pidempiä käännösaikoja voidaan hyväksyä suuremman kuormituksen aikana. {% hint style="danger" %} Jos harkitset NFS:ään (Network File System) perustuvan tiedostojärjestelmän käyttämistä pienessä instanssissasi, katso tämä osio [Vianmääritys](/on-premises/fi/tuki/troubleshooting.md) osiossa. {% endhint %} ### Skaalaus Nyrkkisääntönä, jotta palvelutaso olisi korkea ja tasainen, minimiasennukseen tulisi lisätä 1 CPU-ydin ja 1 Gt muistia jokaista 5–10 samanaikaista käyttäjää kohti. Tätä tulisi pitää vain ohjeellisena, sillä tekijät kuten tyypillisten asiakirjojen koko (suuremmat asiakirjat kuluttavat enemmän käännösresursseja), kuinka usein käyttäjät kääntävät, ja kuinka paljon pidempiä käännösaikoja siedetään kovassa käytössä, vaikuttavat kaikki tarvittavan mitoituksen tasoon. Monet asiakkaistamme haluavat ottaa Server Pron käyttöön koko organisaation laajuisesti tai suurissa tiimeissä. Tällaisissa tilanteissa meidän on vaikea antaa tarkkoja asetusvaatimuksia, koska käyttötapaukset ja käytettävissä oleva taustalla oleva laitteisto voivat vaihdella paljon. | Esimerkki 1 | Esimerkki 2 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Jos käytössäsi on Server Pro -asennus 300 käyttäjälle yhteensä, ja odotat säännöllisesti 30–60:n näistä käyttäjistä kääntävän asiakirjoja samaan aikaan, 8 Gt ja 7 ydintä (5 ydintä + 5 Gt + perus 2 ydintä ja 3 Gt) pitäisi tarjota riittävät resurssit, jotta käyttäjillesi voidaan taata tasaisen korkea palvelutaso. | Esimerkkinä suuremman käyttöönoton laitteistovaatimuksista voidaan mainita, että Server Pro -asennus 1 000 käyttäjälle yhteensä on otettu onnistuneesti käyttöön yhdellä palvelimella, jossa on kaksi 4-ytimistä prosessoria ja 32 Gt järjestelmämuistia. Tämä on riittänyt tiimin tarpeisiin kuluneen vuoden käytön aikana. | Asiakkaat, jotka ylittävät yhden suuren palvelimen rajat, voivat tutustua [Vaakaskaalautuminen](/on-premises/fi/yllapito/horizontal-scaling.md) Server Prolle. ### Tallennus Emme suosittele Network File Systemin (NFS)/Amazon EFS:n/Amazon EBS:n käyttämistä projektien/historian tallennukseen suuremmissa asennuksissa, emmekä nimenomaisesti **emme tue sitä** vaakaskaalautumisessa. Näiden tiedostojärjestelmien toiminta ei tarjoa sellaista suorituskykyä ja luotettavuutta, jota Server Pro tarvitsee suurissa mittakaavoissa. Kun tiedostojärjestelmä ei pysy kuorman mukana, sovellus jumittuu liian monista estävistä IO-operaatioista. Nämä jumitukset voivat johtaa Redis-pohjaisten lukkojen ylivuotoon, mikä puolestaan voi aiheuttaa projektitietojen korruptoitumista. Suosittelemme käyttämään [S3-yhteensopivaa objektitallennusta](/on-premises/fi/aloitus/what-is-the-overleaf-toolkit.md) sen sijaan. Hidas S3-suorituskyky vaikuttaa puolestaan vain tiedostojen lataamiseen ja lähettämiseen, mikä johtaa vain suurempaan avointen yhteyksien määrään S3-palveluntarjoajaan eikä siten vaikuta muun sovelluksen toimintaan. Lisäksi Server Pro voi määrittää S3-pyynnöille järkevät aikakatkaisut, mikä ei ole mahdollista tiedostojärjestelmä-/IO-operaatioille sovellustasolla. {% hint style="info" %} Vertailun vuoksi GitLab noudattaa samankaltaista linjaa [olla tukematta NFS:ää/Amazon EFS:ää](https://docs.gitlab.com/ee/administration/nfs.html) itse hallinnoidussa tarjonnassaan. {% endhint %} ### Nginx-kohtaiset asetukset suurille käyttöönottoille Oletuksena Overleaf Server -instanssi rajoittaa yhteyksien määrän 768:aan. Tämä sisältää pysyvät WebSocket-yhteydet, ylimmän tason HTML-navigoinnin ja AJAX-pyynnöt. Kun raja ylittyy, editori ei ehkä pysty muodostamaan yhteyttä, editorisivu ei ehkä lataudu kokonaan ja käännöspyynnöt voivat epäonnistua. Nginx palauttaa 500-tilavastauksia ja kirjaa `worker_connections ei riitä muodostettaessa yhteyttä upstreamiin` tiedostoon `var/log/nginx/error`.log sisällä `sharelatex` kontissa. Se [`worker_connections`](https://nginx.org/en/docs/ngx_core_module.html#worker_connections) asetus rajoittaa niiden samanaikaisten yhteyksien määrää, jotka nginx hyväksyy jokaista workeria kohden. Workerien määrä määräytyy [`worker_processes`](https://nginx.org/en/docs/ngx_core_module.html#worker_processes) -asetuksen mukaan, ja sen arvoksi on oletuksena asetettu 4 nginx-määrityksessämme. Nginx ei tee kovin paljon työtä verrattuna muihin järjestelmän osiin, joten nämä rajat toimivat turvamekanismina, joka estää liian monien yhteyksien kuormittamasta järjestelmää liikaa. On parempi pudottaa osa ylimääräisistä yhteyksistä ajoissa kuin hidastaa jokaista yhteyttä. Overleaf Server -instanssit tarjoavat ympäristömuuttujat näiden nginx-asetusten säätämiseen: * `NGINX_WORKER_PROCESSES` varten [`worker_processes`](https://nginx.org/en/docs/ngx_core_module.html#worker_processes) (oletus `4`) * `NGINX_WORKER_CONNECTIONS` varten [`worker_connections`](https://nginx.org/en/docs/ngx_core_module.html#worker_connections) (oletus `768`) * `NGINX_KEEPALIVE_TIMEOUT` varten [`keepalive_timeout`](https://nginx.org/en/docs/http/ngx_http_core_module.html#keepalive_timeout) (oletus `65`)

Kun ajetaan toista välityspalvelinta edessä sharelatex -kontin (esim. TLS-purkua varten), niin NGINX_KEEPALIVE_TIMEOUT Overleaf Server -instanssin pitää olla suurempi kuin edellisen välityspalvelimen. Esim. toisella nginx-prosessilla Docker-isännässä nginx-host, tässä on kaksi esimerkkiä:

* Oletusarvo `NGINX_KEEPALIVE_TIMEOUT`, käytä [`keepalive_timeout 60s`](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_timeout) (oletusarvo upstreamissa) kohdassa **nginx-host** * Mukautettu arvo `NGINX_KEEPALIVE_TIMEOUT=100s`, käytä [`keepalive_timeout 90s`](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_timeout) (mukautettu arvo upstreamissa) kohdassa **nginx-host** ### CPU-nopeus LaTeX on yksisäikeinen ohjelma, mikä tarkoittaa, että se voi käyttää vain yhtä CPU-ydintä kerrallaan. CPU on myös tärkein rajoite asiakirjaa käännettäessä. Siksi mitä nopeampi CPU:si yhden ytimen suorituskyky on, sitä nopeammin voit kääntää asiakirjan. Useammat ytimet auttavat vain, jos yrität kääntää enemmän asiakirjoja kuin sinulla on vapaita CPU-ytimiä. --- # 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/fi/aloitus/requirements/hardware-requirements.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.