Overview of Presence Oracle Fusion Middleware Online Documentation Library

Configuring Presence and Presence Web Services 9-3

9.2.2 Bus

Through the Bus MBean you can configure the internal asynchronous bus that the Presence Server is using for its internal job execution. Table 9–1 describes the attributes of the Bus MBean.

9.2.3 PackageManager

The PresenceEventPackage , PresenceWInfoEventPackage , and UA-ProfileEventPackage MBeans enable you to configure the event packages, which define the state information to be reported by a notifier to a watcher subscriber. Note: If you change any attributes of the following MBeans, you must restart OWLCS for these changes to take effect. ■ Presence ■ PresenceEventPackage ■ PresenceWInfoEventPackage ■ UAProfileEventPackage ■ XCapConfigManager Note: JGroups channels must only communicate with their intended peers. To ensure that event packages use JGroups correctly, different channels must use different values for the group name, multicast address and multicast port. See http:www.jboss.org for more information. Table 9–1 Attributes of the Bus MBean Attribute Value Type Description ThreadPoolSize int The number of threads held in the thread pool, which remains constant throughout the lifetime of the application. If no threads are used, then the specified number of threads remain idle. The default value is 15. HighWatermark int The number of pending jobs reached before the bus’s exhausted threshold level is reached. The default value is 20. KeepAlive long The number of seconds to keep an idle thread alive before dropping it. The default value is 60. LogDuration long A warning is logged to the system log for events that remain in the queue for a period exceeding the specified duration before they are broadcast to the bus. This warning indicates that server is about to be overloaded, since an old job has been sent to the bus. The default value is 60. LowWatermark int Specifies the low threshold level for the number of pending jobs. When this threshold is reached from below, the Bus logs a warning that it is about to be choked. At this point, no more warnings are logged until the high watermark level is reached. The default value is 15. 9-4 Oracle WebLogic Communications Server Administration Guide These packages form the core of the Presence Server, as most requests flow through them. A notifier is a User Agent UA that generates NOTIFY requests that alert watchers to the state of a resource the entity about which watchers request state information. Notifiers typically accept SUBSCRIBE requests to create subscriptions. A watcher is another type of UA, one that receives the NOTIFY requests issued by a notifier. Such requests contain information about the state of a resource of interest to the watcher. Watchers typically also generate SUBSCRIBE requests and send them to notifiers to create subscriptions. The PackageManager MBean sets the configuration that determines which of the three event packages Presence, Watcher Info and UA-Profile get loaded, as well as configures the environment in which these event packages are loaded. Table 9–2 describes the attributes of the PackageManger MBean.

9.2.4 Presence

The Presence MBean controls how the Presence Server interacts with clients connecting to it. The attributes described in Table 9–3 include those for setting the composition policy for creating a unified document when a presentity publishes Table 9–2 Attributes of the EventPackageManager MBean Attribute Description JGroupBroadcastEnabled If true, a single JGroup channel is created for all the event packages running on this Presence Server instance. Whenever new resources are created in any of the running event packages, a message is broadcast on this JGroup channel. JGroupXMLConfigPath Path to an XML configuration file for JGroups. The path can be absolute or relative to the WebLogic domain directory on which the event package is running. Leave this empty to use the following default values for the jgroups connection: UDPbind_addr=[ip address of this host];mcast_ addr=230.0.0.1;mcast_port=7426;ip_ttl=1 JGroupChannelName The name to use when creating the JGroup channel. Note that to prevent aliasing of different JGroup clusters, each cluster must have a unique channel name in addition to a unique multicast port or address. CaseSensitiveUserPart Setting this attribute to true enables case-sensitive handling of the user part of the SIP URI. If this parameter is set to false, then the user part of the URI is not a case-sensitive match. For example, foo is considered the same as FoO. The domain part of the URI is always case-insensitive. EventPackageNames A comma-separated list of event package names. For example: presence,presence.winfo,ua-profile. Only the event packages listed here will be started by the Presence Server. WaitingSubsCleanupInterval The interval, in seconds, in which the subscription cleanup check runs. The thread sleeps for this period and then awakens to check for any waiting subscriptions with a timestamp older than the MaxWaitingSubsTimeHours parameter. All old subscriptions are then removed from the subscribed resource. Max WaitingSubsTimeHours The maximum time, in hours, that a subscription can be in a waiting state before the server removes it. This parameter is used by the subscription cleanup check thread waitingsubscleanupinterval to decide if a waiting subscription is old enough to be removed from the subscribed resource.