> Installation Guide > Installation

Installation Guide

     Previous  Next    Open TOC in new window     
Content starts here

Installation

 

Overview

This guide is intended for BEA WebLogic Portal users who install WebLogic Portlets for Groupware Integration. The following sections explain the necessary prerequisites and documentation conventions for successfully installing this product on the various supported platforms:

Prerequisite Software

Perform the following tasks before you install the WebLogic Portlets for Groupware Integration:

  1. Install an appropriate version of WebLogic Platform 9.2 with WebLogic Portal on the machine before running the installer application. Refer to Installation Prerequisites for information on supported versions.
  2. Obtain a basic understanding of Microsoft Exchange, Lotus Domino, and Java.
Note: Refer to the WebLogic Portlets for Groupware Integration Supported Configurations Guide for information on supported versions of Microsoft Exchange and Lotus Domino.

Documentation Conventions

The Windows convention of "\" as a path separator is used wherever necessary. UNIX users and users of other operating systems should translate these paths and variables accordingly.

Also, because system software and configurations can vary from one system to another, portions of the command syntax displayed in this document may include sample parameters or variables that represent the actual command syntax you would need to enter.

Parameter
Definition
BEA_HOME
The location for the BEA Home directory containing the WebLogic Platform 9.2 with WebLogic Portal. For example, c:\bea.
JAVA_HOME
This location represents the full path to the Java 2 SDK directory.

 

Installation

This chapter explains the necessary procedures to successfully install the WebLogic Portlets for Groupware Integration on the various supported platforms. For standard installation procedures, refer to the following sections:

Installation Prerequisites

The following sections specify the installation prerequisites for a WebLogic Portlets for Groupware Integration installation.

System Requirements

The system requirements for WebLogic Platform are given in the following table.

Component
Requirement
Platform configuration
A configuration of hardware, operating system, SDK, and database that is supported by WebLogic Platform 9.2 is required. See WebLogic Platform Supported Configurations at http://edocs.bea.com/platform/suppconfigs/index.html.
This document also specifies other prerequisites and recommendations, such as recommended versions of the Java 2 SDK.
WebLogic Portal
WebLogic Portal 9.2
Groupware System
Microsoft Exchange 2000 or 2003
Lotus Domino R5, R6 or R6.5
JDK
The BEA Products installation program requires a Java runtime environment (JRE) to run. A JRE is bundled in the Windows installation program and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the installation program does not install a JDK. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have the appropriate version of the JDK installed on your system and include the bin directory of the JDK at the beginning of the PATH variable definition. It is important that you use a JDK because the installation process assigns values to JAVA_HOME and related variables to point to the JDK directory.

Licensing

The WebLogic Portlets for Groupware Integration software cannot be used without a valid license. An evaluation license is available for download from the BEA Download Center. To use WebLogic Portlets for Groupware Integration in a full-scale production environment, you must purchase a production license. To find out how to do so, contact your sales representative or visit the BEA corporate Web site at http://www.bea.com.

For more information about development, evaluation, and production licenses as well as instructions for installing the license are provided in Licensing.

Installation Methods

The BEA installation program supports the following methods for installing the WebLogic Portlets for Groupware Integration software:

Installing Using Graphical-Mode Installation

Perform the following steps to install the WebLogic Portlets for Groupware Integration using the Graphical-Mode Installation. To install on Windows, Solaris, or UNIX, see the following sections:

Starting the Installation Program in Graphical Mode on Windows

To start the installation in graphical mode on a Windows system:

  1. Log in to the Windows system.
  2. Download the software from the BEA Web site at http://commerce.bea.com.
  3. Go to the directory where you downloaded the installation program and double-click the installation file:

    4. wl_groupware_portlets_bea92-XXX_win32.exe

    Note: In this filename, XXX represents the version number of the software you are installing.

    The installation program begins to install WebLogic Portlets for Groupware Integration.

  4. Proceed to Running the Installation Program.

Starting the Installation Program in Graphical Mode on UNIX Platforms

The WebLogic Portlets for Groupware Integration installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the WebLogic Portlets for Groupware Integration installation program does not include a JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a Java 2 SDK installed on your system, and include the bin directory of the Java 2 SDK at the beginning of your PATH system variable.

Note: It is important that you use an SDK because the installation process sets the JAVA_HOME and related variables to point to this directory.

To run graphical-mode installation, your console must support a Java-based GUI. If the installation program determines that your system cannot support a Java-based GUI, it automatically starts running in console-mode. For details, see Installing Using Console-Mode Installation on page 8.

Starting Graphical-Mode Installation for .bin Installation Files

