Before You Get Started

Prerequisites

A Linux or Windows server with the following installed:
- java
- tomcat
  - Version 6, 7 and 8 are supported. However, we do not support an in place upgrade of Tomcat due to the changes in structure.
- mysql
  - MySQL 5.5 and 5.6 are supported.
If using Linux, the server must have a GUI (desktop), and one extra java class library from iEnterprises - please contact iEnterprises support for the extra class library.
The Swift MEAP installer from iEnterprises (typically a zip file)
- If you do not have the Installer, and you are a license customer, please contact iEnterprises support.
A .war file specific to your data source type, also from iEnterprises.
- If you do not have the war file, and you are a license customer, please contact iEnterprises support.
If you want to use SSL (https), a self- or CA- signed SSL certificate.

We recommend a minimum of 2 GB of memory for your server, as well as sufficient disk space to keep log files as long as you like.

A minimal installation only requires about 150 MB of disk space, however, log file size varies depends on your logging level and length of time you keep your logs. For a small installation, 1 GB of disk space is more than sufficient space for logs.

Firewall

Note: Your firewall must be opened for users to access Swift MEAP. Please see more information in the Graphical Installer section.

Before beginning the installation, you should confirm tomcat's JVM memory allocation. You may need to add entries to the catalina.sh or startup.sh file in Linux, or the Java options tab in the tomcat monitor properties in Windows. We suggest as a minimum allocation:

-Djavax.servlet.request.encoding=UTF-8

-Dfile.encoding=UTF-8

-Xmx1024m

-Xms2024m

-XX:PermSize=256m

-XX:MaxPermSize=1024m

-XX:NewSize=64m

Please see the tomcat documentation for further instructions on setting these parameters.

If you are installing on Windows, jump to Windows Installation
If you are installing on Linux, jump to Linux Installation

Log files for the installer are kept in the installer's directory under logs/ Should anything go wrong at any point, you may refer to the logs for further information.

Swift MEAP is very flexible, and may be installed on a great many different types of machines with many different options. This guide is intended as a reference for a basic installation. Furthermore, this guide assumes good familiarity with Windows/Linux commands.