Hello and welcome to our todays article in installation setup of OpenEMM on Ubuntu 16.04. OpenEMM is a web-based enterprise application for email marketing, marketing automation, email newsletter and service emails (like transaction emails, event and time triggered emails) and lead management. OpenEMM is the first open source email marketing system that can be used to deploy professional e-mail newsletters and conduct e-mail marketing and it allows users to send both event and time triggered e-mails. OpemEMM includes a basic CRM, CMS and BI functionality, but also allows integration with other systems to provide a best of breed solution. Furthermore you can of course control and organize your lead management using OpenEMM.
In this article we will guide you through some necessary steps, which are needed to install and configure OpenEMM on Ubuntu 16.04.
For the successful installation setup of OpenEMM on Ubuntu 16.04, we need to setup the following software stack.
- Sendmail 8.9 or later, or Postfix 2.6 or later
- Sun Java SE JDK 8
- Apache Tomcat 7 or 8
- MySQL 5.1 to 5.6
- Python 2.4 or later (but not 3.x!)
Update the you operating system to its latest release. This will keep your system in the most stable state and harden it against various intrusion attempts.
You do so by using following commands in your Ubuntu 16.04 server after login with root user credentials.
As we have mentioned earlier that OpenEMM support MySQL 5.6 , so we need to install the required version by using its specific repository using below commands.
Create New User:
Run the commands below to create a special group and user for OpenEMM .
Installing SMTP Server/MTA:
OpenEMM relies on a SMTP server to send out mails and to accept bounces and replies. OpenEMM uses Sendmail for that task by default, because Sendmail is a proven, secure, and fast MTA (Mail Transfer Agent) and OpenEMM is deeply integrated with Sendmail. For sending emails, OpenEMM creates spool files which can be processed directly by Sendmail, and EMM is able to read Sendmail’s log files directly to collect information on the delivery status of each individual email.
Installation of Postfix
In case a different SMTP server is already running on your server, you should stop it first like using command ‘service sendmail stop’.
To be able to use Postfix as SMTP server, you need the appropriate package installed using below command for Ubuntu.
Further dependencies will be resolved and installed automatically by the repository management software once you press ‘Y’ key to proceed. Then configure the postfix when you are asked to choose from the available options and pres ‘OK’ key to proceed.
Installation of Sun Java JDK:
OpenEMM’s web container Tomcat requires the installation of Oracle’s Standard Edition Java Development Kit (SE JDK) – not the GNU version of Java! If Sun’s Java SE SDK is not included in your distribution and has not been installed yet, you have to install it by yourself. For OpenEMM 2015 you have to use Java 8 because Java 7 is no longer be supported by Oracle for free since April 2015.
Installing Java 8
Run below commands to add its repository first and then install Oracle Java 8 after system update.
Accept the License agreement.
Create a new directory and setup the home variable environment for the newly installed Java.
Use command below for symlyincing java to openemm root as shown.
[cc]# echo "export JAVA_HOME=/opt/openemm/java" > ~/.bashrc
Since OpenEMM is a web application using Java, it requires a web container like Tomcat. OpenEMM 2015 runs with Tomcat 6, 7 and 8, but we recommend Tomcat 8. If you still use Tomcat 6, we strongly recommend to update to Tomcat 7 or 8 rather sooner than later.
To install Tomcat, download the latest binary distribution of release 7 or 8 from http://tomcat.apache.org . The core package is sufficient. The examples here use Tomcat 8.0.36 – you should adapt them to the latest version of Tomcat 7 or 8 as needed.
Let’s move to new new directory for software required by OpenEMM and download the Tomcat archive in it using ‘wget’ command.
Once the package is downloaded, extract it within the same directory and the start tomcat service after switching into tomcat directory.
You can also create the soft link using below command.
If you want to make sure that Tomcat works, then run the command below to start tomcat process and check for Tomcat installation screen using below URL.
To stop tomcat you can use below command with tomcat directory.
Enable OpenEMM Access in Firewall:
The Ubuntu Firewall is not enabled by default, because no externally reachable services are running. You can check the status of the firewall and Enable the firewall to open port 25 (SMTP), 8080 (OpenEMM console & redirection) and 8044 (OpenEMM update service)with below commands.
You can verifiy your settings with below command.
If you plan to use the internal SMTP server of OpenEMM instead of Sendmail or Postfix, you have to open port 8025 (OpenEMM SMTP server) as well:
Additionally, you have to enable a prerouting forwarding rule from port 25 to 8025. This is done by adding the following code after the comments at the top in file user.rules in directory ‘/lib/ufw’ :
:PREROUTING ACCEPT [0:0]
:POSTROUTING ACCEPT [0:0]
:OUTPUT ACCEPT [0:0]
-A PREROUTING -i eth+ -p tcp –dport 25 -j REDIRECT –to-port 8025
Committing all these changes requires a restart of the Ubuntu firewall, which is done with
Installation of OpenEMM 2015:
Download the latest version of the OpenEMM binary code from
OpenEMM Download Link . Then copy the tarball to a temporary location – /tmp is a good choice. Change to the home directory and run the following commands to create a version specific directory for the new OpenEMM version and then create a symbolic link from openemm to that directory.
Finally, in order to follow best practise, move the documentation folder to ‘/usr/share/doc’ where doc files are usually located on a Linux system.
Read Access to Maillog:
OpenEMM requires read access to the log file ‘/var/log/maillog’ . For Ubuntu nothing has to be done because openemm was added to group adm and, therefore, can already access the mailog. But since Ubuntu’s maillog is named ‘mail.log’ you have to create a symlink for
maillog with below command.
Initialize/Update the OpenEMM and its CMS Database:
Since OpenEMM 2015 works with a CMS database which did not exist before version 6.0, you have to setup this database and load its layout if you update OpenEMM from a version before 6.0 or if you are installing OpenEMM from scratch.
Create a new data base for openemm.
If you would rather install a demo CMS database with sample values, use below commands to import data with sample values.
Then give full permission to user for access the database
The property system.url in file emm.properties in directory /home/openemm/webapps/openemm/WEB-INF/classes must be set to the URL of your OpenEMM installation, which is usually identical to your redirection URL, in the form
The property ‘cms.ccr.url’ in file cms.properties in the same directory should be set to the identical URL unless the content manager module (central content repository) runs on a different server – which is possible due to its webservices interface.
The property system.url in file emm.properties in directory ‘/home/openemm/webapps/openemm/WEB-INF/classes’ must be set to the URL of your OpenEMM installation, which is usually identical to your redirection URL, in the form as below.
# Edit host for system.url
The property cms.ccr.url in file cms.properties in directory ‘/home/openemm/webapps/openemm/WEB-INF/classes’ must be set to the identical URL.
# Edit host for cms.ccr.url
Start and Stop OpenEMM:
Change to user openemm with below command.
Then start the OpenEMM environment, change to the home directory of OpenEMM and launch the start script as below.
If the script openemm.sh is not found make sure that file .bash_profile in directory ‘/home/openemm’ contains line ‘PATH=$PATH:$HOME/bin’. To stop OpenEMM you can use below command.
Accessing OpenEMM Web:
To invoke the GUI of OpenEMM, point your webbrowser to the following URL
Then log into OpenEMM using below credentials.
After successful login credentials, you will be surprised to see OpenEMM dashboard, where can start using it.
Congratulations! we have successfully installed and setup the world’s most popular open-source software in the email marketing, newsletter and mailing field. OpenEMM offers anything you need for sending newsletter and large quantities of emails. With the aid of this customer-oriented program, any number of recipients or recipient groups receive emails and newsletters with a personal greeting and individual content. With OpenEMM, an unlimited number of recipient profiles can be created, which are saved in a MySQL database. Even already existing datasets can be imported or exported. Besides the automatic detection and filtering of erroneous or undeliverable email addresses, it can also be checked how many emails were opened and how many recipients clicked on a URL contained in the newsletter. I hope you have got this article much helpful, so do not forget to share your valuable comments and suggestions.