Registering Instant Messaging and Presence Servers Using Fusion Middleware Control

Managing the Instant Messaging and Presence Service 16-17 createIMPConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands. To configure the Instant Messaging and Presence service to actively use a new IMP connection, set default=true. For more information, see Section 16.4.2, Choosing the Active Connection for Instant Messaging and Presence Using WLST.

16.4 Choosing the Active Connection for Instant Messaging and Presence

You can register multiple instant messaging and presence server connections with a WebCenter application but only one connection is active at a time. The active connection becomes the back-end presence server for the application. This section includes the following subsections: ■ Section 16.4.1, Choosing the Active Connection for Instant Messaging and Presence Using Fusion Middleware Control ■ Section 16.4.2, Choosing the Active Connection for Instant Messaging and Presence Using WLST 16.4.1 Choosing the Active Connection for Instant Messaging and Presence Using Fusion Middleware Control To change the active connection: 1. Log in to Fusion Middleware Control and navigate to the home page for the WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications 2. Do one of the following: ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration. 3. From the list of services on the WebCenter Services Configuration page, select Instant Messaging and Presence . The Manage Instant Messaging and Presence Connections table indicates the current active connection if any. 4. Select the connection you want to make the active or default connection, and then click Edit.

5. Select the Active Connection checkbox.

Note: To start using the new active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. 16-18 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter

6. Click OK to update the connection.

7. To start using the new active connection you must restart the managed server on which the WebCenter application is deployed. See Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

16.4.2 Choosing the Active Connection for Instant Messaging and Presence Using WLST

Use the WLST command setIMPConnection with default=true to activate an existing presence server connection. For command syntax and examples, see the section, setIMPConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. To disable a presence server connection, either delete it, make another connection the active connection or use the removeIMPServiceProperty command: removeIMPServicePropertyappName=webcenter, property=selected.connection Using this command, connection details are retained but the connection is no longer named as an active connection. For more information, see the section, removeIMPServiceProperty in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

16.5 Modifying Instant Messaging and Presence Connection Details

You can modify instant messaging and presence server connection details at any time. To start using an updated active connection you must restart the managed server on which the WebCenter application is deployed. This section includes the following subsections: ■ Section 16.5.1, Modifying Instant Messaging and Presence Connections Details Using Fusion Middleware Control ■ Section 16.5.2, Modifying Instant Messaging and Presence Connections Details Using WLST

16.5.1 Modifying Instant Messaging and Presence Connections Details Using Fusion Middleware Control

To update connection details for an instant messaging and presence server: 1. Log in to Fusion Middleware Control and navigate to the home page for the WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications Note: To start using this active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. Managing the Instant Messaging and Presence Service 16-19 2. Do one of the following: ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration. 3. From the list of services on the WebCenter Service Configuration page, select Instant Messaging and Presence .

4. Select the connection name, and click Edit.

5. Edit connection details, as required. For detailed parameter information, see Table 16–2, Instant Messaging and Presence Connection - Connection Details .

6. Click OK to save your changes.

7. To start using the updated active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

16.5.2 Modifying Instant Messaging and Presence Connections Details Using WLST

Use the WLST command setIMPConnection to edit presence server connection details. For command syntax and examples, see the section, setIMPConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. If additional parameters are required to connect to your presence server, then use the setIMPConnectionProperty command. For more information, see the section, setIMPConnectionProperty in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

16.6 Deleting Instant Messaging and Presence Connections

You can delete instant messaging and presence connections at any time but take care when deleting the active connection. When you delete the active connection, user presence options are not available, as these require a back-end instant messaging and presence server. When you delete a connection, consider deleting the external application associated with the instant messaging and presence service if the applications sole purpose was to support this service. For more information, see Section 25.5, Deleting External Application Connections. This section includes the following subsections: ■ Section 16.6.1, Deleting Instant Messaging and Presence Connections Using Fusion Middleware Control Note: To start using the updated active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. 16-20 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter ■ Section 16.6.2, Deleting Instant Messaging and Presence Connections Using WLST

16.6.1 Deleting Instant Messaging and Presence Connections Using Fusion Middleware Control

To delete an instant messaging and presence server connection: 1. Log in to Fusion Middleware Control and navigate to the home page for the WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications 2. Do one of the following: ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration. 3. From the list of services on the WebCenter Service Configuration page, select Instant Messaging and Presence .

4. Select the connection name, and click Delete.

5. To effect this change you must restart the managed server on which the WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

16.6.2 Deleting Instant Messaging and Presence Connections Using WLST

Use the WLST command deleteConnection to remove a presence server connection. For command syntax and examples, see the section, deleteConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

16.7 Setting Up Instant Messaging and Presence Service Defaults

Use the WLST command setIMPServiceProperty to set defaults for the IMP service: ■ selected.connection: Connection used by the Instant Messaging and Presence service. ■ rtc.cache.time: Cache timeout for instant messaging and presence data. ■ resolve.display.name.from.user.profile: Determines what to display if user display names are missing. When set to 0, and display name information is unavailable, only the user name displays in the application. When set to 1, and display name information is unavailable, display names are read from user profile data. Setting this option to 1 impacts performance. The default setting is 0. Note: Before restarting the managed server, mark another connection as active; otherwise, the service is disabled.