MailArchiva Upgrade
 

Licensing prerequisite

 

Please ensure the period of your support contract ends after the build date of the version of MailArchiva being downloaded. If not, it is necessary to renew your support contract and install an updated license.

 

Upgrade procedures

 

 

Note: Please refer to Upgrade Issues to resolve common issues related to server upgrades.

 

Full upgrade

 

A full upgrade is mandatory when performing a major version upgrade (e.g. v7 -> v8). It may also be used to perform a minor version update (e.g. v8.11.32 -> v8.11.33).

 

Note: Be sure to read the Supplementary Major Version Upgrade Notes before proceeding with the setup.
Windows

 

  1. Download the latest version of MailArchiva from https://stimulussoft.com/downloads
  1. Stop the existing MailArchiva service from the Windows Services Applet.
  2. Run the setup by double clicking the installer. Accept a license agreement.
  3. When prompted to enter maximum heap size, follow these guidelines. For instance, if 12GB of physical RAM is available, enter 5192m.
  4. If writing data to network shares, edit the MailArchiva Windows service using the Windows Service Manager, and set the logon account with sufficient read/write permissions.
  5. Start the MailArchiva Windows Service in the Windows Service Manager.
  6. Login to the Console by accessing http://localhost:8090 using a browser.
  7. If necessary, install the license key in Configuration->About
Linux

 

  1. Stop the server
systemctl stop mailarchiva

 

  1. Run the installer as indicated below and follow the installer prompts.
curl -sS https://bs.stimulussoft.com/api/v1/download/product/maonprem/linux/latest | grep -oP '"downloadUrl": *"\K[^"]*' | xargs curl | tar -xz -C /tmp && cd /tmp/mailarchiva_dist* && ./install


When prompted to enter maximum heap size, follow these guidelines. For instance, if 12GB of physical RAM is available, enter 5192m.
 

  1. After installation, clean up the /tmp folder.

rm -r /tmp/mailarchiva_dist*

 

  1. Start the MailArchiva service by running:
systemctl start mailarchiva

 

  1. Login to the Console by accessing http://localhost:8090 using a browser.
  2. If the upgrade occurs correctly, the setup wizard will not be displayed.
  3. If necessary, install the license key in Configuration->About
Note: Please refer to Upgrade Issues to resolve common issues related to server upgrades.

 

Minor update

 

In most cases, minor version updates can be performed via the Auto Update or WAR file method. If neither of these methods work, follow the major version upgrade procedure.

 

Upgrade prior to V8.11 If upgrading from any version prior to V8.11, refer to these additional required configuration steps, or alternatively follow the major version upgrade procedure.

 

Be sure to read the Supplementary Minor Version Upgrade Notes before proceeding with an update.

 

WAR upgrade

 
  1. Download the WAR file.
  2. Stop the MailArchiva service.
  3. Delete the contents of [web application] (do not rename this folder under the same location!) .
  4. Rename the WAR file to ROOT.war and copy it to the contents of[web application].
  5. Start the MailArchiva service
     
Linux WAR upgrade

 

systemctl stop mailarchiva
rm /var/opt/mailarchiva/tomcat/webapps/ROOT.war
curl -sS https://bs.stimulussoft.com/api/v1/download/product/maonprem/war/latest | grep -oP '"downloadUrl": *"\K[^"]*' | xargs curl -o /var/opt/mailarchiva/tomcat/webapps/ROOT.war
systemctl start mailarchiva
 
 
Windows WAR upgrade
 
Download the latest WAR file from https://stimulussoft.com/downloads and rename it to ROOT.war
Stop MailArchiva Service from Windows Service Manager
Delete the contents of C:\ProgramData\MailArchiva\Tomcat\webapps directory
Copy ROOT.war to C:\ProgramData\MailArchiva\Tomcat\webapps directory
Start MailArchiva Service from Windows Service Manager
 
 

Auto update

 

  1. Login to the MailArchiva console.
  2. Visit Configuration->Auto Update.
  3. Click the Update button.
     
Note:  After the update is downloaded, it may be necessary to wait a while before the update will be applied and service reloaded.

 

 

Supplementary minor version upgrade notes

 

  • A minor update does not change the app server and Java Runtime software; only the MailArchiva program code.
  • If new versions are not being shown in Configuration->Auto Update,  try performing a full major version upgrade to reinstall the auto update application.
  • On rare occasions, the Java runtime may be changed between minor versions. In such situations, a hint will be placed in the changelog and it may be necessary to perform a full major version upgrade.

 

Legacy upgrade (OSE/V1/V2)

 

  1. 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.
  2. Close the existing Active volume in Configuration->Volumes.

 

Windows
 

  1. Stop the MailArchiva service from Windows Services Applet.
  2. Backup C:\Program Files (x86)\MailArchiva\Server\webapps\ROOT\WEB-INF\conf and C:\Program Files (x86)\MailArchiva\Server\webapps\ROOT\WEB-INF\logs directories using file explorer.
  3. Create a new volume in Configuration->Volumes.
  4. Continue by following the instructions Major Version Upgrade above.
  5.  Login to the Console. Ensure Light stemming is selected in Configuration->Index.
  6. Click Configuration->Volumes->Reindex All to reindex all volumes.

Linux

 

  1. Stop the MailArchiva server.
systemctl stop mailarchiva (Linux)

 

  1. Create a new volume in Configuration->Volumes.
  2. Continue by following the instructions in Major Version Upgrade above.
  3.  Login to the Console. Ensure Light stemming is selected in Configuration->Index.
  4. Click Configuration->Volumes->Reindex All to reindex all volumes.
 

Supplementary major version upgrade notes

 

  • If moving servers and upgrading from MailArchiva v2/OSE at the same time, refer to Move Server for further instructions.
  • All major version upgrades require a valid support contract whose expiry date exceeds the build date of the software being downloaded.
  • If upgrading from OSE/v2, it is recommended to backup your server configuration before running the installer.
  • Ensure that volume store directories are not placed anywhere under the MailArchiva program directory (e.g.  C:\Program Files (x86)\MailArchiva or /opt/mailarchiva) as the directory will be recursively deleted during the upgrade process. Volume stores should always reside outside the MailArchiva program directory.
  • Support for 32 bit OS has been dropped in MailArchiva V5+. Please install MailArchiva on an x64 OS. Follow Move Server instructions to move and upgrade.
Note: Please refer to Upgrade Issues to resolve common issues related to server upgrades
© 2005 - 2024 ProProfs

Found this information useful? Visit mailarchiva.com to learn more about MailArchiva.

-