Configuring the unified web application WAR file for email notification of work order changes

The manager can notify users of work order status changes by sending emails to users. To use this feature, you must configure the unified web application WAR file to use an email server before you install the WAR file to the application server.

Before you begin, determine which Simple Mail Transfer Protocol (SMTP) server you are to use to send email notifications. You must have the following information about the SMTP server:
  • Host name or IP address
  • Port number
  • User name and password if SMTP authentication is enabled

To configure the unified web application WAR file for email notification of work order changes:

  1. Use a file compression utility to extract the \WEB-INF\web.xml configuration file that is packaged in the unified web application WAR file. The WAR file is shared_installation_directory/web/app/optim.unified.web.app.war, where shared_installation_directory is the installation directory that you specified for the IBM Optim Shared package group. For example, the default location for the WAR file on Microsoft Windows is C:\IBM\InfoSphere\Optim\shared\web\app\optim.unified.web.app.war.
  2. Use a text editor to open the extracted \WEB-INF\web.xml configuration file and search for the following parameters:
    <init-param>
       <param-name>mailSMTPHost</param-name>
       <param-value>@smtphost@</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPPort</param-name>
       <param-value>@smtpport@</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPAuth</param-name>
       <param-value>@smtpauth@</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPUser</param-name>
       <param-value>@smtpuser@</param-value>
     </init-param>
    <init-param>
       <param-name>mailSMTPPwd</param-name>
       <param-value>@smtppwd@</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPDebug</param-name>
       <param-value>@smtpdebug@</param-value>
    </init-param>
  3. Set the <param-value> values for your email server.
    • mailSMTPHost: The host name or IP address of the mail server.
    • mailSMTPPort: The port number that is used by the mail server.
    • mailSMTPAuth: Whether to enable SMTP authentication (true or false).
    • mailSMTPUser: The user name to use to access the mail server.
    • mailSMTPPwd: The password to use to access the mail server.
    • mailSMTPDebug: Whether to enable SMTP debug information for testing (1 for errors and messages or 2 for messages only).
    For example:
    <init-param>
       <param-name>mailSMTPHost</param-name>
       <param-value>example.com</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPPort</param-name>
       <param-value>25</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPAuth</param-name>
       <param-value>true</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPUser</param-name>
       <param-value>optim</param-value>
     </init-param>
    <init-param>
       <param-name>mailSMTPPwd</param-name>
       <param-value>password</param-value>
    </init-param>
    <init-param>
       <param-name>mailSMTPDebug</param-name>
       <param-value>1</param-value>
    </init-param>
  4. Use the file compression utility to add the changed version of the \WEB-INF\web.xml configuration file back to the unified web application WAR file.
When you install the unified web application WAR file on an application server, the web application is set to use the email server that you specify in the WAR file.
Use the manager to enable email notification for work order changes, and use the connection manager to assign email addresses to users.


Feedback

URL of this topic: