Install EMS Components Using the MDE Installer

Email Marketing Server (EMS) is installed by using the MDE installer. The MDE installer is available for Windows, Linux, and AIX, and supports graphical installations. A separate JDK or JRE installation is not required: the installer installs the JRE required by EMS as part of the installation.

Use the MDE installer to install one or more EMS components. The installer provides the following component selections.

Installer selection	Default selection	Purpose
Siebel Email Marketing - BHD	Selected	Bounce Handler Daemon
Siebel Email Marketing - CTD	Selected	Click Through Daemon
Siebel Email Marketing - ESD	Selected	Email Sending Daemon
Siebel Email Marketing - WSD	Selected	Web Survey Daemon

Install EMS in Graphical Mode

After downloading the EMS installer, open the folder for the appropriate operating system (Windows, Linux, or AIX), then open the mde folder.
Start the installer by running runInstaller.bat on Windows or ./runInstaller.sh on Linux or AIX. The command opens the installer GUI
Enter the EMS home location where the selected components, configuration files, and bundled JRE will be installed. For an upgrade, select the existing installation path from the list or click Browse to locate it.
Click Next. The component selection page lists the four EMS components. All components and their configuration options are selected by default. Select one or more components to install; uncheck the checkbox for any component that you do not want to install.

Click Next. For each selected ESD, CTD, and WSD component, enter the configuration values shown in the following table. BHD does not require these port and certificate-store values.

Configuration Fields

The installer writes the values to the configuration files identified in the following table.

Installer field	Purpose	Configuration file(s)
HTTPS Redirect Port	HTTPS connector port and HTTP-to-HTTPS redirect target.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD) <EMS_HOME>/wsd/webapps/websurveys/WEB-INF/conf/axis2.xml (WSD only)
HTTP Connection Port	Port used by the HTTP connector.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD) <EMS_HOME>/wsd/webapps/websurveys/WEB-INF/conf/axis2.xml (WSD only)
Shutdown Port	Tomcat shutdown listener port.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD)
Keystore Location	Full path to the server certificate keystore used for HTTPS.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD)
Keystore Password	Password for the server certificate keystore.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD)
Truststore Location	Full path to the truststore used for client-certificate validation when configured.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD)
Truststore Password	Password for the truststore.	<EMS_HOME>/<component>/conf/server.xml (ESD, CTD, and WSD)

Note: If configuration is skipped. If you skip configuration for a component, the installer does not replace the listed template variables. Before starting the component, manually replace these variables in <EMS_HOME>/<component>/conf/server.xml for ESD, CTD, and WSD. For WSD, also replace $HTTP_CONNECTOR_PORT and $HTTPS_REDIRECT_PORT in <EMS_HOME>/wsd/webapps/websurveys/WEB-INF/conf/axis2.xml.

Ensure that the HTTP, HTTPS, and shutdown port numbers are valid (from 1 through 65535), unique, and available for use.
Enter valid port numbers from 1 through 65535. The HTTP, HTTPS, and shutdown ports must be unique and available for use.
After entering the values, review the selected options on the Summary page. To save a response file for a future silent installation, click Save Response File.
Click Install. The installer installs the selected components and the required JRE.
When installation completes, click Next. The installer displays the installer log file name and path; review this log if an error occurs during installation.
Click Close to exit the installer.

UNIX prerequisite. The UNIX MDE installer requires a graphical user interface. A VNC session is one supported way to make that interface available on a remote UNIX host.

Windows service note. On Windows, the installer creates a Windows Service entry for each installed component. After confirming the component configuration, open Windows Services and start the required component service.

Uninstall EMS

Navigate to the EMS installation directory, then open the uninstall folder.
Run uninstaller.exe on Windows or ./uninstaller.sh on Linux or AIX.
Follow the prompts to uninstall all installed EMS components.

Windows service note. On Windows, the uninstaller removes the Windows Service entries for the installed EMS components.

Install EMS in Silent Mode

Create a response file before starting a silent installation. The response file records the EMS home location, installation type, selected components, and release version.

Run the silent installer

On Windows, run the following command from the mde folder:

runInstaller.bat -silent -responseFile <response_file_path>

On Linux or AIX, run the equivalent command from the mde folder:

./runInstaller.sh -silent -responseFile <response_file_path>

Response file format:

With Configuration:

SIEBEL_HOME_LOCATION=<PATH WHERE EMS SHOULD BE INSTALLED>
INSTALLATION_TYPE=<FRESH OR UPGRADE>
SELECTED_COMPONENTS=<COMMA-SEPARATED LIST OF COMPONENTS TO INSTALL>
SELECTED_CONFIGURATION_COMPONENTS=<COMMA-SEPARATED LIST OF COMPONENTS TO CONFIGURE>
POST_INSTALLATION_PERFORMED="NO"
VERSION=<VERSION NUMBER>
[Siebel Email Marketing - CTD Configuration]
HTTPS_REDIRECT_PORT=<HTTPS_REDIRECT_PORT>
HTTP_CONNECTION_PORT=<HTTP_CONNECTION_PORT>
SHUTDOWN_PORT=< SHUTDOWN_PORT>
KEYSTORE_LOCATION=<KEYSTORE_LOCATION>
KEYSTORE_PASSWORD=<ENCRYPTED KEYSTORE_PASSWORD>
TRUSTSTORE_LOCATION=<TRUSTSTORE_LOCATION>
TRUSTSTORE_PASSWORD==<ENCRYPTED TRUSTSTORE_PASSWORD> 
[Siebel Email Marketing - ESD Configuration]
HTTPS_REDIRECT_PORT=<HTTPS_REDIRECT_PORT>
HTTP_CONNECTION_PORT=<HTTP_CONNECTION_PORT>
SHUTDOWN_PORT=< SHUTDOWN_PORT>
KEYSTORE_LOCATION=<KEYSTORE_LOCATION>
KEYSTORE_PASSWORD=<ENCRYPTED KEYSTORE_PASSWORD>
TRUSTSTORE_LOCATION=<TRUSTSTORE_LOCATION>
TRUSTSTORE_PASSWORD==<ENCRYPTED TRUSTSTORE_PASSWORD> 
[Siebel Email Marketing - WSD Configuration]
HTTPS_REDIRECT_PORT=<HTTPS_REDIRECT_PORT>
HTTP_CONNECTION_PORT=<HTTP_CONNECTION_PORT>
SHUTDOWN_PORT=< SHUTDOWN_PORT>
KEYSTORE_LOCATION=<KEYSTORE_LOCATION>
KEYSTORE_PASSWORD=<ENCRYPTED KEYSTORE_PASSWORD>
TRUSTSTORE_LOCATION=<TRUSTSTORE_LOCATION>
TRUSTSTORE_PASSWORD==<ENCRYPTED TRUSTSTORE_PASSWORD>

