Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Formatting was changed.

...

Расположение папок программных файлов Архива, файлов настроек, программных данных и логов изменилось по сравнению с предыдущей версией. Ознакомьтесь с новым расположением папок в Разделах файловой системы

 

Note

Осведомленность о содержимом Содержимое обновления: перед обновлением часто бывает полезно просмотреть список изменений (англ. Change Log) в Центре загрузок, чтобы понять и посмотреть, какие опции и исправления ошибок были добавлены в систему с момента последней установки/последнего обновления.

...

Стандартное обновление вручную

The standard way to upgrade Архива is to download the latest version and run the installer over the existing version (do not uninstall the existing version). During the upgrade procedure, the install script will always try to preserve your server's configuration settings.

  1. Stop the existing EE server
  2. Login to the Архива website using your credentials and locate the Download Center.
  3. Download the latest version of Архива appropriate your platform.
  4. Run the setup / install script
  5. Be sure to point the install path to the exact location where the existing version of Архива is installed

a) Windows - simply double click the installer and follow the installer prompts
b) Linux - run the installer as indicated below and follow the installer promptsСтандартный способ обновить Архива  - скачать последнюю версию системы и запустить установщик поверх существующей версии (не удаляя при этом установленную версию). В процессе обновления скрипт установки будет всегда стараться сохранить системные настройки вашего сервера. 

  1. Остановите существующий EE сервер. 
  2. Авторизуйтесь на сайте Архива с использованием ваших данных и зайдите в Центр загрузок. 
  3. Скачайте последнюю версию Архива для вашей операционной системы.
  4. Запустите установщик или скрипт установки. 
  5. Не забудьте указать путь установки именно в то месторасположение на диске, куда установлена предыдущая версия Архива.

а) Windows - просто дважды кликните по установщику и следуйте его командам. 
б) Linux - запустите установщик с помощью кода, приведенного ниже, и следуйте указаниям установщика. 

Code Block
tar -xzvf mailarchiva_server_enterprise_linux_v2_7_2.tar.gz
cd mailarchiva_dist
./install

Быстрое обновление вручную (только для V3 и более поздних версий)

 

...

Note

This shortcut is only applicable to V3 installations (not V2)

...

Быстрая установка подходит только для V3 (не для V2!)

  1. Скачайте WAR файл Центра загрузок.
  2. Удалите содержимое [main application]\webapps\ROOTUnzip the contents
  3. of the downloaded WAR file into Распакуйте содержимое скачанного WAR файла в [main application]\webapps\ROOTRestart the server
  4. Перезагрузите сервер. 

Автоматическое обновление

  1. Login to the Архива console
  2. Visit Configuration->Auto Update
  3. Click the Update buttonАвторизуйтесь в терминале Архива
  4. Откройте вкладку Настройка -> Обновления
  5. Нажмите кнопку Обновить

 Архива V2 и Архива OSE -> Архива V3

Note

Лицензия для Архива Licensing: Архива v3 requires a valid support contract. If your support contract is current, email the Архива Accounts team to obtain your V3 license file.

The directory locations for Архива's program files, configuration files, program data and logs have changed since previous versions. Please familiarize yourself with File System Layout.

 

...

требует действующего контракта на поддержку. Если у вас есть действующий контракт на поддержку, напишите в финансовый отдел Архива  для получения вашего файла V3 лицензии.

Расположение папок программных файлов Архива, файлов настроек, программных данных и логов изменилось по сравнению с предыдущей версией. Ознакомьтесь с новым расположением папок в Разделах файловой системы

 

Note

