Skip Headers
Oracle® Beehive Installation Guide
Release 2 (2.0.1.8) for Microsoft Windows x86

Part Number E16642-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

5 Oracle Beekeeper Installation Help

Run setup.exe (Microsoft Windows) or runInstaller (UNIX-based operating systems) from the Oracle Beekeeper installation media to start the Install Wizard for this product.

Refer to "Starting the Oracle Beekeeper Uninstall Wizard" to uninstall Oracle Beekeeper.

Product Selection Sequence of Screens

The following screens appear before product selection:

Once you select a product type, you will proceed to "Oracle Beekeeper Sequence of Screens".

Note:

In Microsoft Windows, ensure the following before installing or upgrading Oracle Beekeeper:
  • Ensure that there is only one window session (desktop) is present. Close all other window sessions. Many window sessions can be opened with Windows Remote Desktop or Virtual Network Computing (VNC) applications.

  • Ensure that you have closed all Windows Explorer windows, unnecessary applications, and command prompts. These may interfere with the upgrade process, especially if Windows Explorer or a command prompt is pointing to the directory <Oracle home>\j2ee.

Welcome

The Welcome screen is the first screen of the Oracle Install Wizard. It will guide you through the installation and configuration of Oracle Beekeeper.

The following describes the buttons that appear on most of the installation screens:

  • Click Help to view the online help.

  • Click Save to save the inputs you have entered to a file that you can use later as a response file. You can use this response file to continue the installation at a later time.

  • Click Back to go back to the previous step.

  • Click Next to go to the next step.

  • Click Install to start the installation of the product.

    This button is available only on the Summary screen.

  • Click Uninstall to uninstall a previously installed Oracle Beekeeper product

  • Click Cancel to exit from the Oracle Install Wizard at any time during the installation.

Tip:

Press F1 to open the online help section for the field where your cursor focus is on the installation screen.

New Inventory Location

If Oracle Beekeeper is the first Oracle product you are installing on a computer, then this screen is displayed.

On this screen, you specify in the Inventory Directory Path field the location of an inventory directory (the oraInventory directory). The Install Wizard will use this inventory directory to keep track of all Oracle products installed on the computer.

Note:

The following notes are about the inventory directory:
  • If an Oracle product was installed previously on the computer, then the Install Wizard uses the existing inventory directory. To ensure that you have write permissions on that directory, run the Install Wizard as the same operating system user who installed the existing Oracle product.

  • The inventory directory location should be different from the directory path in which you are going to install Oracle Beekeeper.

  • The Install Wizard (as well as other installation programs from other Oracle products) will store its log files in the directory <inventory directory path>/logs.

    However, if this is the first Oracle product you are installing on your computer, the Install Wizard will store its log files in a temporary directory, such as /tmp on Linux and UNIX-based operating systems. When you exit the Install Wizard, the Install Wizard will move these log files to <inventory directory path>/logs.

On Linux and UNIX-based platforms, specify in the Operating System Group field the operating system group that has the write permission to the target inventory directory location.

Select Product Type

Select which Oracle Beekeeper product you want to install:

  • Oracle Beekeeper: This option installs Oracle Beekeeper on the computer from which you are running the Install Wizard.

  • Provisioning Application for Oracle Beekeeper: This will allow you to install and configure Oracle Beekeeper from Oracle Enterprise Manager Grid Control.

    The prerequisite for installing this plug-in is that you must have a preinstalled instance of Oracle Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or later.

Oracle Beekeeper Sequence of Screens

The following screens appear during the installation of Oracle Beekeeper:

Specify Home Location

Enter the full path of the location where you want to install the product. Do not leave the Location field blank. The location you provide must not already be present in the Oracle inventory and must be empty.

Note:

You may not install Oracle Beekeeper into an existing Oracle home.

Prerequisite Checks

This screen displays the prerequisite checks that the Install Wizard runs. It verifies that the host (where you are installing Oracle Beekeeper) meets all minimum requirements.

Some of the platform-independent checks that the Oracle Beekeeper Install Wizard performs include:

  • Operating system certification

  • Kernel parameters

  • Recommended operating system packages

  • Available swap space

  • Recommended glibc version (Linux and UNIX-based operating systems)

  • libdb.so.2 exists (UNIX-based operating systems)

  • Sufficient file descriptors are allocated (Linux)

  • Disk space

  • In Microsoft Windows, ensuring that the Window user for Oracle Beekeeper installation has administrative privileges.

If an automatic check fails, fix it and click Retry.

Note:

If the disk space check fails and after clicking Retry (after fixing the low disk space issue) the check states "Not Executed," exit the Install Wizard and start it again.

In Microsoft Windows, the Windows user indicated in the Browse and Select: File or Directory screen must belong to the "Log on as a batch job" policy of the agent machine.

To add a user to this policy, click Start, Programs, Administrative Tools, and then Local Security Policy. In Local Security Settings, expand Local Policies, expand Local Policies, and then click User Rights Assignment. Double-click the policy Log on as a batch job. Click Add User or Group to add the user.

