Language Files generated by Sphinx (701294)

locales/bg/LC_MESSAGES/string.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Nitrokey Documentation\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-12 09:00+0200\n"
+"POT-Creation-Date: 2024-09-19 11:48+0200\n"
 "PO-Revision-Date: 2024-09-04 13:51+0000\n"
 "Last-Translator: Anonymous <[email protected]>\n"
 "Language: bg\n"
@@ -9057,11 +9057,11 @@ msgstr "Конфигурацията е във формат yaml:"
 msgid "All platforms"
 msgstr "Всички платформи"
 
-#: ../nethsm/pkcs11-setup.rst:128
+#: ../nethsm/pkcs11-setup.rst:131
 msgid "Instances"
 msgstr "Инстанции"
 
-#: ../nethsm/pkcs11-setup.rst:130
+#: ../nethsm/pkcs11-setup.rst:133
 msgid ""
 "If multiple NetHSM instances are listed in the same slot, these instances"
 " must be configured in a cluster. The credentials of the users and the "
@@ -9071,19 +9071,95 @@ msgstr ""
 "екземпляри трябва да бъдат конфигурирани в клъстер. Удостоверенията на "
 "потребителите и ключовете трябва да са едни и същи за всички инстанции."
 
-#: ../nethsm/pkcs11-setup.rst:132
+#: ../nethsm/pkcs11-setup.rst:135
 msgid ""
 "The module will use the instances in a round-robin fashion, trying "
 "another instance if one fails."
 msgstr ""
 "Модулът ще използва инстанциите по кръгов път, като при неуспех ще опита "
 "друга инстанция."
 
-#: ../nethsm/pkcs11-setup.rst:136
+#: ../nethsm/pkcs11-setup.rst:139
+msgid "Network reliability"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:141
+msgid ""
+"To improve the reliability of the PKCS#11 module, it is possible to "
+"configure timeouts, retries, instance redundancy and TCP keepalives."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:144
+#, fuzzy
+msgid "Retries"
+msgstr "Метрики"
+
+#: ../nethsm/pkcs11-setup.rst:146
+msgid ""
+"If a NetHSM instance is unreachable, the PKCS#11 module is capable of "
+"retrying sending the request to other instances, or to the same instance "
+"(if other instances are also unreachable). It is possible to introduce a "
+"delay between retries."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:149
+msgid ""
+"Failing instances are marked as unreachable and retried in a background "
+"thread, so they won't be tried unless all instances are unreachable"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:150
+msgid ""
+"If no background thread can be spawned "
+"(`CKF_LIBRARY_CANT_CREATE_OS_THREADS`), failed instances will be tried "
+"during normal operations, slowing down the requests. To minimise this, "
+"such \"inline\" health checks are limited to 1 second timeouts, and only "
+"3 health checks can be attempted per request (this is a worst case "
+"situation that can only be reached if a large number of instances "
+"failed)."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:152
+msgid "Therefore:"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:154
+msgid ""
+"The maximum number of requests sent for one API call is: "
+"``retries.count`` + 1 + 3"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:155
+msgid ""
+"The maximum (worst case) duration before reaching the timeout for one API"
+" call is: (``retries.count`` + 1) * ``timeout_seconds`` + 3"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:156
+msgid ""
+"The maximum timeout for one PKCS#11 function call will vary because some "
+"functions will lead to multiple API calls in the NetHSM."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:159
+msgid "TCP keepalive"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:161
+msgid ""
+"To improve performance, connections are kept open with the NetHSM "
+"instances to avoid the need for re-opening them. It is possible that in a"
+" network with a firewall, these idle connection could be closed, leading "
+"to the next connection attempt to timeout. To prevent slow timeouts from "
+"happening, and to detect earlier if it does, it is possible to configure "
+"TCP keepalives for these."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:166
 msgid "Users"
 msgstr "Потребители"
 
-#: ../nethsm/pkcs11-setup.rst:138
+#: ../nethsm/pkcs11-setup.rst:168
 msgid ""
 "The operator and administrator users are both optional but the module "
 "won't start if no user is configured. This is so you can configure the "
@@ -9095,7 +9171,7 @@ msgstr ""
 " можете да конфигурирате модула само с потребител администратор, само с "
 "потребител оператор или и с двамата едновременно."
 
-#: ../nethsm/pkcs11-setup.rst:140
+#: ../nethsm/pkcs11-setup.rst:170
 msgid ""
 "When the two users are set the module will use the operator by default "
 "and only use the administrator user when the action needs it."
@@ -9104,36 +9180,37 @@ msgstr ""
 "подразбиране и ще използва потребителя администратор само когато "
 "действието го изисква."
 
-#: ../nethsm/pkcs11-setup.rst:142
+#: ../nethsm/pkcs11-setup.rst:172
+#, fuzzy
 msgid ""
-"The regular PKCS11 user is mapped to the NetHSM operator and the PKCS11 "
-"SO is mapped to the NetHSM administrator."
+"The regular PKCS#11 user is mapped to the NetHSM operator and the PKCS#11"
+" SO is mapped to the NetHSM administrator."
 msgstr ""
 "Обикновеният потребител PKCS11 е съпоставен с оператора на NetHSM, а "
 "PKCS11 SO е съпоставен с администратора на NetHSM."
 
