1.3 Oracle IRM Server Administration Tools

Oracle offers the following tools for managing Oracle IRM:

  • Oracle IRM Server Management Console

  • Oracle Enterprise Manager Fusion Middleware Control 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 IRM Server Management Console

"The Management Console"

The Management Console is a browser-based application used by the several types of Oracle IRM Server administrator to control access to protected content.

Use the Management Console to:

  • Create Oracle IRM administrators: domain administrators, domain managers, inspectors, and context managers. (Note, however, that it is the first user to log in to the Control Console who is made a domain administrator.)

  • 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.2 Oracle Enterprise Manager Fusion Middleware Control Console

"The Control Console"


The first user to log in to the Control Console is made an Oracle IRM domain administrator.

The Control Console is a browser-based application that is deployed when you install Oracle IRM Server as part of the Oracle Enterprise Manager Fusion Middleware suite.

Use the Control Console for these Oracle IRM tasks:

  • 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.

  • Set up multiple languages support for the names and descriptions of Oracle IRM contexts, roles, etc.

  • 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 the Control Console

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

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:

Running Oracle WebLogic Scripting Tool (WLST) Commands

To run WLST from the command line:

  1. Navigate to the directory <home>/common/bin.

  2. From the command line, enter the command:


    For example:


  3. 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>')


    • <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','welcome1', 'myhost.example.com:7001')

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


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

    or setenv CONFIG_JVM_ARGS


    Where KeyStoreName is the name of the keystore in use (DemoTrust for the built-in demonstration certificate).

  4. 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.