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

4 Oracle Beehive Install Wizard

The following sections describe the Oracle Beehive Install Wizard screens that appear during installation of Oracle Beehive:

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:

Welcome

This screen welcomes you to the Oracle Install Wizard. It will guide you through the installation and configuration of Oracle Beehive Release 1.

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 or perform a silent (non-interactive) installation.

    Refer to the module "Installing Oracle Beehive in Silent Mode (Non-Interactive)" in Oracle Beehive Installation Guide for detailed information about installing Oracle Beehive with a response file.

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

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 Beehive Release 1 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 Oracle Beehive 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 Oracle Beehive Install Wizard uses the existing inventory directory. To ensure that you have write permissions on that directory, run the Oracle Beehive 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 Beehive Release 1.

  • The Oracle Beehive 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

Choose how you want to install Oracle Beehive from one of the following options:

The sequence of the following screens depend on the option that you select on this screen.

Oracle Beehive Release 1

Use this option to perform a complete installation of Oracle Beehive Release 1 on the specified host.

Note:

One of the prerequisites for selection the Oracle Beehive Release 1 option is that you must have an existing instance of Oracle Database. This database is not installed by this procedure.

Refer to the module "Oracle Beehive Database Requirements" in the Oracle Beehive Installation Guide of your operating system for database requirements for Oracle Beehive Release 1.

See "Oracle Beehive (Standard Installation) Sequence of Screens" to continue installing Oracle Beehive Release 1.

Provisioning Application for Oracle Beehive Release 1

Use this option to install the Provisioning Application. This will allow you to install and configure Oracle Beehive Release 1 instances 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 "Oracle Beehive Provisioning Application Sequence of Screens" to continue installing Oracle Beehive Release 1 Provisioning Application.

Oracle Beehive Release 1 for DMZ

Use this option to install Oracle Beehive Release 1 and configure the installation location as a demilitarized zone (DMZ).

This option uses a local, file-based configuration and does not require an existing database. In addition, the administration tool beectl will be disabled for this instance.

See "Oracle Beehive for DMZ Sequence of Screens" to continue installing Oracle Beehive Release 1 for DMZ.

Oracle Beehive Integration for Zimbra

Oracle Beehive Integration for Zimbra is available for Oracle Beehive Release 1 (1.3) and later.

Use this option to install Oracle Beehive Integration for Zimbra, a Web-based client for Oracle Beehive.

See "Oracle Beehive Integration for Zimbra Sequence of Screens" to continue installing Oracle Beehive Integration for Zimbra.

Oracle Beehive (Standard Installation) Sequence of Screens

The following screens appear during the installation of Oracle Beehive Release 1 (standard installation):

Other Oracle Install Wizard Sequence of Screens

If you are installing Oracle Beehive Provisioning Application, refer to "Oracle Beehive Provisioning Application Sequence of Screens".

If you are installing Oracle Beehive for DMZ, refer to "Oracle Beehive for DMZ Sequence of Screens".

Specify Home Location

Enter the full path of the location where you want to install the product. Do not leave the Location field blank.

Note:

If you selected the Provisioning Application for Oracle Beehive Release 1 option on the Select Product Type screen, ensure that you specify the Oracle home for your Oracle Enterprise Manager Grid Control instance. This is a prerequisite for installing the provisioning plug-in.

For more information on prerequisites for installing the provisioning plug-in, refer to "Provisioning Application for Oracle Beehive Release 1". Refer to the module "What You Should Know Before Installing Oracle Beehive" in Oracle Beehive Installation Guide for information on prerequisites for installing Oracle Beehive Release 1.

Specifying Oracle Home Directory

Specify the directory where you want to install Oracle Beehive. You must specify a new Oracle home directory for each new installation of Oracle Beehive.

See the following guidelines for specifying the Oracle home directory on different platforms:

Specifying Oracle Home Directory on Linux and UNIX-Based Systems

On Linux and UNIX-based systems, the Oracle Beehive Install Wizard suggests a path similar to the following for the Oracle home directory:

