Creating and running an apply request for Oracle
Because of the command-line interface, generating an apply request for an Oracle target can be as simple as typing a command.
Before you begin
Before you perform the tasks in this section, you should be familiar with the default path and configuration file for the High-speed Apply Engine for UNIX or for Windows. For more information, see File names for UNIX and Windows.
When you are configuring High-speed Apply Engine, be sure that the shared library environment variable is set to enable High-speed Apply Engine to run correctly. The name of the environment variable depends on your operating system, as shown in Shared library environment variable values: Oracle. In this table, installationDirectory refers to the directory where High-speed Apply Engine was installed. The platform is the UNIX platform chosen during the installation (aix, sol). The v.r.m is the version, release, and maintenance level of High-speed Apply Engine.
You should also become familiar with the examples/oracle subdirectory in the installation directory when you are configuring High-speed Apply Engine. The examples/oracle subdirectory contains a sample apply request. The installation directory is the UNIX or Windows directory that you specified for High-speed Apply Engine during installation.
You can manually set these environment variables and run High-speed Apply Engine by invoking apebmain (for more information, see To run an Apply request for Oracle), or you can use the sample scripts in the installation root directory (installationDirectory/HighSpeedApply/platform/v.r.m).
You must update the BMC Software registry before you can use the sample scripts in the installation root directory. For more information, see Installing High-speed Apply Engine on UNIX or Windows.
The sample scripts in the installation root directory are named apeenv and HighSpeedApply:
The apeenv script originates from the profile and sets the environment variables required to run High-speed Apply Engine. You need to make specific reference to apeenv only once during your login session by typing .apeenv (a period followed by a space, then apeenv) at the command prompt.
You can use the HighSpeedApply script to run High-speed Apply Engine without having to set the path and shared library path. Using the HighSpeedApply script is the easiest way to run High-speed Apply Engine. It accepts the same parameters you specify to the High-speed Apply Engine executable command (apebmain), including the overrides to the parameters in the configuration file. BMC Software recommends that you move the HighSpeedApply script to one of the default directories in your path or your group's path.
To run an Apply request for Oracle
- At the command prompt, type apebmain.
- Verify the name and location of the configuration file, as follows:
If the file uses the default path and file name, skip to Step 4.
If the file does not use the default path and file name, go to Step 3.
If you are not using a configuration file, enter cfn=none and skip to Step 4.
(You do not need a configuration file if you accept all High-speed Apply Engine default values, or if you enter all nondefault values as overrides on the command line.)
- Enter the name of the configuration file, using the FileName (CFN) parameter. (For an example, see UNIX and Windows command line.)
If the configuration file is in the current directory, type the file name. Otherwise, you must type the complete path and file name for the configuration file. You can specify only one configuration file in an apply request for an Oracle target.
- Add any configuration overrides required for the request.
You can include as many overrides as necessary to complete the apply request. Separate each section name and parameter with a single space.
- Press Enter to start processing the apply request.