Skip Headers
Oracle® Beehive Installation Guide
Release 1 (1.5) for Microsoft Windows (32-Bit)

Part Number E14831-05
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
View PDF

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

Note:

Oracle Beekeeper version 1.5 is only supported by Oracle Beehive Release 1 (1.5).

Product Selection Sequence of Screens

The following screens appear before product selection:

Once you select a product type, you will proceed to one of the following 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

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 Beekeeper product

    Note:

    To uninstall Provisioning Application for Oracle Beekeeper, use Oracle Universal Installer from Oracle Management Service. Refer to "Uninstalling Provisioning Application for Oracle Beekeeper" for more information.
  • 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.

Notes:

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 4 (10.2.0.4) or later.

    See "Provisioning Application for Oracle Beekeeper Sequence of Screens" to continue installing Provisioning Application for Oracle Beekeeper.

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 (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 Beekeeper installation has administrative privileges.

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

Notes:

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.

    Notes:

    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.

End of Installation

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

Provisioning Application for Oracle Beekeeper Sequence of Screens

The following screens appear during the installation of Oracle Beekeeper Provisioning Application:

Specify Home Location

In the Location field, specify the full path of Oracle Management Service Oracle home in which you want to install Oracle Beekeeper Provisioning Application.

Oracle Management Service is part of Oracle Enterprise Manager Grid Control.

You may not leave the Location field blank.

Typically, the name of this directory is oms10g.

Repository Database Administrator Password

In the SYS Password field, specify the password for the SYS account of the repository database that Oracle Management Service uses.

This repository database will be used by Oracle Beekeeper Provisioning Application to store required information.

The screen displays the details of the Oracle Enterprise Manager Grid Control database that is used as the repository for the Oracle Beekeeper provisioning plug-in that you are installing. It displays the following information:

  • Host name where the Oracle database is installed

  • Port on which it listens to the incoming requests

  • System identifier (SID) that defines the name of the Oracle database instance

The Oracle Beekeeper Install Wizard verifies the password. If you specified an incorrect password, an error occurs. In this case, you must correct the password before the installation process can continue.

Software Library Location

This screen will only appear if a software library has not been configured for Oracle Enterprise Manager Grid Control.

Specify an absolute, non-empty directory path on the Oracle Management Service host that will be used as the software library location, for example, /app/oracle/gc_soft_library on Linux and UNIX-based systems and C:\app\oracle\gc_soft_library on Microsoft Windows. Oracle Enterprise Manager Grid Control uses the software library as a repository to store certified software images, such as Oracle Beehive.

Installation Summary

The Installation Summary screen presents a summary of the options you have selected so far. Depending on the installation, the information may include the following interview details:

  • Home Detail: The location of the Oracle home where you want to install your product. To change the Oracle home, go back to the Specify Home Location screen.

  • Repository Administrator Password: The masked password for the SYS account of the repository database that Oracle Management Service uses.

  • Software Library Location: The directory path on the Oracle Management Service host that will be used as the software library location by Oracle Enterprise Manager Grid Control.

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

Progress Indicator

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

Configuration Assistants

This screen displays the configuration assistants that the Oracle Beekeeper Install Wizard runs to configure Oracle Beekeeper Provisioning Application.

The Oracle Beekeeper Install Wizard performs the following configuration assistants:

  • Configuring Software Library (appears only if the Install Wizard prompted you for a software library location)

  • Packaging Product Home Zip

  • Repository Upgrade

  • OMS Redeployment

  • Deploy Provision Application

  • Start Oracle Management Server

If any configuration is flagged as Failed, then you must manually run the assistant to configure it. You do so by selecting the check box against it and clicking Retry.

Tip:

For details on why a configuration failed, select the check box against it and see the details in the description box at the bottom of the screen. Also, review the log files in <Oracle inventory directory>/logs whose names start with installActions.

End of Installation

The End of Installation screen indicates if the installation of Oracle Beekeeper Provisioning Application was successful.

Click Finish to complete the installation process and close the Oracle Beekeeper Install Wizard.

Refer to "Provisioning Oracle Beekeeper" to install Oracle Beekeeper with Oracle Beekeeper Provisioning Application.

Starting the Oracle Beekeeper Uninstall Wizard

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

Note:

To uninstall Provisioning Application for Oracle Beekeeper, use Oracle Universal Installer from Oracle Management Service. Refer to "Uninstalling Provisioning Application for Oracle Beekeeper" for more information.

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.

Uninstalling Provisioning Application for Oracle Beekeeper

Uninstall Provisioning Application for Oracle Beekeeper with the Oracle Universal Installer:

  1. Run Oracle Universal Installer from the Oracle Management Service home:

    • Linux and UNIX-based operating systems: <Oracle Management Service home>/oui/bin/runInstaller

    • Microsoft Windows: <Oracle Management Service home>\oui\bin\setup.exe

  2. Click Deinstall Products.

  3. In the Oracle Homes tree, expand the <OMS_HOME> node to view all installed components. Select the provisioning application for Oracle Beekeeper and click the Remove button.