Monitoring Content Server Status

This chapter describes how to monitor the status of a Content Server instance using various Oracle WebCenter Content Server internal resources.

This chapter includes the following topics:

• Viewing Content Server Status

• Viewing Content Server Console Output

• Viewing System Configuration Information

• Viewing System Audit Information

• Viewing Server Output

• Viewing Event Output

• Checking Schema Cache

• Viewing Localization Audit Information

• Monitoring Scheduled Jobs

Viewing Content Server Status

You can view the current status (such as running or stopped) of the Content Server instance.

To view current Content Server status using Fusion Middleware Control:

1. In the navigation tree, expand the appropriate domain name (for example, Content_base_domain).

2. Expand WebCenter, thenContent, then Content Server.

3. Select the Content Server instance name (for example, Oracle WebCenter Content - Content Server (UCM_server1)).

4. On the Content Server home page, you can view the current status of a Content Server instance.

Viewing Content Server Console Output

You can view console output from the Content Server instance. This shows the same information that is located in the DomainHome/ucm/cs/data/trace/classname.log file.

1. Choose Administration, then System Audit Information.

2. Click View Server Output.

3. To refresh the output messages, click Refresh Page. To clear the output messages, click Clear.

Viewing System Configuration Information

Oracle WebCenter Content provides a Configuration Information page that displays system configuration information for the Content Server instance, which can be useful while troubleshooting a problem or working with the Oracle support organization.

To access the Configuration Information page:

1. Choose Administration, then Configuration for instance.

2. To view details, click the link for each type of configuration information.

   Configuration information provided includes:

   • Server name

   • Version

   • Class loader

   • Instance directory

   • Database type

   • Database version

   • HTTP server address

   • Mail server

   • Search engine name

   • Index engine name

   • Active index

   • Number of installed features

   • Number of enabled components

   • Number of disabled components

   • Auto number prefix

   • Use accounts

   • Ntlm security enabled

   • Allow get copy for user with read privilege

   • Allow only original contribute to check out

   • Java version

   Note:

   Some options are specified during the software installation, while other options are set using the System Properties utility.

Viewing System Audit Information

Oracle WebCenter Content provides a System Audit Information page for a Content Server instance, which can be useful when troubleshooting a problem or adjusting the Content Server’s performance.

The System Audit Information page provides several types of information.

• System Audit General Information

• System Audit Localization Information

• System Audit Tracing Sections Information

• System Audit Cache Information

• System Audit Configuration Entry Information

• System Audit Component Report Information

System Audit General Information

You can view general system audit numbers and details in the General Information section of the System Audit Information page.

To access the System Audit Information page, choose Administration, then System Audit Information.

• Amount of time the Content Server instance has been up and running.

• Number of server requests processed, and whether the system is handling server requests successfully. If the system is receiving too many requests, an email is sent to the system administrator regarding load performance.

• Total JVM memory capacity and total JVM available memory. Also information about the memory usage for the system, which may be useful in troubleshooting any “out of memory” errors you might receive. This can be important when running the Content Server instance with many users and a large quantity of data.

• Total number of threads, and information about which Java threads are currently running. This may be useful in determining the cause of an error.

• Total number of active database connections, and information about database activity.

• Total number of audit messages.

To view more details, click the link on the page for the type of configuration information.

System Audit Localization Information

You can view numbers about localization for your Content Server instance in the Localization Information section of the System Audit Information page.

To access the System Audit Information page, choose Administration, then System Audit Information.

• String key count

• Whether the Localization system is using a string index

• Localization test run time

• Localization test lookups per second

System Audit Tracing Sections Information

You can view tracing details in the Tracing Sections Information section of the System Audit Information page. This section enables tracing in the Content Server instance and can be activated on a section-by-section basis. Tracing for active sections is displayed by clicking View Server Output on the System Audit Information page. Section tracing can be useful for determining which section of the Content Server is causing trouble, or when you want to view the details of specific sections.

To access the System Audit Information page, choose Administration, then System Audit Information.

• To view a list with brief descriptions of sections available for tracing, click the Info icon next to the Tracing Sections Information heading.

• To see in-depth tracing for any active section that supports it, select Full Verbose Tracing. For more information, see Using Tracing.

• To save tracing information, select Save.

• To specify additional sections for tracing, enter a comma-separated list of section names, or select sections from the menu next to the Active Sections field. The wildcard character * is supported; for example, using schema* will trace all sections that begin with the prefix schema. After specifying sections, click Update.

• To specify additional services to trace, enter a comma-separated list of service names in the Active Services field, then click Update.

• To specify additional threads to trace, enter a comma-separated list of thread names in the Active Threads field, then click Update.

• To specify what text to trap in the trace, enter the text in the Event Trap Text field, then click Update. For more information about using Event Trap, see the “Caught in the Act!” blog.

• To add a thread dump to the trace, select Add Thread Dump, then click Update.

• To return to the previous setting for any field you modified, click Reset.

Important:

Any options set in Tracing Sections Information will be lost when the Content Server instance is restarted unless you enable Save and click Update.

System Audit Cache Information

The Content Server instance caches various items for quick access. You can view current details for three caches in the Cache Information section of the System Audit Information page.

