2 Using Fusion Middleware Control to Manage Oracle Universal Content Management

This chapter describes how to use Oracle Enterprise Manager Fusion Middleware Control to access Oracle Universal Content Management (Oracle UCM) Oracle Content Server related pages and perform Oracle Content Server configuration, monitoring, and other management tasks.

Audience

The content of this chapter is intended for Oracle Fusion Middleware administrators (users granted the Admin role through the Oracle WebLogic Server Administration Console).

2.1 Displaying the Fusion Middleware Control User Interface

Fusion Middleware Control is a web browser-based interface that you can use to monitor and administer a farm. A farm is a collection of components managed by Fusion Middleware Control. It can contain Oracle WebLogic Server domains, one Administration Server, one or more Managed Servers, clusters, and the Oracle Fusion Middleware components that are installed, configured, and running in the domain.

Fusion Middleware administrators can use Fusion Middleware Control to access and manage an Oracle Universal Content Management Oracle Content Server instance.

For more information, see "Getting Started Managing Oracle Fusion Middleware" in the Oracle Fusion Middleware Administrator's Guide.

To access Fusion Middleware Control:

Fusion Middleware Control is configured for a domain and it is automatically started when you start the Oracle WebLogic Server Administration Server.

  1. Enter the Fusion Middleware Control URL in your web browser. The URL must include the name of the host and the port number assigned during the installation. The following shows the format:

    http://hostname.domain:port/em

    For example: http://myhost.mycompany.com:7001/em

    You can find the exact URL, including the administration port number, in the config.xml file:

    • On Windows: DOMAIN_HOME\config\config.xml

    • On UNIX: ORACLE_INSTANCE/config/config.xml

    If the port number is not listed in the file, the default port number is 7001.

  2. Enter a valid Oracle Fusion Middleware administrator user name and password, and click Login.

    A default user name for the administrator user is provided with the software. This is the account you can use to log in to Fusion Middleware Control for the first time. The password is the one supplied during the installation of Oracle Fusion Middleware.

    The first page Fusion Middleware Control displays is the farm home page. You can also view this page at any time by selecting the name of the farm in the navigation pane.

    From the navigation pane, you can expand the tree and select a target to view and manage components in your farm, including Universal Content Management and Oracle Content Server. For detailed instructions, see Section 2.2, "Navigating to the Home Page for Oracle Content Server."

2.2 Navigating to the Home Page for Oracle Content Server

The Oracle Content Server home page is your starting place for managing an Oracle UCM Oracle Content Server instance.

From the home page you can:

  • Check the general status of an Oracle Content Server instance

  • View overall response time for services

  • View resource information on concepts and tasks

The Oracle Content Server home page displays the UCM menu. From the UCM menu you can:

  • Start and shut down an Oracle Content Server instance

  • Configure Oracle Content Server instance parameters and e-mail settings

  • Monitor Oracle Content Server instance performance metrics

  • Analyze diagnostic information and log files

  • Modify attributes using the system MBean browser

  • View general information about the Oracle UCM configuration

Figure 2-1 Oracle Content Server UCM Menu

Description of Figure 2-1 follows
Description of "Figure 2-1 Oracle Content Server UCM Menu"

To navigate to the Oracle Content Server home page:

  1. Log in to Fusion Middleware Control. See Section 2.1, "Displaying the Fusion Middleware Control User Interface."

  2. In the navigation pane, expand the tree to select the appropriate target domain name (for example, UCM_ucm_domain).

  3. Expand Content Management, then Universal Content Management, then Content Server.

  4. Select Oracle Content Server (server_name) to navigate to the home page for your Oracle Content Server instance.

Figure 2-2 Navigation to the Oracle Content Server Page

Description of Figure 2-2 follows
Description of "Figure 2-2 Navigation to the Oracle Content Server Page"

2.3 Starting and Shutting Down Oracle Content Server

This section covers the following topics:

2.3.1 Starting Oracle Content Server

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle UCM Oracle Content Server name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Control, then Start. The Oracle Content Server instance is started.

For more information, see "Starting and Stopping Oracle WebLogic Server Instances" in Oracle Fusion Middleware Administrator's Guide.

2.3.2 Shutting Down Oracle Content Server

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Control, then Shut Down.... The Oracle Content Server instance is shut down.

For more information, see "Starting and Stopping Oracle WebLogic Server Instances" in Oracle Fusion Middleware Administrator's Guide.

2.4 Modifying Configuration Parameters for Oracle Content Server

This section covers the following topics:

2.4.1 Modifying Server Configuration Parameters for Oracle Content Server

Server configuration contains information used to identify an Oracle UCM Oracle Content Server deployment scenario.

From the Configuration page you can:

  • Manage the HTTP address, which is the server address used to formulate full URLs in the Oracle Content Server user interface. This prevents users from being prompted to log in again because the domain name used to enter the server is not changed when links on pages are relative. Example setting: pc.idc.oracle.com.

  • Manage the Intradoc server port, which is the port number listened to by the Oracle Content Server instance. This is a trusted connection where only the user ID is required to authenticate. Example setting: 4056.

  • Manage the IP address filter, which is a list of IP addresses that are allowed to communicate to the Oracle Content Server instance through the Intradoc Server Port. The field accepts both IP and IPv6 addresses, with a pipe as the separator between addresses. This list must be well defined because it is a trusted connection. Example setting: 10.131.123.*.

  • Choose whether or not to use Secure Sockets Layer (SSL), which is related to the HTTP server address and indicates that the full URL uses the secured HTTP nomenclature. For example, it generates an address with https://(HttpServerAddress)/... instead of http://(HttpServerAddress)/...

