Во время процесса обновления, описанного ниже, данные настроек Архива будут сохранены (если не указано обратное). Но не смотря на это, бывают случаи, когда настройки терялись из-за проблем с блокировкой и тому подобных. Поэтому всегда приветствуется делать вручную бэкап настроек сервера (большей частью хранящихся в файле server.conf) перед тем, как приступать к обновлению системы.
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.
Доступные варианты обновления
Стандартное обновление версии 3.x
Обновление с более ранних версий
- C Архива V2 и Архива OSE до Архива V3
- С Open Source Edition до новой версии Open Source Edition
- C Open Source Edition до v2
Архива V3 -> Новая версия Архива V3
There are three easy ways to upgrade Архива:
- Manual Upgrade Standard - Download the latest distribution from the Download Center. Run the setup over your existing version. (surefire, slower manual method!)
- Manual Upgrade Shortcut (V3 and higher) - Download a small WAR file and unpack it in the webapps folder (fast download!)
- Auto Update Run the auto update (convenient!)
Стандартное обновление вручную
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.
- Stop the existing EE server
- Login to the Архива website using your credentials and locate the Download Center.
- Download the latest version of Архива appropriate your platform.
- Run the setup / install script
- 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
Быстрое обновление вручную (только для V3 и более поздних версий)
- Download the WAR file from the Download Center.
- Delete the contents of [main application]\webapps\ROOT
- Unzip the contents of the downloaded WAR file into [main application]\webapps\ROOT
- Restart the server
Auto Update
- Login to the Архива console
- Visit Configuration->Auto Update
- Click the Update button
Архива V2 и Архива OSE -> Архива V3
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.
- Disable archiving in the existing server.
a) In Configuration->Journal Accounts, uncheck Enabled for all connections
b) In Configuration->Listeners, disable SMTP and Milter listeners - Stop the existing EE server
/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) - Download the latest version of Архива V3 appropriate for the target platform
- Run the setup / install script
a) Windows - unpack the distribution zip file containing the main setup executable. Double click the installer and follow the installer prompts.
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
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:
Start Архива service by double clicking the Архива task tray icon, clicking Start or starting from Control Panel->Windows Services (Windows)
- 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 Shift+Refresh).
Retest your Journal Account client connections and check your SMTP / Milter listeners for correctness
Close the old volume and create a new one for archiving.
- 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.
- Stop the existing OSE server|
- If necessary, rename Архива webapp directory (Архива preferences the Архива webapp name to named be 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] - Note: Performing this action will mean that you no longer access the console via http://localhost:8090/mailarchiva but simply http://localhost:8090
- Login to the Архива website using your credentials. Click the Download Center.
- 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
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.
Open Source Edition -> Новая версия Open Source Edition
- Stop the existing OSE server
- Login to the Sourceforge website using your credentials and locate the Архива OSE download page.
- Download the latest version of Архива OSE 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
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.
Смена формата индекса
- 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 /etc/init.d/mailarchiva stop - Backup your existing volume index directories to another location (to ensure you can get them back if the reindex process goes awry)
- Manually delete all volume index directories (not volume store directories).
- Run the installer over your existing copy of Архива.
- Start the server.
- 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. - 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