/home_directory/oracle/product/version_number/identifier_n
  • home_directory is the home directory of the user running the Oracle Beehive Install Wizard

  • version_number is the version number of the product being installed

  • identifier identifies the product installed in this Oracle home directory

  • n is a number that ensures that this path is unique

Note:

You must have write permissions in the directory that you specify, if it exists, or you must have permissions to create it.

You may also click Browse to choose a directory to install your product. This location is the destination directory in which the product will be installed.

Specifying Oracle Home Directory on Windows Systems

On Windows systems, the Oracle Beehive Install Wizard suggests a path similar to the following for the Oracle home directory:

X:\oracle\product\version_number\identifier_n
  • X is the default drive

  • version_number is the version number of the product being installed

  • identifier identifies the product installed in this Oracle home directory

  • n is a number that ensures that this path is unique

If the directory specified does not exist, the Oracle Beehive Install Wizard creates it. Unless you want to install the software on a different drive with sufficient free space, you can accept the default value.

You may also click Browse to choose a directory to install your product. This location is the destination directory in which the product will be installed.

Prerequisite Checks

This screen displays the prerequisite checks that the Oracle Beehive Install Wizard runs. It verifies that the host (where you are installing Oracle Beehive Release 1) meets all minimum requirements for installing and configuring the product type that you selected on the Select Product Type screen.

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.

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

Select Installation Type

Specify the type of installation you want to perform. You can choose from:

Install and Configure

Select this option if you want to install and automatically start the configuration of the product.

If you select this option, the Oracle Beehive Release 1 instance is functional with minimal configuration after the installation is completed.

Install Only

Select this option to only install the product. This will only copy files to your system. Until you configure Oracle Beehive, you will not be able to perform any tasks with it nor start any Oracle Beehive managed component.

To configure the product after installation, you must run the Configuration wizard as follows:

  1. Navigate to the following directory:

    • On Linux and UNIX-based platforms: $ORACLE_HOME/beehive/oobwiz

    • On Microsoft Windows: %ORACLE_HOME%\beehive\oobwiz

  2. Run the configWizard script as follows:

    • On Linux and UNIX-based platforms, enter the following command:

      ./configWizard
      
    • On Microsoft Windows, run the configWizard.bat script.

Database Information

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

Notes:

The database that you specify on this screen must use the Unicode Standard UTF-8 AL32UTF8 character set.

To determine the character set of an existing database, perform the following steps:

  1. Log in to the SQL*Plus console of the target Oracle database.

  2. Run the following query:

select value from nls_database_parameters where parameter='NLS_CHARACTERSET';

If the character set of the Oracle database is not Unicode Standard UTF-8 AL32UTF8, then you must create a new Oracle database. You may use Database Configuration Assistant (DBCA) to do this.

Refer to the module "Oracle Beehive Database Requirements" in the Oracle Beehive Installation Guide of your operating system for database requirements for Oracle Beehive Release 1.

Host and Port

Host

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

Admin User Name

Specify the administrative user name (that can perform database administration tasks) for the database instance. Typically, this user is the SYS account.

For more information about the SYS account, refer to Oracle Database Administrator's Guide.

Admin User Password

Enter the password for the Oracle database administrative user account that you specified in the Admin User Name field.

After clicking Next, the Oracle Beehive 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.

Enterprise Definition Information

Specify the following enterprise site information that identifies this installation of Oracle Beehive Release 1:

Enterprise

Specify the name for the new enterprise you want to create. An enterprise is the top-level container for all users and objects. An enterprise may contain any number of organizations and workspaces.

The enterprise name is typically a company name, such as Oracle.

The enterprise name may only contain only letters, numbers, spaces, the period (.), the hyphen (-) and the underscore (_). The name cannot be greater than 127 bytes. The name cannot consist of only one or two periods (. or ..).

In Oracle Beehive Release 1, an Oracle Beehive deployment may have only one enterprise.

Organization

Specify the name of the organization to be created and added to the enterprise you specified previously. An organization is a logical grouping of users, groups, workspaces, and resources at a level lower than the enterprise level. Later, you may add any number of organizations to the enterprise you specified previously.

