User Guide

Reference

This chapter provides a detailed description of the Guardian User Interface components and features, and a detailed reference guide to the Guardian Command Line Interface. Topics include the following:

Main Menu Bar

The Main Menu Bar is at the top of the Oracle Guardian main window just below the Oracle Guardian titlebar. The Menu Bar contains the following menus:

The Menu Bar menus in turn contain a series of options and submenus, some of which also lead to additional menus, dialog boxes, or wizards. The following sections provide a description of each of these menus, and instructions for invoking them.

Keyboard Shortcuts

You can invoke many menus, submenus, and menu options by using a keyboard shortcut. To display Menu Bar menus, press the Alt key and type the menu selection key for the menu you want to display. The menu selection key is the letter underlined in the menu name in the Menu Bar when you press the Alt key.

Some menu options also have keyboard shortcuts, which consist of a specific sequence of characters pressed simultaneously. If a menu item has a keyboard shortcut, the key sequence is listed next to the item in the menu. To see the complete list of keyboard shortcuts, press Ctrl+Shift+L.

File Menu

Table 3-1 describes the File menu options and submenus.

Edit Menu

Table 3-2 describes the Edit menu options.

Tools Menu

Table 3-3 describes the Tools menu options and submenus.

Window Menu

Table 3-4 describes the Window menu options and submenus.

Help Menu

Table 3-5 describes the Help menu options and submenus.

Main Toolbar

The Main Toolbar is located below the Main Menu Bar, and contains action buttons for the most common Guardian tasks. You can roll your mouse pointer over a button to display the tool tip text for that button.

Table 3-6 describes the Main Toolbar buttons.

Context Menus

Many views and displays contain context menus. Right-click on an item or anywhere in a display to open the associated context menu.

Related Tasks

Related Reference

Navigation Pane

The Navigation Pane resides in the left side of the Oracle Guardian main window. The Navigation Pane contains several tabs leading to Explorer Views. You can have multiple Views open at once, but only one can be displayed at a time. Click on a tab to display that Explorer View.

The following section provides an overview of Navigation Pane elements.

Navigation Pane Elements

Navigation Pane elements include the following:

The following sections describe each of these elements.

Explorer Views

At the top of the Navigation Pane are the Explorer View tabs. Select a tab to display that View. Table 3-7 provides an overview of the Navigation Pane Explorer Views.

Explorer Toolbar Icons

Below each Explorer tab titlebar is the Explorer toolbar. An Explorer toolbar may contain all or some of the following active icons:

Explorer Toolbar Menus

The Domain Explorer, Signature Explorer, and Bundle Explorer each contain a menu icon in the right corner of the toolbar. Click the menu icon to open a menu of display options for that Explorer.

Table 3-9 describes the Explorer menus.

Explorer Context Menus

Right-click in an Explorer View to display the context menu of tasks and operations you can perform from that View. You can also right-click on a specific item to select it and open the context menu for that item. Menu options that do not apply to your selection are deactivated.

For a detailed description of a specific context menu, see the appropriate section listed below:

Domain Explorer

The Domain Explorer is a Navigator View that enables you to browse, manage, and monitor the domains you have activated in Guardian. In the Navigation Pane, select the Domain Explorer tab to display the explorer.

The following table provides an overview of Domain Explorer elements:

Domain Nodes

A domain node represents a domain that has been activated (defined and enabled for evaluation) in Guardian. When you activate a domain for the first time in Guardian, a node for the new domain is added to the Target Domains folder in the Domain Explorer tree. A unique name is automatically generated for the new domain, based upon your entries in the Domain Activation Wizard.

The generated name has the following syntax:

<domain_name>_<hostname>_<listen-port>

Where:

For example:

wl_server_localhost_7001

The Domain Explorer tree displays only the active Domain Nodes. “Active” does not refer to the state of the domain servers themselves, but rather to whether you have enabled that domain for evaluation. If you deactivate a domain in Guardian, that domain is removed from the Domain Explorer tree. However, if you reactivate the domain, the node for that domain is again displayed, and the original contents of the History folders are also again available. Deactivating a domain does not remove the Workspace data for that domain.