To modify the server configuration:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. Use the UCM menu to select Configuration. The General Settings page displays.

  5. In the Server Configuration section, in the HTTP Address field, enter an HTTP server address.

  6. In the Server Configuration section, in the Intradoc Server Port field, enter a server port number.

  7. In the Server Configuration section, in the IP Address Filter field, enter a list of IP addresses that can be used to access the server.

  8. In the Server Configuration section, select Use SSL to turn on SSL.

  9. Click Apply.

    The General Settings page updates with the configuration changes.

    If you do not want to apply changes, click Revert to return to the previous configuration settings.

2.4.2 Modifying E-mail Configuration Parameters for Oracle Content Server

E-mail configuration parameters contain information used to identify an Oracle UCM Oracle Content Server deployment scenario.

From the Configuration page you can:

  • Specify the mail server, which is the name of the mail server that the content server uses to send SMTP based e-mail. Example: mymailserver.company.com.

  • Specify the SMTP port, which is the port number used to connect to the mail server. Example: 25.

  • Specify the admin mail address, which is the administrator e-mail address that receives error messages. Such messages are generally logged, but this is an additional method of notification. Example: mymail@mail.com.

To modify the e-mail configuration:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Configuration. The General Settings page displays.

  5. In the Email Configuration section, in the Mail Server field, enter the name of a mail server.

  6. In the Email Configuration section, in the SMTP Port field, enter a port number.

  7. In the Email Configuration section, in the Admin Mail Address field, enter an e-mail address.

  8. Click Apply.

    The General Settings page updates with the configuration changes.

    If you do not want to apply changes, click Revert to return to the previous configuration settings.

2.5 Viewing Performance Information for Oracle Content Server

You can monitor performance information for an Oracle UCM Oracle Content Server instance. Information includes a graphic of metrics for the Oracle Content Server instance, a summary of the most recent metric values, and a listing of recent service requests.

To view performance information:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Monitoring, then Performance Summary.

    The Performance Summary page displays. It contains information in graphic format.

  5. To select which metrics to display in performance graphs, click the Show Metric Palette button on the Performance Summary page. The Metric Palette lists available options for metrics to display in graphs on the Performance Summary page.

    To view metrics in a table format, select Table View.

  6. Check the box for each metric you want to display:

    • Active Threads: The number of active threads.

    • Active Database Connections: The number of active database connections made by the Oracle Content Server instance.

    • Search Queries Cached: The number of search queries cached (rows).

    • Hit to Miss Ratio: The hit to miss ratio for the number of search queries performed.

    • Documents in GenWWW State: The number of documents waiting for Inbound Refinery in a GenWWW state.

    • Documents Waiting to be Indexed in Done State: The number of documents waiting to be indexed in a Done state.

    • Average Requests Per Sec: The average number of Services requested per second.

More details about performance information for Oracle Fusion Middleware are available from the Enterprise Manager Administration Console Online Help.

2.6 Viewing Log Information for Oracle Content Server

You can view log messages and manage the log configuration for the Oracle UCM Oracle Content Server instance.

To view log information:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Serverinstance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Logs, then View Log Messages.

    The Log Messages page displays. It contains information about the contents of all available log files. You can use this page to:

    • Search for log messages logged during the past "n" hours.

    • Search for log messages that were logged between two time intervals.

    • Filter log messages based on message type.

To modify log configuration:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select Logs, then Log Configuration.

    The Log Configuration page displays. Use this page to configure basic and advanced log configuration settings for log levels and log files:

    • Change log levels of persistent loggers (loggers defined in the logging configuration file).

    • Change log levels of run-time loggers.

    • Specify loggers that are currently neither persistent nor run time.

    • Specify the log file configuration parameters such as the log file path and log rotation policies.

    • Create a new log file configuration.

    • Create a new log file configuration using an existing log file configuration.

    • View the log file configuration parameters.

    • Associate one or more loggers with a log file configuration.

More details about log information for Oracle Fusion Middleware is available from the Enterprise Manager Administration Console Online Help.

2.7 Viewing MBean Information for Oracle Content Server

You can use the MBean browser to view MBean attribute information about an Oracle UCM Oracle Content Server instance.

To view MBean information:

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

  2. Expand Content Management, then Universal Content Management, then Content Server.

  3. Select the Oracle Content Server instance name (for example, Oracle Content Server (UCM_server1)). The home page for your Oracle Content Server instance displays.

  4. From the UCM menu on the Oracle Content Server page, select System MBean Browser.

    The System MBean Browser page displays. This page shows the navigation pane with the UCM server name highlighted, and shows configuration MBean application deployment information for an Oracle Content Server instance.

    You can use the MBean browser to view or modify individual MBean attribute values, and to invoke MBean operations. Select the MBean and the attribute you want to view or modify. If you change an attribute value, click Apply.

For more information see "Understanding WebLogic Server MBeans" in Oracle Fusion Middleware Developing Custom Management Utilities With JMX for Oracle WebLogic Server.