# Installation Guide

# Post-Installation Information

This section provides the following topics:

- Understanding the WLOC Product Directory Structure
- The WLOC Windows Shortcuts
- Upgrade Patches
- Determining Which Software Versions You Are Using

## Understanding the WLOC Product Directory Structure

During the product installation, you are asked to select or create a BEA Home directory and a product installation directory. For information about the BEA Home directory, see Choosing a BEA Home Directory. For a complete installation, the installation program creates a dedicated directory structure for the Oracle software. It may or may not reside in the BEA Home directory.

WARNING: | The use of spaces in the BEA Home directory (`BEA_HOME`) and the WLOC product directory name (`WLOC_HOME`) are not supported.

Table 4-1 describes the contents of the directories created when WLOC is installed in an existing BEA Home directory.

Table 4-1 WLOC Product Directory Structure
Directory | Description
coherence | Smart Pack definitions intended for use with Coherence 3.4 are bundled in the `coherence-wloc.jar` file. See Setting Up a Coherence Management Gateway in the WLOC Configuration Guide.
`common` | Scripts used for setting environment attributes for the utilities and template JAR files used by the Configuration Wizard offline when creating the WLOC Controller and Agent components.
`console` | WLOC administration console.
`inventory` | Installation metadata.
`modules` | WLOC-specific modules for executing the WLOC Controller and Agent components.
`schemas` | XSD schemas for WLOC components.
`uninstall` | Uninstall script for removing WLOC components.

Note: | The `WLOC-Licenses.doc` file located in the `WLOC_HOME` directory contains information about third-party software installed along with WLOC. The file is named `WLOC-Licenses.txt` on non-Windows platforms.

## The WLOC Windows Shortcuts

When you install your WLOC software as an Administrator on a Windows system, the installation program offers to creates shortcut entries on the Start Menu. You can select from the following options:

- All Users Start menu folder

Selecting this option provides all users registered on the machine with access to the installed software. However, only users with Administrator privileges can create shortcuts in the All Users folder. Therefore, if a user without Administrator privileges uses the Configuration Wizard to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired. Press ALT+Y on the keyboard to select the All Users Start Menu.

- Local user’s Start menu folder

Selecting this option ensures that other users registered on this machine will not have access to the Start menu entries for this installation. Press ALT+N on the keyboard to select the Local User’s start menu.

Notes: |

- The installer offers to create shortcuts only if you are performing an initial installation.
- The Windows Start Menu icons for WLOC are not installed under BEA Products even when WLOC is installed into an existing BEA Home.

The folder that the WLOC installer creates (Start > All Programs > WebLogic Operations Control 10gR3) contains the following shortcut files:

- WLOC Configuration Wizard—Creates WLOC Controller and Agent components. See the Configuration Guide.
- Uninstall WebLogic Operations Control—Launches the uninstallation program. For more information, see Uninstalling WLOC.
- Smart Update—launches the Smart Update program, which checks for any updates available for the WLOC installation and installs the updates as required.

## Upgrade Patches

For information about software updates, see Installing Maintenance Updates and Service Packs.

## Determining Which Software Versions You Are Using

You can determine the versions of the WLOC software, Controller, and Agents in your environment using the `version` command, as follows:

1. Open a command prompt window and change to the following directory:

`WLOC_HOME``\common\bin` (Windows)
`WLOC_HOME``/common/bin` (UNIX)

where `WLOC_HOME` specifies the location of your WLOC installation, such as `bea\wloc_10.3`.

2. Enter the `version` command at the prompt, specifying one of the following arguments, as required.

Table 4-2 Command-line Arguments for the version Command
This argument . . . | Displays . . .
`-fullversion` | Full version of the WLOC software. This is the default.
`-version` | Version of the WLOC software only.
`-agent` | Full version of the WLOC Agent.
`-controller` | Full version of the WLOC Controller.
`-help` | This help.

For example:

    C:\bea\wloc_10.3\common\bin> version -controller
    Oracle WebLogic Operations Control Controller 10.3.0.0 - Tue Sep 2 02:45:33 EDT 2008 128886