Domain Node Icon and Icon Decorations

The Domain Explorer displays only the active Domain Nodes. In the Domain Explorer tree, active domains have a blue node icon to the left of the domain name. Icon decorations indicate whether the username and password have been persisted, and whether the domain requires SSL encryption for all communication.

The following table describes the Domain Node icon and icon decorations.

Domain History Folders

Domain Inventories and Evaluation Summaries for a domain are accumulated in History folders, which persist on disk in your Guardian Workspace. These are represented as folder icons below each Domain Node in the Domain Explorer Target Domains tree. Each Domain Node contains the following two History folders:

The following sections describe each of these folders.

Inventory History Folder

The Inventory History folder contains the Domain Inventories that have been generated for that domain. Double-click on a Domain Inventory name to display the inventory details in the Document Pane.

Each time you activate, evaluate, or inventory a domain, a new Domain Inventory is created and added to the Inventory History folder for that domain. A unique name is generated for each new Inventory, using this format:

<domain_name>_<hostname>_<listen_port>_<date> <time>.

See also Domain Inventory in “About Oracle Guardian,” and Domain Inventory View in “Reference.”

Evaluation History Folder

The Evaluation History folder contains the Evaluation Summaries that have been generated for that domain. Double-click on an Evaluation Summary name to display the evaluation details in the Document Pane.

Each time you evaluate a domain, a new Evaluation Summary is created and added to the Evaluation History folder for that domain. A unique name is generated for each new Inventory, using this format:

<bundle_name>_<date> <time>

Each Evaluation Summary listed in the Evaluation History folder has an icon indicating whether any signatures were detected. If any signatures were detected, the icon is decorated with a severity indicator. The detected signature with the highest severity determines the severity of the Evaluation Summary.

The following table describes the Evaluation Summary icons.

Domain Explorer Toolbar Menu

Click the Domain Explorer toolbar menu icon to display a menu containing the following options:

Domain Explorer Context Menu

You can use either of the following methods to open the Domain Explorer context menu:

The following table describes the Domain Explorer context menu options.

Domain Properties Dialog Box

Domain Properties govern how Guardian accesses a target domain. The Domain Properties dialog box enables you to view and modify the Domain Properties for a specific domain.

To open the Domain Properties dialog box for a domain, right-click on the domain name in the Domain Explorer tree, and then select Modify Domain from the context menu.

The Domain Properties dialog box contains the following elements:

Evaluate from File Dialog Box

To capture target domain data to a file for later evaluation, you can set the following flag in your guardian.ini file:

-Dguardian.dump.collection.data

When this flag is set, each time a domain is evaluated, the data is captured and written to two files in the data subdirectory of your Guardian Workspace. The files are named as follows:

collectedData_<nnnnnnnnnnnnn>.xml

Where <nnnnnnnnnnnnn> is a timestamp for the creation of the file.

For example:

collectedData_1218570631376.xml

These two files are differentiated by their respective timestamps, and their size. The earlier, smaller file contains the data collected from the domain as restricted by the selected Signature Bundle. The second and much larger file contains a collection of all available data from the domain.

The captured data can then be evaluated, as explained below. The evaluation proceeds the same as with a “live” evaluation, except that the data in the capture file is evaluated, rather than evaluating the realtime data from a live server.

You can use the Evaluate from File dialog box to specify a domain, Signature Bundle, and data file to use for a data file evaluation.

You can use either of the following methods to open the Evaluate from File dialog box:

The Evaluate from File dialog box contains the following elements:

Add Domain Group Dialog Box

Use the Add Domain Group dialog box to create a new Domain Group. To open, right-click on Target Domains in the Domain Explorer tree and select Add Domain Group from the context menu. Enter a name for the domain and click OK to add the new group to the Target Domains folder.

