Configuring and Using Diagnostic Tools › Set Notifications for the OutOfMemory Conditions on the SA Manager

Set Notifications for the OutOfMemory Conditions on the SA Manager

As an administrator, you can enable email notifications for out-of-memory conditions.

Any exceptions (such as OutOfMemory conditions) on the SA Manager can compromise the stability of the SA Manager if they are left unnoticed. To manage such situations, CA SOI provides a detection mechanism that sends notifications whenever any exception stops the JSW wrapper. CA SOI identifies such scenarios and uses the JSW wrapper to send email notifications to the administrator. The email includes detailed information about the failure condition and the reason about why CA SOI was shut down. The administrator can then analyze the scenario, take appropriate measures to fix the issues, and prevent the SA Manager from growing indefinitely and compromising the stability. To set the email notification, update the SOI_HOME\jsw\conf\EmailNotification.conf file.

Follow these steps:

1. Navigate to the SOI_HOME\jsw\conf folder.
2. Locate and open the EmailNotification.conf file in a text editor.
3. Update the parameters available under various sections of the file as appropriate; for example:
   • To enter the sender and recipient email addresses, update the wrapper.event.default.email.sender and wrapper.event.default.email.recipient parameters under the # Common Event Email settings. section. An example is as follows:

     wrapper.event.default.email.sender=abc@xyz.com
     wrapper.event.default.email.recipient=def@xyz.com
     

   • To update the email server, update the wrapper.event.default.email.smtp.host=<SMTP Server Host> entry and modify the SMTP server host with the actual email server the client is using. An example is as follows:

     wrapper.event.default.email.smtp.host=mail.xyz.com
     

   • To receive notifications for any option that is mentioned in the # Enable specific event emails. section, uncomment the specific option.
   • To customize the body of the email, update the wrapper.event.jvm_restart.email.body parameter under the # Specify custom mail content section. An example is as follows:

     wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n
     

   Note: For more information about various parameters, see http://wrapper.tanukisoftware.com/doc/english/props-event.html#properties.

4. Save the changes in the file.

   The settings are applied.