If you have an installation program for UNIX platforms with a filename that ends in .bin, complete the following steps to start the installation in graphical mode:

  1. Log in to the target UNIX system.
  2. Download the software from the BEA Web site at http://commerce.bea.com.
  3. Go to the directory in which you downloaded the installation program. Launch the installation by entering the following commands:

    4. chmod a+x filename.bin
    ./filename.bin

    Here filename.bin is the name of the WebLogic Portlets for Groupware Integration installation program, for example: wl_groupware_portlets_bea92-XXX_solaris32.bin.

    Note: In this filename, XXX represents the version number of the software you are installing.

    The installation program begins to install WebLogic Portlets for Groupware Integration

  4. Proceed to Running the Installation Program.
Starting Graphical-Mode Installation for .jar Installation Files

If you have an installation program for UNIX platforms with a filename that ends in .jar, follow these steps to start the installation in graphical mode:

  1. Log in to the target UNIX system.
  2. Add the bin directory of the appropriate SDK to the beginning of the PATH variable definition on the target system. For example:

    3. PATH=JAVA_HOME/bin:$PATH
    export PATH

    Note: Here JAVA_HOME represents the full path to the SDK directory.
  3. Download the software from the BEA Web site at http://commerce.bea.com.
  4. Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

    5. java -jar filename.jar

    Here, filename.jar is the name of the WebLogic Portlets for Groupware Integration installation file, for example wl_groupware_portlets_bea92-XXX_generic.jar.

    Note: In this filename, XXX represents the version number of the software you are installing.
  5. Proceed to Running the Installation Program.

Running the Installation Program

The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following table:

In this window . . .
Perform the following action . . .
Welcome
Click Next to proceed with the installation. You may cancel the installation at any time by clicking Exit.
BEA License Agreement
Read the BEA Software License Agreement and indicate your acceptance of the terms of the agreement by selecting Yes. To continue with the installation, you must accept the terms of the license agreement and then click Next.
Choose BEA Home Directory
Specify the BEA Home directory that contains WebLogic Platform 9.2 with WebLogic Portal. This directory will serve as the central support directory for all BEA products installed on the target system.
The files in the BEA Home directory are essential to ensuring that BEA software operates correctly on your system such as ensuring that licensing works correctly for the installed BEA products.
Choose Install Type
Select the option button for the type of installation you want to perform:
  • Complete — All the software components provided with WebLogic Portlets for Groupware Integration are installed on your system.
  • Custom — You select software components to be installed.
Choose Components

Note: This window is displayed only if you selected Custom installation in the Choose Install Type window.

Specify the components to be installed by selecting or clearing the appropriate check boxes. This window displays a tree-view of all the components available for installation. In an initial installation, all components are selected.
Choose Product Installation Directory
Specify the directory in which you want to install the WebLogic Portlets for Groupware Integration software and click Next. You can accept the default product directory (wlpgwi30) or create a new product directory.
If you choose to create a new directory, the installation program automatically creates the directory for you.
Choose Shortcut Location
Select All Users if you want the shortcuts available to all users on this machine. Select Local if you only want the shortcuts available for this local user.
Status
Read the information displayed about BEA products and services.
Installation Complete
  1. Select from the following options:
  • Launch start page with useful links
  1. Click Done to exit the installation program.

Installing Using Console-Mode Installation

Perform the following steps to install the WebLogic Portlets for Groupware Integration using the Console-Mode Installation. You can install on Windows, Solaris, or UNIX.

Start Console-Mode Installation on Windows

To start the installation in console mode on a Windows system:

  1. Log in to the Windows system.
  2. Download the software from the BEA Web site at http://commerce.bea.com.
  3. Open a MS DOS command prompt.
  4. Go to the directory where you downloaded the installation program and run:

    5. wl_groupware_portlets_bea92-XXX_win32.exe -mode=console

    Note: In this filename, XXX represents the version number of the software you are installing.

    The installation program begins to install WebLogic Portlets for Groupware Integration.

  5. Proceed to Running the Console-Mode Installation.

Start Console-Mode Installation on UNIX

The WebLogic Portlets for Groupware Integration installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the WebLogic Portlets for Groupware Integration installation program does not include a JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a Java 2 SDK installed on your system, and include the bin directory of the Java 2 SDK at the beginning of your PATH system variable.

Note: It is important that you use an SDK because the installation process sets the JAVA_HOME and related variables to point to this directory.
Starting Console-Mode Installation for .bin Installation Files

If you have an installation program for UNIX platforms with a filename that ends in .bin, complete the following steps to start the installation in console mode:

  1. Log in to the target UNIX system.
  2. Download the software from the BEA Web site at http://commerce.bea.com.
  3. Go to the directory in which you downloaded the installation program. Launch the installation by entering the following commands:

    4. chmod a+x filename.bin
    ./filename.bin -mode=console

    Here filename.bin is the name of the WebLogic Portlets for Groupware Integration installation program, for example wl_groupware_portlets_bea92-XXX_solaris32.bin.

    Note: In this filename, XXX represents the version number of the software you are installing.

    The installation program begins to install WebLogic Portlets for Groupware Integration.

  4. Proceed to Running the Console-Mode Installation.