-#: ../nethsm/pkcs11-setup.rst:145 ../nitrokey3/shared/reset.rst.inc:17
+#: ../nethsm/pkcs11-setup.rst:175 ../nitrokey3/shared/reset.rst.inc:17
 #: ../software/nk-app2/passwords.rst:2
 msgid "Passwords"
 msgstr "Пароли"
 
-#: ../nethsm/pkcs11-setup.rst:147
+#: ../nethsm/pkcs11-setup.rst:177
 msgid "The password can be provided by multiple means:"
 msgstr "Паролата може да бъде предоставена по няколко начина:"
 
-#: ../nethsm/pkcs11-setup.rst:149
+#: ../nethsm/pkcs11-setup.rst:179
 msgid "In plain text in the configuration ``password: \"mypassword\"``"
 msgstr "В обикновен текст в конфигурацията ``password: \"mypassword\"``"
 
-#: ../nethsm/pkcs11-setup.rst:150
+#: ../nethsm/pkcs11-setup.rst:180
 msgid ""
 "In an environment variable read by the module with the ``env:`` prefix: "
 "``env:ENV_STORING_THE_PASSWORD``"
 msgstr ""
 "В променлива на средата, прочетена от модула с префикс ``env:``: "
 "``env:ENV_STORING_THE_PASSWORD``"
 
-#: ../nethsm/pkcs11-setup.rst:151
+#: ../nethsm/pkcs11-setup.rst:181
 msgid ""
 "Via the login function of pkcs11, example for pcks11-tool: ``pkcs11-tool "
 "--module libnethsm_pkcs11.so -p opPassphrase`` To provide the the admin "
@@ -9146,7 +9223,7 @@ msgstr ""
 "``pkcs11-tool --module libnethsm_pkcs11.so --login --login-type so --so-"
 "pin Administrator``"
 
-#: ../nethsm/pkcs11-setup.rst:154
+#: ../nethsm/pkcs11-setup.rst:184
 msgid ""
 "If the password of an user is not set in the configuration file a login "
 "will be required to provide the password (3rd method)."
@@ -9155,7 +9232,7 @@ msgstr ""
 "ще се изисква влизане в системата, за да се предостави паролата (3-ти "
 "метод)."
 
-#: ../nethsm/pkcs11-setup.rst:156
+#: ../nethsm/pkcs11-setup.rst:186
 msgid ""
 "A NetHSM that is not operational is considered as a slot with the token "
 "not present."

locales/cs/LC_MESSAGES/string.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Nitrokey Documentation\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-12 09:00+0200\n"
+"POT-Creation-Date: 2024-09-19 11:48+0200\n"
 "PO-Revision-Date: 2024-09-04 13:51+0000\n"
 "Last-Translator: Anonymous <[email protected]>\n"
 "Language: cs\n"
@@ -8873,11 +8873,11 @@ msgstr "Konfigurace je ve formátu yaml:"
 msgid "All platforms"
 msgstr "Všechny platformy"
 
-#: ../nethsm/pkcs11-setup.rst:128
+#: ../nethsm/pkcs11-setup.rst:131
 msgid "Instances"
 msgstr "Instance"
 
-#: ../nethsm/pkcs11-setup.rst:130
+#: ../nethsm/pkcs11-setup.rst:133
 msgid ""
 "If multiple NetHSM instances are listed in the same slot, these instances"
 " must be configured in a cluster. The credentials of the users and the "
@@ -8887,19 +8887,95 @@ msgstr ""
 "instance nakonfigurovány v clusteru. Pověření uživatelů a klíče musí být "
 "ve všech instancích stejné."
 
-#: ../nethsm/pkcs11-setup.rst:132
+#: ../nethsm/pkcs11-setup.rst:135
 msgid ""
 "The module will use the instances in a round-robin fashion, trying "
 "another instance if one fails."
 msgstr ""
 "Modul bude instance používat obousměrně a v případě selhání jedné "
 "instance vyzkouší jinou."
 