The organization is typically a sub-level or department under the enterprise, such as Sales or Accounting.

The enterprise name may only contain only letters, numbers, spaces, the period (.), the hyphen (-) and the underscore (_). The name cannot be greater than 127 bytes. The name cannot consist of only one or two periods (. or ..).

Site

Specify the name of the site. A site consists of all Oracle Beehive services and service instances and the database they use.

A site is typically a reference to a physical location, such as Headquarters or Montreal.

The site name may only contain ASCII letters (a-z, A-Z), numbers, and the underscore (_). The name cannot be greater than 19 characters.

In Oracle Beehive Release 1, an Oracle Beehive deployment may have only one site.

Instance Name

Specify the name of the instance for this Oracle Beehive installation. The instance name is used during server configuration.

The full name of an Oracle Beehive instance consists of the instance, host, and domain names. For example, if you name your instance myinstance1, your host is myhost, and your domain is example.com, the full name of your instance will be myinstance1.myhost.example.com.

The instance name may only contain ASCII letters (a-z, A-Z), numbers, and the underscore (_). The name cannot be greater than 63 characters. The name cannot be tempinst.

Notes:

Only enter the instance name; do not specify the host and domain name. Oracle Beehive will append the host and domain name to the instance name. For example, you would specify myinstance1, not myinstance1.myhost.example.com.

All Oracle Beehive Release 1 instances must have a unique name.

Existing Enterprise Information

Note:

This screen will only appear if you are installing Oracle Beehive Release 1 against a database that is already configured for an existing Oracle Beehive instance.

The Oracle Beehive Install Wizard will use the enterprise and site of the existing Oracle Beehive instance; the enterprise and site name displayed on this screen are those of this Oracle Beehive instance.

Specify the following information:

  • Enterprise: Select an enterprise to which this Oracle Beehive installation will belong.

  • Site: The site to which the selected enterprise belongs will be displayed.

  • Instance: Specify a name for this Oracle Beehive installation that will distinguish it from others in the selected enterprise. This name has have the following characteristics:

    • Not empty

    • Contain no spaces

    • Contain only valid ASCII characters

    • Not longer than 63 characters

    • Unique among other Oracle products configured in the same computer

Schema Password

Specify and confirm the password for the new database schema that will be created and used by the instance of Oracle Beehive Release 1.

Password Restrictions

The schema password must have the following characteristics:

  • Be between 5 and 30 characters long.

  • Only contain alpha-numeric characters (a-z, A-Z, and 0-9) or the underscore (_); the password cannot contain any other punctuation mark character.

  • Contain at least one alphabetic character and at least one numeric character

  • Begin with an alphabetic character; the password cannot begin with a number or the underscore (_).

Password Recommendations

  • Passwords should not be simple or obvious words, such as welcome, account, database, or user.

  • Passwords should not be the same as the user name.

  • Passwords should not be Oracle reserved words such as ACCESS, AUTHORIZATION, UID, or VARCHAR,

Existing Schema Password

Enter the password for the Oracle database schema that the Oracle Beehive Install Wizard has detected. This schema is used by the Oracle Beehive Release 1 instance.

After clicking Next, the Oracle Beehive Install Wizard verifies the schema password. If an error occurs, then you must correct the password before the installation process can continue.

beeadmin Password

Specify and confirm the password for the beeadmin user. The oc4jadmin and bpeladmin users will have the same password.

The oc4jadmin user will be exposed if you set up monitoring with Oracle Enterprise Manager Grid Control.

Use the bpeladmin user to log in to Oracle BPEL Process Manager. Do not use Oracle BPEL Console to deploy or modify workflows.

Note:

This screen will not appear if you are installing Oracle Beehive against a database that is already configured for an existing Oracle Beehive instance.

Password Restrictions

The password of the beeadmin user must have the following characteristics:

  • Be between 8 and 30 characters long.

  • Only contain alpha-numeric characters (a-z, A-Z, and 0-9) or the underscore (_); the password cannot contain any other punctuation mark character.

  • Contain at least one uppercase and one lowercase alphabetic character.

  • Contain at least one numeric character.

  • Begin with an alphabetic character; the password cannot begin with a number or the underscore (_).