For instructions on populating and using Domain Groups, see Domain Groups in Tasks.

Rename Domain Group Dialog Box

Use the Rename Domain Group dialog box to change the name for a Domain Group. To open, right-click on Target Domains in the Domain Explorer tree and select Rename Domain Group from the context menu. Enter the new name and click OK.

See also, Rename Domain Group in Tasks.

Related Tasks

Related Reference

Signature Explorer

The Signature Explorer is a Navigator View that enables you to browse the available signatures and view the contents of a selected signature. In the Navigation Pane, select the Signature Explorer tab to display the explorer.

The Signature Explorer contains a list of all existing signatures currently installed in Guardian. Double-click on a signature title to display the contents of that signature in the Document Pane.

Signature Severity Icons

To the left of each signature title in the Signature Explorer signature list is a Signature Severity icon. The icon indicates the severity level for that signature.

The following table describes the Signature Severity icons:

Table 3-17 Signature Severity Icons

Icon	Severity
	Critical
	Warning
	Informational

Signature Explorer Toolbar Menu

Click the Signature Explorer toolbar menu icon to open a menu of options for sorting and filtering the signature list.

The Signature Explorer toolbar menu contains the following options:

Signature Explorer Context Menu

Right-click on a signature name in the Signature Explorer to display the Signature Explorer context menu. This menu has only one option:

Related Tasks

Related Reference

Bundle Explorer

The Bundle Explorer is a Navigator view for browsing the available Signature Bundles and their contents. In the Navigation Pane, select the Bundle Explorer tab to display the explorer.

The Bundle Explorer contains the following elements:

Bundle and Signature Severity Icons

Each Bundle Node has an icon indicating the severity level for that Bundle. The security level for the Bundle is determined by the highest security level occurring for any signature in that Bundle. For example, if only one signature in the Bundle has a severity level of Critical, then the entire Bundle will have a severity level of Critical.

The Bundle and Signature Severity icons are as follows:

Bundle Explorer Toolbar Menu

Click the Bundle Explorer menu icon to open a menu with the following options:

Bundle Explorer Context Menu

In the Bundle Explorer, right-click on a signature title to display the Bundle Explorer context menu. This menu has only one option:

Related Tasks

Related Reference

Shortcut Explorer

The Shortcut Explorer is a Navigation Pane View for viewing and managing your Evaluation Shortcuts. In the Navigation Pane, select the Shortcut Explorer tab to display the explorer.

The Shortcut Explorer displays a list of all of the Evaluation Shortcuts you have created. Double-click on a Shortcut to open the Shortcut Evaluation Wizard with the Shortcut target domain and Signature Bundle preselected.

For a description of Shortcuts, see Shortcut in About Oracle Guardian. For instructions on creating and using Shortcuts, see Shortcuts in Tasks.

Shortcut Explorer Context Menu

You can use either of the following methods to open the Shortcut Explorer context menu:

The Shortcut Explorer context menu contains the following options:

Related Tasks

Related Reference

Document Pane

The Document Pane is located in the central portion of the Oracle Guardian main window. The Document Pane displays the Document Views.

The Document Pane contains the following elements:

Document Views

The Document Views display the details document(s) for the object selected in the Navigation Pane. Some Views also have editing features for cutting, copying, and pasting text selections into an external editor. If edit options are available for a View, you can right-click in that View to open an Edit menu of those options.

You can have multiple Views open in the Document Pane, but only one can be active at a time. Each opened View has a tab, located at the top of the Document Pane. Click on a View tab to activate and display that View. Some Views have additional tabs, located at the bottom of the View display. These display additional pages for that View, such as the Overview, Source, and Report pages.

Table 3-25 provides an overview of the Document Views.

Document Pane Outline Views

When a Document View is open, you can select Window > Show View > Outline View to display the Outline View for the current Document View. You can use the Outline View as a navigator for the current Document View. You can click the Overview, Source, or Report nodes in the Outline View to bring the corresponding tab of the Document View to the forefront. You can open the Outline View Source node to select specific XML tag names, to jump to those tags in the Source page and highlight them.

