19 Universal Content Management Custom WLST Commands

The following sections describe the custom WLST commands for Oracle Universal Content Management (Oracle UCM). These commands enable you to configure and monitor the Oracle Universal Content Management server and Content Server instance from the command line. Topics include:

For additional information about Oracle UCM and Oracle Content Server administration and configuration, see Oracle Fusion Middleware System Administrator's Guide for Oracle Content Server.

Note:

To use the Oracle Universal Content Management custom commands, you must invoke the WLST script from the Oracle Common home in which the component has been installed. See "Using Custom WLST Commands" in the Oracle Fusion Middleware Administrator's Guide.

Overview of WLST UCM Command Categories

WLST UCM commands are divided into the following categories:

Table 19-1 WLST Oracle UCM Command Categories

Command Category Description

Server Configuration Commands

View and manage configuration for the Oracle Content Server instance.

E-Mail Configuration Commands

View and manage configuration for Oracle Content Server e-mail.

Additional Commands

View status information for the Oracle Content Server instance.


WLST UCM Help

To view the Oracle UCM commands that can be invoked from WLST, enter the following command at the WLST prompt:

help('UCM')

To view help for a specific Oracle UCM command, replace the 'UCM' with the name of the command; for example:

help('getUCMServerPort')

Getter and Setter Methods Implementation

The WLST component for Oracle UCM uses getter and setter methods to handle a situation where multiple applications register their corresponding Mbeans on a managed server, but WLST can talk to only one application.

Getter Method

The getter method is designed to handle zero or one argument.

If you do not provide an argument to an WLST Oracle UCM command, then one of two things occurs:

  • If only one application has registered its Mbean on the server, then the WLST Oracle UCM command should work successfully and display the output.

  • If multiple applications have registered Mbeans on the server, then an error message is displayed to prompt you to enter the specific application name in the argument.

If there is one argument to an WLST Oracle UCM command, then the following occurs:

  • You must enter the correct application name when entering an argument. If the name is not entered properly, then an error message is displayed to prompt you to enter the valid application name in the argument.

Setter Method

The setter method is designed to handle one or two arguments.

  • The first argument is the value to which you want to set the parameter.

  • The second argument is the application name, which can be null or a string.

Server Configuration Commands

Use the commands in Table 19-2 to configure the Oracle UCM Oracle Content Server instance.

Table 19-2 WLST Server Configuration Commands

Use this command... To... Use with WLST...

getUCMHttpServerAddress

Display the HTTP Server Address value.

Online

setUCMHttpServerAddress

Set the HTTP Server Address value.

Online

getUCMServerPort

Display the Intradoc Server Port configuration parameter.

Online

setUCMServerPort

Set the Intradoc Server Port configuration parameter.

Online

getUCMIPAddressFilter

Display the IP Address Filter value.

Online

setUCMIPAddressFilter

Set the IP Address Filter value.

Online

getUCMUseSSL

Display the Use SSL value.

Online

setUCMUseSSL

Set the Use SSL value.

Online


getUCMHttpServerAddress

Use with WLST: Online

Description

Gets the HTTP Server Address value from the config.cfg file and displays it.

Syntax

getUCMHttpServerAddress()

or

getUCMHttpServerAddress(application_name)

Example

The following command displays the Oracle UCM HTTP server address for the application "Oracle Content Server":

getUCCHttpServerAddress('Oracle Content Server')
server.mycompany.com

setUCMHttpServerAddress

Use with WLST: Online

Description

Sets the HTTP Server Address value in the config.cfg file. The HTTP Server Address can be of the form abc.xyz.def or an IP address with port number.

The HTTP Server Address is used to formulate full URLs in the Oracle Content Server user interface.

Syntax

setUCMHttpServerAddress()

or

setUCMHttpServerAddress(value,application_name)

Example

The following command sets the Oracle UCM HTTP server address for the application "Oracle Content Server":

setUCMHttpServerAddress(server.mycompany.com,'Oracle Content Server')

getUCMServerPort

Use with WLST: Online

Description

Gets the Intradoc Server Port configuration parameter from the config.cfg file and displays it.

Syntax

getUCMServerPort()

or

getUCMServerPort(application_name)

Example

The following command displays the Intradoc Server Port value for the application "Oracle Content Server":

getUCMServerPort('Oracle Content Server')
4442

setUCMServerPort

Use with WLST: Online

Description

Sets the Server Port configuration parameter. The Server Port must be a positive integer between 0 and 65535.

Syntax

setUCMServerPort(value)

or

setUCMServerPort(value,application_name)

Example

The following command sets the Server Port configuration parameter for the application "Oracle Content Server":

setUCMServerPort(4442,'Oracle Content Server')

getUCMIPAddressFilter

Use with WLST: Online

Description

Gets the IP Address Filter value from the config.cfg file and displays it.

Syntax

getUCMIPAddressFilter()

or

getUCMIPAddressFilter(application_name)

Example

The following command displays the IP address filter value for the application "Oracle Content Server":

getUCMIPAddressFilter('Oracle Content Server')
10.131.123.*

setUCMIPAddressFilter

Use with WLST: Online

Description