Note:

When entering your password, check that the state of your Caps Lock key is what you want it to be. Passwords are case-sensitive.

Password Recommendations

  • Passwords should not be simple or obvious words, such as welcome, account, database, or user.

  • Passwords should not be the same as the user name.

  • Passwords should not be Oracle reserved words such as ACCESS, AUTHORIZATION, UID, or VARCHAR,

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:

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

  • Product Type: A predefined component set that automatically selects which components and dependency groups to install. To change the product type, go back to the Select Product Type screen.

  • Install Type: The option to only install Oracle Beehive Release 1 or to install and configure Oracle Beehive Release 1. To change the install type, go to the Select Installation Type screen.

  • Inventory Location: The location of the oraInventory directory where all the installation information about your product will be stored. To change this location, go back to the New Inventory Location screen.

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

    • Home Details: 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.

    • Database Information: The host name, port, service name, administrator user name, and password of the existing Oracle Database instance that will be used by this installation. To change the details, go back to the Database Information screen.

    • Enterprise Definition Information: The detailed enterprise site information that identifies this installation. To change the details, go back to the Enterprise Definition Information screen.

    • Schema Password: The masked password for the Oracle database schema that the Oracle Beehive Install Wizard detects and is used by this Oracle Beehive instance.

    • beeadmin Password: The masked password for the beeadmin user, which is the administrative user for Oracle Beehive Release 1 instances. To change the details, go back to the beeadmin Password screen.

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 Beehive Install Wizard runs to configure the product type that you selected on the Select Product Type screen.

The Oracle Beehive Install Wizard performs the following configuration assistants:

  • Oracle Beehive Product Preparation Assistant

  • Oracle Beehive Initialization Assistant

  • Oracle Beehive Database Configuration Assistant - SOA schemas

  • Base Platform Support Configuration Assistant

  • Disabling OC4J Home Instance

  • Oracle Beehive Database Configuration Assistant - Beehive schemas

  • Oracle Beehive Framework Core Configuration Assistant

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.

You may also use the Oracle Beehive Config Wizard to complete all pending and failed configuration assistants at a later time. The full path of the command is <Oracle home>/beehive/oobwiz/configWizard.

For more information about the Oracle Beehive Config Wizard, refer to the module "Oracle Beehive Install and Config Wizard Command-Line Options" in Oracle Beehive Installation Guide.

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 or oraInstall.

End of Installation

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

Oracle Beehive Provisioning Application Sequence of Screens

The following screens appear during the installation of Oracle Beehive Release 1 Provisioning Application:

Other Oracle Beehive Install Wizard Sequence of Screens

If you are installing Oracle Beehive (standard installation), refer to "Oracle Beehive (Standard Installation) Sequence of Screens"

If you are installing Oracle Beehive for DMZ, refer to "Oracle Beehive for DMZ Sequence of Screens".

Specify Home Location

In the Location field, specify the full path of Oracle Management Service Oracle home in which you want to install Oracle Beehive 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 Beehive 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 Beehive Release 1 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 Beehive 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 a directory path on the Oracle Management Service host that will be used as the software library location. 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 user, which is the administrative user for the database that this Oracle Beehive Release 1 instance uses as a repository.

  • 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 Beehive Install Wizard runs to configure Oracle Beehive Provisioning Application.

The Oracle Beehive 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 Beehive Provisioning Application was successful.

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

Refer to "Installing Oracle Beehive with Provisioning Application" to install Oracle Beehive with Oracle Beehive Provisioning Application.

Oracle Beehive for DMZ Sequence of Screens

The following screens appear during the installation of Oracle Beehive Release 1 for DMZ:

Other Oracle Beehive Install Wizard Sequence of Screens

If you are installing Oracle Beehive (standard installation), refer to "Oracle Beehive (Standard Installation) Sequence of Screens"

If you are installing Oracle Beehive Provisioning Application, refer to "Oracle Beehive Provisioning Application Sequence of Screens".

