> 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/fi/aloittaminen/requirements/hardware-requirements.md).

# Laitteistovaatimukset

## Laitteistovaatimukset

Kun hankit laitteistoa Overleafin ajamista varten, tärkein huomioon otettava tekijä on se, kuinka monta samanaikaista käyttäjää suorittaa käännöksiä.

Jos sinulla on esimerkiksi lisenssi yhteensä 100 käyttäjälle, mutta odotat vain noin 5:n työskentelevän samaan aikaan, minimiasennus riittää. Jos odotat suuremman osuuden työskentelevän (ja kääntävän) samanaikaisesti, kannattaa harkita palvelimen hankkimista suuremmalla kokoonpanolla.

### Minimiasennus

Perusvaatimuksena tarvitaan vähintään 2 ydintä ja 3 Gt muistia perustoimintoihin noin 5 samanaikaiselle käyttäjälle. Tämä vähimmäisvaatimus riittää myös suuremmille ryhmille, joissa samanaikaista käyttöä on vähemmän tai joissa on hyväksyttävää, että käännösajat ovat pidempiä kuormituksen ollessa suurempaa.

{% hint style="danger" %}
Jos harkitset NFS:ään (Network File System) perustuvan tiedostojärjestelmän käyttämistä pienessä instanssissasi, tutustu tähän osioon [Vianmääritys](/on-premises/fi/tuki/troubleshooting.md) osiossa.
{% endhint %}

### Skaalautuminen

Nyrkkisääntönä korkean ja tasaisen palvelutason tarjoamiseksi minimiasennukseen tulisi lisätä 1 CPU-ydin ja 1 Gt muistia jokaista 5–10 samanaikaista käyttäjää kohden.

Tämä tulisi ottaa vain suuntaa-antavana ohjeena, sillä esimerkiksi tyypillisten dokumenttien koko (suuremmat dokumentit käyttävät enemmän käännösresursseja), kuinka usein käyttäjät kääntävät, sekä se, kuinka hyvin pidempiin käännösaikoihin suhtaudutaan kovemman kuormituksen aikana, vaikuttavat kaikki tarvittavan mitoituksen tasoon.

Monet asiakkaistamme pyrkivät ottamaan Server Pro -ratkaisun käyttöön koko organisaatiossa tai suurissa tiimeissä. Näissä tilanteissa meidän on vaikea neuvoa tarkkoja asetusvaatimuksia, koska käyttötapaukset ja käytettävissä oleva taustalla oleva laitteisto voivat vaihdella paljon.

| Esimerkki 1                                                                                                                                                                                                                                                                                                                  | Esimerkki 2                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Jos sinulla on Server Pro -asennus 300:lle käyttäjälle yhteensä, ja odotat säännöllisesti 30–60:n näistä käyttäjistä kääntävän dokumentteja samaan aikaan, 8 Gt ja 7 ydintä (5 ydintä + 5 Gt + perus 2 ydintä ja 3 Gt) pitäisi tarjota käyttäjillesi riittävät resurssit, jotta palvelutaso pysyy johdonmukaisesti korkeana. | Esimerkkinä suuremman käyttöönoton laitteistovaatimuksista Server Pro -asennus 1 000:lle käyttäjälle on otettu onnistuneesti käyttöön yhdelle palvelimelle, jossa oli kaksi 4-ydinprosessoria ja 32 Gt järjestelmämuistia. Tämä on ollut riittävä tiimin tarpeisiin viimeisen käyttövuoden ajan. |

Asiakkaat, jotka ylittävät yhden suuren palvelimen rajat, voivat tutustua [Vaakasuuntainen skaalautuminen](/on-premises/fi/yllapito/horizontal-scaling.md) Server Pro -ratkaisua varten.

### Tallennus

Neuvomme olemaan käyttämättä Network File System (NFS)/Amazon EFS/Amazon EBS -ratkaisuja projektin/historian tallennukseen suuremmissa ympäristöissä, emmekä nimenomaisesti **tueta niitä** vaakasuuntaisessa skaalautumisessa.

