Update backup-restore.ascx

This commit is contained in:
Svetlana Maleeva 2024-02-20 15:03:38 +03:00
parent dff4218e78
commit bbdd445969
2 changed files with 88 additions and 6 deletions

View File

@ -123,7 +123,7 @@
If you select the <b>Documents module</b> or one of the third-party services connected to it (DropBox, Box.com, OneDrive, Google Drive, Yandex Disk and storages connected via the WebDAV protocol), the backup file size affects the overall disk space used on your portal.
</div>
</li>
<li>check the <b>Include Mail in backup</b> box if you want to backup the <b>Mail</b> data as well. This increases the backup process time and backup file size, but if this option is unchecked, the <b>Mail</b> data will be lost after restoring and you'll need to connect accounts again.
<li>check the <b>Include Mail in backup</b> box if you want to backup the <b>Mail</b> data as well. This increases the backup process time and backup file size, but if this option is unchecked, the <b>Mail</b> data will be lost after restoring and you'll need to connect accounts again. Please refer to the <a href="#step2"><b>Backup Mail data</b></a> section to find aditional instructions for Mail.
<div class="notehelp nh_notice">
The license data will not be included into the backup. After restoring data from the backup, you will need to upload your license file again.
</div>
@ -137,7 +137,48 @@
</div>
</div>
<h2 id="step2">Automatic backup</h2>
<h2 id="step2">Backup Mail data</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Perform additional actions to backup the <b>Mail</b> data.</p>
</div>
<div class="screen_text">
<div class="notehelp">This instruction does not work for Windows version.</div>
<ol>
<li>Enter the Community Server container:
<pre><code>docker exec -it onlyoffice-community-server bash</code></pre>
</li>
<li>Go to the services folder:
<pre><code>cd /var/www/onlyoffice/Services/TeamLabSvc</code></pre>
</li>
<li>Open the configuration file:
<pre><code>nano TeamLabSvc.exe.config</code></pre>
</li>
<li>Add settings for access to the host machine:
<pre><code>&lt;backup&gt;
&lt;mailServer pathToMailFilesOnHost="/app/onlyoffice/MailServer/data" hostAddress="127.0.0.1" hostUsername="root" hostKey="/tmp/key.pem" /&gt;
&lt;/backup&gt;
</code></pre>
<ul>
<li><b>pathToMailFilesOnHost</b> - the full path to the Mail Server files. For Linux, you can specify the following path: <code>/app/onlyoffice/MailServer/data</code>.<</li>
<li><b>hostAddress</b> - the address of the machine where the Mail Server container is located.</li>
<li><b>hostUsername</b> - the username for connecting to the machine where the Mail Server container is located.</li>
<li><b>hostPassword</b> - the password for connecting to the machine where the Mail Server container is located.</li>
<li><b>hostKey</b> - the path to the file with the user's SSH certificate for connecting to the machine where the Mail Server container is located. The file must be in the OpenSSH format, it can be generated with Putty Key Generator.</li>
</ul>
<div class="notehelp nh_important"><span class="important_notice_label">Important</span>Either <b>hostPassword</b> or <b>hostKey</b> field must be filled in. If both fields are filled in, the connection will be performed using the key first, if unsuccessful, the password will be used.</div>
<div class="notehelp nh_important"><span class="important_notice_label">Important</span>The user (<b>hostUsername</b>) specified in the settings must have rights to read and write the folder with the Mail Server files (<b>pathToMailFilesOnHost</b>). For Linux machines, you can execute the following command: <code>chmod -R 755 /app/onlyoffice/MailServer/data</code>.</div>
</li>
<li>Save the file (Ctrl+S) and exit (Ctrl+X).</li>
<li>Restart the service:
<pre><code>systemctl restart onlyofficeBackup</code></pre>
</li>
<li>Proceed to the <a href="#step4"><b>Data restore</b></a> section to restore data from the backup file.</li>
</ol>
</div>
</div>
<h2 id="step3">Automatic backup</h2>
<div class="block_of_step">
<div class="screen_text">
<p>To automate the backup process, switch to the <b>Backup</b> page in the <b>COMMON SETTINGS</b> section on the left sidebar and use the <b>Automatic backup</b> section:</p>
@ -160,7 +201,7 @@
</div>
</div>
<h2 id="step3">Data restore</h2>
<h2 id="step4">Data restore</h2>
<div class="block_of_step">
<div class="screen_text">
<div class="notehelp">

View File