Document View Titlebars

Each Document View has a titlebar that contains the name of the View, an identity icon (for example, a Domain or Signature icon), and buttons to close, minimize, maximize, and restore the display.

The View titlebars also have the following additional features:

Document View Context Menus

The following Document Views have context menus:

The Active Domains Table and Shortcuts Table Views do not have context menus.

Each tab page for a View has a context menu specific to the tab contents. Some context menus—for example, Edit menus—may be available only for certain items within that View.

To open a context menu, right-click on an item in that View.

Document View Edit Menus

Edit menus are available in some View pages for text items that can be copied and pasted to an external editor. If an item cannot be edited (copied), the Edit menu will not be available. Right-click on an item to display a menu of standard edit options for that item.

The Edit context menu contains the following standard options:

Domain Inventory View

The Domain Inventory Document View displays the contents of a Domain Inventory. The Domain Inventory is an XML document that describes the products in your domain, and is persisted in your Guardian Workspace. The inventory includes descriptions of your servers, Java Virtual Machines, operating systems, databases, product versions, and certain configuration settings. For details, see Domain Inventory in the section “About Oracle Guardian.”

You can use either of the following methods to open a Domain Inventory View:

The Domain Inventory View contains the following tabs:

The contents of each of these tab pages are described in the following sections.

Domain Inventory Overview Tab

The Domain Inventory Overview page displays a summary of the selected Domain Inventory. The Overview page contains the following sections:

These are described in the following sections.

General Information Section

Servers Section

The Domain Inventory Servers section contains the following information:

JDBC

The Domain Inventory JDBC section contains the following information:

Domain Inventory Source Tab

The Domain Inventory Source page displays the XML source for the selected Domain Inventory. This page also has a context menu of options for saving, copying, and printing the inventory XML source.

Domain Inventory Source Tab Context Menu

Right-click in the Source page to display a context menu with the following options:

Domain Inventory Report Tab

The Domain Inventory Report page displays all of the information contained in the Domain Inventory Overview page, in a printer friendly format. This page also has a system menu of options for exporting, printing, creating a desktop shortcut for the page, adding the inventory to your favorites list, and other file operations. Right-click anywhere in the Report page to display this menu. Some options may not be applicable in this context.

Related Tasks

Related Reference

Evaluation Summary View

The Evaluation Summary View displays the contents of a selected Evaluation Summary document. An Evaluation Summary is created each time you evaluate a domain, and is persisted in the Guardian Workspace. For more information, see Evaluation Summary in the section “About Oracle Guardian.” For instructions on conducting evaluations, see Inventories and Evaluations in Tasks.

You can use either of the following methods to display an Evaluation Summary:

The Evaluation Summary View contains the following tabs:

The following sections describe the contents of each of these tab pages.

Evaluation Summary Overview Tab

The Overview page displays the results data for the selected Evaluation Summary, which includes a table of all signatures detected in the Evaluation. You can click on a signature entry in the table to view the Description and Remedy information for that signature. The Description and Remedy information is displayed in the lower half of the Overview page, just below the Detected Signatures table. You can expand or collapse a View section by clicking the triangle icon in the heading.

The Evaluation Summary Overview page contains the following sections:

These are described in the following sections.

General Information Section

The General Information section of the Evaluation Summary View contains the following information:

Detected Signatures Table

The Detected Signatures Table contains the list of signatures detected for this domain for this evaluation, and some additional information about each detected signature.

Select a signature entry in the table to display the details for that signature in the Description and Remedy sections of the View. Details for the first entry are displayed by default.

Click on a table column heading to sort the table contents according to that column order. The default sort order is by Severity and then Name.

The Detected Signatures Table contains the following information for each detected signature:

Evaluation Summary Signature Severity Icons

To the left of each signature title in the Severity column of the table is a Signature Severity icon. The icon indicates the severity level for that signature.

