Oracle® Beehive Installation Guide Release 1 (1.4) for Microsoft Windows (32-Bit) Part Number E13792-02 |
|
|
View PDF |
The following sections describe the Oracle Beehive Install Wizard screens that appear during installation of Oracle Beehive:
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 Beehive: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
.
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.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.
Choose how you want to install Oracle Beehive from one of the following options:
Complete installation by using the Oracle Beehive Release 1 option
Plug-in installation by using the Provisioning Application for Oracle Beehive Release 1 option
Products that allow Oracle Beehive users to collaborate with Microsoft Exchange users by using the Oracle Collaboration Coexistence Gateway
Note:
This option is only available on Windows systems. You will also need an installed and configured instance of Oracle Beehive.Installation for a demilitarized zone by using the Oracle Beehive Release 1 for DMZ option
Installation of Oracle Beehive Integration for Zimbra, a Web-based client for Oracle Beehive.
The sequence of the following screens depend on the option that you select on this screen.
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.
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.
Use this option to install the following products required for Oracle Collaboration Coexistence Gateway:
Oracle Coexistence Connector
Oracle Change Notification Service
Oracle Collaboration Coexistence Gateway requires Microsoft Exchange Server 2003.
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 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.
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".
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.
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.
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.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:
Navigate to the following directory:
On Linux and UNIX-based platforms: $ORACLE_HOME
/beehive/oobwiz
On Microsoft Windows: %ORACLE_HOME%
\beehive\oobwiz
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.
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 theUnicode Standard UTF-8 AL32UTF8
character set.
To determine the character set of an existing database, perform the following steps:
Log in to the SQL*Plus console of the target Oracle database.
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.
Specify the following enterprise site information that identifies this installation of Oracle Beehive Release 1:
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.
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 ..
).
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.
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 specifymyinstance1
, not myinstance1.myhost.example.com
.
All Oracle Beehive Release 1 instances must have a unique name.
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
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,
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.
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,
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.
Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.
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
.Click Finish to complete the installation process and close the Oracle Beehive Install Wizard.
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".
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
.
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.
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.
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.
Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.
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
.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.
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".
Enter the complete path for the location where you want to install Oracle Beehive Release 1 and configure as a DMZ.
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.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.
Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.
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
.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 is available for Oracle Beehive Release 1 (1.3) and later.
The following screens appear during the installation of Oracle Beehive Integration for Zimbra:
Enter the full path of the location where you want to install Oracle Beehive Integration for Zimbra. Do not leave the Location field blank.
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.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:
Navigate to the following directory:
On Linux and UNIX-based platforms: $ORACLE_HOME
/beehive/oobwiz
On Microsoft Windows: %ORACLE_HOME%
\beehive\oobwiz
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.
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 theUnicode Standard UTF-8 AL32UTF8
character set.
To determine the character set of an existing database, perform the following steps:
Log in to the SQL*Plus console of the target Oracle database.
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.
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 specifymyinstance1
, not myinstance1.myhost.example.com
.
All Oracle Beehive instances must have a unique name.
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.
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.
Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.
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.Click Finish to complete the installation process and close the Oracle Beehive Install Wizard.