Always use Fusion Middleware Control or the WLST command-line tool to review and configure back-end services for WebCenter Portal. Any configuration changes that you make, post deployment, are stored in the MDS metatdata store as customizations. See Oracle WebCenter Portal Configuration Considerations.
Note:
Configuration changes for events, through Fusion Middleware Control or using WLST, are not dynamic, so you must restart the managed server on which WebCenter Portal is deployed for your changes to take effect. See Starting and Stopping Managed Servers for WebCenter Portal Application Deployments.
This chapter includes the following topics:
Permissions
To perform the tasks in this chapter, you must be granted the WebLogic Server Admin
role through the Oracle WebLogic Server Administration Console and the Administrator
role granted through WebCenter Portal Administration.
For more information about roles and permissions, see Understanding Administrative Operations, Roles, and Tools.
For troubleshooting, see Troubleshooting Issues with Events.
In WebCenter Portal, events provides portal calendars that you can use to schedule meetings, appointments, and any other type of team, project, or group occasion. Events also enables you to access your personal Microsoft Exchange calendar, where you can schedule events that are not related to a particular portal.
Personal calendars are available through a Microsoft Exchange Server; therefore, a connection to that server is required. You can register the Microsoft Exchange Server connection through the Fusion Middleware Control Console or using WLST.
You must mark a connection as active for events to work. You can register additional Microsoft Exchange Server connections, but only one connection is active at a time.
To view personal events in WebCenter Portal, users must have an account on the Microsoft Exchange Server.
Use the roadmaps in this section as a guide through the configuration process for providing access to personal events:
The flow chart (Figure 9-1) and table (Table 9-1) in this section provide an overview of the prerequisites and tasks required for personal events to work in WebCenter Portal.
Figure 9-1 Configuring Personal Events for WebCenter Portal
Table 9-1 Configuring the Personal Events for WebCenter Portal
Actor | Task | Subtask | Notes |
---|---|---|---|
Administrator |
1. Install WebCenter Portal and Microsoft Exchange Server |
MS Exchange Server is the back-end component for personal calendars |
|
Administrator |
|
1.a Configure MS Exchange Server 2013 (see Microsoft Exchange Server 2013 - Configuration) 1.b Edit security settings (see Microsoft Exchange Server 2013 - Security Considerations) 1.c Ensure SSL is enabled (see Microsoft Exchange Server 2013 - Security Considerations) |
|
Administrator |
|
1.a Configure MS Exchange Server 2010 (see Microsoft Exchange Server 2010 - Configuration) 1.b Edit security settings (see Microsoft Exchange Server 2010 - Security Considerations) 1.c Ensure SSL is enabled (see Microsoft Exchange Server 2010 - Security Considerations) |
|
Administrator |
|
1.a Configure MS Exchange Server 2007 (see Microsoft Exchange Server 2007 - Configuration) 1.b Edit security settings (see Microsoft Exchange Server 2007 - Security Considerations) 1.c (Optional) Enable SSL (see Microsoft Exchange Server 2007 - Security Considerations) |
|
Administrator |
2. Configure a connection between the application and the events server using one of the following tools:
|
||
End User |
3. Test that the personal calendar is working in WebCenter Portal |
3.a Log in to WebCenter Portal and add an Events task flow to a page in your Home portal 3.b Click Login to Personal Calendar on the Events task flow and enter your MS Exchange Server |
This section includes the following subsections:
This section describes the Microsoft Exchange Server 2013 prerequisites when used as the server for personal events.
This section includes the following subsections:
Refer to the Microsoft Exchange Server 2013 documentation for installation information.
To use Microsoft Exchange Server 2013 as the server for personal events, you must edit the Microsoft Exchange Server 2013 web service WSDL to specify the location of the web service.
To specify the location of the Microsoft Exchange Server 2013 web service:
Events includes a Microsoft Exchange Server 2013 adapter that communicates with the Microsoft Exchange Server 2013 generic web service through a JAX-WS proxy. To set up the communication between the adapter and the web service, you must edit the Microsoft Exchange Server security settings. You must enable Basic authentication. Further, you must enable anonymous access to Services.wsdl
, Messages.xsd
, and Types.xsd
so that JAX-WS can access them to create the service port before committing any web service call. This involves creating a virtual directory and enabling anonymous authentication and disabling Windows authentication.
To edit Microsoft Exchange Server security settings:
Events uses Basic Authentication to communicate with the Microsoft Exchange Server. To secure the communication, ensure that SSL is enabled. For more information, see:
You must also ensure that the SSLAlwaysNegoClientCert
property is set to true
in IIS. The SSLAlwaysNegoClientCert
property controls SSL client connection negotiations.
For example, use the following command to set the SSLAlwaysNegoClientCert
property:
CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true
For more information about the SSLAlwaysNegoClientCert
property, see:
For information about setting the SSLAlwaysNegoClientCert property, see:
This section describes the Microsoft Exchange Server 2010 prerequisites when used as the server for personal events.
This section includes the following subsections:
Refer to the Microsoft Exchange Server 2010 documentation for installation information.
To use Microsoft Exchange Server 2010 as the server for personal events, you must edit the Microsoft Exchange Server 2010 web service WSDL to specify the location of the web service.
To specify the location of the Microsoft Exchange Server 2010 web service:
Events includes a Microsoft Exchange Server 2010 adapter that communicates with the Microsoft Exchange Server 2010 generic web service through a JAX-WS proxy. To set up the communication between the adapter and the web service, you must edit the Microsoft Exchange Server security settings. You must enable Basic authentication. Further, you must enable anonymous access to Services.wsdl
, Messages.xsd
, and Types.xsd
so that JAX-WS can access them to create the service port before committing any web service call. This involves creating a virtual directory and enabling anonymous authentication and disabling Windows authentication.
To edit Microsoft Exchange Server security settings:
Events uses Basic Authentication to communicate with the Microsoft Exchange Server. To secure the communication, you must enable SSL. For more information, see:
You must also ensure that the SSLAlwaysNegoClientCert
property is set to true
in IIS. The SSLAlwaysNegoClientCert
property controls SSL client connection negotiations.
For example, use the following command to set the SSLAlwaysNegoClientCert
property:
CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true
For more information about the SSLAlwaysNegoClientCert
property, see:
This section describes the Microsoft Exchange Server 2007 prerequisites when used as the server for personal events.
This section includes the following subsections:
Refer to the Microsoft Exchange Server 2007 documentation for installation information.
To use Microsoft Exchange Server 2007 as the server for personal events, you must edit the Microsoft Exchange Server 2007 web service WSDL to specify the location of the web service.
To specify the location of the Microsoft Exchange Server 2007 web service:
Events includes a Microsoft Exchange Server 2007 adapter that communicates with the Microsoft Exchange Server 2007 generic web service through a JAX-WS proxy. To set up the communication between the adapter and the web service, you must edit the Microsoft Exchange Server security settings.
To edit security settings:
Events uses Basic Authentication to communicate with the Microsoft Exchange Server. To secure the communication, ensure that SSL is enabled. For more information, see:
You must also ensure that the SSLAlwaysNegoClientCert
property is set to true
in IIS. The SSLAlwaysNegoClientCert
property controls SSL client connection negotiations.
For example, use the following command to set the SSLAlwaysNegoClientCert
property:
CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true
For more information about the SSLAlwaysNegoClientCert
property, see:
For information about setting the SSLAlwaysNegoClientCert property, see:
You can register multiple events servers for WebCenter Portal, but only one is active at a single time.
To start using a new (active) connection you must restart the managed server on which the application is deployed.
This section includes the following topics:
Use the WLST command createPersonalEventConnection
to create an events server connection. Use setPersonalEventConnection
to alter an existing connection. For command syntax and examples, see createPersonalEventConnection
and setPersonalEventConnection
in WebCenter WLST Command Reference.
For information on how to run WLST commands, see Running Oracle WebLogic Scripting Tool (WLST) Commands.
Note:
To start using the new (active) connection you must restart the managed server on which WebCenter Portal is deployed. See Starting and Stopping Managed Servers Using WLST in Administering Oracle Fusion Middleware.
You can register multiple events server connections with WebCenter Portal, but only one connection is active at a time.
This section includes the following topics:
To change the active connection:
Use the WLST command setPersonalEventConnection
with default=true
to activate an existing events server connection. For command syntax and examples, see setPersonalEventConnection in WLST Command Reference for WebLogic Server.
To subsequently disable an events connection, run the same WLST command with default=false
. Connection details are retained but the connection is no longer named as an active connection.
For information on how to run WLST commands, see Running Oracle WebLogic Scripting Tool (WLST) Commands.
Note:
To start using the active connection you must restart the managed server on which WebCenter Portal is deployed. For more information, see Starting and Stopping Managed Servers Using WLST in Administering Oracle Fusion Middleware.
You can modify events server connection details at any time.
To start using the updated (active) connection you must restart the managed server on which WebCenter Portal is deployed.
This section includes the following subsections:
To update connection details for an events server:
Use the WLST command setPersonalEventConnection
to edit an existing events server connection. For command syntax and examples, see setPersonalEventConnection
in WebCenter WLST Command Reference .
For information on how to run WLST commands, see Running Oracle WebLogic Scripting Tool (WLST) Commands.
Note:
To start using the updated (active) connection you must restart the managed server on which WebCenter Portal is deployed. For more information, see Starting and Stopping Managed Servers Using WLST in Administering Oracle Fusion Middleware.
You can delete events server connections at any time, but use caution when deleting the active connection. If you delete the active connection, users cannot create events in their personal calendar.
This section includes the following subsections:
To delete an events server connection:
Use the WLST command deleteConnection
to remove an events server connection. For command syntax and examples, see deleteConnection
in WebCenter WLST Command Reference.
For information on how to run WLST commands, see Running Oracle WebLogic Scripting Tool (WLST) Commands.
Note:
To effect this change you must restart the managed server on which WebCenter Portal is deployed. For more information, see Starting and Stopping Managed Servers in Administering Oracle Fusion Middleware.