Starting Console-Mode Installation for .jar Installation Files

If you have an installation program for UNIX platforms with a filename that ends in .jar, follow these steps to start the installation in console mode:

  1. Log in to the target UNIX system.
  2. Add the bin directory of the appropriate SDK to the beginning of the PATH variable definition on the target system. For example:

    3. PATH=JAVA_HOME/bin:$PATH
    export PATH

    Here JAVA_HOME represents the full path to the SDK directory.

  3. Download the software from the BEA Web site at http://commerce.bea.com.
  4. Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

    5. java -jar filename.jar -mode=console

    Here, filename.jar is the name of the WebLogic Portlets for Groupware Integration installation file, for example wl_groupware_portlets_bea92-XXX_generic32.jar. In this filename, XXX represents the version number of the software you are installing.

  5. Proceed to Running the Console-Mode Installation.

Running the Console-Mode Installation

To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, type exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, type next (or n, for short).

Note: The sample console text and directory pathnames in this section use Windows conventions (backslashes) for pathnames, for example C:\bea\wlpgwi30. When entering pathnames on a UNIX system, use the UNIX convention (forward slashes) in pathnames, for example, /home1/bea/wlpgwi30.

The following procedure steps you through the installation program. Use this procedure after you have started the installation program in console mode as described in the previous sections.

  1. At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process. The BEA Systems License Agreement prompt is displayed.
  2. Read the Agreement and indicate your acceptance or rejection of its terms by doing one of the following at the prompt:
    1. Type 1 to indicate your agreement with the terms of the license and proceed with the installation. To review the entire agreement, press Enter or type Down several times.
    2. Type Up to scroll back through sections previously displayed.
    3. Type 2 if you do not agree with the terms of the license. If you type 2, the installation process terminates.

      4. The Choose BEA Home directory prompt is displayed.

  3. Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system.

    4. The installation program displays the following prompt:

    Choose BEA Home Directory:

    --------------------------

    ->1¦*Create a new BEA Home [C:\bea]

    2¦ D:\beahome1

    Enter index number to select OR [Exit][Previous][Next]>

    Note: Instead of typing complete words when you want to enter [Exit], [Previous], and [Next], you can use the following one-letter shortcuts: x, p, and n, respectively.
  4. Do one of the following:
    • To use an existing BEA Home directory, type 2 or next (or n for short), or press Enter. If you have more than one BEA Home directory on your system, an additional prompt will display the directories. Type the number associated with the desired BEA Home directory.
    • To create a new BEA Home directory, type 1, then at the prompt, enter the full path of the BEA Home directory, for example C:\beahome2. If you specify a directory that does not exist, the installation program creates it for you.
  5. Whether you accept the existing BEA Home directory or choose to create a new BEA Home directory, you are prompted to confirm your selection, as shown in the following sample:

    6. Choose BEA Home Directory:

    --------------------------

    *BEA home choice

    ->1¦Yes, Use this BEA home directory [C:\bea]

    2¦No, return to BEA home directory selection

    Enter index number to select OR [Exit][Previous][Next]>

  6. On the command line, type 1 or press Enter to accept your selection. Otherwise, type 2 to return to the Choose BEA Home Directory panel where you can modify your entry.
    7. Note: After you have selected your BEA Home directory and confirmed your selection, the Choose Install Type prompt is displayed.
  7. Specify the type of installation you want to perform by entering the number associated with the install type, as shown in the following text:

    8. Choose Install Type:

    --------------------

    ->1¦Complete

    2¦Custom Installation

  8. If you chose "Custom Installation" in the previous step, you will need to specify the components you wish to install.
    9. Note: Specify the components as specified in the following text:

    Choose Components to install:

    -----------------------------

    Release 3.0.0.0

    +----WebLogic Portlets for Groupware Integration [1] v

    +----Libraries [1.1] v

    +----Domain Template [1.2] v

    +----Eclipse Plugin [1.3] v

    +----Documentation [1.4] v

    +----WebLogic Services [1.5] v

    Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]>

  9. Specify the directory in which you want to install the WebLogic Portlets for Groupware Integration software. Select the default product directory (BEA_HOME\wlpgwi30) or create a new product directory. If you specify a new directory, the installation program automatically creates it for you.

    10. The choices displayed in this section are as follows:

    Choose Product Directory:

    -------------------------

    Product Installation Directory= [C:\bea\wlpgwi30]

    Input new Product Installation Directory OR [Exit][Previous][Next]>

  10. Do one of the following:
    • Press Enter or type next (or n for short) to accept the current selection.
    • Enter the full path to the directory in which you want to install the WebLogic Portlets for Groupware Integration software and press Enter.
  11. You are prompted to confirm your selection as shown in the following text:

    12. Choose Product Installation Directory:

    -------------------------

    ->1| Yes, use this product directory [C:\bea\wlpgwi30]

    2| No, select another product directory

    Enter index number to select OR [Exit][Previous][Next]>\

  12. Verify that your entry is correct, then type 1 or press Enter to proceed with the installation. Otherwise, type 2 to return to the Choose Product Directory panel where you can modify your entry.
  13. Specify the location for the shortcuts to BEA product components, samples, and tools.
  14. Confirm the above selection to begin the product installation.
  15. Press Enter or type Exit to exit the installation program.

 