Näiden tiedostojärjestelmien toiminta ei tarjoa sellaista tarvittavaa suorituskykyä ja luotettavuutta, jota Server Pro tarvitsee toimiessaan suuressa mittakaavassa. Kun tiedostojärjestelmä ei pysy kuorman mukana, sovellus jumittuu liian monien estävien I/O-toimintojen vuoksi. Nämä jumit voivat johtaa Redis-pohjaisten lukkojen ylivuotoon, mikä puolestaan voi aiheuttaa projektitiedon korruptoitumisen.

Neuvomme käyttämään [S3-yhteensopivaa objektitallennusta](/on-premises/fi/aloittaminen/what-is-the-overleaf-toolkit.md) sen sijaan. Hidas S3-suorituskyky vaikuttaa puolestaan vain tiedostojen lataamiseen ja lataamisesta, mikä johtaa vain suurempaan avoimien yhteyksien määrään S3-palveluntarjoajaasi kohtaan 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ä-/I/O-toiminnoissa sovellustasolla.

{% hint style="info" %}
Viitteen vuoksi GitLab noudattaa samankaltaista linjaa [NFS:n/Amazon EFS:n tukemattomuus](https://docs.gitlab.com/ee/administration/nfs.html) itsehallinnoidussa tarjonnassaan.
{% endhint %}

### Nginxiä koskeva määritys suuria käyttöönottoja varten

Oletusarvoisesti Overleaf Server -instanssit rajoittavat yhteyksien määrän 768:aan. Tähän sisältyvät pysyvät WebSocket-yhteydet, ylimmän tason HTML-navigointi ja AJAX-pyynnöt. Kun raja täyttyy, editori ei ehkä pysty muodostamaan yhteyttä, editorisivu ei ehkä lataudu kokonaan ja käännöspyynnöt voivat epäonnistua. Nginx palauttaa tilan 500 vastauksia ja kirjaa `worker_connections eivät riitä muodostettaessa yhteyttä upstreamiin` sisään `var/log/nginx/error`.log-tiedostoon `sharelatex` säilön sisällä.

The [`worker_connections`](https://nginx.org/en/docs/ngx_core_module.html#worker_connections) asetus rajoittaa niiden samanaikaisten yhteyksien määrää, jotka nginx hyväksyy per worker. Työntekijöiden määrä määräytyy [`worker_processes`](https://nginx.org/en/docs/ngx_core_module.html#worker_processes) asetuksen mukaan, ja se on oletuksena 4 nginx-määrityksessämme.

Nginx ei tee juurikaan työtä verrattuna järjestelmän muihin osiin, joten nämä rajat toimivat turvamekanismina, joka estää liian monien yhteyksien ylikuormittamasta järjestelmää. On parempi pudottaa osa ylimääräisistä yhteyksistä aikaisin kuin hidastaa jokaista yhteyttä.

Overleaf Server -instanssit tarjoavat ympäristömuuttujia näiden nginx-asetusten säätämiseksi:

* `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`)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Kun edessä on toinen välityspalvelin <code>sharelatex</code> säilölle (esim. TLS-päätettä varten), <code>NGINX_KEEPALIVE_TIMEOUT</code> Overleaf Server -instanssin <strong>nginx-host</strong>täytyy olla suurempi kuin edellisen välityspalvelimen. Esim. kun Docker-isännällä on toinen nginx-prosessi, </p></div>
* Oletusarvo `NGINX_KEEPALIVE_TIMEOUT`, käytä [`keepalive_timeout 60s`](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_timeout) (oletusarvo upstreamissä) 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 upstreamissä) 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 dokumenttia käännettäessä. Siksi mitä nopeampi CPU:si yksiydin suorituskyky on, sitä nopeammin pystyt kääntämään dokumentin. Useammat ytimet auttavat vain, jos yrität kääntää useampia dokumentteja 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://overleaf-pro.ayaka.space/on-premises/fi/aloittaminen/requirements/hardware-requirements.md?ask=<question>&goal=<endgoal>
```

`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.