Administering WebCenter Sites and Its Components in Enterprise Manager

38 Administering WebCenter Sites and Its Components in Enterprise Manager

You can monitor performance metrics, audit system performance, and view system messages for Oracle WebCenter Sites and Visitor Services with the Enterprise Manager.

Topics:

38.1 Starting WebCenter Sites and Its Components in the WebLogic Server Console

The Oracle WebLogic Server Administration Console is a browser-based user interface that you use to manage a WebLogic Server domain. The Administration Server hosts the Administration Console, which is a Web application accessible from any supported Web browser with network access to the Administration Server.

To navigate to component functions in WebLogic Server:

Enter the WebLogic Server URL, which includes the name of the host and the port number assigned to WebLogic Server during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/console
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password and click Login.
From the navigation pane, expand the farm and then WebLogic Domain, and click Sites or the Visitor Services component.

The domain page is displayed for your selection.

In the WebLogic Server Administration Console, you can manage the environment including servers, clusters, virtual hosts, and work managers. See Getting Started Managing Oracle Fusion Middleware in Administering Oracle Fusion Middleware.

38.2 Starting WebCenter Sites and Its Components in Enterprise Manager

Oracle Enterprise Manager Fusion Middleware Control is a browser-based management application that is deployed when you install Oracle WebCenter. From Oracle Enterprise Manager, you can monitor and administer the following:

Oracle WebCenter Sites
Oracle WebCenter Sites: Visitor Services

To navigate to Oracle WebCenter Sites Enterprise Management pages in Oracle Enterprise Manager:

Enter the Oracle Enterprise Manager Fusion Middleware Control URL, which includes the name of the host and the port number assigned to Oracle Enterprise Manager during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/em
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password, and click Login.
From the Target Navigation pane, expand the farm, then WebCenter, and then Sites.
Choose Sites or Visitor Services , and then select the server node (for example, Visitor Services).

The home page for the component you started is displayed.

Click WebCenter Sites: <Component Name> in the left pane to display the <Component> menu.

The following table lists some of the <Component> server menu options on this page.

Table 38-1 WebCenter Sites: <Component> Menu Options

Menu Option	Description
Home	Use this option to navigate to the WebCenter Sites or Visitor Services home page.
Monitoring	Use this option to monitor key performance metrics for the WebCenter Sites or Visitor Services server.
Control	Use this option to start or stop the WebCenter Sites or Visitor Services application deployed on the server.
Logs	Use this option to view the logs or to control the log level.
System MBean Browser	The System MBean Browser lists all the configured, runtime and application defined MBeans. Use this option to access the attributes of the MBeans and to perform operations on them.
Target Sitemap	Use this option to view menu options for the WebCenter Sites or Visitor Services server.
Target Information	Use this option to view general information about the WebCenter Sites or Visitor Services server.

38.3 Viewing the Home Pages of WebCenter Sites and Its Components

You can view the status of Oracle WebCenter Sites or Visitor Services server using Oracle Enterprise Manager or Oracle WebLogic Server. The home pages for Oracle WebCenter Sites and Visitor Services in Oracle Enterprise Manager display the status of your system. The home pages display the state, version, and uptime of the Oracle WebCenter Sites and Visitor Services systems.

To view the status of your Oracle WebCenter Sites or Visitor Services system installation:

Enter the Oracle Enterprise Manager Fusion Middleware Control URL, which includes the name of the host and the port number assigned to Oracle Enterprise Manager during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/em
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password, and click Login.
The component home page displays.
On the General Information section on the home page, check the status of Oracle WebCenter Sites or its component systems (state, version, and uptime).
On the Performance Summary section on the lower pane, view the component Performance metrics. See Monitoring the Performance Metrics of WebCenter Sites and Its Components for more information about Performance metrics.

You can navigate to the home page from any other page by clicking Home in the component menu options in the right pane.

Note:

For more information about viewing the status of your Oracle WebCenter Sites or WebCenter Sites: Visitor Services system using the Oracle WebLogic Server administration console, see the Oracle WebLogic Server documentation.

38.4 Managing Log Files for WebCenter Sites and Its Components

You can enable logging of configuration messages, debug messages, and trace messages and configure the log files using Oracle Enterprise Manager.

This section includes the following topics:

38.4.1 Configuring Log File Settings for WebCenter Sites and Its Components

