WebLogic Collaborate Installation on Windows Systems

 

The following sections describe WebLogic Collaborate installation procedures for Windows systems:

• Installation Prerequisites

• Installing the BEA WebLogic Collaborate Software Package

• Verifying the Software Installation

• Troubleshooting Your Installation

• Uninstalling the BEA WebLogic Collaborate Software Package

 

---

Installation Prerequisites

Before you install the WebLogic Collaborate software, make sure you have the following software and hardware configuration for your machine:

• Hardware requirements and recommendations:

  • Intel Pentium II processor or later

  • 400 MHz recommended

  • 256 MB RAM recommended (512 MB preferable)

    Note: The 256 MB RAM recommendation is for one instance of WebLogic Server, where the c-hub and c-enabler are colocated. You may need more memory if you run two instances of WebLogic Server.

  • 100 MB free disk space

• A Microsoft Windows operating system:

  • Microsoft Windows NT 4.0 with Service Pack 5 or 6

  • Windows 2000

• Java 2 SDK, Standard Edition, v1.2.2

  The Java 2 SDK v1.2.2 software must be installed to run the WebLogic Collaborate sample applications, including the installation verification example. To avoid Java errors, modify PATH so that %JAVA_HOME%\bin is first in your PATH:

  prompt> PATH=%JAVA_HOME%\bin;%PATH%

• BEA WebLogic Server 5.1 with Service Pack 7

  WebLogic Collaborate is supported on platforms that are certified and approved for WebLogic Server 5.1. For details about WebLogic Server 5.1 platforms, refer to http://www.weblogic.com/platforms/index.html.

• One of the following databases:

  • Cloudscape 3.5.0

    BEA ships the Cloudscape software—a pure-Java relational database management system (RDBMS)—with WebLogic Server. If you installed WebLogic Server before October 1 2000, you should update your Cloudscape database with the 3.5.0 version. You can download Cloudscape 3.5.0 from the WebLogic Server 5.1.0 Service Packs section at the following URL:

    http://commerce.bea.com/downloads/weblogic_server.jsp#wlssp. 

  • Oracle 8i (8.1.5)

    The Oracle 8.1.5 client libraries must be installed on the machine running WebLogic Server 5.1. You must also have access to an Oracle 8.1.5 or 8.1.6 server. WebLogic Collaborate uses the WebLogic jDriver for Oracle, which is included with your WebLogic Server software.

    For more information about configuring Oracle with WebLogic Server, see http://www.weblogic.com/docs51/install/install_jdbc.htm1.

Note: The following variables should be defined in the user you create for WebLogic Collaborate, to use an Oracle Database. Contact your Oracle Database Administrator for more information.

ORACLE_HOME=directory_where_Oracle_is_installed
PATH=$PATH:$ORACLE_HOME/bin
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib

• Microsoft SQL Server 7.0 and WebLogic jDriver for Microsoft SQL Server (MSSQLServer4 Kit Version 7)

  For more information about configuring Microsoft SQL Server with WebLogic Server, see http://www.weblogic.com/docs51/classdocs/API_jmsq4.html.

  For more details about using the JDBC specification for database access, see http://www.weblogic.com/docs51/classdocs/jdbcdrivers.html.

• Access to a CD reader (if you get the WebLogic Collaborate software on a CD ROM and not from the BEA Web site)

• A network connection

• A Web browser

  • Microsoft Internet Explorer 5.x or above

  • Netscape Navigator 4.7 or above

 

---

Installing the BEA WebLogic Collaborate Software Package

The WebLogic Collaborate installation procedure installs the following components:

• BEA WebLogic Collaborate, including examples and Javadoc API descriptions

• BEA WebLogic Process Integrator (Studio and run-time engine)

• Apache XML Server (XSLT and XPath):

  • Xalan 1.0.1

  • Xerces 1.2.0

To install the BEA WebLogic Collaborate software, complete the following steps:

1. Confirm that your system has all of the prerequisites as described in Installation Prerequisites.

2. Uninstall previous versions of WebLogic Collaborate before proceeding with a new installation. Refer to Uninstalling the BEA WebLogic Collaborate Software Package.