The following table describes the Signature Severity icons:

Table 3-33 Signature Severity Icons

Icon	Severity
	Critical
	Warning
	Informational

Detected Signatures Table Context Menu

Right-click on a signature title in the Detected Signatures table to open a context menu with the following options:

Description Section

The Description section of the Evaluation Summary View is the left panel below the Detected Signatures table. Select a signature entry in the Detected Signatures table to display the Description details for that signature. This section contains the following information:

Remedy Section

The Remedy section of the Evaluation Summary View is located below the Detected Signatures table, on the right side. Select a signature entry in the Detected Signatures table to display the Remedy details for that signature.

The Remedy section contains the following information:

Evaluation Summary Overview Tab Context Menu

Right-click on a signature title in the Detected Signatures table to open a context menu with the following options:

Evaluation Summary Source Tab

The Evaluation Summary Source tab page displays the XML source for the selected Evaluation Summary. This page also has a context menu of options for saving, copying, and printing the inventory XML source.

Evaluation Summary Source Tab Context Menu

Right-click in the Source page to display a context menu with the following options:

Evaluation Summary Report Tab

The Evaluation Summary Report page displays all of the information contained in the Evaluation Summary Overview page, in a printer friendly format. This page also has a system menu of options for exporting, printing, creating a desktop shortcut for the page, adding the inventory to your favorites list, and other file operations. Right-click anywhere in the Report page to display this menu. Some options may not be applicable in this context.

Related Tasks

Related Reference

Text Compare View

The Text Compare View enables you to view two Domain Inventories or two Evaluation Summaries, side-by-side. You can compare inventories or evaluations from the same or different domains. Both objects must be of the same type—that is, two inventories or two evaluations. You cannot compare an inventory against an evaluation.

To display the Text Compare View, do the following:

The Text Compare navigation controls are as follows:

Text Compare View Context Menu

Right-click in the left or right Text Compare View panel to display the Text Compare context menu. This menu has the following options:

Related Tasks

Related Reference

Signature View

The Signature View displays some basic descriptive and target information for a selected signature. For information on viewing the entire contents of a signature, see Evaluation Summary View.

Double-click on a signature entry in the Signature Explorer or Bundle Explorer to display this View.

The Signature View contains the following tabs:

The following sections describe the contents of each of these tab pages.

Signature View Overview Tab

The Signature View Overview tab page displays some basic descriptive and target information for the signature. For information on viewing the entire contents of a signature, see Evaluation Summary View.

The Signature View Overview page contains the following sections:

Signature View Source Tab

The Signature View Source tab page displays the complete XML source for the selected signature. This page also has a context menu of options for saving, copying, and printing the inventory XML source.

Signature View Source Tab Context Menu

Right-click in the Source page to display a context menu with the following options:

Signature View Report Tab

The Signature View Report page displays all of the information contained in the Signature View Overview page, in a printer friendly format. This page also has a system menu of options for exporting, printing, creating a desktop shortcut for the page, adding the inventory to your favorites list, and other file operations. Right-click anywhere in the Report page to display this menu. Some options may not be applicable in this context.

Related Tasks

Related Reference

Signature Bundle View

The Document Pane Signature Bundle View displays a description and some additional details about the selected Signature Bundle. This also includes the Signature Definition for the Bundle, which determines which signatures are included in the Bundle.

To open the Signature Bundle View, double-click on a Bundle Node in the Bundle Explorer.

The Signature Bundle View has the following tabs:

The following sections describe the contents of each of these tab pages.

Signature Bundle View Overview Tab

The Signature Bundle View Overview page displays a description and some additional details about the selected Signature Bundle.

The Overview page contains the following sections:

Signature Bundle View Report Tab

The Signature Bundle View Report page displays all of the information contained in the Signature Bundle View Overview page, in a printer friendly format. This page also has a system menu of options for exporting, printing, creating a desktop shortcut for the page, adding the inventory to your favorites list, and other file operations. Right-click anywhere in the Report page to display this menu. Some options may not be applicable in this context.

