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

1 What You Should Know Before Installing Oracle Beehive

This module describes the hardware and software prerequisites of Oracle Beehive and available installation scenarios. It covers the following topics:

Requirements

This section describes the following Oracle Beehive software and hardware requirements:

Operating System Certification

Oracle Beehive is certified for Sun Solaris 10 (SPARC 64-bit).

Required Operating Systems Packages for SPARC

Oracle Beehive requires the following packages on Solaris operating systems (SPARC 64-Bit):

  • SUNWbtool

  • SUNWhea

  • SUNWlibm

  • SUNWlibms

  • SUNWsprot

  • SUNWtoo

  • SUNWi1of

  • SUNWxwfnt

Required Operating System Patches

Currently, no patches are required for Solaris 10. However, Sun Microsystems, Inc. often updates the list of required patches for J2SE. Click the "Readme" link on the following URL for the most current list of patches: http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage

Increasing Shell Limits

Note:

In order to install Oracle Beehive, the maximum number of open file descriptors must be at least 4096.

In particular, on Solaris, ensure that the output from the command ulimit -n is at least 4096.

Although the steps in this section increase the value of the maximum number of open file descriptors, ensure that the kernel parameter fs.file-max is set to a value equal or higher than the value of hard nofile in the /etc/security/limits.conf file.

Solaris

To improve the performance of Oracle Beehive on Solaris, increase the following shell limits for the user installing Oracle Beehive:

  • Maximum number of open file descriptors, hard limit: 65536

  • Maximum number of processes available to a single user, hard limit: 16384

For more information, refer to Solaris Tunable Parameters Reference Manual from the Solaris 10 Administrator Collection from the Sun Microsystems Documentation Web site.

Linux

To improve the performance of Oracle Beehive on Linux, increase the following shell limits for the user installing Oracle Beehive:

Table 1-1 Minimum Shell Limits

Shell Limit Item in limits.conf Hard Limit

Maximum number of open file descriptors

nofile

65536

Maximum number of processes available to a single user

nproc

16384


Follow these steps to increase the shell limits. These steps assume you are using a user named oracle to install Oracle Beehive:

  1. Add the following lines to the /etc/security/limits.conf file:

    oracle              soft    nproc   2047
    oracle              hard    nproc   16384
    oracle              soft    nofile  1024
    oracle              hard    nofile  65536
    
  2. Add or edit the following line in the /etc/pam.d/login file, if it does not already exist:

    session  required  /lib/security/pam_limits.so
    
  3. Depending on the oracle user's default shell, make the following changes to the default shell start-up file:

    • For the Bourne, Bash, or Korn shell, add the following lines to the /etc/profile file (or the file on SUSE Linux systems, /etc/profile.local):

      if [ $USER = "oracle" ]; then
              if [ $SHELL = "/bin/ksh" ]; then
                    ulimit -p 16384
                    ulimit -n 65536
              else
                    ulimit -u 16384 -n 65536
              fi
      fi
      
    • For the C shell (csh or tcsh), add the following lines to the /etc/csh.login file (or the file on SUSE Linux systems, /etc/csh.login.local):

      if ( $USER == "oracle" ) then
              limit maxproc 16384
              limit descriptors 65536
      endif
      

Database Requirements

Refer to "Oracle Beehive Database Requirements" for information about Oracle Beehive database requirements, creating databases, and configuring database settings.

Note:

The installation scenario "Installing Oracle Beehive for Demilitarized Zone (DMZ)" does not require a database. See this section for more information about this scenario.

Oracle Enterprise Manager Grid Control Requirements

If you want to install the Oracle Beehive Provisioning Application, which enables you to install Oracle Beehive from Oracle Enterprise Manager Grid Control, you must have Oracle Enterprise Manager 10g Release 4 Grid Control (10.2.0.4) or later.

Hardware Requirements

The following are the minimum hardware requirements for Oracle Beehive:

  • Disk Space: 2.6 GB

  • Swap Space: 2,048 MB

  • Memory:

    • Oracle Beehive: 2 GB RAM

    • Oracle Beehive for DMZ: 1 GB