Without Configuration:

SIEBEL_HOME_LOCATION=<PATH WHERE EMS SHOULD BE INSTALLED>
INSTALLATION_TYPE=<FRESH OR UPGRADE>
SELECTED_COMPONENTS=<COMMA-SEPARATED LIST OF COMPONENTS TO INSTALL>
POST_INSTALLATION_PERFORMED="NO"
VERSION=<VERSION NUMBER>

Use the following valid values:

INSTALLATION_TYPE: Fresh or Upgrade.
SELECTED_COMPONENTS: Siebel Email Marketing - BHD; Siebel Email Marketing – CTD, Siebel Email Marketing – ESD, or Siebel Email Marketing - WSD.
SELECTED_CONFIGURATION_COMPONENTS: Siebel Email Marketing - CTD Configuration, Siebel Email Marketing - ESD Configuration, Siebel Email Marketing – WSD Configuration
When selecting more than one component, separate the component names with commas.
VERSION: the release version of the EMS installer being used.

Response file examples:

New installation with all four components with no configuration:

SIEBEL_HOME_LOCATION="C:\EMS_25.6"
INSTALLATION_TYPE="Fresh"
SELECTED_COMPONENTS="Siebel Email Marketing - BHD,Siebel Email Marketing - CTD,Siebel Email Marketing - ESD,Siebel Email Marketing - WSD"
POST_INSTALLATION_PERFORMED="NO"
VERSION="25.6.0.0.0"

Example for New installation with configuration CTD and ESD:

[Installation Details]
INSTALLATION_TYPE="Fresh"
SIEBEL_HOME_LOCATION="C:\EMS_26_8"
SELECTED_COMPONENTS="Siebel Email Marketing - CTD,Siebel Email Marketing - ESD"
SELECTED_CONFIGURATION_COMPONENTS="Siebel Email Marketing - CTD ,Siebel Email Marketing - ESD"
[Siebel Email Marketing - CTD Configuration]
HTTPS_REDIRECT_PORT=6000
HTTP_CONNECTION_PORT=6001
SHUTDOWN_PORT=6002
KEYSTORE_LOCATION=C:/EMS_26_8
KEYSTORE_PASSWORD=aEdDWStVLy9CMUFCRExHalE0OTFtWHc2cERKVUFJRlNkTnZEMGxJK1ZFNnB6WStWUjdQTzlnPT1TRk9TV09IZEM5TnJuWU5SZGdEQ1VBPT1nOWU4WTVmaDc5amp2TWU2Nmcvdi8zY2N6cmZnYXA3Tw==
TRUSTSTORE_LOCATION=C:/EMS_26_8
TRUSTSTORE_PASSWORD=aEdDWStVLy9CMUFCRExHalE0OTFtWHc2cERKVUFJRlNkTnZEMGxJK1ZFNnB6WStWUjdQTzlnPT1TRk9TV09IZEM5TnJuWU5SZGdEQ1VBPT1nOWU4WTVmaDc5amp2TWU2Nmcvdi8zY2N6cmZnYXA3Tw==
[Siebel Email Marketing - ESD Configuration]
HTTPS_REDIRECT_PORT=5000
HTTP_CONNECTION_PORT=5001
SHUTDOWN_PORT=5002
KEYSTORE_LOCATION=C:/EMS_26_8
KEYSTORE_PASSWORD=aEdDWStVLy9CMUFCRExHalE0OTFtWHc2cERKVUFJRlNkTnZEMGxJK1ZFNnB6WStWUjdQTzlnPT1TRk9TV09IZEM5TnJuWU5SZGdEQ1VBPT1nOWU4WTVmaDc5amp2TWU2Nmcvdi8zY2N6cmZnYXA3Tw==
TRUSTSTORE_LOCATION=C:/EMS_26_8
TRUSTSTORE_PASSWORD=aEdDWStVLy9CMUFCRExHalE0OTFtWHc2cERKVUFJRlNkTnZEMGxJK1ZFNnB6WStWUjdQTzlnPT1TRk9TV09IZEM5TnJuWU5SZGdEQ1VBPT1nOWU4WTVmaDc5amp2TWU2Nmcvdi8zY2N6cmZnYXA3Tw==

Note: You can run the following command to generate the encrypted password. Open command prompt and run the following. Java should be part of the class path.

<build_location>\mde\ext\jlib>java -jar EncryptString.jar <passwordtext>