|
|
The following sections provide information for starting the Guardian User Interface and Guardian Command Line Interface (Guardian Headless Mode):
Oracle Guardian has two modes of operation:
The Guardian is located in the Guardian installation home directory. For example:
<Guardian_Root>\guardian.exe
<Guardian_Root> is the Guardian installation directory. See
Each time you start the Guardian User Interface, you are prompted to select a Guardian Workspace. If you do not want to select the Workspace each time you start Guardian, you can specify a default location and select an option to skip this process in the future. Instructions are provided below. For a description of the Guardian Workspace, see “Chapter 1: About Guardian” in the Guardian User Guide.
To start Guardian and select a Workspace, do the following:
Select Start > Oracle Guardian > Guardian or double-click on guardian.exe in your Guardian installation home folder.
Change directories to the installation directory, and enter the following command:
Guardian first displays the initial splash screen while loading, and then displays the Select Workspace dialog box.
IMPORTANT: Do not place this folder within the Guardian installation directory. Otherwise, when conducting automatic updates of Guardian, your Workspace will be overwritten and the data will be lost. In addition, if you are upgrading from a previous Guardian release and have not yet imported your old Workspace, do not select the default, as that may overwrite the old contents. Make sure that you select a location that is different than the Workspace used by the previous version.
To use an existing folder: Click Browse to open a directory browser from which you can select the folder.
If you do not want to select the Workspace each time you start Guardian, select the checkbox for Use this as the default workspace and do not ask again.
| Note: | You can change this setting at a later time by selecting Prompt for workspace on startup in the Guardian Preferences configuration page. For instructions, open the Online Help and select Tasks > Workspaces > Select Workspace. |
Guardian loads the selected Workspace and completes the startup procedure.
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 almost every task available in the Guardian User Interface. For a complete description of these commands and their syntax, see the Guardian 1.1 Online Help and the Guardian User Guide.
To start the Guardian Command Line Interface, do the following:
| Note: | Guardian Command Line Interface commands are case sensitive. |
The Command Line Interface uses your specified Guardian Workspace as the location for all CLI operations, unless you specify otherwise in each command. Identifying the Guardian Workspace location is essential for accessing the correct set of active domains, Domain Inventories, and Evaluation Summaries. For instructions on selecting a Guardian Workspace, see the Guardian User Guide and Guardian Online Help.
The following are some examples of Guardian Headless command lines:
guardianHeadless.cmd -g listActiveDomains guardianHeadless.cmd -g activateDomain -t http://localhost:9116 -u un -p pw -c true -data "D:\MyData\Guardian Data Directories\
Installer-2079" guardianHeadless.cmd -g createShortcut -d Naxos_localhost_9116 -b 2 guardianHeadless.cmd -g deleteShortcut -s "Security Advisories in Naxos" The output of each command is sent to the following output file:
The output file is created in your current directory, and is overwritten each time you run a Guardian Headless Mode command.
For a complete list of Guardian Command Line Interface commands and syntax, see the Guardian User Guide and the Online Help.
|