Notes:

The values for minimum disk space and memory do not include the amounts required for the target database.

Oracle Beehive does not support IPv6 (Internet Protocol version 6). You must disable IPv6 from the server on which you plan to install Oracle Beehive before starting the installation process.

Installation Scenarios

This section describes the possible ways you may install Oracle Beehive. It covers the following topics:

Installing Oracle Beehive Against an Existing Database

This is the standard installation scenario that will give you a fully functioning instance of Oracle Beehive.

This scenario gives you the choice to install and configure Oracle Beehive, or to install Oracle Beehive now and configure it later.

For more information about installing Oracle Beehive against an existing database, refer to "Oracle Beehive (Standard Installation) Sequence of Screens".

Installing Oracle Beehive Provisioning Application to Allow Oracle Beehive to Be Provisioned through Oracle Enterprise Manager Grid Control

Oracle Enterprise Manager Grid Control offers a centralized environment with which you can manage the complete Oracle IT infrastructure, including systems running Oracle and non-Oracle technologies. Oracle Enterprise Manager Grid Control gives you a broad set of administration, configuration management, provisioning, end-to-end monitoring, and security capabilities.

Oracle Beehive Provisioning Application enables you to install and configure Oracle Beehive instances in the robust environment of Oracle Enterprise Manager Grid Control.

Oracle Beehive Provisioning Application enables you to upload an installable version of Oracle Beehive into the central software library of Oracle Enterprise Manager Grid Control. Oracle Beehive Provisioning Application also creates a deployment procedure with which you can install and configure Oracle Beehive on any host through the deployment procedure manager of Oracle Enterprise Manager Grid Control.

For more information about installing Oracle Beehive Provisioning Application, refer to "Oracle Beehive Provisioning Application Sequence of Screens". For more information about the Oracle Beehive Provisioning Application, refer to "Installing Oracle Beehive with Provisioning Application".

Specifying Location of Oracle Beehive Shiphome Binaries in Grid Control

Before you install Oracle Beehive Provisioning Application, you must specify the location where Oracle Enterprise Manager Grid Control will look for the Oracle Beehive shiphome binaries, which is a zip file containing an installable version of Oracle Beehive. The following steps show you how to do this:

  1. Navigate to Oracle Enterprise Manager Grid Control, http://<Oracle Enterprise Manager Grid Control host>:<Oracle Enterprise Manager Grid Control port>/em.

  2. Click the Deployments tab. Click Provisioning from the menu bar. Click Administration. In the section Software Library Configuration, specify the location for the software library. This is a directory where Oracle Enterprise Manager Grid Control will look for the Oracle Beehive shiphome binaries.

    Note:

    If you have more than one Oracle Management Service sharing the same management repository, make sure each Oracle Management Service can read from and write to the location of the software library.

Installing Oracle Beehive for Demilitarized Zone (DMZ)

This scenario installs and configures Oracle Beehive into a demilitarized zone (DMZ) that will integrate with the rest of the Oracle Beehive system.

An Oracle Beehive DMZ configuration consists of one or more Oracle Beehive DMZ instances that are isolated from the Internet by a firewall on one side, and from one or more Oracle Beehive non-DMZ instances by a firewall on the other side. The DMZ instances are viewed as semi-secure. They are protected from the open Internet, but are not completely trusted like the non-DMZ instances that are inside the second firewall and part of the company's intranet. Oracle Beehive data is stored only in the non-DMZ instances, and administrative tasks may only be performed on the non-DMZ instances.

Oracle Beehive for DMZ requires an existing (non-DMZ) Oracle Beehive instance.

Oracle Beehive for DMZ does not require a database. However, the administration tool beectl will be disabled. Because this installation scenario does not require a database, you only have to specify a target installation location, which the Oracle Beehive Install Wizard will configure as a DMZ.

The following image illustrates an Oracle Beehive DMZ instance integrated in an Oracle Beehive system:

Figure 1-1 Oracle Beehive DMZ Instance Integrated in Oracle Beehive System

Description of Figure 1-1 follows
Description of "Figure 1-1 Oracle Beehive DMZ Instance Integrated in Oracle Beehive System"

