============================ xMatters Patch Release Notes ============================ Patch version: PATCH-410-003 Build: 549 Revision: 40080 Document revision date: September 7, 2010 Copyright xMatters, inc. 1994-2010 --------------------- NOTICE OF NAME CHANGE --------------------- AlarmPoint Systems, Inc. is now xMatters, inc. This change extends to how we name our products: the AlarmPoint Integration Agent is now the xMatters integration agent; AlarmPoint Enterprise is now xMatters enterprise; and so on. You can learn more about why we changed our name at www.xmatters.com. During the ongoing transition to the new naming conventions, legacy corporate and product names will still appear in some parts of our products, such as directory paths, logs, and messages. This document reflects the new names whenever possible, while respecting the need for clarity when referring to older products, legacy issues, existing knowledge base articles, etc. For more information (including instructions on how to switch between the AlarmPoint and xMatters interfaces), see the article "Common questions about rebranding from AlarmPoint to xMatters", available on the xMatters (user) community web site. ------- SUMMARY ------- This document covers the following: * Versions of xMatters this patch affects * Behavior the issues display * Fixes included in this patch * How to install this patch (including any prerequisites) * Files included in this patch package * Issue status (i.e., which version of xMatters includes this patch) NOTE: This document is subject to change after the initial release of this patch. The latest version of this document is available in the "Patches/Misc. Downloads" section of the xMatters (user) community web site (https://connect.xmatters.com/). -------------------------- AFFECTED xMatters VERSIONS -------------------------- This is a cumulative patch for version 4.1.0 issues, and should be applied to all xMatters Application Nodes, Notification Nodes and Web Servers (and to the DataSync Server, if applicable). --------------------- PATCH FILE MANAGEMENT --------------------- Applying this patch does not automatically overwrite existing properties files (e.g., log4j.xml, custom.properties). This is to prevent inadvertent overwriting of client modified properties. Instead, this patch includes several files with a ".patch" extension (e.g., log4j.xml.patch, custom.properties.patch). These .patch files represent the latest versions of these files. It is recommended that you compare the .patch files against your deployment's files to determine the specific needs of your environment. WARNINGS ******** - When applying an xMatters patch to an existing installation, the patch may overwrite some files that were already modified for an integration. This may cause the integration to stop working. If this occurs, using the integration documentation, re-apply the configuration changes and validate the integration. (See also the article titled "Integration stops working after applying AlarmPoint patch" on the xMatters (user) community web site.) In particular, note that the following xMatters integrations may edit pre-existing xMatters Node or Web User Interface files: - HP NNMI: Updates web.xml in webserver\webapps\axis2\WEB-INF (see the section "Initialize the Incident Subscription Manager" in the integration guide) - HP Service Manager (Adv): Updates classpath on node-start.conf on Windows and node.sh on Unix (see the section "Initialize the Web Services Library" in the integration guide) - HP Service Center (Adv): Updates classpath on node-start.conf on Windows and node.sh on Unix (see the section "Initialize the Web Services Library" in the integration guide) - Before applying this patch, you must upgrade to xMatters 4.1.0. After upgrading, it is recommended that you apply the latest xMatters 4.1 patch, UNLESS your upgrade path is not compatible with the latest patch. To determine whether your upgrade path is compatible with the latest patch, see the article titled "AlarmPoint Patch Compatibility Matrix" on the xMatters (user) community web site. REMINDER: The xMatters Support Policy was updated in February 2009. You can access the updated Technical Support Policy document on the xMatters (user) community web site (https://connect.xmatters.com/support). After logging in, click the Support tab, and then download the document from the menu on the left of the page. This cumulative patch provides fixes for all entries under "ISSUES". ---------------------------------- ISSUES FIXED IN THIS PATCH RELEASE ---------------------------------- Issues fixed in xMatters 410 patch 3: ************************************* 81. Stacktrace occurs when deleting Recording on Initiate Scenario page. On a DB2 database deployment, a stacktrace occurs when attempting to delete a Recording on the Initiate Scenario page. (xMatters Reference: PRE-41) 80. DataSync export fails to process Team Members on DB2. On DB2, a DataSync export will fail to process Team Members and an error message similar to the following will be generated: com.invoqsystems.apex.datasynchronizer.exceptions. AlarmPointErrorLimitExceededException: Too many errors generated. Processing halted. Processing does not actually stop (it finishes successfully), but DS_TEAM_MEMBERSHIPS is empty. (xMatters Reference: PRE-72) 79. Some Permissions are missing from the list of Available Permissions. Some Permissions do not appear in the Available Permissions list in the web user interface. This means that if you remove some permissions (e.g., ability.act.Developer, ability.act.SupportUser) from some functions (e.g., Developer, Support User), it is not possible to add them back to the function because they do not appear in the Available Permissions list. (xMatters Reference: PRE-133) 78. Incorrect Integration Service capitalization causes all IAs to fail. An Integration Agent that registers an Integration Service with incorrect capitalization (i.e., the wrong case) causes all other Integration Agents to fail indefinitely. (xMatters Reference: PRE-135) 77. Health Monitor hangs when attempting to create event for database failure. When the Health Monitor detects a database failure, it attempts to create a new event and post it (i.e., if the notification target is configured). However, creating a new event requires database access. If no database failover has been configured, the Health Monitor will hang because it is waiting for database access; and, if database failover is configured, the Health Monitor does not try to gain access to the failover database. (xMatters Reference: PRE-140) 76. Outlook may not parse new line characters in email subject line. When sending notifications through the SMTP Device Engine, an email subject line that includes new line characters may not be parsed properly by Microsoft OutLook. (xMatters Reference: PRE-143) 75. Port number should be logged when TAP or any serial port connection fails. When multiple serial ports are configured and the sending of an initial string fails do to a timeout, it is currently not possible to tell which port has failed. The port number should be logged when port initialization fails. (xMatters Reference: PRE-149) 74. Temporary Replacement validation incorrectly allows replacement overlap. It is possible to create a Temporary Replacement that overlaps an existing replacement, causing the existing replacement not to be honored. The validation should be changed so that the overlapping of Temporary Replacements is not allowed. (xMatters Reference: PRE-147) 73. Company Administrator can view data for another Company via report. Under a multi-tenancy license, a Company Administrator can select and view data for another Company via the Notification Throughput Details Report. Company Administrators should be able to view data for their own Company only. (xMatters Reference: PRE-151) 72. Patch 400-006 causes DS_DEVICE_TIMEFRAMES reorg pending state issue on DB2. After applying xMatters 4.0 patch 6 (400-006) and executing the patch database update scripts on a DB2 database, the DS_DEVICE_TIMEFRAMES table goes into the reorg pending state. (xMatters Reference: PRE-157) 71. SMTP DE peformance issues in POP/IMAP accounts with many messages. Using an SMTP Device Engine with a POP/IMAP email account that has a large number of email messages can affect the overall performance and processing of notifications for the associated notification server. This is because the Device Engine attempts to read all messages at once, causing increased memory usage that affects processing times. (xMatters Reference: PRE-168) 70. LDAP Servers configuration page now allows creation of multiple servers. The LDAP Servers configuration page now provides for the creation of multiple LDAP servers (i.e., versus the previous behavior of multiple templates on a single server). This allows administrators to configure separate LDAP servers that use simple bind, anonymous bind, or authenticated search bind, and also provides the ability to authenticate Users across all LDAP configurations. (xMatters Reference: PRE-1355) 69. SubmitAPXML can fail with an UNKNOWN_APPLICATION_ERROR response. In some cases, the SubmitAPXML web service can fail unexpectedly with an UNKNOWN_APPLICATION_ERROR response. When SubmitAPXML is used by an Integration Agent, this can result in repeated submissions, potentially flooding the system with the same event. (xMatters Reference: PRE-1702) 68. New Holiday Behavior setting provides greater Holiday Coverage flexibility. The new Holiday Behavior setting on the Schedule Details page allows you to specify whether and how holidays affect existing Coverages. For example, in some cases, you may choose to have a Coverage that would normally span midnight to end at midnight when there is a holiday the next day. In other cases, you may want the Coverage to span midnight. Similarly, Coverages that start during the holiday can also be controlled by this setting, allowing you to specify whether and for what duration the Coverage operates during a holiday. (xMatters Reference: PRE-1970) 67. DataSync does not support adding phone login/password to an existing User. After a new User has been created without a phone login/password, the User cannot then be updated via Data Synchronization to include a phone login/password. DataSync should check whether the existing User has phone credentials; if not, the phone password should be added (i.e., without disabling it). (xMatters Reference: PRE-2041) 66. Coverages not displayed correctly when Holidays associated with Group. Group Coverages are not displayed correctly when Holidays are associated with the Group. If Holidays are excluded from the coverage a one hour segment may be remaining. If Holidays are included on the coverage a second shift may appear that starts and ends one hour later. (xMatters Reference: PRE-2093) 65. "call" string causes @event::terminate() script method to stack trace. Script method @event::terminate() stack traces when the target name of any recipient has the word "call" in it. (xMatters Reference: PRE-2095) 64. Multiple messages cannot be sent during a single SNPP connection. Currently, the SNPP Device Engine uses one connection to send one message. When the engine sends the next message in the same batch, it must reconnect to the SNPP server. This causes problems when the job contains many messages (in cases of lengthy connection times, notifications will take longer to send and may also result in duplicate notifications because they cannot be processed quickly enough). (xMatters Reference: PRE-2126) 63. Log information is lost (overwritten) when Device Engines are stopped. (xMatters Reference: PRE-2127) 62. Unhandled exception (or silence) when TTS engine encounters "% f". When a message contains a sequence of characters that includes "% f" to be spoken through a TTS engine, an unhandled exception (or silence) can result. A new installer for the Phone runtime binaries that provide the CT ADE libraries has been created to resolve this issue. This new installer is called AlarmPointPhoneRuntime.exe and can be found in the patch under the tools/phone-runtime directory. For more information, refer to the article "Deploying the new PSTN installer included with Patches 400-011 and 410-003" available on the xMatters (user) community web site (https://connect.xmatters.com/). (xMatters Reference: PRE-2173) 61. TTS engine does not play audio for Asian languages. The TTS engine does not play audio for Asian languages (Chinese, Japanese, Korean). (xMatters Reference: PRE-2218) 60. Web Service Audit Report unstable due to Integration Agent registrations. The Web Service audit report becomes unusable when using integrations that require Integration Agents to be registered in xMatters. (xMatters Reference: PRE-2481) 59. SSO requests do not include query string. In SSO configurations, URL requests requiring some query data may not display the correct page results. This means that Users must enter the data in the web user interface and resubmit the page to obtain results. (xMatters Reference: PRE-2491) 58. Group Details page stack traces when User logged in via SSO. When a User has logged on via SSO, the Group Details page displays a stacktrace when the Group includes the logged-in User as a member. (xMatters Reference: PRE-2510) 57. SUCP Device Engine does not support reply messages from the User's device. The SUCP Device Engine does not work with service providers that send reply messages from the User's device. This can result in notification retries or failures in xMatters. Support should be added to handle SUCP reply messages. (xMatters Reference: PRE-2685) Issues fixed in xMatters 410 patch 2: ************************************* 56. Memory leak causes OutOfMemory error leading to node & web server failure. A third-party library issue causes memory leaks that may lead to OutOfMemory errors and the eventual failure of the related node or web server. (xMatters Reference: PRE-2103) 55. Device Engine concurrency limited by message processing thread pool size. Even if a Device Engine's WebUI-configured Concurrent Threads limit (Line Appearances for SIP/PSTN) exceeds its Spring-configured message processing thread pool size, the Device Engine will not be able to concurrently process more notifications than defined in its Spring configuration. (Note that this issue was listed as a Known Issue in the AlarmPoint 4.1 release notes.) (xMatters Reference: PRE-1862) 54. Stack trace occurs when editing text predicates for a Scenario. After a Scenario including text predicates is successfully created, later adding another text predicate causes a stack trace. (xMatters Reference: PRE-2013) 53. Web server logs are truncated after restart, hindering troubleshooting. If a web server is restarted (e.g., due to hanging, performance issues, etc.), the logs are truncated, causing diagnostic information to be lost and hindering the troubleshooting process. (xMatters Reference: PRE-1923) 52. Unhandled exception in web service can display internal server page. Providing a bad URL (e.g., http://localhost:8888/api/services/ AlarmPointWebService?wsdl=') when using web services can cause the internal server page to be displayed. This can be a potential security issue, as the server page includes a link (i.e., "Home") to the admin servlet. The displayed error should be modified so that it does not display the Home link. (xMatters Reference: PRE-1791) 51. Fields on the Company Quotas page should be limited to nine digits. On the Company Quotas page, specifying the current allowable number of digits in any field causes a stack trace. Fields on this page should be limited to nine digits. (xMatters Reference: PRE-1775) 50. xMatters does not receive any DTMF data from the SIP server. In some cases, xMatters does not receive any DTMF data from the SIP server. This means that Users cannot log in to their accounts even when the correct password is input from a Phone Device. This issue is caused by SIP servers that do not follow RFC2833 to send DTMF data to xMatters. If the SDP (Session Description Protocol) does not contain attributes defined in RFC2833, an ERROR message should be logged. (xMatters Reference: PRE-1454) 49. IA appears as FAILED after first heartbeat when it should be ACTIVE. The Integration Agent appears as FAILED in the Component Status Report after its first successful heartbeat; it should instead be marked as ACTIVE. (Note that after the second successful heartbeat the agent is correctly marked as ACTIVE.) In addition to the potential for confusion, this results in the return of FAILED services to the Integration Agent, which causes integration-to-integration requests using the ServiceAPI to fail (i.e., since no active service will be found). (xMatters Reference: PRE-81) 48. Total node shutdown timeout should be configurable. Once the node manager receives a shutdown command, it tries to shut down all components in an orderly manner. However, if the manager cannot shut down a component after five minutes, the node will be terminated regardless of the issue. Currently, this timeout should be configurable. (NOTE: the custom.properties file now includes the nodeManager.shutdownTimeout setting, which has a default value of 300 seconds). (xMatters Reference: PRE-79) 47. IA that heartbeats less frequently than 30 seconds appears as FAILED. An Integration Agent that registers less frequently than every 30 seconds always appears as FAILED in the Component Status Report. Additionally, after 30 seconds, the FAILED agent's services appear as FAILED. However, from the perspective of the Integration Agent, the heartbeats all appear to be succeeding. (xMatters Reference: PRE-73) 46. Health Monitor message generated during normal processing. In some cases, the Health Monitor generates messages for normal operations on the SIP Device Engine. The list of conditions that trigger these messages should be modified to include only those events that require an alert to be sent. (xMatters Reference: PRE-71) 45. Clicking Perform Selected Actions when no Alert selected performs action. In the My Alerts area of a User's Home Page (or on their Active Alerts page), clicking Perform Selected Actions results in a "Your response has been posted" message, even when no Alert has been selected in the table. (xMatters Reference: PRE-66) 44. Support User should not be able to create or delete Users or Groups. The Support User Role currently includes the ability to create and delete Groups; this Role should not have these permissions. (xMatters Reference: PRE-53) 43. No error is displayed when bad data is entered via web Device Validation. If bad data is entered when validating a Device via the web user interface, no error message is displayed. If the User has not seen what a successful validation looks like, this could lead the User to believe that the validation was successful. (xMatters Reference: PRE-48) 42. Group Supervisors can view and details for Groups they do not supervise. From the Who Is On Duty Report, Group Supervisors can view and edit Team details for Groups they do not supervise. (xMatters Reference: PRE-47) 41. Exhaustive Report displays internal Protocol Provider details. If notification delivery fails due to an authentication failure, the Exhaustive Report displays the Protocol Provider's Server IP address. However, the Exhaustive Report should not display internal details about the configuration. (xMatters Reference: PRE-43) 40. Null Address Range causes Address Range TON and NPI to be ignored On the SMPP Device Engine Details page, leaving the Address Range setting blank (i.e., null) causes the Address Range TON and Address Range NPI settings to be ignored. (xMatters Reference: PRE-37) 39. Split Size should be mandatory when Split Long Message is selected. On the settings pages for Protocol Providers, selecting Split Long Message should cause Split Size to become a mandatory setting (i.e., it cannot be left blank). (xMatters Reference: PRE-36) 38. WS_AUDIT table uses the wrong sequence (Oracle and DB2 only). In the xMatters (Oracle or DB2) database, the WS_AUDIT table does not sequence its data correctly, causing errors (e.g., when using the FindGroups web service operation). (xMatters Reference: PRE-35) 37. Permissions page shows duplicate permissions for merged Admin account. When xMatters Administrator accounts are merged (i.e., Super Admin and Company Admin are merged), the Permissions page for the merged Admin displays some permissions twice. (xMatters Reference: PRE-34) 36. Cannot reduce the number of licensed Users in one-Company deployment. In non-multi-tenancy xMatters deployment (i.e., a deployment with only one Company), attempting to reduce the number of licensed Users results in the following error message: "The license of users is less than the configured quota values of all companies, to downgrade a license the quota must be reduced first". (xMatters Reference: PRE-30) 35. Stack trace occurs when trying to remove Event Domain with active events. When an Event Domain still has active events, a stack trace occurs if removal of the domain is attempted. Deletion should be prevented (with message) when the Event Domain has active events. (xMatters Reference: PRE-28) 34. Cannot add Admin User's Devices to a Group when Admin accounts are merged. (xMatters Reference: PRE-25) 33. Only xMatters enterprise should include the Low-Use User Report. xMatters workgroup currently includes the Low-Use User Report; this report should be limited to AlarmPoint enterprise. (xMatters Reference: PRE-23) 32. On SSL, Internet Explorer displays error when saving Data Import results. When attempting to save the results of a Data Import on an SSL connection (i.e., by clicking the "Download Result" button), Internet Explorer displays an error message. (xMatters Reference: PRE-18) 31. Existing Custom Subscription Panels drop Devices when opened and re-saved. Users will unexpectedly lose notifications to BES and Numeric Pager Devices if an existing Subscription Panel (that has not been modified to support Device Names) is opened and re-saved for any reason. (xMatters Reference: PRE-1972) 30. setPresentation has new optional parameter specifying Device Type. On the notification script object, setPresentation has a new optional parameter that allows you to specify a Device Type. This causes the presentation script to generate content only for this Device Type (for example, when you do not want to generate BROWSER & VOICE content). Current behavior when no DEVICE TYPE is passed will remain the same (i.e., content for BROWSER and VOICE will be generated). (xMatters Reference: PRE-1681) 29. SNPP Device Engine does not handle the 88x response code properly. The SNPP Device Engine does not handle an 88x response code to the MSTAtus command properly, treating it as user replied. The handling should be modified to match section "4.6.10 MSTAtus " of the SNPP protocol. (xMatters Reference: PRE-17) Issues fixed in xMatters 410 patch 1: ************************************* 28. Custom Messaging Panels not ordered properly after upgrade to 4.1. Existing message panels are not ordered properly after upgrading to xMatters 4.1 running against a DB2 database. Although the panels remain usable, they exhibit the following symptoms: * The panels are displayed out of order on Messaging tab's left menu (the Quick Message Panel should appear first) * All of the panels are ranked as "0" in the Order column of the table on the Custom Messaging Panels page * The Reorder page for Messaging Panels throws a stacktrace when saved. (xMatters Reference: APE-19210) 27. Upgrading to xMatters 4.1 may cause Custom Subscription Panels errors. Existing xMatters integrations (e.g., to HP NNMi) that include Custom Subscription Panels may experience errors after xMatters is upgraded to version 4.1. In particular, a "String index out of range" exception occurs on xMatters integrations that have a summary panel for Subscription details. (xMatters Reference: APE-19108) 26. Group Schedules set to end after X occurrences cannot be notified. After applying xMatters 4 patch 5 (Patch 400-005), newly-created Groups with Schedules set to end after a specified number of occurrences cannot be notified (and the node generates a stacktrace). (xMatters Reference: APE-18846) 25. Some SIP servers (e.g., Avaya) do not recognize xMatters DTMF tones. (xMatters Reference: APE-18172) 24. getDigits script method can only capture up to ten digits on SIP. The getDigits script method for the phone script object can only capture up to ten digits on SIP. This applies to all uses of getDigits, including Login IDs, passwords, conference numbers, etc. For example, if a User attempts to enter an 11-digit Phone Login ID, the returned number will include only the first 10 digits (resulting in an invalid login). (xMatters Reference: APE-18171) 23. Unable to view home page when xMatters configured for SSO. If xMatters is configured for SSO and a User successfully logs into xMatters via SSO and subsequently logs out, they will be redirected to the xMatters login page (i.e., a page with a URL ending in SSOSignOn.do). When the User logs in again (using valid credentials), the login is successful but the User is presented with a page indicating that they do not have the proper permissions to view their xMatters home page. (xMatters Reference: APE-18141) 22. LDAP authentication logging has been improved to assist with debugging. (xMatters Reference: APE-18137) 21. Deleting Company can cause SIP Device Engine callin/callout & TTS failure. In a multi-Company deployment, deleting a Company can cause the SIP Device Engine callin, callout, and TTS engine to fail. (xMatters Reference: APE-18136) 20. SMPP password field does not validate field length. The SMPP specification allows for a short password, and the SMPP Device Engine correctly detects passwords that are too long and logs an error. However, this error is not obvious to Users in xMatters; the password should be validated in the associated configuration field, providing the User with immediate feedback when an invalid password is specified. (xMatters Reference: APE-18131) 19. Assign Permissions page displays permission names instead of descriptions. The Assign Permissions page currently displays the formal names of Permissions (e.g., view.screen.PersonDetails) rather than descriptions of the Permissions. While these names generally match the URL for each page, they may not be congruent with the page title, which can cause User confusion. (xMatters Reference: APE-18113) 18. FindWhoIsOnDuty web service call response includes duplicate Users. When the FindWhoIsOnDuty web service call is run against a Group with duplicate Users across Teams, the response includes a detailed recipient list with duplicate Users. This data duplication can delay response times and serialization, and in extreme cases can cause out-of-memory errors. (xMatters Reference: APE-18086) 17. No Health Monitor Message is sent when SIP registration fails. When a SIP Device Engine fails to register with the SIP Server, the Health Monitor should send out a message to this effect. (xMatters Reference: APE-17570) 16. Add 'export to Microsoft Excel' option to Company Quotas page. (xMatters Reference: APE-17400) 15. xMatters URLs can be improperly shared, causing potential security issue. xMatters URLs can be improperly shared, which can cause a potential security issue. In particular, Users with the same permissions who share URLs may be able to view the other User's xMatters pages via the shared URL. (xMatters Reference: APE-17368) 14. User's notification status may be reported on the wrong Exhaustive Report. A User's notification status may be reported on the wrong Exhaustive Report for simultaneous events that reach voicemail. (xMatters Reference: APE-16934) 13. AddEvent web service call does not allow null values for event tokens. The AddEvent web service call does not allow null values for event tokens. This can cause some custom integrations to receive an unexpected unsuccessful response code. (xMatters Reference: APE-16597) 12. Health Monitor events not created for a failed Protocol Provider. In a multi-Company xMatters deployment, Health Monitor events are not created for a failed Protocol Provider if the notification target is not in the default Company. (xMatters Reference: APE-16412) 11. Log message and script report ANAYLSIS_ERROR instead of actual error. When the xMatters Phone Device Engine encounters connection errors such as NetworkDown or another telco network signal, the log message reports ANAYLSIS_ERROR instead of the actual error. (xMatters Reference: APE-16175) 10. Custom Attributes Details page accessible without proper permissions. (xMatters Reference: APE-16158) 9. View Sent Messages page displays only one of multiple predicate values. xMatters 4.0 patch 5 added functionality to allow the selection of multiple values for one predicate in a Custom Messaging Panel. However, after sending a message with multiple predicate values selected through such a messaging panel, the View Sent Messages page displays only one of values. (xMatters Reference: APE-16138) 8. Cannot delete Subscription when it has an active alert. Currently, if there are active alerts for a Subscription, it cannot be deleted. This can become an issue for longer-lifecycle Subscriptions for which there are always active alerts (i.e., the Subscription can never be deleted). (xMatters Reference: APE-15724) 7. EventScriptObjectImpl.getUniquePersons method can cause stacktrace. When message recipients in different Companies have the same User ID, a script including the EventScriptObject.getUniquePersons method causes a stack trace to be logged and notifications are not sent out. The method should be modified so that it distinguishes between Users with identical IDs in different Companies (i.e., the method should be Company 'aware'). (xMatters Reference: APE-15720) 6. SMTP Device Engine cannot send multiple emails in one connection. To maximize message throughput, the SMTP Device Engine should be able to send multiple emails in a single connection. After applying xMatters 4.0 patch 9, the xMatters SMTP Device Engine will support multiple emails in one socket connection. For details, see the article titled "How can I configure AlarmPoint to send multiple emails through one connection?" on the xMatters (user) community web site. (xMatters Reference: APE-15714) 5. Add new isValid method to ExternalServiceMessage script object. A new method called isValid should be added to the ExternalServiceMessage script object. The script should use this method before it tries to send messages to an external service. (xMatters Reference: APE-15675) 4. Adding an empty (i.e., blank) Event Domain Predicate causes stacktrace. Attempting to save an Event Domain Predicate with a null value causes a stacktrace to occur. (xMatters Reference: APE-15452) 3. Pagination on the Groups I Supervise page does not work correctly. In some cases, the incorrect page is displayed on the Groups I Supervise page. For example, clicking the page 6 button may display page 10 of the results. (xMatters Reference: APE-14962) 2. Support User should not be able to create or delete Users or Groups. Users who have the Support User Role can currently create or delete Users and Groups; these permissions should be removed from the Role. (xMatters Reference: APE-13480) 1. External key of DataSync's DS_USERS table is case-insensitive for imports. The external key of the Data Synchronizer's DS_USERS table is case-insensitive when importing users. For example, if an attempt is made to import a new User with an external key of "test-user" and there is an existing User with an external key of "TEST-USER" (imported via a previous Data Sync), the new User is not imported, and details for the existing User will instead be updated. The external key should be case-sensitive. (xMatters Reference: APE-15531) ------------ KNOWN ISSUES ------------ After applying xMatters (alarmpoint) engine version 4.0 patch 11 or version 4.1 patch 3, data synchronization does not work for Users authenticating with LDAP. For further information, refer to the article "Data synchronization does not work for Users authenticating with LDAP after applying patch 400-011 or 410-003", available on the xMatters (user) community web site. This issue will be fixed for the 410-004 patch release. (xMatters Reference: PRE-3663) After applying version 4.1 patch 3 (410-003), the Holiday Duration period defaults to 24 minutes rather than 24 hours. To resolve this issue, refer to the article "Holiday Duration defaults to 24 minutes after applying patch 400-011 or 410-003", available on the xMatters (user) community web site. This issue will be fixed for the 410-004 patch release. (xMatters Reference: PRE-3655) Even when the xMatters Integration Agent submits a message to a Company other than the Default Company, the Integration Agent log indicates that the message was submitted to the Default Company. (xMatters Reference: APE-13596) ---------------------- INSTALLING THIS PATCH ---------------------- Apply this patch to all xMatters Application Nodes, Notification Nodes and Web Servers (and any DataSync installations, if applicable). WARNING: This patch includes database changes (see next section) that may impact your replication mechanism; consult with your database administrator for further details. Database changes ---------------- DDL: On all supported databases (Oracle, SQL Server, DB2): - Adds table DATABASECHANGELOG - Adds column CUS_FIELDS to table NTFN_EVS - Creates index IDX_DISPATCH on table LIVE_NTFN - Adds Procedure DISPATCH_QUERY On DB2 Only: - Adds Type NTFN_IDS BIGINT ARRAY[] DML: On all supported databases (Oracle, SQL Server, DB2): - Updates table PROV_PROTS setting SESSION_MAX_SIZE - Adds Node Component: Notification Response Processor - If missing, re-add permission 18210 (view.menuitem.AddCustomPage) to function 100 (Super/Company Administrator) - If missing, re-add permission 18211 (view.screen.AddCustomPage) to function 100 (Super/Company Administrator) Before installing this patch: ----------------------------- 1. Shut down all Node processes. 2. Shut down all Webserver processes. 3. Back up the xMatters Database. To install this patch: ---------------------- NOTE: This patch includes path names longer than 100 characters. As a result, you must use a GNU-compatible version of tar to extract the tar archives. 1. Back up the xMatters installation directory. - On Windows, default install directory is: C:\Program Files\AlarmPointSystems\AlarmPoint - On Unix, default install directory is: /opt/alarmpointsystems/alarmpoint 2. Save the @patch_version@.zip or @patch_version@.tar.gz file to the xMatters installation directory. 3. Do one of the following: - On Windows, extract (i.e., unzip) the @patch_version@.zip file to the installation directory and overwrite the existing files. - On Unix, run the following commands on the @patch_version@.tar.gz file and overwrite the existing files: gunzip @patch_version@.tar.gz tar -xvf @patch_version@.tar 4. If you are applying this patch on: - Windows, delete the following files from the Windows\system32 folder (if the files are present): - alarmpoint_sapi_tts.dll - alarmpoint_mapi.dll - AIX, move the libjspAixPpc.so file from /AIX (located in the extracted patch directory) to /jre/bin Navigate to the /jre/bin directory and set the proper permissions by executing the following command line: chmod 755 libjspAixPpc.so - HP-UX Itanium, move the libjspHpxIa64.so file from /HPUX (located in the extracted patch directory) to /jre/bin Navigate to the /jre/bin directory and set the proper permissions by executing the following command line: chmod 755 libjspHpxIa64.so - HP-UX PA-RISC, move the libjspHpxPaRisc.sl file from /HPUX (located in the extracted patch directory) to /jre/bin Navigate to the /jre/bin directory and set the proper permissions by executing the following command line: chmod 755 libjspHpxPaRisc.sl 5. Do one of the following: - If you have not installed the DataSync component, skip to "After installing this patch", below. - If you have installed the DataSync component, complete the remaining steps. 6. Back up the xMatters DataSync installation directory. - On Windows, default DataSync install directory is: C:\Program Files\AlarmPointSystems\AlarmPoint_DataSync - On Unix, default DataSync install directory is: /opt/alarmpointsystems/alarmpoint_datasync 7. Do one of the following: - Extract (i.e., unzip) the @patch_version@-DataSync.zip file to the installation directory and overwrite the existing files. - Run the following commands on the @patch_version@-DataSync.tar.gz file and overwrite the existing files: gunzip @patch_version@-DataSync.tar.gz tar -xvf @patch_version@-DataSync.tar After installing this patch: ---------------------------- IMPORTANT: Database upgrades may take place after this patch is applied (i.e., during startup of xMatters components). The first component to be started will cause the database upgrades to be applied. This means that the subsequent startup of web servers and nodes may be delayed while they wait for the database updates to be completed. To monitor the progress of the updates, see "Determining the status of database updates", below. 1. Restart the Node processes. 2. Restart the Webserver processes. Determining the status of database updates ------------------------------------------ To determine the current status of database updates, open the log file(s) associated with the first xMatters component being restarted (default locations shown; only one log will include the MUTEX entries): Node ---- /logs/AlarmPoint.txt. Web Server ---------- /webserver/webapps/axis2/WEB-INF/logs/ AlarmPoint_WebApp.log /webserver/webapps/cocoon/WEB-INF/logs/ AlarmPoint_WebApp.log /webserver/webapps/mobilegateway/WEB-INF/logs/ AlarmPoint_WebApp.log During component restart, you will see log entries similar to the following: 2009-01-21 22:07:02,251 [AlarmPoint Node-main] WARN - - Acquiring patch update MUTEX. 2009-01-21 22:07:21,685 [AlarmPoint Node-main] WARN - - Acquired patch update MUTEX. 2009-01-21 22:07:22,356 [AlarmPoint Node-main] WARN - - Package 1 of 8 (4.1.x/oracle/01.xml) 2009-01-21 22:07:22,356 [AlarmPoint Node-main] WARN - - Statement 1 of 2: Executing SQL Statement. 2009-01-21 22:07:22,506 [AlarmPoint Node-main] WARN - - Statement 2 of 2: Executing SQL Statement. 2009-01-21 22:07:22,516 [AlarmPoint Node-main] WARN - - Package 2 of 8 (4.1.x/oracle/02.xml) . . . 2009-01-21 22:07:22,847 [AlarmPoint Node-main] WARN - - Package 8 of 8 (4.1.x/oracle/finalize.sql) 2009-01-21 22:07:22,936 [AlarmPoint Node-main] WARN - - The database update scripts have been successfully processed and deleted. 2009-01-21 22:07:22,936 [AlarmPoint Node-main] WARN - - Patch update MUTEX released. After the message "Patch update MUTEX released" appears in the log, the database update has completed. NOTE: If the log shows that the process has not proceeded from "Acquiring patch update MUTEX" to "Acquired patch update MUTEX" in a timely manner, ensure that there are no locks on the ORGS database table. ------------------------------ FILES INCLUDED WITH THIS PATCH ------------------------------ @patch_version@.tar.gz @patch_version@.zip @patch_version@-DataSync.tar.gz @patch_version@-DataSync.zip --------------- WEBSPHERE FILES --------------- The "Patches/Misc. Downloads" section of the xMatters (user) community web site (https://connect.xmatters.com/) includes the following archive files: @patch_version@-websphere.tar.gz @patch_version@-websphere.zip These archive files contain the following WAR files for use with IBM WebSphere 7: - @patch_version@-axis2-websphere7.war: Contains xMatters Web Services files. - @patch_version@-cocoon-websphere7.war: Contains web user interface files. - @patch_version@-mobilegateway-websphere7.war: Contains xMatters mobile access files. If you have already deployed these files on a previous xMatters deployment, you must uninstall the existing files and then reinstall the new files based on the instructions in the "Advanced xMatters Administration" chapter of the xMatters Installation and Administration Guide (available for download from the xMatters (user) community site). END OF FILE