3. Download the WebLogic Collaborate install.exe distribution from http://www.bea.com, or locate the install.exe program in the Windows folder on your WebLogic Collaborate software CD.

4. Double-click the install.exe program to display the Setup screen.

   

5. Click OK to continue the WebLogic Collaborate installation.

   The WebLogic Collaborate Introduction screen is displayed.

   

6. Click Next to display the Software License Agreement screen.

   

7. Select Yes to accept the software license agreement. Then click Next to display a list of the installation prerequisites.

   

8. Click Next to display the Choose Shortcut Location dialog box, which prompts you to specify a shortcut location for BEA WebLogic Collaborate.

   

9. Select the location for the shortcut and click Next to display a dialog box prompting you to choose a home directory.

   

10. Create a new BEA home directory or choose an existing one. Click Next to display a dialog box that prompts you to choose a product directory.

    

11. Specify the product installation directory and click Next to display a dialog box that prompts you to select a database.

    

12. Select a database and click Next.

    The next screen displayed in the installation process depends on the database you selected.

    • If you selected the Cloudscape database, the installation begins.

      Cloudscape is the default database. It is a pure-Java relational database management system that BEA ships with WebLogic Server and requires no configuration to use.

    • If you selected the Oracle database or the Microsoft SQL Server database, a database configuration dialog box is displayed before the WebLogic Collaborate installation begins.

      The configuration dialog box prompts you to enter Oracle or SQL Server access configuration information.

      

      To configure the Oracle database, enter the Oracle Service name, user, and password in the appropriate fields and click Install.

      To configure the Microsoft SQL Server database, enter the Microsoft SQL Server host name, SQL user, and SQL password in the appropriate fields, and click Install.

      When the installation begins, a screen showing the status of the installation process is displayed.

      

      After all WebLogic Collaborate components are installed, the Install Complete screen is displayed, indicating that the installation procedure is complete.

      

13. Click Done.

14. Install the software license.

    Copy the license file into the following directory:

    %WLC_HOME%\license

    Your license file is in the downloaded distribution if you downloaded the product from the BEA Web site, or is sent to you by email if you purchased the software on a CD.

 

---

Verifying the Software Installation

An installation verification example is provided to ensure that the installation of WebLogic Collaborate is successful. This section explains what the installation verification example does and how you run it.

How the Installation Verification Example Works

The installation verification example is a simple application that is automatically configured during the WebLogic Collaborate installation. You can run this example immediately after the installation procedure to verify that WebLogic Collaborate was installed successfully on your system. The verification example does the following:

• Starts a c-hub and two c-enablers colocated on a single WebLogic Server instance.

• From an HTML page, allows you to access a servlet that sends messages from one c-enabler to another c-enabler.

• When the verification example runs, the following actions occur:

  1. One c-enabler, identified as Partner1, sends an upper-case string to the second c-enabler, Partner2.

  2. The Partner2 c-enabler converts the string to lower-case and returns it to the Partner1 c-enabler.

Running the Installation Verification Example

When you complete the installation as described in Installing the BEA WebLogic Collaborate Software Package, verify that the installation is successful by completing the following procedure:

1. From the Start menu on the Microsoft Windows Task Bar, go to the folder where you installed WebLogic Collaborate.

   This example assumes the folder is named WebLogic Collaborate 1.0 and is installed in the Programs folder. For example, select:
   Start—>Programs—>WebLogic Collaborate 1.0.

2. Choose Repository—>Create Database Schema.

   A Command window opens and the database schemas are created in the repository. Wait for this step to complete.

3. Choose Start—>Programs—>WebLogic Collaborate 1.0—>Repository
   —>Bulkload Repository Data.

   A Command window opens and the database repository data is loaded into the repository. Wait for this step to complete.

4. Choose Start—>Programs—>WebLogic Collaborate 1.0—>C-Hub—>
   Start C-Hub.

   A Command window opens. The WebLogic Server and one c-hub starts. Wait for the message "WebLogic Server started" to appear in the window.