For more information about installing Oracle Beehive for a DMZ, refer to "Oracle Beehive for DMZ Sequence of Screens".

Installing Oracle Beehive Integration for Zimbra

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

Oracle Beehive Integration for Zimbra is a Web-based client for Oracle Beehive. For more information about installing this product, refer to "Oracle Beehive Integration for Zimbra Sequence of Screens".

After installing this product, refer to "Configuring Oracle Beehive Integration for Zimbra".

Note:

If you install Oracle Beehive in a computer with at least 3 GB of memory, Oracle Beehive Integration for Zimbra will be configured in the same Oracle home.

Requirements

The following are the minimum hardware requirements for Oracle Beehive Integration for Zimbra:

  • Disk Space: 1.3 GB

  • Memory: 1 GB RAM

The following Web browsers are supported for Oracle Beehive Integration for Zimbra:

  • Microsoft Windows XP and Vista: Internet Explorer 7 and 6.0 SP2 and Firefox 1.5 and later and 2.0

  • Fedora Core 4: Firefox 1.5 and 2.0

  • Mac OS X 10.4: Firefox 1.5 and 2.0

Installing Oracle Beekeeper

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

Oracle Beekeeper is a secure, browser-based administration client. It provides Oracle Beehive administrators centralized and role-based access to system configuration and management, user and workspace administration, monitoring, and reporting functions. For more information about installing this product, refer to "Oracle Beekeeper Installation Help".

Oracle Beekeeper Release 1 (1.4) is only supported by Oracle Beehive Release 1 (1.4)

Requirements and Certifications

This version of Oracle Beekeeper is certified for Oracle Beehive Release 1 (1.4) and Web browsers Mozilla Firefox version 2 and Microsoft Internet Explorer version 7.

The following are the minimum hardware requirements for Oracle Beekeeper:

Installing Oracle Beehive in Silent Mode

Silent mode enables you to install Oracle Beehive with minimal interaction. You provide the Oracle Beehive Install Wizard with a response file that contains all the required information to install and configure Oracle Beehive. As a result, you do not have to be present to select, specify, and confirm options in each step of the installation process.

This scenario is appropriate if you want to install Oracle Beehive as a batch process or do not want to use the GUI provided by the Install Wizard.

You may install Oracle Beehive against an existing database or Oracle Beehive Provisioning Application in silent mode.

For more information about installing Oracle Beehive in silent mode, refer to "Installing Oracle Beehive in Silent Mode (Non-Interactive)".

Installing Oracle Beehive in High Availability Environment

Installing Oracle Beehive in a high availability environment involves installing a third-party load balancer, installing multiple Oracle Beehive instances, and configuring the virtual server of each instance.

For more information, refer to "Installing Oracle Beehive in High Availability Environment".

Installing More Than One Instance

To install more than one instance of Oracle Beehive so that each instance is in its own computer and shares the same database, simply install each instance with the Install Wizard. When entering the database information for each instance, use the same global service name for the server name.

To install multiple instances of Oracle Beehive with Oracle RAC, refer to the section, "Installing Multiple Oracle Beehive Instances with Oracle RAC".

To configure a load balancer after installing multiple Oracle Beehive instances, refer to "Installing Oracle Beehive in High Availability Environment".

Upgrading Oracle Beehive

Note:

You may only upgrade an Oracle Beehive Release 1 (1.4.1) deployment to Oracle Beehive Release 1 (1.4.3). You must upgrade an Oracle Beehive Release 1 (1.3) deployment to Oracle Beehive Release 1 (1.4.1) before upgrading it to Oracle Beehive Release 1 (1.4.3).

This section covers the following topics:

Upgrade Sequence