Specify Home Location

Enter the complete path for the location where you want to install Oracle Beehive Release 1 and configure as a DMZ.

Prerequisite Checks

This screen displays the prerequisite checks that the Oracle Beehive Install Wizard runs. It verifies that the host (where you are installing Oracle Beehive Release 1 for DMZ) meets all minimum requirements for installing and configuring the product type that you selected on the Select Product Type screen.

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

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.

Installation Summary

The Installation Summary screen presents a summary of the options you have selected so far. The information includes the following:

  • 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 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. To change this location, go back to the New Inventory Location screen.

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

    • Home Details: The location of the Oracle home where you want to install Oracle Beehive Release 1 for DMZ. To change the Oracle home, go back to the Specify Home Location screen.

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 Beehive Install Wizard runs to configure Oracle Beehive Release 1 for DMZ.

The Oracle Beehive Install Wizard performs the following configuration assistants:

  • Oracle Beehive for DMZ Product Preparation

  • Oracle Beehive for DMZ Initialization

  • Disabling OC4J Instances

  • BTI (Oracle Beehive Transport Infrastructure) Configuration

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.

You may also use the Oracle Beehive Config Wizard to complete all pending and failed configuration assistants at a later time. The full path of the command is <Oracle home>/beehive/oobwiz/configWizard.

For more information about the Oracle Beehive Config Wizard, refer to the module "Oracle Beehive Install and Config Wizard Command-Line Options" in Oracle Beehive Installation Guide.

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 Beehive Release 1 for DMZ was successful.

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

Refer to "Configuring Oracle Beehive Demilitarized Zone Instances" to configure the Oracle Beehive DMZ instance you have just installed.

Oracle Beehive Integration for Zimbra Sequence of Screens

Oracle Beehive Integration for Zimbra is available for Oracle Beehive Release 1 (1.3) and later.

The following screens appear during the installation of Oracle Beehive Integration for Zimbra:

Specify Home Location

Enter the full path of the location where you want to install Oracle Beehive Integration for Zimbra. Do not leave the Location field blank.

Prerequisite Checks

This screen displays the prerequisite checks that the Oracle Beehive Install Wizard runs. It verifies that the host (where you are installing Oracle Beehive Integration for Zimbra) meets all minimum requirements for installing and configuring the product type that you selected on the Select Product Type screen.

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

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 Oracle Beehive Install Wizard and start it again.

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.

Select Installation Type

Specify the type of installation you want to perform. You can choose from:

Install and Configure

Select this option if you want to install and automatically start the configuration of the product.

If you select this option, Oracle Beehive Integration for Zimbra is functional with minimal configuration after the installation is completed.

Install Only

Select this option to only install the product. This will only copy files to your system. Until you configure Oracle Beehive Integration for Zimbra, you will not be able to perform any tasks with it.

To configure the product after installation, you must run the Configuration wizard as follows:

  1. Navigate to the following directory:

    • On Linux and UNIX-based platforms: $ORACLE_HOME/beehive/oobwiz

    • On Microsoft Windows: %ORACLE_HOME%\beehive\oobwiz

  2. Run the configWizard script as follows:

    • On Linux and UNIX-based platforms, enter the following command:

      ./configWizard
      
    • On Microsoft Windows, run the configWizard.bat script.

Database Information

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

Note:

The database that you specify on this screen must use the Unicode Standard UTF-8 AL32UTF8 character set.

To determine the character set of an existing database, perform the following steps:

  1. Log in to the SQL*Plus console of the target Oracle database.

  2. Run the following query:

select value from nls_database_parameters where parameter='NLS_CHARACTERSET';

If the character set of the Oracle database is not Unicode Standard UTF-8 AL32UTF8, then you must create a new Oracle database. You may use Database Configuration Assistant (DBCA) to do this.

Host and Port

Host

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 you must enter the following:

foo.abc.com:1521

In case of an Oracle Real Application Cluster (Oracle RAC) database, use the following format:

virtual_host1:virtual_port1^host2:virtual_port2^.....

