Software OpenEMM 免費的電子郵件營銷工具

1 REQUIRED SOFTWARE
===================

1.1 MySQL: Get the most recent version of MySQL 5.0 Community Server for
Windows from http://www.mysql.org/ and install it. Do not forget the
password for the database super user account, you will need it during
OpenEMM installation!

1.2. Get the most recent version of Python 2.5 for Windows from
http://www.python.org/ and install it.

1.3 Get the MySQL database module for Python 2.5 for Windows from
http://sourceforge.net/projects/mysql-python (Download MySQL for Python ->
latest version, select the version ending with *-py2.5.exe, e.g.
MySQL-python-1.2.2.win32-py2.5.exe) and install it.

1.4 Get the most recent JDK version 6 for Windows from http://java.sun.com/
and install it.

As always with Windows, it may be a good idea to reboot now.


2 INSTALL OpenEMM
=================

2.1 Download OpenEMM-5.5.x-win32.zip from
http://sourceforge.net/projects/openemm (Download OpenEMM ->
OpenEMM-5.5.x-win32.zip) and store it anywhere on your local system.

2.2 If you upgrade from a previous release please rename the directory of
the installed version - do not overwrite it with the new release. In case
you changed configuration files manually, do not forget to copy them to the
new OpenEMM directory!

2.3 Unzip the content of the zipfile to your preferred drive (e.g. C:\).

After this, you should find the directory C:\OpenEMM (or whatever drive you
have choosen). This is the home directory of OpenEMM refered further in this
document. Open the Windows explorer and change to the OpenEMM home
directory.


3 IF YOU INSTALL FOR THE FIRST TIME
===================================

3.1 Start "setup.bat" from the home directory and follow the instruction
on the screen. The super user password of the MySQL database has to be
entered twice, first time to create the OpenEMM database, second time to
fill it with the required database structure and content.

3.2 After that you can change the default values for the redirection
domain. This is typically "http://" followed by the name of your system
(not "localhost" in a production enviroment) followed by the default port
":8080", e.g. for a server "www.company.com" the RDIR domain would be
http://www.company.com:8080".

3.2 To enable handling of incoming bounce mails not only for instant
bounces (which works out of the box) but also for delayed bounces and
autoresponder mails you have to set the mailloop domain to a FQDN (Fully
Qualified Domain Name) which points to the machine OpenEMM runs on. You can
find out the hostname of your machine with 'hostname', entered in the
command line mode (Start -> Programs -> Accessories -> Command Prompt). Add
your domain name and TLD (Top Level Domain) to the hostname to get the FQDN
(like news.openemm.org).

When you send e-mails and want to take advantage of the bounce management
for delayed bounces there are two possibilities for the format of the sender
address:

A.) Use whatever address you like. Set up a bounce filter in OpenEMM (see
user manual) to foward the filtered response to a feedback e-mail address of
your choice (different from the sender address, of course). Implement a
forward mechanism to forward incoming mail sent back to the sender address
to the e-mail address generated by the bounce filter (like
ext_1@news.openemm.org). The flow for responses of your e-mails works like
this:

sender address -> filter-generated address (to filter out bounces) -> feedback address

B.) Use an e-mail address with the sender hostname (like
newsletter@news.openemm.org) Since no real e-mail addresses exist for the
sender hostname, normally it would not be possible to reply to an e-mail
with this ender address. To forward responses to a valid e-mail address you
have to define a bounce filter with an e-mail feedback address of your
choice. The e-mail address generated by the bounce filter has to be defined
as an alias in directory C:\OpenEMM\conf\bav in a new file named
bav.conf-local. Example:

news@news.openemm.org    alias:ext_1@news.openemm.org

The flow for responses of your e-mails works like this:

sender address -> bav.conf-local -> filter-generated address -> feedback address

3.4 You can enter a smart relay host. This may be useful for dial-up users
to send the mail via their ISP. You can either just enter the domain or IP
address or you can prefix this address by a : pair,
separated by a '@'. If you want to remove a previous entry, just enter a
hyphen '-'. An example for an ISP with domain 'isp.domain.com' using the
username 'user' and the password 'pass' must be entered in this form:

user:pass@isp.domain.com


4 IF YOU UPDATE FROM A PREVIOUS VERSION
=======================================

Start "update.bat" from the home directory and follow the instruction on the
screen. With OpenEMM 5.4.x the OpenEMM database will be converted to the UTF-8
character set. Therefore, the update script wants to drop and recreate the
OpenEMM database. Please do not be worried and confirm this request.

To change the configuration for the redirect or mailloop domain or the smart
relay (see above) you can start "config.bat" at any time.


5 START OpenEMM
===============

To start the application itself, start "start.bat". Beside the management
scripts this starts the servlet engine Resin to generate the application
frontend and to handle the URL redirection server.

Note: Depending on your installation your firewall will tell you that
httpd.exe asks to use the TCP port 8080 and python.exe the port 25
(the displayed name may vary depending on your Windows and firewall
software.) For proper functionality you have to accept these requests.

Now you can point your local web browser to http://localhost:8080 and login
using username "admin" and password "openemm". One of your first steps
should be changing the password for this user.


6 STOP OpenEMM
==============

To stop the application, just press "Return" in the command line window the
application runs in and stop the Java process by clicking the "Quit" button
in the Resin window. Finally, press "Return" in the command line window
again and wait briefly for termination of all processes and the closing of
this window.