5. Choose Start—>Programs—>WebLogic Collaborate 1.0—>Verifier—>
   Start Verifier.

   The Verifier application is invoked, which in turn launches a Web browser with the following URL:

   http://localhost:7001/Verifier.html

   where localhost represents the name of the machine where you are running WebLogic Server.

6. Click the Start WLC Verification button displayed in the Web browser.

   The verification example starts. During verification, the Partner1 c-enabler sends a message to the Partner2 c-enabler. The message sent by Partner1 is the string ABCDEFGHI, and the message returned by Partner2 is abcdefghi.

   If the verification sample executes successfully, a report containing a "verification SUCCESS" message is displayed in the browser. The report identifies the process flow and the status of the verifier application.

   The following is an extract from a typical report:

   WLC Verifier

   Partner 2 enabler started
   Waiting for request...

   Partner 1 process flow.
   Starting enabler... done.
   Creating conversation... done.
   Sending message: conversation id=verifierConv ...
   string=ABCDEFGHI
   Status=success
   Waiting for response... done.
   Processing reply:
   Received string=abcdefghi
   Verification SUCCESS
   Termination conversation:verifierConversation:1.0requ...
   success

7. If errors occur, check the WebLogic Server log for more information.

 

---

Troubleshooting Your Installation

The following information can help you to troubleshoot the WebLogic Collaborate software installation.

Accessing Verifier.html

If your Web browser is unable to connect to the URL, it could indicate that your browser is using a proxy server and is preventing you from connecting to your local WebLogic Server.

To bypass the proxy server, change your browser's proxy settings so that the browser does not use the proxy server to access the servlet. For example, in Netscape:

1. Choose Edit—>Preferences—>Advanced—>Proxies, and select Manual proxy configuration view.

2. In the Exceptions text field, specify a value for the local host and the listening port using the following syntax:

   localhost:listening_port

   In the preceding syntax, listening_port is the listening port number specified in the weblogic.properties file. The default listening port number is 7001.

Note: If you are using Microsoft Internet Explorer, you can access the proxy settings by selecting Tools—>Internet Options—>Connections in your browser window.

Also check for error messages in the command prompt window in which WebLogic Server was started.

Starting the C-Hub

If the c-hub fails to start, the license may not be installed. Check for error messages in the command prompt window in which WebLogic Server was started (refer to step 4 in Running the Installation Verification Example).

Running the Verification Example

Confirm that your system has the installation prerequisites as described in Installation Prerequisites, and that the software prerequisites are installed in the correct locations.

Run the set command to confirm that the following environment variables are correct:

• JAVA_HOME

  This environment variable should be set to the location of the Java 2 SDK v1.2.2 software on your machine; for example:

  JAVA_HOME=D:\jdk1.2.2

• WL_HOME

  This environment variable should be set to the location of the WebLogic Server 5.1 software on your machine; for example:

  WL_HOME=D:\weblogic

• WLC_HOME

  This environment variable should be set to the location of the WebLogic Collaborate software on your machine; for example:

  WLC_HOME=D:\bea\wlcollaborate1.0

 

---

Uninstalling the BEA WebLogic Collaborate Software Package

To remove the WebLogic Collaborate software from your system:

1. Invoke the Uninstall script by using one of the following methods:

   • Choose Uninstall from the WebLogic Collaborate folder.

     For example, on the Microsoft Windows Task Bar choose
     Start—>Programs— >WebLogic Collaborate 1.0—>Uninstall.

   • Choose the WebLogic Collaborate program from the Add/Remove Programs dialog box.

     On the Microsoft Windows Task Bar, choose Start—>Settings—>Control Panel. Choose Add/Remove Programs and then choose the WebLogic Collaborate program name from the list of programs. Click Add/Remove.

     When you invoke the Uninstall script, a screen prompting you to confirm the removal of the software is displayed.

     

2. Click Uninstall to continue.

   The WebLogic Collaborate software is uninstalled from your system. A screen showing the status of the process is displayed.

   .

   When the uninstall process is complete, a screen is displayed to indicate that it was successful.

   

3. Click Exit.

   The WebLogic Collaborate product is removed from your system and from the Windows Registry.