To upgrade an Oracle Beehive Release 1 deployment, upgrade the following Oracle Beehive products in the indicated order:

  1. Oracle Beehive Release 1. Refer to "Oracle Beehive Release 1 (1.3) to Release 1 (1.4.1) Upgrade Process Sequence of Screens" or "Oracle Beehive Release 1 (1.4.1) to Release 1 (1.4.3) Upgrade Process Sequence of Screens".

    Note:

    You must shutdown all Oracle Beehive application tiers before upgrading them.

    Ensure that the upgrade process has started your newly upgraded Oracle Beehive application tiers before proceeding to upgrade other Oracle Beehive products.

    Refer to "Upgrading Multiple Oracle Beehive Application Tiers" if you are upgrading more than one Oracle Beehive application tier.

  2. Any standalone Oracle Beehive Integration for Zimbra, Oracle Beehive Provisioning Application, or Oracle Collaboration Coexistence Gateway (Windows only).

  3. Any Oracle Beehive for DMZ instances. Refer to "Oracle Beehive for DMZ Release 1 (1.3) to Release 1 (1.4.1) Upgrade Process Sequence of Screens" or "Oracle Beehive for DMZ Release 1 (1.4.1) to Release 1 (1.4.3) Upgrade Process Sequence of Screens".

    Note:

    You must shutdown all Oracle Beehive for DMZ instances before upgrading them.

    Ensure that the upgrade process has started your newly upgraded Oracle Beehive DMZ instances before proceeding to upgrade other Oracle Beehive products.

  4. Any Oracle Beekeeper Release instances. Refer to "Upgrading Oracle Beekeeper Version 1.3" or "Upgrading Oracle Beekeeper Version 1.4.1".

Refer to "Upgrading Oracle Beehive Release 1 (1.3)" or "Upgrading Oracle Beehive Release 1 (1.4.1)" for information about upgrading Oracle Beehive products.

Refer to "Upgrading Oracle Beehive in Silent Mode" in "Installing Oracle Beehive in Silent Mode (Non-Interactive)" for more information about upgrading Oracle Beehive products in silent mode.

Upgrading Multiple Oracle Beehive Application Tiers

Follow these steps to upgrade multiple Oracle Beehive Release 1 (1.4.1) application tiers:

  1. Shutdown all your Oracle Beehive Release 1 (1.4.1) application tiers.

  2. Upgrade an Oracle Beehive Release 1 (1.4.1) application tier.

  3. Wait until the upgrade process is complete. Upgrade a subsequent Oracle Beehive Release 1 (1.4.1) application tier. Do not start upgrading this tier until the previous tier's upgrade process is complete. You do not have to shutdown any upgraded application tiers.

  4. Repeat step 3 until all application tiers are upgraded.

Applying Deployment Template after Upgrade

It is highly recommended that you apply a deployment template to your upgraded Oracle Beehive Release 1 (1.4) deployment; the upgrade process does not automatically do this for you. Note that a new Oracle Beehive Release 1 (1.4) installation already has a deployment template associated with it.

A deployment template is an XML file that represents the formally defined structure of an Oracle Beehive application tier and its components such as OC4J instances, services, Oracle Beehive Transport Infrastructure (BTI), and the HTTP server.

If your upgraded Oracle Beehive Release 1 (1.4) deployment does not have a deployment template associated with it, those beectl commands that change the deployment structure (such as those that add and delete OC4J and service instances) will succeed. However, you will receive a message indicating that you should apply a deployment template.

In addition, an upgrade from Oracle Beehive Release 1 (1.4) to Oracle Beehive Release 1 (1.5) will fail if your deployment does not have a deployment template associated with it.

Follow these steps to apply a deployment template to an Oracle Beehive deployment:

  1. Retrieve a list of available deployment templates with the command beectl list_deployment_templates. This command will output the identifier of each deployment template and a short description.

  2. Select an appropriate deployment template and apply it with the beectl modify_deployment_structure. The following example applies the deployment template SERVER_AND_CLIENT to the local Oracle Beehive application tier:

    modify_deployment_structure --primary_template SERVER_AND_CLIENT
    

    Note:

    Any customizations to the deployment structure (such as extra OC4J or service instances) or start/stop parameters (such as the maximum heap size of an OC4J instance) will be lost when you apply a deployment template with the command beectl modify_deployment_structure. The deployment template specified by this command will overwrite any customizations in your Oracle Beehive deployment.

Upgrading Voicemail Configuration

