Skip Headers

Oracle® Audit Vault Collection Agent Installation Guide Release 10.2.3 Part Number E11057-02 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| View PDF

# 4 Upgrading an Oracle Audit Vault Agent

This chapter describes the procedure to upgrade an Oracle Audit Vault Agent installation from release 10.2.2.1.0 or lower to release 10.2.3.0.0. This chapter covers the following topics:

- Back Up and Recovery of Oracle Audit Vault Collection Agent Files

- Upgrade Requirements

- Upgrade Procedure

- Performing a Silent Upgrade Installation Using a Response File

- Post Upgrade Information

## 4.1 Back Up and Recovery of Oracle Audit Vault Collection Agent Files

Oracle Audit Vault Collection Agent upgrade installation does not have the ability to be rolled back, therefore you should take precautions to backup the files before the upgrade is performed until you have tested the upgrade installation.

Back Up Audit Vault Collection Agent Home

Because the upgrade installation will update files in the Audit Vault Collection Agent home, these files should be backed up or copied to another directory until the upgrade installation has been tested.

Abandon the Upgrade

If the upgrade installation is not successful, to abandon the upgrade, copy (Restore) the Audit Vault Collection Agent home files back.

## 4.2 Upgrade Requirements

Note:

On the Solaris Operating System (SPARC 64-bit) platform before performing an upgrade operation from Audit Vault Agent release 10.2.2.1.0 to release 10.2.3.0.0, you must set the write permissions for the `$ORACLE_HOME/jre` folder as follows; otherwise, a write permission error is returned for the `../jre/../` files during the upgrade.

    chmod -R u+w jre

The only requirement for upgrading your Audit Vault Agents to release 10.2.3.0.0 is that you must have already upgraded the associated Audit Vault Server for these Agents to release 10.2.3.0.0. This is essential to maintain compatibility between these Audit Vault Agents with the most current version of the associated Audit Vault Server. In other words, you cannot upgrade an Audit Vault Agent to release 10.2.3.0.0 without first upgrading its associated Audit Vault Server to this release because the Audit Vault Agent would not be compatible nor would it work with the older associated release 10.2.2.1.0 or lower Audit Vault Server.

The rule of thumb is that an older, installed Audit Vault Agent will always work with the most current installed release of the Audit Vault Server that is either of the same release or higher; this is called upward compatibility of the older Audit Vault Agent with the newer Audit Vault Server. For example, a release 10.2.2.1.0 Oracle Audit Vault Agent would be compatible with a release 10.2.3.0.0 Audit Vault Server.

However, on the contrary, a release 10.2.3.0.0 Audit Vault Agent would not be compatible nor would it work with a release 10.2.2.1.0 or lower Audit Vault Server. For example, neither an upgraded release 10.2.3.0.0 Audit Vault Agent nor a fresh installation of a release 10.2.3.0.0 Audit Vault Agent would be compatible with a release 10.2.2.1.0 or lower Oracle Audit Vault Server.

## 4.3 Upgrade Procedure

To upgrade to Oracle Audit Vault Agent release 10.2.3, you must follow this sequence of steps to shut down Audit Vault components, perform the upgrade, then start up Audit Vault components:

1. Set the `NLS_LANG` environment variable.

   Note:

   This step is not necessary if the October 2007 or later Oracle CPU has been applied to Audit Vault Agent release 10.2.2.1 or lower.

2. Stop all collectors running within the context of the agent you are upgrading.

3. Stop the agent you are upgrading.

4. Stop Agent OC4J that houses the agent you are upgrading.

5. Perform the upgrade to Oracle Audit Vault Agent release 10.2.3.0.0.

6. Start the upgraded agent.

7. Start the collectors that run in the upgraded agent.

8. Monitor the Audit Vault System.

Details of each of these steps follows.

Step 1: Set the NLS_LANG Environment Variable

Set the `NLS_LANG` environment variable to the same value that was used during the base installation of Oracle Audit Vault release 10.2.2.0.0 or lower.

Step 2: Stop All Collectors Running Within the Context of the Agent You Are Upgrading

All collectors associated with the Audit Vault Agent being upgraded must be stopped.

From the Audit Vault Server home with `ORACLE_HOME`, `ORACLE_SID`, and `PATH` environment variables properly set for the Audit Vault Server home, use the following command syntax to stop each collector.

    avctl stop_collector -collname collector-name -srcname source-name

Step 3: Stop the Agent You Are Upgrading

The agent associated with the Audit Vault Agent being upgraded must be stopped.

From the Audit Vault Server home with `ORACLE_HOME`, `ORACLE_SID,` and `PATH` environment variables properly set for the Audit Vault Server home, use the following command syntax to stop each agent.

    avctl stop_agent -agentname agent-name

Step 4: Stop the Agent OC4J That Houses the Agent You Are Upgrading

The Agent OC4J associated with the Audit Vault Agent you are upgrading must be stopped. There is one Agent OC4J associated with each agent.