Sets the Oracle UCM IP Address Filter value, which must be of "*.*.*.*" format or IPV6 Format. The value must be taken from a list of IP Addresses allowed to communicate with the Content Server instance through the Intradoc Server Port.

Syntax

setUCMIPAddressFilter(value)

or

setUCMIPAddressFilter(value,application_name)

Example

The following command sets the value for the Oracle UCM IP address filter for the application "Oracle Content Server":

setUCMIPAddressFilter(10.131.123.*,'Oracle Content Server')

getUCMUseSSL

Use with WLST: Online

Description

Gets the Use SSL value from the config.cfg file and displays it. The value can be True or False.

Syntax

getUCMUseSSL()

or

getUCMUseSSL(application_name)

Example

The following command displays the Use SSL value for the application "Oracle Content Server":

getUCMUseSSL('Oracle Content Server')
True

setUCMUseSSL

Use with WLST: Online

Description

Sets the Use SSL value in the config.cfg file. The value can be True or False.

Syntax

setUCMUseSSL(value)

or

setUCMUseSSL(value,application_name)

Example

The following command sets the Use SSL value for the application "Oracle Content Server":

setUCMUseSSL(True,'Oracle Content Server')

E-Mail Configuration Commands

Use the commands in Table 19-3 to configure e-mail for the Oracle UCM Oracle Content Server instance.

Table 19-3 WLST E-Mail Configuration Commands

Use this command... To... Use with WLST...

getUCMMailServer

Display the Mail Server value.

Online

setUCMMailServer

Set the Mail Server value.

Online

getUCMSmtpPort

Display the SMTP Port value.

Online

setUCMSmtpPort

Set the SMTP Port value.

Online

getUCMSysAdminAddress

Display the Admin Address value.

Online

setUCMSysAdminAddress

Set the Admin Address value.

Online


getUCMMailServer

Use with WLST: Online

Description

Gets the Mail Server value from the config.cfg file and displays it.

Syntax

getUCMMailServer()

or

getUCMMailServer(application_name)

Example

The following command displays the Mail Server value for the application "Oracle Content Server":

getUCMMailServer('Oracle Content Server')
mymailserver.mycompany.com

setUCMMailServer

Use with WLST: Online

Description

Sets the Mail Server value in the config.cfg file. The Mail Server value is the name of the mail server that the Oracle Content Server instance uses to send SMTP based e-mail.

Syntax

setUCMMailServer(value)

or

setUCMMailServer(value,application_name)

Example

The following command sets the value for the Mail Server for the application "Oracle Content Server":

setUCMMailServer(mymailserver.mycompany.com,'Oracle Content Server')

getUCMSmtpPort

Use with WLST: Online

Description

Gets the SMTP Port value in the config.cfg file and displays it.

Syntax

getUCMSmtpPort()

or

getUCMSmtpPort(application_name)

Example

The following command displays the SMTP port value for the application "Oracle Content Server":

getUCMSmtpPort('Oracle Content Server')
4055

setUCMSmtpPort

Use with WLST: Online

Description

Sets the SMTP Port value in the config.cfg file. The SMTP Port must be a positive integer between 1 and 65535. To reset the port to null, enter None for the value: setUCMSmtpPort(None)

Syntax

setUCMSmtpPort(value)

or

setUCMSmtpPort(value,application_name)

Example

The following command sets the SMTP port value for the application "Oracle Content Server":

setUCMSmtpPort(4055,'Oracle Content Server')

getUCMSysAdminAddress

Use with WLST: Online

Description

Gets the Admin Address value from the config.cfg file and displays it. The value can be of the form abc@xyz.def.

Syntax

getUCMSysAdminAddress()

or

getUCMSysAdminAddress(application_name)

Example

The following command displays the Admin Address value for the application "Oracle Content Server":

getUCMSysAdminAddress('Orcle Content Server')
mymail@mycompany.com

setUCMSysAdminAddress

Use with WLST: Online

Description

Sets the Admin Address value in the config.cfg file. The Admin Address can be of the form abc@xyz.def.

Syntax

setUCMSysAdminAddress(value)

or

setUCMSysAdminAddress(value,application_name)

Example

The following command sets the Admin Address value for the application "Oracle Content Server":

setUCMSysAdminAddress(mymail@mycompany.com,'Oracle Content Server')

Additional Commands

Use the commands in Table 19-4 to configure additional settings to monitor the Oracle UCM Oracle Content Server instance.

Table 19-4 WLST Additional Configuration Commands

Use this command... To... Use with WLST...

getUCMCSVersion

Display the version number.

Online

getUCMServerUptime

Display the uptime value.

Online


getUCMCSVersion

Use with WLST: Online

Description

Gets the version number of the Oracle Content Server running instance.

Syntax

getUCMCSVersion()

or

getUCMCSVersion(application_name)

Example

The following command displays the version number of the active instance of the application "Oracle Content Server":

getUCMCSVersion('Oracle Content Server')
11g R1

getUCMServerUptime

Use with WLST: Online

Description

Gets the amount of time the Oracle Content Server instance has been up.

Syntax

getUCMServerUptime()

or

getUCMServerUptime(application_name)

Example

The following command displays the amount of time the application "Oracle Content Server" has been up:

getUCMServerUptime('Oracle Content Server')
00H:01 Min:12 Sec:255 MilliSeconds