By default, errors, warnings, and major application life cycle events in Enterprise Manager are logged on the application server. As a system administrator, you can progressively increase the log level to enable logging of configuration messages, debug messages, and trace messages. You can use Oracle Enterprise Manager to view and configure log messages for your WebCenter Sites system. For more information about managing log files, see Managing Log Files and Diagnostic Data in Administering Oracle Fusion Middleware.

The {weblogic_server_name} is the name of the WebLogic Server, for example VisitorServices01 or Sites01.

Out of the box, the log files are named sites.log and cas.log, and are created in the application server log directory.

You can configure the log files for WebCenter Sites using Oracle Enterprise Manager.

You can configure the names and locations of log files, the size of the log files, the level of information written to the log files, the format, and the Locale encoding, as described in Configuring Settings for Log Files in Administering Oracle Fusion Middleware.

38.4.2 Viewing Log Files for WebCenter Sites and Its Components

You can view log files for Oracle WebCenter Sites or Visitor Services from the Oracle Enterprise Manager.

To view the log files using the Oracle Enterprise Manager:

Enter the Oracle Enterprise Manager Fusion Middleware Control URL, which includes the name of the host and the port number assigned to Oracle Enterprise Manager during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/em
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password, and click Login.
Click the component server in the left pane to display the component menu options.
To view the log files, choose Logs, and then View Log Messages from the component menu. The Log Messages page displays.
In this page, you can search for messages by specified date range, type, or containing certain keywords. You can also select a message from the list and view its details.

38.5 Monitoring the Performance Metrics of WebCenter Sites and Its Components

For information about monitoring the Oracle WebCenter Sites or Visitor Services system, including an overview of monitoring and viewing the status of your system, see these topics:

Note:

You can set the CURSOR_SHARING initialization parameter to FORCE to enhance the performance of WebCenter Sites. If you set the CURSOR_SHARING initialization parameter to FORCE, the database replaces literals with system-generated bind variables.

38.5.1 Viewing the Status of WebCenter Sites and Its Components

You can view the status of Oracle WebCenter Sites or Visitor Services using Oracle Enterprise Manager or Oracle WebLogic Server. The component home page in Oracle Enterprise Manager displays the status of your component system. It displays the state, version, and uptime of the component system.

To view the status of your component system installation:

Enter the Oracle Enterprise Manager Fusion Middleware Control URL, which includes the name of the host and the port number assigned to Oracle Enterprise Manager during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/em
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password, and click Login.
On the <Component> - General Information section on the home page, check the status of your component system (state, version, and uptime).

You can navigate to the home page from any other page by clicking Home in the component menu options in the right pane.

Note:

For more information about viewing the status of your component system using the Oracle WebLogic Server administration console, see the Oracle WebLogic Server documentation.

38.5.2 Viewing the Performance Metrics of WebCenter Sites and Its Components

To view the performance metrics of your Oracle WebCenter Sites or Visitor Services system installation:

Enter the Oracle Enterprise Manager Fusion Middleware Control URL, which includes the name of the host and the port number assigned to Oracle Enterprise Manager during the installation. The following shows the format of the URL.
```
http://hostname.domain:port/em
```
Port is the IP port number of the Administration Server running on Oracle WebLogic Server. By default, the port number is 7001.
Enter the system administrator user name and password, and click Login.
Click component server in the right pane to display the component menu options.
To view performance metrics, choose Monitoring, and then Performance Summary from the component menu. The Performance Summary page displays. By default, the Performance Summary page displays the performance metrics for the past 15 minutes.
Optionally, click Slider in the top right side of the page to view the time slider.

Use the time slider to select the time period for which to display the metrics.
Optionally, click the Enter Time icon next to Slider in the top right side of the page.

The Enter Time dialog box displays.
Enter the start and end time for which to display the metrics, then click OK.
Click Show Metrics Palette in the right pane. The Metric Palette displays.
In the Metric Palette, select the metrics that you want to display in the Performance Summary page. To view metrics in a table format, select Table View.

For more information about Oracle WebCenter Sites or Visitor Services metrics, see these sections:

38.5.2.1 WebCenter Sites Performance Metrics

This section describes metrics to monitor the performance of WebCenter Sites. It includes the following:

38.5.2.1.1 BlobServer Servlet Details, ContentServer Servlet Details, and Satellite Servlet Details