From the Audit Vault Agent home with `ORACLE_HOME`, `ORACLE_SID, PATH, LD_LIBRARY_PATH` (for Linux x86, Linux x86-64, and Solaris SPARC_64), `SHLIB_PATH` (for HP-UX PA RISC and HP Itanium), or `LIBPATH` (for AIX) environment variables properly set for the Audit Vault Agent home, use the following command syntax to stop the Agent OC4J.

    avctl stop_oc4j

Step 5: Perform the Upgrade to Oracle Audit Vault Agent Release 10.2.3.0.0 in the Audit Vault Agent Home

Perform the following steps to perform the upgrade to Oracle Audit Vault Agent release 10.2.3.0.0 in the Audit Vault Agent home:

1. Locate the Oracle Audit Vault Agent release 10.2.3 media and mount the media.

2. Start Oracle Universal Installer (OUI) from the directory where the runInstaller program is located.

       cd directory-containing-Oracle-Audit-Vault-Agent-Installation-Files
       ./runInstaller

3. On the Oracle Audit Vault Agent Installation Select Installation Type window, when the installer detects an upgradable release, it automatically selects the Upgrade Existing Audit Vault Agent Home option and displays the upgradeable home path specifications. If there is more than one upgradable path to upgrade, review the path names, and select the path specification to upgrade. Then click Next.

4. The Summary Page screen is displayed. Check the space requirements. Note that 33 MB of space is required to install Patch Set 1 along, which includes 27 MB of temporary space. Next, review each of the items that are about to be installed. Click Install.

5. The Configuration Assistant screen appears and proceeds to apply Audit Vault Agent one-off patches and then the Audit Vault Upgrade Assistant runs some AVCA scripts to continue the release 10.2.3 upgrade installation.

6. On the End of Installation screen, you should see a message indicating a successful installation. Click Exit to exit the Oracle Universal Installer. Then on the Exit confirmation screen for the prompt "Do you really want to exit?", click Yes to confirm the exit operation.

Step 6: Start the Upgraded Agent

From the Audit Vault Server home with `ORACLE_HOME`, `ORACLE_SID`, and `PATH` environment variables properly set for the Audit Vault Server home, use the following command syntax to start the upgraded agent.

    avctl start_agent -agentname agent-name

Step 7: Start the Collectors That Run in the Upgraded Agent

From the Audit Vault Server home with `ORACLE_HOME`, `ORACLE_SID, PATH, LD_LIBRARY_PATH` (for Linux x86, Linux x86-64, and Solaris SPARC_64), `SHLIB_PATH` (for HP Itanium), or `LIBPATH` (for AIX) environment variables properly set for the Audit Vault Server home, use the following command syntax to start each collector that runs in the upgraded agent.

    avctl start_collector -collname collector-name -srcname source-name

Step 8: Monitor the Audit Vault System

This step is a reminder to monitor the Audit Vault system to ensure all Audit Vault components are running and the system is operational.

## 4.4 Performing a Silent Upgrade Installation Using a Response File

Follow these brief steps to perform a silent upgrade installation using a response file:

1. Make sure all prerequisites are met for the installation of Audit Vault Agent.

2. Prepare the Audit Vault Agent response file. A template response file can be found at `<AV agent installer location>/response/upgrade_avagent.rsp` on Linux and UNIX-based systems at the Audit Vault Agent installation media and at `<AV agent installer location>\response\upgrade_avagent.rsp` on Windows systems at the Audit Vault Agent installation media.

   Prepare the response file by entering values in the first part of the response file for all parameters, then save the file. Do not edit any values in the second part of the response file.

3. Invoke Oracle Universal Installer using the following options:

   For Linux and UNIX-based systems:

       ./runInstaller -silent -responseFile <Path of response file>

   For Windows systems:

       setup.exe -silent -responseFile <Path of response file>

   In this example:

   `Path of response file` identifies the full path of the response file.

   `-silent` runs Oracle Universal Installer in silent mode and suppresses the Welcome window.

   For more information about these options, see Section 1.1.2. For general information about these options and about how to complete an installation using these response files, see the platform specific Oracle Database installation guides and Oracle Database Oracle Clusterware and Oracle Real Application Clusters Installation Guide for Linux and "Installing Oracle Products" in Oracle Universal Installer and OPatch User's Guide for more information about installing and using response files.

## 4.5 Post Upgrade Information

Note that after performing an Oracle Audit Vault Agent upgrade, because the upgrade is an inplace upgrade, the original directory structure is still in use. This means that the `ORACLE_HOME`, `ORACLE_SID, PATH, LD_LIBRARY_PATH` (for Linux x86, Linux x86-64, and Solaris SPARC_64), `SHLIB_PATH` (for HP-UX PA RISC and HP Itanium), or `LIBPATH` (for AIX) environment variables are the same as they were prior to the upgrade.

See Section 3.4 for any additional post upgrade installation tasks.