Upgrade steps

Upgrade steps

Before starting the update process, make sure you backup your files and database, this is very important.

The upgrade process:
Make sure you download latest version of AppMail and you don’t use the files from the same version you already have installed. AppMail archives are numbered properly, like appmail-X.Y.Z.zip where X.Y.Z is the version number to which you will be upgrading to.

Unzip the archive that contains the AppMail application. In it you’ll have two folders: update and latest. You’ll need the update folder.

1. Make sure you are not running any campaign when updating (pause them if needed)
2. Move your application offline from Backend -> Settings -> Common
3. Upload the contents of the “update” folder on your host, overwriting (don’t replace, but overwrite) the existing AppMail files (the ones which you initially uploaded to install the app)
4. Follow the update wizard

After the upgrade is done, make sure the needed folders are still writable by the web server. if you’re not sure what folders must be writable by the web server.

NOTES:
Some FTP clients, such as Transmit for macOS(x) will replace your server files with the ones from your local folder. This is not the correct behavior, because the client will delete the files from the server then upload the ones from your local folder.

The correct behavior is to override existing files with the new ones, so please pay attention to the way the files are actually uploaded.

    • Related Articles

    • The upgrade timed out and now I have missing columns in the database

      If during the upgrade process you get a timeout it is because your database is just too big and it takes too much time to run all the queries against your existing database. In such case, the best is to restore your backup that you did before ...

    • Install steps

      INSTALL NOTES: Unzip the archive containing the AppMail application. In the resulted folder, you’ll find a folder named “latest”. Upload the contents of that folder on your web hosting account, in the document root, that is, ...

    • Update AppMail from the command line

      If your database is too large, you might want to update your AppMail application from command line rather than the web interface. In order to do this, follow the upgrade steps but once you reach the update screen, do not press the Submit button in ...

    • Upgrading notes for AppMail 1.x to AppMail 2.x

      When upgrading from AppMail 1.x to AppMail 2.x there are a few things you need to do before starting the upgrade process. #1. It is very important you backup your application, be it on your own or by using the Backup Manager. #2. You need to disable ...

    • Update failure - Missing database table or columns

      You can get an error like: The table '{{table_name}}' for active record class 'ModelName' cannot be found in the database. Which means a database table is missing from your app, or you can get an error where the app complaints about a missing ...