How to upgrade to EPOS from previous version (Linux)

This article will get you through the upgrade process of your IceWarp Server to the latest version on Linux. Before you proceed with the upgrade, please read the article about the downgrade to address recent changes in the product that require your attention.

PLEASE NOTE THAT FILE SYSTEM FOR ACCOUNTS IS NOT SUPPORTED ON THIS VERSION!

You can use this article for the migration before you proceed with the upgrade.

If you have an older version of IceWarp for example version 11.X.X.X. Here are the steps on how to upgrade your IceWarp server before you upgrade your server to the EPOS version with links to every single version.

API CHECK

The latest version requires successfully passing the API check to make sure the server is accessible from outside for its latest feature called Dashboard. This is the initial step for each upgrade to EPOS.

This check opens two sessions simultaneously; wherein the first session, the client contacts our Dashboard microservice in our cloud and introduces itself. It continues to tell your server to provide the Smart Discover settings next.

In the second session, the server will try to contact your server through the Smart Discover settings and provide an answer in the first session.

There is an option to skip this check, but the recommended steps are to find out why you cannot reach our API. Issues will likely be in your infrastructure, so we recommend you look at the firewall and Smart Discover settings. The last thing is to ensure the communication is getting through both ways.

To skip the check, please enter the following command. However, please keep in mind that this will make the Dashboard unavailable when the server starts after the upgrade.

 "./install.sh --skip-api-check"

PREPARATION STEPS

To prepare for an upgrade, you must have the previous version of IceWarp called Deep Castle 2. If you are running an older version than build 10 (13.0.3.10), we recommend upgrading to this version first. And if you feel uncomfortable doing it on your own, we can help you install it for you or answer any related questions.

To enhance the functionality of EPOS, it is necessary to transition from SQLite to MariaDB before upgrading to EPOS. This will help overcome the constraints of SQLite, including the incapability to support foreign keys, among others.

If you plan to start using IceWarp and EPOS as your first installation, you can read the article about how to run a clean installation of EPOS.

UPGRADE STEPS

1. Download EPOS from our website and unzip it via Terminal with the command "unzip"
2. Enter the folder with the command "cd" and run the installation file "./install.sh"

The first thing that will pop up is the new license agreement. Please read it carefully and confirm by "Enter" to continue.

The installer will automatically detect your older version of IceWarp but will still ask you if you want to upgrade. Press "Y" and hit enter.

After this, you will be asked to check the information like "Installation prefix" and under which user IceWarp Server will run.

The next check is the "API check" we discussed initially. If the installation process fails on this step, please check your network settings and ensure your server is accessible from the outside.

Then the IceWarp services will be stopped, and the installer will start extracting data; this step can take a while.

Now you will be asked if you want to start IceWarp Server on every system startup.

After this step, you will be asked if you want to use "ffmpeg", which is used for generating thumbnails of any files that can be reviewed as a video. More about this plugin can be found here.

To skip the installation of this plugin for any reason, run the following command.

"./install.sh --skip-ffmpeg-check"

Then you'll be asked if you'd like to start the services and perform the upgrade now.

This is how the installer looks when successfully upgrading your IceWarp server to EPOS.

Congratulation, you have successfully upgraded the server to EPOS now.