Metric Name	Description
Execution Time Average	Displays the average amount of time (in milliseconds) it took to execute all invocations of the servlet since it was most recently deployed.
Execution Time High	Displays the average amount of time (in milliseconds) the single longest invocation of the servlet has executed since it was most recently deployed.
Execution Time Total	Displays the average amount of time (in milliseconds) all invocations of the servlet have executed since it was most recently deployed.
Invocation Total Count	Displays the total number of times the servlet has been invoked since WebLogic Server started.

38.5.2.1.2 Cache Details

Metric Name	Description
CacheHits	Provides the number of times a requested item was found in the cache.
CacheHitsPercentage	Provides the percentage of cache accesses that found a requested item in the cache.
CacheMisses	Provides the number of cache accesses that did not find a requested element in the cache.
CacheMissPercentage	Provides the percentage of cache accesses that did not find a requested element in the cache.
MemoryStoreObjectCount	Provides the number of objects in the MemoryStore.
DiskStoreObjectCount	Provides the number of objects in the DiskStore.

38.5.2.1.3 JDBC Info

Metric Name	Description
ActiveConnectionsAverageCount	Average number of active connections in this instance of the data source. Active connections are connections in use by an application.
ActiveConnectionsCurrentCount	The number of connections currently in use by applications.
ActiveConnectionsHighCount	Highest number of active database connections in this instance of the data source since the data source was instantiated. Active connections are connections in use by an application.
ConnectionDelayTime	The average amount of time, in milliseconds, that it takes to create a physical connection to the database. The value is calculated as summary of all times to connect divided by the total number of connections.
ConnectionsTotalCount	The cumulative total number of database connections created in this data source since the data source was deployed.
MaxCapacity	Maximum number of physical database connections that this connection pool can contain. Different JDBC Drivers and database servers may limit the number of possible physical connections.
NumAvailable	The number of database connections that are currently idle and available to be used by applications in this instance of the data source.
PrepStmtCacheAccessCount	The cumulative, running count of the number of times that the statement cache was accessed.
PrepStmtCacheAddCount	The cumulative, running count of the number of statements added to the statement cache. Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements added to the caches for all connections in the connection pool.
PrepStmtCacheCurrentSize	The number of prepared and callable statements currently cached in the statement cache. Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements in the caches for all connections in the connection pool.
PrepStmtCacheDeleteCount	The cumulative, running count of statements discarded from the cache. Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements that were discarded from the caches for all connections in the connection pool.
PrepStmtCacheHitCount	The cumulative, running count of the number of times that statements from the cache were used.
PrepStmtCacheMissCount	The number of times that a statement request could not be satisfied with a statement from the cache.
ReserveRequestCount	The cumulative, running count of requests for a connection from this data source.

38.5.2.1.4 ThreadPool Info

This section describes the metrics related to the thread pool:

Metric Name	Description
completedRequestCount	The total number of requests handled by WebCenter Sites or its component application.
executeThreadIdleCount	Number of executing threads that are currently idle. It also indicates the additional unused capacity.
executeThreadTotalCount	Total number of execute threads that are current active in the system.
pendingUserRequestCount	Number of requests in the queue waiting to be processed. Ideally the number of requests in the queue should be a low.
queueLength	The number of pending requests in the priority queue. This is the total of internal system requests and user requests.
stuckThreadCount	Number of threads that are stuck. Weblogic considers a thread as stuck if no work is done in over 600 seconds. Stuck threads are an indication that there is trouble in the system.
throughput	The system throughput.

38.5.2.1.5 OS Detail

This section describes the metrics related to the operating system:

Metric Name	Description
commitedVirtualMemory Size	The size of the virtual memory in megabytes.
freePhysicalMemorySize	The size of the unused physical memory in megabytes.
freeSwapSpaceSize	The size of memory available for swap space in megabytes.
maxFileDescriptorCount	The maximum number of file descriptors in the system.
openFileDescriptorCount	The number of open file descriptors in the system.
processCpuLoad	The CPU time utilized by the Java process hosting WebCenter Sites or its components.
systemCpuLoad	The total CPU utilization across all processes in the system.
systemLoadAverage	The number of tasks waiting to be processed, or stalled waiting on a CPU to become available. This is a system wide metric and should be below three in a normal system.
totalPhysicalMemorySize	The physical memory size in bytes.
totalSwapSpaceSize	The swap memory space in bytes.