Related Tasks

Related Reference

Active Domains Table

The Active Domains Table is a Document View for managing the domains currently activated in Guardian.

You can use either of the following methods to open the Active Domains Table:

The Active Domains Table contains the following information for each active domain:

By default, the domains are listed alphabetically by domain name. Click a column heading to sort the table entries according to the sort order for that column. Click a column heading again to alternate between ascending or descending order.

Active Domains Table Toolbar Buttons

The Active Domains Table toolbar contains the following buttons:

Related Tasks

Related Reference

Shortcuts Table

The Shortcuts Table is a Document Pane View for viewing and managing the Evaluation Shortcuts you have created.

To open the Shortcuts Table, go to the Main Menu Bar and select Window > Show View > Shortcuts Table.

The Shortcuts Table contains the following information for each Shortcut:

By default, the Shortcuts are listed alphabetically by Shortcut name. Clicking a column heading sorts the Shortcuts according to the sort order for that column. For example, clicking the Domain column orders the Shortcuts alphabetically by domain name. Clicking the same column heading in succession alternates between ascending and descending order.

Shortcuts Table Toolbar

The Shortcuts Table toolbar contains the following buttons:

Related Tasks

Related Reference

Preferences

The Preferences page enables you to customize your Oracle Guardian environment.

You can use either of the following methods to open the Preferences page:

Preference parameters are organized into primary and secondary categories, or pages. The left pane of the Preferences page contains a Navigation Tree listing these pages, in hierarchical order. Click on a category title in the tree to display that page. For instructions on setting Preferences, see Preferences in Tasks.

The following table provides an overview of the Preferences pages.

Related Tasks

Related Reference

Wizards

Oracle Guardian provides the several wizards for guiding you through some of the more common or complex Guardian tasks.

The following table describes the Guardian wizards and how to invoke them.

Wizard Titlebar Menus

Right-click a wizard titlebar to open a context menu of options to Move, Size, or Close the wizard. You can also move or resize a Wizard by dragging the titlebar or window borders.

Annotations Wizard

Use the Annotations Wizard to create an annotation for a selected signature.

To open the Annotations Wizard, first navigate to a signature list containing the signature you want to annotate. Then right-click on the signature title and select Annotations > Manage Annotations from the context menu.

For instructions on using this wizard, see Signature Annotations in Tasks.

The Annotations Wizard contains the following elements:

Annotations Table

The Annotations Wizard contains an Annotations table listing the annotations that exist for the selected signature.

The Annotations table contains the following information for each annotation in the list:

Related Tasks

Related Reference

Bundle Evaluation Wizard

Use the Bundle Evaluation Wizard to preselect a domain and Bundle for Evaluation, and then initiate the evaluation.

To open the Bundle Evaluation Wizard, do the following:

For instructions on using this wizard, see Evaluate Bundles in Tasks.

The Bundles Evaluation Wizard contains the following sections and fields:

Related Tasks

Related Reference

Domain Activation Wizard

Use the Domain Activations Wizard to activate a domain in Guardian.

You can use any of the following methods to open the wizard:

For complete instructions on using this wizard, see Activate Domain in Tasks.

The Domain Activation Wizard contains the following tabs:

These are described in the following sections.

General Tab

The General tab contains the following fields:

Advanced Tab

The Advanced tab contains the following fields and options:

Related Tasks

Related Reference

Domain Deactivation Wizard

You can use either of the following methods to open the Domain Deactivation Wizard:

Select a domain and click Finish to deactivate the domain.

For complete instructions on using this wizard, see Deactivate Domain in Tasks.

The Domain Deactivation Wizard contains the following fields:

Related Tasks

Related Reference

Evaluation Wizard

Use the Evaluation Wizard to evaluate a domain. You can select one or more domains for evaluation.

You can use any of the following methods to select a domain and open the wizard:

For complete instructions on using this wizard, see Evaluate Domain in Tasks.