@ -117,7 +117,7 @@
При выборе опции <b>Модуль Документы</b> или одного из сторонних сервисов, подключенных к нему (DropBox, Box.com, OneDrive, Google Drive, Yandex Disk, хранилища, подключенные по протоколу WebDAV), размер файла резервной копии влияет на общее занятое дисковое пространство на портале.
</div>
</li>
<li>установите флажок <b>Включить Почту в резервную копию</b>, если вы хотите также выполнить резервное копирование данных <b>Почты</b>. Это увеличит время выполнения резервного копирования и размер файла резервной копии, но, если эта опция отключена, данные модуля <b>Почта</b> будут потеряны после восстановления, и учетные записи придется подключать заново.
<li>установите флажок <b>Включить Почту в резервную копию</b>, если вы хотите также выполнить резервное копирование данных <b>Почты</b>. Это увеличит время выполнения резервного копирования и размер файла резервной копии, но, если эта опция отключена, данные модуля <b>Почта</b> будут потеряны после восстановления, и учетные записи придется подключать заново. Пожалуйста, обратитесь к разделу <a href="#step2"><b>Резервное копирование данных Почты</b></a> для получения дополнительных инструкций.
<div class="notehelp nh_notice">
Данные о лицензии не будут включены в резервную копию. После восстановления данных из резервной копии вам понадобится повторно загрузить файл лицензии.
</div>
@ -128,7 +128,48 @@
</div>
</div>
<h2 id="step2">Автоматическое резервное копирование</h2>
<h2 id="step2">Резервное копирование данных Почты</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Выполните дополнительные действия для резервного копирования данных <b>Почты</b>.</p>
</div>
<div class="screen_text">
<div class="notehelp">Эта инструкция не работает для Windows-версии.</div>
<ol>
<li>Войдите в контейнер Community Server:
<pre><code>docker exec -it onlyoffice-community-server bash</code></pre>
</li>
<li>Перейдите в папку сервисов:
<pre><code>cd /var/www/onlyoffice/Services/TeamLabSvc</code></pre>
</li>
<li>Откройте файл конфигурации:
<pre><code>nano TeamLabSvc.exe.config</code></pre>
</li>
<li>Добавьте настройки доступа к хостовой машине:
<pre><code>&lt;backup&gt;
&lt;mailServer pathToMailFilesOnHost="/app/onlyoffice/MailServer/data" hostAddress="127.0.0.1" hostUsername="root" hostKey="/tmp/key.pem" /&gt;
&lt;/backup&gt;
</code></pre>
<ul>
<li><b>pathToMailFilesOnHost</b> - полный путь к файлам почтового сервера. Для Linux можно указать следующий путь: <code>/app/onlyoffice/MailServer/data</code>.</li>
<li><b>hostAddress</b> - адрес машины, на которой размещен контейнер почтового сервера.</li>
<li><b>hostUsername</b> - имя пользователя для подключения к машине, на которой размещен контейнер почтового сервера.</li>
<li><b>hostPassword</b> - пароль для подключения к машине, на которой размещен контейнер почтового сервера.</li>
<li><b>hostKey</b> - путь к файлу с сертификатом SSH пользователя для подключения к машине, на которой размещен контейнер почтового сервера. Файл должен быть в формате OpenSSH, его можно сгенерировать с помощью Putty Key Generator.</li>
</ul>
<div class="notehelp nh_important"><span class="important_notice_label">Важно</span>Должно быть заполнено хотя бы одно из полей: <b>hostPassword</b> или <b>hostKey</b>. Если заполнены оба поля, подключение будет производиться сначала по ключу, при неудаче по паролю.</div>
<div class="notehelp nh_important"><span class="important_notice_label">Важно</span>У пользователя (<b>hostUsername</b>), который указывается в настройках, должны быть права на чтение и запись папки с письмами (<b>pathToMailFilesOnHost</b>). Для Linux можно выполнить следующую команду: <code>chmod -R 755 /app/onlyoffice/MailServer/data</code>.</div>
</li>
<li>Сохраните файл (Ctrl+S) и выйдите (Ctrl+X).</li>
<li>Перезапустите сервис:
<pre><code>systemctl restart onlyofficeBackup</code></pre>
</li>
<li>Перейдите к разделу <a href="#step4"><b>Восстановление данных</b></a> для восстановления данных из файла резервной копии.</li>
</ol>
</div>
</div>
<h2 id="step3">Автоматическое резервное копирование</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Для автоматизации процесса резервного копирования перейдите на страницу <b>Резервное копирование</b> в разделе <b>ОБЩИЕ НАСТРОЙКИ</b> на левой боковой панели и используйте раздел <b>Автоматическое резервное копирование</b>:</p>
@ -151,7 +192,7 @@
</div>
</div>
<h2 id="step3">Восстановление данных</h2>
<h2 id="step4">Восстановление данных</h2>
<div class="block_of_step">
<div class="screen_text">
<div class="notehelp">