38.5.2.1.6 Number of Errors

This section describes the metrics related to Number of errors:

Metric Name	Description
Number of errors	The number of exceptions caught by the application during runtime.

38.5.2.1.7 NIO Details

This section describes the metrics related to the NIO details:

Metric Name	Description
count	Non-blocking I/O (NIO) object counts.
Memory Used	The memory used in the system in megabytes.
Total Capacity	The total memory in the system in megabytes.

38.5.2.1.8 Connections Metrics

This section describes the metrics related to the connections:

Metric Name	Description
Active Threads	The number of active threads in the system.
Daemon Threads	The number of daemon threads in the system. Daemon threads are threads that run in the background.
Peak Threads Count	The maximum number of threads in the system.

38.5.2.1.9 Memory Details Metrics

This section describes the metrics related to memory details:

Metric Name	Description
Available Processors	The number of available processors in the system.
Free Memory(bytes)	The free memory in the system displayed in bytes.
Total Memory(bytes)	The total memory in the system in bytes.
Maximum Memory(bytes)	The maximum memory in the system in bytes.

38.5.2.1.10 ServerState Metrics

The following table lists the Visitor Services ServerState metrics:

Metric Name	Description
State	The status of the selected component server. To select a server, click List Metric Rows icon and select the component server.

38.5.2.2 Visitor Services Performance Metrics

This section describes performance metrics for monitoring Visitor Services. It includes the following:

38.5.2.2.1 ThreadPool Info

This section describes the metrics related to the thread pool:

Metric Name	Description
completedRequestCount	The total number of requests handled by WebCenter Sites or its component application.
executeThreadIdleCount	Number of executing threads that are currently idle. It also indicates the additional unused capacity.
executeThreadTotalCount	Total number of execute threads that are current active in the system.
pendingUserRequestCount	Number of requests in the queue waiting to be processed. Ideally the number of requests in the queue should be a low.
queueLength	The number of pending requests in the priority queue. This is the total of internal system requests and user requests.
stuckThreadCount	Number of threads that are stuck. Weblogic considers a thread as stuck if no work is done in over 600 seconds. Stuck threads are an indication that there is trouble in the system.
throughput	The system throughput.

38.5.2.2.2 OS Detail

This section describes the metrics related to the operating system:

Metric Name	Description
commitedVirtualMemory Size	The size of the virtual memory in megabytes.
freePhysicalMemorySize	The size of the unused physical memory in megabytes.
freeSwapSpaceSize	The size of memory available for swap space in megabytes.
maxFileDescriptorCount	The maximum number of file descriptors in the system.
openFileDescriptorCount	The number of open file descriptors in the system.
processCpuLoad	The CPU time utilized by the Java process hosting WebCenter Sites or its components.
systemCpuLoad	The total CPU utilization across all processes in the system.
systemLoadAverage	The number of tasks waiting to be processed, or stalled waiting on a CPU to become available. This is a system wide metric and should be below three in a normal system.
totalPhysicalMemorySize	The physical memory size in bytes.
totalSwapSpaceSize	The swap memory space in bytes.

38.5.2.2.3 Number of Errors

This section describes the metrics related to Number of errors:

Metric Name	Description
Number of errors	The number of exceptions caught by the application during runtime.

38.5.2.2.4 NIO Details

This section describes the metrics related to the NIO details:

Metric Name	Description
count	Non-blocking I/O (NIO) object counts.
Memory Used	The memory used in the system in megabytes.
Total Capacity	The total memory in the system in megabytes.

38.5.2.2.5 Connections Metrics

This section describes the metrics related to the connections:

Metric Name	Description
Active Threads	The number of active threads in the system.
Daemon Threads	The number of daemon threads in the system. Daemon threads are threads that run in the background.
Peak Threads Count	The maximum number of threads in the system.

38.5.2.2.6 Memory Details Metrics

This section describes the metrics related to memory details:

Metric Name	Description
Available Processors	The number of available processors in the system.
Free Memory(bytes)	The free memory in the system displayed in bytes.
Total Memory(bytes)	The total memory in the system in bytes.
Maximum Memory(bytes)	The maximum memory in the system in bytes.

38.5.2.2.7 ServerState Metrics

The following table lists the Visitor Services ServerState metrics:

Metric Name	Description
State	The status of the selected component server. To select a server, click List Metric Rows icon and select the component server.