1.3 Oracle IRM Server Administration Tools

Oracle offers the following tools for managing Oracle IRM:

Oracle Enterprise Manager Fusion Middleware Control Console
Oracle IRM Server Management Console
Oracle WebLogic Scripting Tool (WLST)

Administrators should use these tools, rather than edit configuration files, to perform administrative tasks unless a specific procedure requires you to edit a file. Editing a file may cause the settings to be inconsistent and generate problems.

1.3.1 Oracle Enterprise Manager Fusion Middleware Control Console

Oracle Enterprise Manager Fusion Middleware Control Console is a browser-based management application that is deployed when you install Oracle IRM Server. From Fusion Middleware Control Console, you can monitor and administer a farm (such as one containing Oracle IRM Server).

Fusion Middleware Control organizes a wide variety of performance data and administrative functions into distinct, Web-based home pages. The Oracle IRM home page hosts some of the administrative functions for Oracle IRM. For general information about the Fusion Middleware Control Console, see "Getting Started Using Oracle Enterprise Manager Fusion Middleware Control" in the Oracle Fusion Middleware Administrator's Guide.

The Oracle IRM pages on Fusion Middleware Control Console can be used to:

Set the cryptography algorithms and strengths to use for sealed content.
Set the URL of the server that sealed content must contact.
Set the URL of a privacy statement that users must accept before viewing sealed content.
Set a restriction on the number of devices that a sealed document can be used on simultaneously by one user
Set how frequently Oracle IRM Desktop will attempt to contact Oracle IRM Server to synchronize rights.
Set options for the age of retained report records and the frequency of their deletion.
Set options for context refresh periods that are available when creating or editing roles.
Set up test content that will be accessible when users successfully connect to Oracle IRM Server.
Determine which languages will be available on the Oracle IRM Server management console.
Set up multiple downloads of the Oracle IRM Desktop installation software to cover different combinations of language, product version, and locale.
Set up license record purges, status page redirection, and key store configuration.

Displaying Fusion Middleware Control Console

For information about starting Fusion Middleware Control and displaying Fusion Middleware Control Console, see "Using Enterprise Manager Fusion Middleware Control Console for Oracle IRM".

1.3.2 Oracle IRM Server Management Console

The Oracle IRM Server management console is a browser-based, graphical user interface that you use to manage Oracle IRM Server.

Use the Oracle IRM Server management console to:

Create Oracle IRM administrators: domain administrators, domain managers, inspectors, and context managers.
Create roles.
Create and modify context templates.
Create, modify, and delete contexts, exclude specific documents from a context, and associate a context with trusted contexts.
Create and modify rights.
Generate reports.
Copy, rename, and change descriptions within Oracle IRM Server.
Add, change, and delete names and descriptions in multiple supported languages.

1.3.3 Oracle WebLogic Scripting Tool (WLST)

Oracle provides the WebLogic Scripting Tool (WLST) to manage Oracle Fusion Middleware components, such as Oracle IRM Server, from the command-line.

WLST is a complete, command-line scripting environment for managing Oracle WebLogic Server domains, based on the Java scripting interpreter, Jython. In addition to supporting standard Jython features such as local variables, conditional variables, and flow control statements, WLST provides a set of scripting functions (commands) that are specific to Oracle WebLogic Server. You can extend the WebLogic scripting language to suit your needs by following the Jython language syntax.

Oracle WebCenter offers WLST commands for:

The functionality available on the Oracle IRM pages on Fusion Middleware Control Console (see "Oracle Enterprise Manager Fusion Middleware Control Console").
Migrating users and groups from one user store to another.

Running Oracle WebLogic Scripting Tool (WLST) Commands

To run WLST from the command line:

Navigate to the directory <home>/common/bin.
From the command line, enter the command:

wlst.sh

For example:

<home>/common/bin/wlst.sh

At the WLST command prompt, enter the following command to connect to the Administration Server for Oracle IRM:

wls:/offline>connect('<user_name>','<password>', '<host_name>:<port_number>')

where

<user_name> is the username of the operator who is connecting to the Administration Server
<password> is the password of the operator who is connecting to the Administration Server
<host_name> is the host name of the Administration Server
<port_number> is the port number of the Administration Server

For example:

connect('weblogic','weblogic', 'myhost.example.com:7001')

For help for this command, type help('connect') at the WLST command prompt.

Note:

If SSL is enabled, you must edit the wlst.sh file and append the following to JVM_ARGS:

-Dweblogic.security.SSL.ignoreHostnameVerification=true -Dweblogic.security.TrustKeyStore=DemoTrust

or setenv CONFIG_JVM_ARGS

-Dweblogic.security.SSL.ignoreHostnameVerification=true -Dweblogic.security.TrustKeyStore=DemoTrust

Once connected to the Administration Server you can run any Oracle IRM or generic WLST command.

For a complete list, see "Oracle IRM Custom WLST Commands" in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.