Port

Specify the port on which Oracle database is listening.

You can determine the Oracle database Listener port value from the following file in the Database Oracle home:

  • On Linux and UNIX-based platforms:

    $ORACLE_HOME/network/admin/listener.ora

  • On Microsoft Windows:

    %ORACLE_HOME%\network\admin\listener.ora

If you are using Oracle Enterprise Manager Grid Control, then to determine the port on which Oracle database is listening, click the Ports link in Oracle Enterprise Manager 10g Database Control for the instance where Oracle database is installed.

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

To check if a port is being used, you can use the netstat command to show the used port as follows:

  • On Linux and UNIX-based platforms:

    prompt> netstat -an | grep port_num
    

    In the preceding syntax, port_num refers to the port number you want to check.

  • On Microsoft Windows:

    Drive_Letter:\> netstat -an | find "port_num"
    

    In the preceding syntax, port_num refers to the port number you want to check.

    Note that you need quotation marks around the port number.

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

Admin User Name

Specify the administrative user name (that can perform database administration tasks) for the database instance. Typically, this user is the SYS account.

For more information about the SYS account, refer to Oracle Database Administrator's Guide.

Admin User Password

Enter the password for the Oracle database administrative user account that you specified in the Admin User Name field.

After clicking Next, the Oracle Beehive 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.

Existing Enterprise Information

Specify the name of the Oracle Beehive instance for this Oracle Beehive Integration for Zimbra installation. The instance name is used during server configuration.

Enterprise

Select the enterprise with which you want to configure Oracle Beehive Integration for Zimbra.

Site

This is a non-editable field displaying the configured site based on the enterprise chosen.

Instance

Specify a unique Oracle Beehive instance name for this Oracle Beehive Integration for Zimbra instance.

The full name of an Oracle Beehive instance consists of the instance, host, and domain name. For example, if you name your instance myinstance1, your host is myhost, and your domain is example.com, the full name of your instance will be myinstance1.myhost.example.com.

The instance name may only contain ASCII letters (a-z, A-Z), numbers, and the underscore (_). The name cannot be greater than 63 characters. The name cannot be tempinst.

Notes:

Only enter the instance name; do not specify the host and domain name. Oracle Beehive will append the host and domain name to the instance name. For example, you would specify myinstance1, not myinstance1.myhost.example.com.

All Oracle Beehive instances must have a unique name.

Existing Schema Password

Enter the password for the Oracle database schema that the Oracle Beehive Install Wizard has detected. This schema is used by Oracle Beehive Integration for Zimbra.

After clicking Next, the Oracle Beehive Install Wizard verifies the schema password. If an error occurs, then you must correct the password before the installation process can continue.

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:

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

  • Product Type: A predefined component set that automatically selects which components and dependency groups to install. To change the product type, go back to the Select Product Type screen.

  • Install Type: The option to only install Oracle Beehive Integration for Zimbra or to install and configure Oracle Beehive Integration for Zimbra. To change the install type, go to the Select Installation Type screen.

  • Inventory Location: The location of the oraInventory directory where all the installation information about your product will be stored. To change this location, go back to the New Inventory Location screen.

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

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

    • Database Information: The host name, port, service name, administrator user name, and password of the existing Oracle Database instance that will be used by this installation. To change the details, go back to the Database Information screen.

    • Enterprise Definition Information: The detailed enterprise site information that identifies this installation. To change the details, go back to the Existing Enterprise Information screen.

    • Schema Password: The masked password for the Oracle database schema that the Oracle Beehive Install Wizard detects and is used by this Oracle Beehive instance.

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 Beehive Install Wizard runs to configure the product type that you selected on the Select Product Type screen.

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.

You may also use the Oracle Beehive Config Wizard to complete all pending and failed configuration assistants at a later time. The full path of the command is <Oracle home>/beehive/oobwiz/configWizard.

For more information about the Oracle Beehive Config Wizard, refer to the module "Oracle Beehive Install and Config Wizard Command Line Options" in Oracle Beehive Installation Guide.

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.

End of Installation

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