The Evaluation Wizard contains the following fields:

Related Tasks

Related Reference

Filters Wizard

Use the Filters Wizard to specify which signatures to display in signature lists.

You can use either of the following methods to open the wizard:

For complete instructions on using this wizard, see Filter Signatures in Tasks.

The Filters Wizard contains the following sections and fields:

Related Tasks

Related Reference

Inventory Wizard

Use the Inventory Wizard to inventory a domain.

You can use any of the following methods to open the wizard:

For a description of Domain Inventories, see Domain Inventory in About Oracle Guardian. For instructions on using the Domain Inventory Wizard, see Inventory Domain of Tasks.

The Inventory Wizard contains the following sections and fields:

Related Tasks

Related Reference

Shortcut Wizard

Use the Shortcut Wizard to create an Evaluation Shortcut.

You can use any of the following methods to open the wizard:

For a description of Shortcuts, see Shortcut in About Oracle Guardian. For instructions, see Create Shortcut in Tasks.

The Shortcut Wizard contains the following sections and fields:

Related Tasks

Related Reference

Shortcut Evaluation Wizard

Use the Shortcut Evaluation Wizard to evaluate a selected Shortcut.

You can use any of the following methods to open the wizard:

For a description of Shortcuts, see Shortcut in About Oracle Guardian. For instructions, see Evaluate Shortcut in Tasks.

The Shortcut Evaluation Wizard contains the following sections and fields:

Related Tasks

Related Reference

Service Request Wizard

You can use the Service Request Wizard to create a service request archive based on a detected signature, which can be submitted to Oracle Customer Support at your convenience.

To open the Service Request Wizard, do the following:

For a description of a Guardian Service Request Archive, see Support Service Request in About Oracle Guardian. For instructions on using the wizard, see Creating a Service Request Archive in Tasks.

The Service Request Wizard presents a series of pages that guide you through the service request creation process. These pages are as follows:

Related Tasks

Related Reference

Update Wizard

Use the Update Wizard to update your Guardian software and signature Bundles.

You can use either of the following methods to open the wizard:

For a description of this feature, see Update Guardian in About Oracle Guardian. For instructions on using the wizard, see Automatically Update Guardian in Tasks.

The Update Wizard presents a series of pages that guide you through the update process. The following table describes each of these pages.

Related Tasks

Related Reference

Log Files

The Oracle Guardian log files contain information that Oracle Customer Support can use to diagnose and resolve issues with your Guardian system.

The Guardian log files are as follows:

Related Tasks

Related Reference

Command Line Interface

The Guardian Command Line Interface (CLI)—also referred to as Guardian Headless Mode—is a set of Guardian commands that can be issued directly from the operating system command prompt. There is a Guardian CLI command for each of the most common tasks you can perform using the Guardian User Interface.

The Guardian command interpreter is an executable .cmd batch file for Windows, and a .sh shell script for Linux. Both the Windows batch file and the Linux shell script are wrappers that accumulate and organize arguments to the Java command.

For instructions on starting and using the Command Line Interface, see Command Line Interface in Tasks.

Important Notes

The following are some guidelines for using the Command Line Interface. For complete instructions on using the CLI commands, see Command Line Interface in Tasks.

The following section provides an overview of the Command Line Interface commands.

Overview of CLI Commands

The following table provides a brief description of each of the Guardian Command Line Interface commands. For a detailed description and syntax for each command, see CLI Command Reference.

See Overview of CLI Commands for a detailed description of each of these commands.

CLI Command Reference

This section describes the syntax, arguments, and usage for each of the Command Line Interface commands. For instructions on starting and using the Command Line Interface, see Command Line Interface in Tasks.

activateDomain

Activate the specified domain and return the domain identifier.

activateDomain -t targetUrl -u username -p password 
[ -c persistCredentials ] [ -data workspaceDir ] [ -x proxy ] 
[ -m maxAgentThreads ] [ -o agentThreadTimeoutSecs ]