Skip Headers
Oracle® Beehive Installation Guide
Release 1 (1.4) for Solaris Operating System (SPARC 64-Bit)

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

Go to previous page
Go to next page
View PDF

7 Oracle Beekeeper Installation Help

Run runInstaller (UNIX-based operating systems) or setup.exe (Microsoft Windows) 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.

Oracle Beekeeper Sequence of Screens

The following screens appear during the installation of Oracle Beekeeper:


This screen welcomes you to 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 Beehive product

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


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.


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.

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.


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 Beehive Install Wizard performs include:

  • Operating system certification (or version)

  • Operating system patches and packages

  • Security kernel parameters

  • Memory

  • Swap space

  • Disk space

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

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


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.


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, and the database listener port is 1521, then enter the following:

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:


For example:

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.

Installation Summary

The Upgrade 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.


    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, and service name of the existing Oracle Beehive database that will be used by this installation process.

    • Schema Password: The masked password for the Oracle database schema that you specified.

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.

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 the Oracle Beekeeper Install Wizard and clicking the Uninstall button. Alternatively, run the Oracle Beekeeper Config Wizard (or Oracle Beekeeper Install Wizard) with the -uninstall command-line option.

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 Beehive 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.


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.


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.