Важный совет по безопасности: Перед тем как продолжить, пожалуйста, создайте резервную копию настроек вашего существующего сервера! Для создания резервной копии скопируйте все файлы из C:\Program Files\MailArchiva\server\webapps\ROOT\WEB-INF\conf\* or или /usr/local/mailarchiva/server/webapps/ROOT/WEB-INF/conf/* to a temporary locationв какую-нибудь временную папку.

Note

Important Safety Tip №2: Make sure your volume store directories are not placed anywhere under the Архива program directory (e.g. Важный совет по безопасности №2: Проверьте, что папки томов архива не находятся в папке с программными файлами Архива (например, в  C:\Program Files\Архива or /usr/local/mailarchiva) as the directory will be recursively deleted during the upgrade process. Your volume stores should always reside outside the Архива program directory, так как эти папки будут рекурсивно удалены в процессе обновления. Хранилища архивов должны всегда находиться вне программной папки Архива.

Note

Пользователь Open Source Edition User: By upgrading to Архива V3, you can take advantage of : При обновлении до Архива V3 вы можете попробовать преимущества функций Архива V3 Free Edition features. After a 45 day period, features will be switched off and the free features will be enabled. You can activate features at any stage by purchasing an license.

Disable archiving in the existing server. a) In Configuration->Journal Accounts

После 45 дней использования функции будут отключены, а бесплатные функции системы включены. Вы сможете активировать возможности в любой момент, приобретя лицензию на .

  1. Отключите архивирования на существующем сервере.  

    а) Во вкладке Настройка -> Соединения, uncheck Enabled for all connections
    b) In Configuration->Listeners, disable SMTP and Milter listeners

    Stop the existing EE server

    б) Во вкладке Настройка -> Коннектор отключите SMTP и Milter соединения. 

  2. Остановите существующий EE сервер. 
    а) /usr/local/mailarchiva/server/stopserver (Linux)

    Stop Архива service by double clicking the Архива task tray icon, clicking Stop or stopping from Control Panel->Windows Services (Windows)
  3. Download the latest version of Архива V3 appropriate for the target platform
  4. Run the setup / install script

    б) Остановите сервис Архива, дважды кликнув на иконку Архива в панели задач, а потом кликнув Стоп. Или же остановить систему из Панели управления -> Сервисы Windows (Windows)

  5. Скачайте последнюю версию Архива V3, подходящую для вашей платформы. 
  6. Запустите установку/ скрипт установки. 

a) Windows - unpack the distribution zip file containing the main setup executable. Double click the installer and follow the installer prompts.

Note

Target Directory: Sometimes the installer may not pickup the old install path correctly. Please ensure that during the upgrade process, the install path is exactly the same as the existing Архива installation. 

During the install, you wil be prompted to enter the desired heap size. Refer to Memory Settings for guidance on this issue.

b) Linux - run the installer as indicated below and follow the installer promptsраспакуйте файл дистрибутива, содержащий .exe файл установщика. Двойной клик по установщику - и следуйте его дальнейшим инструкциям. 

Note

Целевая папка: иногда установщик может правильно "подцепить" старый путь установки. Пожалуйста, проверьте, что в процессе установки, путь установки (и целевая папка) точно совпадает с уже существующим с предыдущей установки Архива.  

В процессе установки вам предложат ввести желаемый размер "кучи". Для получения информации по этому вопросу обратитесь к разделу Настройка памяти

б) Linux - запустите установщик, как показано ниже, и следуйте его инструкциям. 

Code Block
tar -xzvf mailarchiva_server_linux_v3_0_0.tar.gz
cd mailarchiva_dist
./install

During the install, you wil be prompted to enter the desired heap size. Refer to Memory Settings for guidance on this issue.

The server should be started and listening on port 8090. If not, start the server as follows

В процессе установки вам предложат ввести желаемый размер "кучи". Для получения информации по этому вопросу обратитесь к разделу Настройка памяти

  1. Сервер должен быть запущен и прослушивать порт 8090. Если это не происходит, запустите сервер следующим образом:

    Code Block
    /opt/mailarchiva/server/startserver (Linux)

    Start Архива service by double clicking the Архива task tray icon, clicking Start or starting from Control Panel->Windows Services Запустите сервис Архива, дважды кликнув по иконке Архива в панели задач и потом кликнув "Старт". Или запустите систему из Панели управления -> Сервисы Windows (Windows)

    Note

    Program Location Change: On Linux, the startserver script location has changed. Please familiarize yourself with the new File System Layout.

    Since your browser may have cached copies of the old Архива interface, when logging to Архива console for the first time, be sure to refresh your browser cache (i.e. in Firefox presss

    Смена местонахождения программы: На Linux месторасположение скрипта startserver изменилось. Пожалуйста, ознакомьтесь с новым расположением папок в Разделах файловой системы

  2. Так как ваш браузер может хранить кэшированную копию старого индерфейса Архива, при авторизации в терминале Архива в первый раз не забудтье обновить кэш вашего браузера (в Firefox для этого нажмите Shift+Refresh). 
  3. Retest your Journal Account client connections and check your Проверьте соединение вашего журналируемого клиента и проверьте правильность SMTP / Milter listeners for correctnessсоединений. 

    Note

    Connections Missing: If the Connections menu is missing, edit the Administrator role in Configuration->Roles and ensure that the Connections permission is assigned to it.

    Close the old volume and create a new one for archiving

    Отсутствует меню Соединения: если меню Соединения отсутствует, отредактируйте Роль Администратора во вкладке Настройка -> Роли и проверьте, что роли предоставлены на это права.

  4. Закройте старый том и создайте новый для архивирования.  

Note

Take noteЗамечание: Архива v3 is capable of reading and writing old volume formats. If you do not create a new volume, Архива v3 will continue to write to the old volume in the old format. Only when a new volume is created, will Архива begin archiving in the new format.

To access your old volumes, either:
a) reindex [RECOMMENDED] - This process involves reindexing your data to account for an index format change. It leaves your existing volume data in the old V2 format.
                  Login to the Console. To reindex, Click Configuration->Volumes->Reindex. Refer to Volume Reindex to learn more.  
b) convert - This process involves converting your old V2 volumes to the V3 format. To convert,  Click Configuration->Voumes->Convert. Refer to Volume Conversion to learn more.
 

Архива v3 uses both a new volume store format and a new index format. While, Архива V3 can read and write old V1/V2 volumes, it cannot read old volume indexes. Thus, a reindex is required at minimum. Converting old volumes is a slow process and can take several days to complete on a large volume. Converting an old volume is at least x10 slower than performing a reindex.

When converting an old volume, for safety sake, the old volume will not be deleted. Thus, before converting ensure that you have at least as much free space available as is used by your current volumes. Due to the length of time volume conversion can take, we strongly recommend reindexing your old volume, as opposed to converting them to the new format. 

If upgrading from Архива OSE or Архива v2.1 and lower, please follow steps in Kerberos -> NTLM v2 Authentication Engine Change to reconfigure your Active Directory settings.

Server Not Archiving? Ensure that you have recreated the Journal Account and SMTP/Milter listener settings as indicated in Step 7 above

может читать/записывать в старых форматах хранилищ. Если вы не создадите новый том, Архива v3 продолжит записывать в старый том старого формата. Только когда новый том будет создан, Архива начнет архивировать в новом формате.

  1. Чтобы получить доступ к старым томам нужно:

    a) переиндексировать [РЕКОМЕНДУЕТСЯ] - этот процесс включает переиндексацию ваших данных для последующей смены формата индекса. Он оставляет существующие данные тома в старом V2 формате. 
     Авторизуйтесь в терминале. Для переиндексации зайдите во вкладку Настройка -> Тома и нажмите Переиндексировать. Для более подробной информации обратитесь к разделу  Переиндексировать
    б) конвертировать - Этот процесс включает конвертацию ваших старых V2 томов в V3 формат. Для конвертации во вкладке Настройка -> Тома кликните Конвертировать. Для подробной информации читайте раздел Конвертировать тома.
     

Архива v3 использует и новый формат хранилища тома и новый формат индекса. В то время как Архива V3 может читать/записывать в старых V1/V2 томах, она не может читать старые индексы томов. Поэтому, как минимум требуется переиндексация. Конвертация старых томов - медленный процесс и может занять несколько дней для томов большого объема. Конвертация старых томов по меньшей мере в 10 раз медленнее, чем переиндексация. 

Во время конвертации старого тома, в целях безопасности, старый том не удаляется. Поэтому перед конвертацией проверьте, есть ли у вас на диске столько свободного места, сколько используется в настоящий момент томами. Из-за того, что конверсия занимает так много времени, вы настоятельно рекомендуем переиндексировать старые тома, а не конвертировать их в новый формат. 

Если вы обновляетесь с Архива OSE или Архива v2.1 и более ранних версий, пожалуйста, следуйте инструкциям в Kerberos -> NTLM v2 смена метода авторизации для установки новой конфигурации настроек Active Directory. 

Сервер не архивирует? Проверьте, восстановили ли вы журналируемую учетную запись и настройки SMTP/Milter соединения, как это было указано выше в пункте 3.  

Open Source Edition -> v2

  1. Stop the existing OSE server|
  2. If necessary, rename Архива webapp directory (Архива preferences the Архива webapp name to named be Остановите существующий OSE сервер.  
  3. Если это необходимо, переименуйте Архива папку webapp (папку с веб-приложениями) (Архива предпочитает, чтобы папка с веб-приложениями называлась ROOT).
    rename а) переименуйте C:\Program Files\MailArchiva\server\webapps\mailarchiva to на C:\Program Files\MailArchiva\server\webapps\ROOT (Windows) [if necessaryесли требуется]
    б) mv /usr/local/mailarchiva/server/webapps/mailarchiva to на /usr/local/mailarchiva/server/webapps/ROOT (Linux) [if necessaryесли требуется]
  4. Note: Performing this action will mean that you no longer access the console via Замечание: Если вы это сделали, значит, теперь вам больше не требуется длинный доступ к терминалу: http://localhost:8090/mailarchiva but simply , а можно использовать короткий: http://localhost:8090
  5. Login to the Архива website using your credentials. Click the Download Center.
  6. Download the latest version of Архива appropriate your platform.
Run the setup / install script
a) Windows - simply double click the installer and follow the installer prompts
b) Linux - run the installer as indicated below and follow the installer prompts
  1. Авторизуйтесь на сайте Архива с использованием ваших данных. Зайдите в Центр загрузок. 
  2. Скачайте последнюю версию Архива EE, подходящую для вашей платформы. 
  3. Запустите установщик/ скрипт установки. 

а) Windows - просто дважды кликните по установщику и следуйте его командам. 
б) Linux - запустите установщик с помощью кода, приведенного ниже, и следуйте указаниям установщика. 

Code Block
tar -xzvf mailarchiva_server_enterprise_linux_v2_7_2.tar.gz
cd mailarchiva_dist
./install

NoteЗамечание: Since the OSE uses a different authentication engine and index format to the EE product, it is necessary to complete the steps outlined in Authentication Engine Change and Index Format Change sections further below.
Please also check that all IMAP connections present in Configuration->Journal Accounts have a polling interval that is set to no less than 10 msec. Also, each IMAP connection must have maximum simultaneous messages set to 50Так как OSE использует другой движок для авторизации и другой формат индекса по сравнению с EE продуктом, для завершения необходимо сменить метод авторизации и формат индекса, как это показано чуть ниже.

Пожалуйста, также проверьте, что все IMAP соедиения во вкладке Настройка -> Соединения имеют установленный интервал опросане меньше 10 мсек. Максимальное количество одновременно обрабатываемых сообщений у каждого IMAP соединения должно быть 50 сообщений.

Open Source Edition -> Новая версия Open Source Edition

  1. Stop the existing OSE server
  2. Login to the Sourceforge website using your credentials and locate the Архива OSE download page.
  3. Download the latest version of Архива OSE appropriate your platform.
  4. Run the setup / install script
a) Windows - simply double click the installer and follow the installer prompts
b) Linux - run the installer as indicated below and follow the installer prompts
  1. Остановите существующий OSE сервер. 
  2. Авторизуйтесь на сайте Sourceforge с использованием ваших данных и найдите страницу скачивания Архива OSE.
  3. Скачайте последнюю версию Архива OSE, подходящую для вашей ОС.
  4. Запустите установщик/ установочный скрипт. 

а) Windows - просто дважды кликните по установщику и следуйте его командам. 
б) Linux - запустите установщик с помощью кода, приведенного ниже, и следуйте указаниям установщика. 

Code Block
tar -xzvf mailarchiva_server_opensource_linux_v1_5_0.tar.gz
cd mailarchiva_dist
./install.sh


Kerberos -> NTLM v2 смена метода авторизации

Follow the steps in the Следуйте инструкциям Руководства администратора v2.6 Administration Guide to redefine your AD settings. In summary, you will need to run a vbs script to create a computer account in AD and setup a password on the account. Once the VBS script is completed, it will output all the parameters that are needed for Архива's new AD settingsдля того, чтобы переустановить настроки вашей AD. Вкратце, вы должны запустить скрипт vbs, чтобы создать учетную запись компьютера в AD и установить пароль для этой учетной записи. Как только VBS скрипт завершит свою работу, он выведет вам параметры, которые потребуются для новых AD настроек в Архива.

Смена формата индекса

  • The safest reindex procedure is as follows:
  • In Configuration->Volumes, write down the location of the index directory corresponding with each of your volumes
  • To ensure that all index file locks are eliminated, stop the Архива server
    a) Windows: Stop the Архива server from the Архива system tray or alternatively from the Windows services applet
    b) Linux: type

    Самая безопасный способ переиндексации такой: 

    1. Во вкладке Настройка -> Тома запишите куда-нибудь месторасположение папки индексов (пути к индексу) каждого тома. 
    2. Для надежности, что все блокировки в файлах индекса устранены, остановите сервер Архива
      а) Windows: Остановите сервер Архива из панели задач или же из апплета сервисов Windows. 
      б) Linux: Напечатайте в терминале: /etc/init.d/mailarchiva stop
    3. Backup your existing volume index directories to another location (to ensure you can get them back if the reindex process goes awry)
    4. Manually delete all volume index directories (not volume store directories).
    5. Run the installer over your existing copy of Архива.
    6. Start the server.
    7. Login to the Архива Console. Click Reindex All button in Configuration->Volumes.
      Note: Depending on your I/O constraints and how many messages you have in your archive, the reindex process can take a while to complete. Although, due to indexing operations, server performance will be degraded, the server should still be useable for normal archiving and searching activities.
    8. To obtain the status of the Reindex, click Status->Processes. You should see the reindex process running there.
      A large archive can take several days to complete reindexing. Архива uses very aggressive reindexing algorithms. If your reindex appears slow, it is most likely due to I/O resource constraints. It is generally a bad idea to store your indexes on a remote drive. It is better to store them locally and on a separate drive to volume store paths
    9. Создайте резервную копию папок с индексами ваших существующих томов в другом месте (чтобы быть уверенным, что вы сможете восстановить данные, если что-то в процессе переиндексации пойдет не так) 
    10. Вручную удалите все папки с индексами (но не папки хранилища архива!).
    11. Запустите установщик поверх вашей существующей копии Архива.
    12. Запустите сервер. 
    13. Авторизуйтесь в терминале Архива. Нажмите кнопку Переиндексировать во вкладке Настройка -> Тома.
      Замечение: В зависимости от ограничений вашего ввода-вывода и того, сколько сообщений хранится у вас в архиве, процесс переиндексации может занять какое-то время. Хотя из-за операции индексирования производительность сервера ухудшится, сервер все равно сможет нормально архивировать письма и производить поиск. 
    14. Для того чтобы узнать статус переиндексации, зайдите во вкладку Статус системы -> Процессы. Там вы должны увидеть активный процесс переиндексации. 
      Полная переиндексация большого архива может занять несколько дней. Архива использует самые действенные алгоритмы переиндексации. Если ваша переиндексация идёт медленно, скорее всего это связано с органичениями ввода-вывода. И в целом весьма плохая идея хранить индексы на удаленном диске. Лучше хранить их локально, на компьютере, или на отдельном жестком диске.