Licensing

Your WebLogic Portlets for Groupware Integration distribution requires a valid product license to run. This chapter contains the following sections that explain how to acquire and install the WebLogic Portlets for Groupware Integration license:

About WebLogic Portlets for Groupware Integration License

The WebLogic Portlets for Groupware Integration uses an XML-format license file called license.bea.

The WebLogic Portlets for Groupware Integration checks this file at run time to determine which BEA WebLogic software components you are authorized to use.

License Type
Description
Development
  • Used in a development environment where a developer is preparing an application to use the WebLogic Portlets; a production license is required for deployment.
  • Enables all Providers of the WebLogic Portlets.
  • Is not tied to the IP address of a machine.
Production
  • Used in full-scale production environments.
  • May restrict functionality to the software components that you have purchased.
  • Permits service interactions and connections to and from an unlimited number of IP addresses.
  • Must be purchased separately. For information about purchasing a production license, contact your sales representative or visit the BEA web site at http://www.bea.com.

Note: If you have other BEA directories on your system, each BEA_HOME directory must have a license.bea file that authorizes use of the products associated with that directory. The types of license files that can be used as the license.bea file and the technical restrictions that they impose are described in the table above.
Note: See the BEA Software License Agreement for specific license terms and conditions.

Installing and Updating License Files

To update your license.bea file, perform the following procedure.

  1. Save the license update file that you received through e-mail, with a name other than license.bea, in the target BEA_HOME directory. For example, save the file as new_license.bea.
    2. WARNING: Do not overwrite or change the name of the existing license.bea file.
  2. Merge the license file contents into your existing license.bea file using a text editor.
  3. Save a copy of your updated license.bea file in a safe place outside the WebLogic installation directories. Although no one else can use your license file, you should save it in a place that is protected from both malicious and innocent tampering.
Note: The license.bea file delivered with your software conforms with the XML grammar definition. The XML definition (<?xml version="1.0" encoding="UTF-8"?>) must be at the very beginning of the license.bea file. There cannot be any spaces or line breaks before the XML definition.

Updating Your license.bea File

When you install WebLogic Portlets for Groupware Integration, the software requires a license.bea file. You must merge an evaluation, development or production license for those components into the existing license.bea file, or install the components into a separate BEA Home directory.

Additionally, you must update the license.bea file separately, independent of the installation process if at least one of the following is true:

In each of these cases, you will receive a new license file from BEA, the contents of which must be included in the license.bea file in the target BEA Home directory. To facilitate the license update process, BEA provides an UpdateLicense utility that merges the new license into the existing license in the BEA Home directory, and deletes any expired or duplicate entries.

Updating license.bea Using the UpdateLicense Utility

To update your license.bea file, perform the following procedure:

  1. Save the license update file that you received through email, with a name other than license.bea, in the target BEA Home directory. For example, save the file as new_license.bea. Use this file as the license_update_file in step 4 of this procedure.
    2. WARNING: Do not overwrite or change the name of the existing license.bea file.
  2. Perform the step appropriate for your platform:
    1. On a Windows system, open an MS-DOS command window and go to the target BEA Home directory.
    2. On a UNIX system, go to the target BEA Home directory.
  3. If it is not already included, add the Java 2 SDK to your PATH variable by entering the following commands:
    • On a Windows system set PATH=BEA_HOME\SDK\bin;%PATH%
    • On a UNIX system set PATH=BEA_HOME/SDK/bin:$PATH
      export PATH

      • In these commands, SDK represents the directory name of the Java 2 SDK being used for this installation, for example, jdk150_04 or jrockit90_150_04.

  4. Merge the license update file into your existing license by entering one of the following commands:
    • On a Windows system: UpdateLicense license_update_file
    • On a UNIX system: sh UpdateLicense.sh license_update_file

      • license_update_file is the name to which you saved the license update file in step 1.

  5. Save a copy of your updated license.bea file in a safe place outside the BEA Home and application installation directories.
Note: Although no one else can use your license file, you should save it in a place that is protected from both malicious and innocent tampering.

  Back to Top       Previous  Next