After you have upgraded Oracle Beehive from an earlier version to version 1.4, you must re-create your voicemail facilities using the new method, and remove facilities that you created in earlier version with the beectl add_config_object command.

You can list facilities and groups created using the earlier method by using the following command (from the operating system shell, so you can make use of the grep utility):

beectl list_components | grep -i voice

Locate all the voice components defined with a voicemail DNIS alias. Then, check which group is associated to each voicemail DNIS by using the beectl list_properties command:

beectl list_properties --component <voicemail DNIS>

Run this command for each identified component, and make a note of the group associated with each voicemail DNIS.

Once you have this information, you can assign the groups and phone numbers using the new facility configuration method, by using the new beectl add_voice_facility command. The following example demonstrates briefly how to use the command:

beectl add_voice_facility
  --group_collabid <GROUP_COLLAB_ID>
  --include "18885551111|18885552???"
  --exclude "188855529??"

See Also:

For complete information on creating voicemail facilities in Oracle Beehive Release 1 (1.4), see "Managing Oracle Beehive Voicemail and Fax" in the Oracle Beehive Administrator's Guide.

The --include statement associates phone number 18885551111 and phone number range 18885552000-18885552999.

The --exclude statement associates the phone number range 18885552900-18885552999 not to be included in the broader include range.

The value of --group_collabid is a the CollabID of a group. You can find this value for any group by using the beectl list_groups command with the global option --entity_format id:

beectl list_groups --group <group identifier> --show ALL --entity_format id

Use this command with the group that was defined for voicemail. If you followed the upgrade procedure described earlier to gather all the information, then the value for the <GROUP_COLLAB_ID> was listed when you used the beectl list_properties command.

Starting Oracle Beehive Install Wizard

All installation scenarios use the Oracle Beehive Install Wizard.

Run runInstaller from a user account other than root to start the installation and configuration of Oracle Beehive

Note:

Oracle Beekeeper is shipped on its own installation media (separate from Oracle Beehive). Run runInstaller from this installation media to start the installation and configuration of Oracle Beekeeper.

The Oracle Beehive Install Wizard has several command-line options available. For more information about these options, refer to "Oracle Beehive Install and Config Wizard Command-Line Options".

Note:

For all installation scenarios, except "Installing Oracle Beehive in Silent Mode", you may run the Oracle Beehive Install Wizard without any command-line options. For more information about installing Oracle Beehive in silent mode, refer to "Installing Oracle Beehive in Silent Mode (Non-Interactive)".

Post-Installation Procedures

Depending on the installation scenario you have chosen, your security requirements, the standards-based clients you want to use with Oracle Beehive, or any other issue particular to your deployment, perform the appropriate procedures described in "Oracle Beehive Post-Installation Procedures". These procedures include the following:

Cloning Application Tiers and Deployments

Cloning is the process of copying an existing installation to a different location while preserving its configuration.

You may clone an application tier, which involves preparing a "gold" image of a patched Oracle home. With this clone, you may create a new application tier with all patches applied to it in a single step. This is in contrast to separately installing, configuring, and applying any patches to Oracle Beehive.

You may also clone a deployment, which involves creating an installation that is a copy of a production, test, or development installation.

Refer to "Cloning Oracle Beehive Application Tiers and Sites" for more information.

Uninstalling Oracle Beehive

You may uninstall the following products with the Oracle Beehive Uninstall Wizard:

Start the Oracle Beehive Uninstall Wizard by running the Oracle Beehive Install Wizard and clicking the Uninstall button. Alternatively, run the Oracle Beehive Config Wizard (or Oracle Beehive Install Wizard) with the -uninstall command-line option.

For more information about Oracle Beehive Install Wizard or Oracle Beehive Config Wizard, refer to "Oracle Beehive Install and Config Wizard Command-Line Options".

For more information about uninstalling Oracle Beehive, refer to "Oracle Beehive Uninstall Wizard".

You may uninstall Oracle Beehive in silent mode. For more information, refer to the section "Uninstalling Oracle Beehive in Silent Mode" in "Installing Oracle Beehive in Silent Mode (Non-Interactive)".