-#: ../nethsm/pkcs11-setup.rst:136
+#: ../nethsm/pkcs11-setup.rst:139
+msgid "Network reliability"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:141
+msgid ""
+"To improve the reliability of the PKCS#11 module, it is possible to "
+"configure timeouts, retries, instance redundancy and TCP keepalives."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:144
+#, fuzzy
+msgid "Retries"
+msgstr "Metriky"
+
+#: ../nethsm/pkcs11-setup.rst:146
+msgid ""
+"If a NetHSM instance is unreachable, the PKCS#11 module is capable of "
+"retrying sending the request to other instances, or to the same instance "
+"(if other instances are also unreachable). It is possible to introduce a "
+"delay between retries."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:149
+msgid ""
+"Failing instances are marked as unreachable and retried in a background "
+"thread, so they won't be tried unless all instances are unreachable"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:150
+msgid ""
+"If no background thread can be spawned "
+"(`CKF_LIBRARY_CANT_CREATE_OS_THREADS`), failed instances will be tried "
+"during normal operations, slowing down the requests. To minimise this, "
+"such \"inline\" health checks are limited to 1 second timeouts, and only "
+"3 health checks can be attempted per request (this is a worst case "
+"situation that can only be reached if a large number of instances "
+"failed)."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:152
+msgid "Therefore:"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:154
+msgid ""
+"The maximum number of requests sent for one API call is: "
+"``retries.count`` + 1 + 3"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:155
+msgid ""
+"The maximum (worst case) duration before reaching the timeout for one API"
+" call is: (``retries.count`` + 1) * ``timeout_seconds`` + 3"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:156
+msgid ""
+"The maximum timeout for one PKCS#11 function call will vary because some "
+"functions will lead to multiple API calls in the NetHSM."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:159
+msgid "TCP keepalive"
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:161
+msgid ""
+"To improve performance, connections are kept open with the NetHSM "
+"instances to avoid the need for re-opening them. It is possible that in a"
+" network with a firewall, these idle connection could be closed, leading "
+"to the next connection attempt to timeout. To prevent slow timeouts from "
+"happening, and to detect earlier if it does, it is possible to configure "
+"TCP keepalives for these."
+msgstr ""
+
+#: ../nethsm/pkcs11-setup.rst:166
 msgid "Users"
 msgstr "Uživatelé"
 
-#: ../nethsm/pkcs11-setup.rst:138
+#: ../nethsm/pkcs11-setup.rst:168
 msgid ""
 "The operator and administrator users are both optional but the module "
 "won't start if no user is configured. This is so you can configure the "
@@ -8911,7 +8987,7 @@ msgstr ""
 "nakonfigurovat pouze s uživatelem správce, pouze s uživatelem operátora "
 "nebo s oběma uživateli současně."
 
-#: ../nethsm/pkcs11-setup.rst:140
+#: ../nethsm/pkcs11-setup.rst:170
 msgid ""
 "When the two users are set the module will use the operator by default "
 "and only use the administrator user when the action needs it."
@@ -8920,36 +8996,37 @@ msgstr ""
 "uživatele operátora a uživatele správce použije pouze tehdy, když to akce"
 " vyžaduje."
 
-#: ../nethsm/pkcs11-setup.rst:142
+#: ../nethsm/pkcs11-setup.rst:172
+#, fuzzy
 msgid ""
-"The regular PKCS11 user is mapped to the NetHSM operator and the PKCS11 "
-"SO is mapped to the NetHSM administrator."
+"The regular PKCS#11 user is mapped to the NetHSM operator and the PKCS#11"
+" SO is mapped to the NetHSM administrator."
 msgstr ""
 "Běžný uživatel PKCS11 je namapován na operátora NetHSM a PKCS11 SO je "
 "namapován na správce NetHSM."
 
-#: ../nethsm/pkcs11-setup.rst:145 ../nitrokey3/shared/reset.rst.inc:17
+#: ../nethsm/pkcs11-setup.rst:175 ../nitrokey3/shared/reset.rst.inc:17
 #: ../software/nk-app2/passwords.rst:2
 msgid "Passwords"
 msgstr "Hesla"
 
-#: ../nethsm/pkcs11-setup.rst:147
+#: ../nethsm/pkcs11-setup.rst:177
 msgid "The password can be provided by multiple means:"
 msgstr "Heslo lze zadat více způsoby:"
 
-#: ../nethsm/pkcs11-setup.rst:149
+#: ../nethsm/pkcs11-setup.rst:179
 msgid "In plain text in the configuration ``password: \"mypassword\"``"
 msgstr "V prostém textu v konfiguraci ``password: \"mypassword\"``"
 
-#: ../nethsm/pkcs11-setup.rst:150
+#: ../nethsm/pkcs11-setup.rst:180
 msgid ""
 "In an environment variable read by the module with the ``env:`` prefix: "
 "``env:ENV_STORING_THE_PASSWORD``"
 msgstr ""
 "V proměnné prostředí načtené modulem s předponou ``env:``: "
 "``env:ENV_STORING_THE_PASSWORD``"
 
-#: ../nethsm/pkcs11-setup.rst:151
+#: ../nethsm/pkcs11-setup.rst:181
 msgid ""
 "Via the login function of pkcs11, example for pcks11-tool: ``pkcs11-tool "
 "--module libnethsm_pkcs11.so -p opPassphrase`` To provide the the admin "
@@ -8962,15 +9039,15 @@ msgstr ""
 "--module libnethsm_pkcs11.so --login --login-type so --so-pin "
 "Administrator``"
 
-#: ../nethsm/pkcs11-setup.rst:154
+#: ../nethsm/pkcs11-setup.rst:184
 msgid ""
 "If the password of an user is not set in the configuration file a login "
 "will be required to provide the password (3rd method)."
 msgstr ""
 "Pokud není heslo uživatele nastaveno v konfiguračním souboru, bude "
 "vyžadováno přihlášení za účelem zadání hesla (3. metoda)."
 
-#: ../nethsm/pkcs11-setup.rst:156
+#: ../nethsm/pkcs11-setup.rst:186
 msgid ""
 "A NetHSM that is not operational is considered as a slot with the token "
 "not present."