This chapter includes the following topics:
There are several methods for starting, stopping, and restarting the Content Server instance. Which method you choose depends on your requirements, your authorization, and the task you want to complete. For example, when certain configuration changes are made to the Content Server instance, such as when components are enabled or disabled, the instance must be restarted.
For the Inbound Refinery (IBR) instance, the only method available is to use Oracle Enterprise Manager Fusion Middleware Control.
Available methods for managing the Content Server instance include:
Oracle Enterprise Manager Fusion Middleware Control (see Starting and Stopping Content Server and Inbound Refinery Using Fusion Middleware Control)
Oracle WebLogic Server Administration Console (see Starting and Stopping Content Server Using WebLogic Server)
Oracle WebLogic Server scripts (see Starting and Stopping Content Server Using Scripts)
Note:
In earlier releases, the Content Server's Admin Server could be used to start, stop, and restart the Content Server instance. This functionality has been replaced as of 11g Release 1 (11.1.1).
Oracle Enterprise Manager Fusion Middleware Control is used by administrators to manage an Oracle WebLogic Server running a WebCenter Content domain with the Content Server or Inbound Refinery instance.
The Content Server and Inbound Refinery instances are initially started during the process of installing and deploying the instance on a managed server on an Oracle WebLogic Server domain. The Content Server and Inbound Refinery instances can be stopped and restarted for several reasons, including changing the configuration, such as enabling or disabling a component.
Note:
The Inbound Refinery instance can be stopped and started using the same Fusion Middleware Control procedures as for Content Server.
Starting Content Server or Inbound Refinery Using Fusion Middleware Control
Stopping Content Server or Inbound Refinery Using Fusion Middleware Control
Restarting Content Server or Inbound Refinery Using Fusion Middleware Control
See Starting and Stopping Oracle WebLogic Server Instances in Administering Oracle Fusion Middleware.
To start the Content Server or Inbound Refinery (IBR) instance:
To stop the Content Server or Inbound Refinery (IBR) instance:
The Oracle WebLogic Server Administration Console is available to Content Server administrators because they must have administrative privileges to manage WebCenter Content with the Content Server instance. The Node Manager must be configured and running in order to start or stop the WebCenter Content managed server with the Content Server instance.
The Content Server instance is initially started during the process of installing and deploying the instance on a WebCenter Content server in an Oracle WebLogic Server domain. You might want to start the Content Server instance at other times, for example, to start the instance after it has been stopped when changing a Content Server configuration setting.
The Content Server instance can be stopped and restarted for several reasons, including changing the configuration, such as enabling or disabling a server component.
Starting Content Server Using WebLogic Server Administration Console
Stopping Content Server Using WebLogic Server Administration Console
Restarting Content ServerUsing WebLogic Server Administration Console
See Starting and Stopping Oracle WebLogic Server Instances in Administering Oracle Fusion Middleware.
To start the Content Server instance:
UCM_server1
), then click Start.To stop the Content Server instance:
UCM_server1
), then click Shutdown.To restart the Content Server instance:
UCM_server1
), then click Shutdown.Scripts provide a quick method to execute actions on Oracle WebLogic servers. Before you can start a Managed Server for an application, you must start the Administration Server for the Oracle WebLogic Server domain.
The following script examples assume that the Content Server instance has been previously started as part of the software installation process. See Installing and Configuring Oracle WebCenter Content.
Caution:
These script commands control the Oracle WebLogic Server Managed Server that includes the WebCenter Content server and the WebLogic Server Administration Server, which includes the Administration Console. If you do not want to start or stop the Oracle WebLogic Server Administration Server, then use another method to start the Content Server instance.
To start the Content Server instance:
UCM_Server1
.Windows script:
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startWebLogic.sh MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startManagedWebLogic.sh UCM_server1
UNIX script:
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startWebLogic.sh MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startManagedWebLogic.sh UCM_server1
To stop the Content Server instance:
UCM_server1
.Windows script:
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopManagedWebLogic.sh UCM_server1 MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopWebLogic.sh
UNIX script:
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopManagedWeblogic.sh UCM_server1 MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopWebLogic.sh
To restart the Content Server instance:
UCM_server1
.Windows script:
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopManagedWeblogic.sh UCM_server1 MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopWeblogic.sh MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startWeblogic.sh MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startManagedWeblogic.sh UCM_server1
UNIX script:
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopManagedWeblogic.sh UCM_server1 MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopWeblogic.sh MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startWeblogic.sh MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startManagedWeblogic.sh UCM_server1
You can run Content Server administration applications either as applets or in standalone mode. Running applications in standalone mode requires additional configuration for database connections and that the Content Server administrator be a local user.
You can run several of the Content Server administration applications as applets from any web browser with access to the Content Server instance. Applets are convenient for remote administration.
Note:
The Batch Loader, Component Wizard, System Properties, and Content Server Analyzer utilities cannot be run as applets; for security reasons, they must be run in standalone mode from the computer where the Content Server instance is deployed. See Running Administration Applications in Standalone Mode.
Some functions that are available in the standalone version of an application are not available from the applet version. See the documentation for each application for more information.
To run an administration application as a Java applet within a Java-enabled browser:
You can run Content Server administration Java applications in standalone mode from the computer where a Content Server instance is deployed. Some of the applications are the same as the applets accessed using a web browser, such as Configuration Manager and Repository Manager. Some utilities can be run only in standalone mode, such as System Properties and Batch Loader. The method required to start these programs differs slightly between Windows and UNIX installations.
Running the standalone version of an application offers greater security than browser applets, and enables you to send passwords without having them captured or copied from the web or a network.
Standalone administration applications require that the Content Server system administrator running the applications be a local admin user, instead of a user defined through Oracle WebLogic Server. (Local users are otherwise unused in Oracle WebLogic Server.) To use standalone administration applications that require a login, run the User Admin applet and define a new local user with Admin permissions in Content Server. For information on local users, see Local Users. For details on using the User Admin applet to create a local user, see Editing a User Login.
Note:
Before you can run Content Server administration applications in standalone mode, additional configuration is required to authenticate the applications on Oracle WebLogic Server and to establish a JDBC connection to the system database and access to the Oracle WebLogic Server database connection. See Configuring a System Database Provider for Standalone Mode and Configuring an External Database Provider for Standalone Mode.
If a standalone application is required to connect to a SSL-enabled database where digital certificates are used for authentication, then the database root CA certificate must be imported into the standard Java key store that the application uses to check trusted sources. See Configuring the WebCenter Content Domain in Installing and Configuring Oracle WebCenter Content.
To run a Content Server administration application in standalone mode on a UNIX operating system:
To run a Content Server administration application in standalone mode on a Windows operating system.
Content Server administration applications and utilities that can only run in standalone mode require specific configuration to run in an Oracle WebLogic Server domain with Oracle WebCenter Content and the Content Server instance. The configuration changes for a standard (non-customized) Oracle WebLogic Server connection are necessary to have the applications authenticate Oracle WebLogic Server users and to set up a JDBC connection to the Oracle WebLogic Server system database.
Follow these steps to configure connections for standalone mode:
For Content Server to work with administration applications that only run in standalone mode (for example, Batch Loader, System Properties, and Content Server Analyzer utilities) you must configure a JDBC driver for the system database or an external database provider. Oracle Fusion Middleware DataDirect JDBC drivers for Microsoft SQL Server and IBM DB2 databases are available to support Content Server standalone applications. You can use the System Properties utility to enter the configuration information.
To configure a JDBC Driver for standalone applications:
You can create an external database provider in the Content Server instance for standalone applications to directly connect to a database with JDBC without using the System Database provider for the Oracle WebLogic Server data source.
For standalone applications to use the OracleTextSearch feature as an external search engine, you must configure the external database provider to include the JDBC connection information.
By default, the configuration of an incoming provider does not include values for JDBC Driver and JDBC Connection String. You must add these values, but be careful not to change the provider name because you cannot rename an existing provider. To change the name of a provider, you would need to delete it and then add it again.
The IdcShell tool enables administrators to run Idoc Script from a command line. Idoc Script is a proprietary server-side custom scripting language for the WebCenter Content system. This scripting language enables administrators to reference variables, conditionally include content in HTML pages, and loop over results returned from queries.
Idoc Script is used primarily for configuration settings and the presentation of HTML templates. Idoc variables (sometimes called configuration variables or environment variables) can be used in Idoc Script and in configuration files. See Configuration Variables in Configuration Reference for Oracle WebCenter Content. See Introduction to the Idoc Script Custom Scripting Language in Developing with Oracle WebCenter Content.
The IdcShell tool also includes some additional Idoc Script functions, listed in Table 3-1, and some dynamichtml definitions, listed in Table 3-2, which are useful for managing Content Server or Inbound Refinery instances.
The IdcShell tool has built-in help, which you can access by running the command:
bin/IdcShell "include shell_help"
Table 3-1 lists and describes Idoc Script functions typically used with the IdcShell command-line tool.
Table 3-1 Command-Line Idoc Script Functions
Function | Description |
---|---|
doService(serviceName) |
Executes a serviceName in the current context. |
formatBinder() |
Formats a DataBinder for easy reading. |
getWithTrace() |
Traces the get() function and reports on the source of the data. |
promptUser(text, flags) |
Displays text on the console and reads a user response. If flags is NO_ECHO, then it does not echo input. |
Table 3-2 lists and describes dynamichtml definitions typically used with the IdcShell command-line tool.
Table 3-2 Dynamichtml Definitions
Dynamichtml definition | Description |
---|---|
get_username |
Prompts for a user name on the console and assigns to userName. |
get_password |
Prompts for a password on the console and assigned to dPassword. |
set_user_password |
Sets a user's password. |
create_user |
Creates a new user, by default with Admin role. |