To access the System Audit Information page, choose Administration, then System Audit Information.

• Search cache: The number of permanently loaded pages and resource files. The number at which cache is temporarily capped. Whether any temporary items are loaded. Total number of distinct search queries being executed. Total number of distinct search queries being executed. These details are useful when troubleshooting any search related issues.

• Schema cache: Total number of items stored in schema cache. Number of bytes used out of number permitted. Additional details of any schema objects currently in cache.

• Buffer pool cache: Information about objects in cache and how much memory each object is using, which is reflected in the memory information of the System Audit General Information section. This information may be useful in pinpointing which object may be responsible for any memory leaks or other memory issues. (For information on troubleshooting, see Troubleshooting Oracle WebCenter Content.

To view more information, click the link for the type of cache information on the page.

System Audit Configuration Entry Information

You can view numbers and details in the Configuration Entry Information section of the System Audit Information page.

To access the System Audit Information page, choose Administration, then System Audit Information.

• Number of environment keys

• Number of overwritten config values

• Number of ignored settings

• Number of removed settings

To view more information for an item, click the link for the type of configuration entry information on the page.

System Audit Component Report Information

You can view information about components in the Component Report section of the System Audit Information page. This page lists Content Server components in alphabetical order by name. To view details about a component, click the component name in the list. Component details.

To access the System Audit Information page, choose Administration, then System Audit Information.

• Location: Pathname for the component in the instance

• Version: Date, build, and revision number

• Status: Current status of the component (Loaded or Skipped)

• Reason: Explanation of the component status

Viewing Server Output

You can view server output, which is the console output of the Content Server instance. This is the same information that is located in the DomainHome/ucm/cs/data/trace/classname.log file.

1. Choose Administration, then System Audit Information.

2. Click View Server Output.

Viewing Event Output

You can view event output from the server.

1. Choose Administration, then System Audit Information.

2. Click View Event Output.

3. To view other than the current output, select an earlier timestamp from the menu.

4. To update the current view, click Refresh Page.

Checking Schema Cache

You can view the newest schema cache information from the server.

1. Choose Administration, then System Audit Information.

2. Click Check Schema Cache.

   The System Audit Information page opens and shows the Cache Information section with additional columns for View Names and Bytes Used in schema cache.

3. To see details for a specific schema cache view, select the name in the View Name column.

Viewing Localization Audit Information

You can view information regarding the availability of localized variables for the Content Server user interface on the Localization Audit page. This information is useful in determining if any custom metadata field labels or other customized Content Server text requires localization. Localization auditing is not persistent and must be started and stopped when using it.

1. Choose Administration, then System Audit Information.

2. Click Localization Auditing.

3. To start localization auditing, click Start auditing.

4. To stop localization auditing, click Stop auditing.

5. To view the generated Java exceptions, click Show in the Stack Trace column.

Monitoring Scheduled Jobs

Scheduled jobs run as part of events scheduled by system components. The Scheduled Jobs Administration interface can be used to monitor information about scheduled jobs on the Content Server instance and in some cases edit scheduled jobs.

• Viewing Active Scheduled Jobs

• Viewing Scheduled Jobs History

• Modifying a Scheduled Job

• Canceling or Deleting a Scheduled Job

Viewing Active Scheduled Jobs

To view active scheduled jobs:

1. Choose Administration, then Scheduled Jobs Administration, then Active Scheduled Jobs.

   The job name, job description, processed date and time, current status, and available actions are listed for each scheduled job on the Scheduled Jobs Listing page. The status icons represent Priority, Inactive/Processed, Once/Repeat, and Short/Long.

2. Click Actions to select any of the following actions for a scheduled job:

   • Info: Display the Scheduled Jobs Information page.

   • Edit: Edit the scheduled job.

   • Cancel: Cancel the scheduled job.

   • Delete: Delete the scheduled job.

3. Click Info.

   The Scheduled Jobs Information page opens.

Viewing Scheduled Jobs History

To view a scheduled job history:

1. Choose Administration, then Scheduled Jobs Administration, then Scheduled Jobs History.

   The Historical Scheduled Jobs Listing page opens and lists the job name, job description, last process date, last status, and actions for each scheduled job.

2. Click the Info icon in the Actions column to open the Scheduled Jobs Information page for a specific job.

Modifying a Scheduled Job

To modify a scheduled job:

1. Choose Administration, then Scheduled Jobs Administration, then Active Scheduled Jobs.

2. For a specific job in the list on the Scheduled Jobs Listing page, click the Actions icon, then Edit.

   The job name, description, category, exception parent job, initial user, queue type, schedule type, current state, priority, interval, start token, progress status, create date, update date, process date, last processed date, and last processed status are displayed.

3. Edit the appropriate fields (not all fields can be modified).

4. Click Update. If you want to remove your changes, click Reset.

Canceling or Deleting a Scheduled Job

To cancel or delete a scheduled job:

1. Choose Administration, then Scheduled Jobs Administration, then Active Scheduled Jobs.

2. To cancel a specific job in the list on the Scheduled Jobs Listing page, click the Actions icon for the job, then select Cancel.

3. To delete a specific job in the list on the Scheduled Jobs Listing page, click the Actions icon for the job, then select Delete.