Tip:

For details on why a check failed, select the check box against it and see the details in the description box at the bottom of the screen.

Database Information

Specify the following details of an existing Oracle Beehive database that will be used by this installation:

Host and Port

Specify the fully qualified domain name (FQDN) of the host where the target database is running.

For example, if the host name is foo, its domain is abc.com, and the database listener port is 1521, then enter the following:

foo.abc.com:1521

The default port on which the database listener listens for connection requests is 1521.

To determine this port number, run the command <Database home>/bin/lsnrctl status. (Ensure that the environment variable ORACLE_HOME is set to the directory in which Oracle Database is installed and ORACLE_SID is set to the system identifier of your database.)

Service Name

Enter the service name for the Oracle database. This is the same as the global database name, and must be unique across all databases.

A database is identified by its global database name. The global database name is comprised of two parts:

database_name.database_domain

For example:

sales.us.yourcompany.com

Schema User Password

Enter the password for the Oracle Beehive database schema that is stored in the database whose information you have specified in this screen.

After clicking Next, the Install Wizard verifies the connection to the Oracle Database Server, initialization parameters, and other requirements. If an error occurs, then you must correct the problem before the installation process can continue.

Site Key Information

Enter the site key that you specified when you installed your first Oracle Beehive application tier.

Installation Summary

The Installation Summary screen presents a summary of the options you have specified so far:

  • Space Requirements: The disk space required to install the product. The space requirement appears in a different color if the disk space available is less than what is required.

    Note:

    The space requirements shown on this screen do not include the space required in the target database.

    The space requirements shown on this screen also might differ slightly from the actual space the component occupies on the installation disk. This is because of the differences in the disk configurations. For example, the space required on one hard drive might differ from the space required on another hard drive that uses different block size or that is managed by a different file system.

  • Inventory Location: The location of the oraInventory directory where all the installation information about your product will be stored.

  • Product: The name of the product you are installing, Oracle Beekeeper.

  • Interview Details: The details of your inputs for the other screens, such as:

    • Home Details: The location of the Oracle home where you are installing the product.

    • Database Information: The host name, port, service name, and masked schema user password of the existing Oracle Beehive database that will be used by this installation process.

    • Site Key: The masked site key that you entered.

When you have reviewed your inputs, click Install to continue.

Installation Process

Use this screen to monitor the installation process. Click Show Details to see the details in the description box that appears

Configuration Assistants

This screen displays the configuration assistants that the Install Wizard runs to install Oracle Beekeeper:

  • Oracle Beekeeper Initialization: Runs the Oracle Universal Installer clone method

  • Oracle Beekeeper Port Configuration: Ensures that the Oracle Beekeeper OC4J instance has dynamically allocated port values to ensure that no port conflicts occur with other processes after install

  • Oracle Beehive Control OC4J Configuration: Ensures proper java arguments are configured in the standard oc4j command

  • Oracle Beehive Control Service Creation: Establishes the Oracle Beekeeper service in the Oracle Beehive repository

  • Starting OC4J Instance: Starts the OC4J container instance

  • Oracle Beekeeper Framework Deployment: Deploys the Oracle Beehive Framework application into the home instance

  • Oracle Beekeeper Application Deployment: Deploys the beehivecontrol.ear file into the home OC4J instance

  • Configuring OC4J Application Settings: This modifies the OC4J related configuration files for Oracle Beekeeper operation

  • Stopping OC4J Instance: Stops the OC4J instance

  • Starting OC4J Instance: Starts the OC4J container instance

End of Installation

This screen indicates if the installation of Oracle Beekeeper was successful.

Starting the Oracle Beekeeper Uninstall Wizard

Start the Oracle Beekeeper Uninstall Wizard by running setup.exe -uninstall from the installation media.

Oracle Beekeeper Uninstall Wizard Sequence of Screens

The following screens appear during the uninstallation of Oracle Beekeeper:

Select Oracle Home to Uninstall

This screen lists all the Oracle Beekeeper instances you have installed and their respective Oracle homes.

Select the Oracle Beekeeper home you want to uninstall.

This screen will not appear if you started the uninstall process by running the Config Wizard. In this case, the Config Wizard will uninstall the current Oracle home.

Start Uninstallation

This screen will list actions that the Oracle Beekeeper Uninstall Wizard must perform to uninstall your chosen Oracle Beekeeper instance.

Note:

If you started the uninstall process with the Config Wizard, the "Delete Oracle Home" action will not be displayed. This action will be performed after you have exited the Config Wizard graphical user interface.

Click Start Uninstall to proceed with the uninstallation of your chosen Oracle Beekeeper instance.

Note:

On Microsoft Windows, if you receive an error message from the Oracle Beekeeper Uninstall Wizard that it was unable to delete the Oracle home folder, delete it manually, then restart your computer.

End of Uninstallation

This screen indicates that the uninstallation of the chosen Oracle Beekeeper instance is successful.