WebLogic Collaborate Installation on Windows Systems

 

This section provides the information needed to install and uninstall WebLogic Collaborate on a Windows platform. Specifically, it includes the following topics:

• 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 installing the WebLogic Collaborate software, make sure you have the following software and hardware installed for your machine:

• Hardware:

  • Intel Pentium II processor or later required

  • 400 MHz recommended

  • 256 MB RAM required (512 MB recommended)

    Note: 256 MB RAM are recommended for one instance of WebLogic Server, where the c-hub and c-enabler are colocated. If you run two instances of WebLogic Server, the machine will need more memory.

  • 100 MB free disk space

• One of the following Microsoft Windows operating systems:

  • Windows NT 4.0 with Service Pack 5 or later

  • Windows 2000

• Correct path to JDK 1.3.0

  Verify that the path to JDK 1.3.0 is at the beginning of your PATH statement. The PATH statement should begin with <drive:\wls_6.0>\jdk1.3\bin. <drive:\wls_6.0> represents the location on the local machine in which WebLogic Server 6.0 is installed.

• BEA WebLogic Server Version 6.0 with Service Pack 1

  WebLogic Collaborate is supported on selected platforms that are certified and approved for WebLogic Server Version 6.0. For details about WebLogic Server Version 6.0 platforms, refer to the following URL:

  http://download.oracle.com/docs/cd/E13222_01/wls/platforms/index.html.

• Enterprise JavaBeans (EJB) 2.0 Upgrade

  You need EJB20.jar to activate the BEA WebLogic Server implementation of Sun Microsystem's Enterprise JavaBeans 2.0 specification. You can download it from BEA WebLogic Server Downloads at the following URL:

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

  Choose the EJB 2.0 download option to download a zip file that contains the EJB20.jar file and the README file.

• One of the following databases:

  • Cloudscape 3.5.1

    BEA ships the Cloudscape software—a pure-Java relational database management system (RDBMS)—with WebLogic Server.

  • Oracle 8i (8.1.6)

    The Oracle 8i (8.1.6) client libraries must be installed on the machine runningWebLogic Server 6.0. You must also have access to an Oracle 8.1.5 or 8.1.6 server. WebLogic Collaborate uses the Oracle thin driver, which is bundled with your WebLogic Server distribution and installed with WebLogic Server.

    For more information about configuring the Oracle thin driver with WebLogic Server, see Using Third-Party Drivers with WebLogic Server at the following URL:

    http://download.oracle.com/docs/cd/E13222_01/wls/docs60/jdbc/thirdparty.html

    Note: Before you can use an Oracle database, you must define the following variables for the user you create for WebLogic Collaborate. 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 details about using the JDBC specification for database access, see Programming WebLogic JDBC at the following URL:

    http://download.oracle.com/docs/cd/E13222_01/wls/docs60/jdbc/index.html.

• Access to a CD reader (if you get the WebLogic Collaborate software on a CD ROM)

• Network connection

• 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. If you choose not to uninstall any previous versions of WebLogic Collaborate, be sure to install each newer version with a unique directory name. To uninstall a previous version, see Uninstalling the BEA WebLogic Collaborate Software Package.

3. Download the WebLogic Collaborate installation program, install.exe, 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 window.

    

   

    

5. Click OK to continue the WebLogic Collaborate installation.

   The WebLogic Collaborate Introduction window is displayed.

    

   

    

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

   

    

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

    

   

    

8. Verify that your system meets the installation prerequisites, then click Next to display the Choose Install Set dialog box.

   

    

9. Click Next to display the Choose BEA Home Directory dialog box, prompting you to choose a product home directory.

   

    

   An existing BEA home directory containing WebLogic Server 6.0 is selected by default.

   Warning: You must install WebLogic Collaborate in an existing BEA home directory. This home directory can reside anywhere on the system. It must contain the registry.xml file, which holds descriptions of all BEA products that are installed in the BEA home directory.

10. In the Choose BEA Home Directory dialog box, click Next to display a dialog box that prompts you to choose a product directory.

    

     

11. In the Choose Product Directory dialog box, specify the product installation directory. The same directory can serve as both the Product Directory and the BEA Home Directory.

12. Click Next. A dialog box prompts you to select a database.

    

     

     

13. Select a database and click Next.

14. Follow the appropriate instructions for the database you selected.

    If you selected . . .	Then . . .
    Cloudscape	The installation begins immediately. Skip to step 16. Note: Cloudscape is the default database. It is a pure-Java relational database management system delivered with BEA WebLogic Server. It requires no configuration.
    Oracle	Go to step 15.
    Microsoft SQL	Go to step 15.

15. If you selected the Oracle database or the Microsoft SQL Server database, a database configuration dialog box is displayed prompting you to enter Oracle or SQL Server access configuration information, as in the following example.

    

     

    If you selected . . .	Then . . .
    Oracle	Enter the Oracle Service name, user, and password in the appropriate fields. Then click Next.
    Microsoft SQL	Enter the Microsoft SQL Server host name, SQL user, and SQL password in the appropriate fields. Then click Next.

16. The installation procedure displays the Confirm Database Selection dialog box, as in the following example.

    

     

17. In the Confirm Database Selection dialog box, click Install to confirm your database selection and continue installation procedure.

18. Monitor installation progress by noting the initial and final messages displayed by the installation program. When installation begins, the following window is displayed.

    

     

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

    

     

19. Click Done.

20. Install the software license.

    If this is your first installation of WebLogic Collaborate, an evaluation license is included in the evaluation software and is installed automatically. If your installation is an upgrade to a previous version of WebLogic Collaborate, you will receive a new license file from BEA. To upgrade your existing license after you install the WebLogic Collaborate 1.0.1 software:

    1. Execute the setEnv script that exists in the root directory in which you installed the WebLogic Collaborate software; for example, in

       d:\bea\wlcollaborate1.0.1.

    2. Copy the new license file into the BEA home directory on your machine.

    3. Change to the BEA home directory; for example:

       cd d:\bea

    4. Merge this new license file into your existing license by entering the following command in the bea home directory, where new_license represents the name of the license file you received from BEA:

       UpdateLicense new_license

 

---

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 configured automatically 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 uppercase string to the second c-enabler, Partner2.

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

Running the Installation Verification Example

After you complete installation of WebLogic Collaborate (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 in which you installed WebLogic Collaborate.

   Note: In this example, we assume that the folder is in the default location: Programs\BEA WebLogic E-Business Platform\WebLogic Collaborate 1.0.1.

2. Select Programs\BEA WebLogic E-Business Platform\WebLogic Collaborate 1.0.1.

3. Choose Repository—>Create Database Schema.

   A Command window is opened and the database schemas are created in the repository. Wait until this step is complete.

4. Choose Start—>Programs—><BEA WebLogic E-Business Platform>—>WebLogic Collaborate 1.0.1—>Repository—>Bulkload Repository Data.

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

5. Choose Start—>Programs—><BEA WebLogic E-Business Platform>—>WebLogic Collaborate 1.0.1—>C-Hub—>Start C-Hub.

   A Command window is opened. WebLogic Server and one c-hub are started. Wait until the message WebLogic Server started appears in the window.

6. Choose Start—>Programs—><BEA WebLogic E-Business Platform>—>WebLogic Collaborate 1.0.1—>Verifier—>Start Verifier.

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

   http://localhost:7001/Verifier.html

   Here localhost represents the machine on which you are running WebLogic Server.

7. 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 is executed 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:

   Partner1 process flow:
   Starting enabler... done.
   Creating conversation... done.
   Sending message: conversation 
   id=verifierConversation:1.0:requestor_http://127.0.0.1:7001/Enabler1_0_98279 
   4402436
   send string=ABCDEFGHI
   status=success
   Waiting for response... done.
   Processing reply:
   received string=abcdefghi
   Verification SUCCESS
   Terminating 
   conversation:verifierConversation:1.0:requestor_http://127.0.0.1:7001/Enable 
   r1_0_982794402436
   status=success
   Shutting down session... done.

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

 

---

Troubleshooting Your Installation

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

Accessing Verifier.html

If your Web browser is unable to connect to the Verifier Web page, the reason may be 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 as follows:

   localhost:listening_port

   In the preceding line, listening_port is the listening port number specified in the WebLogic Server Administration Console. 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. (For instructions, see step 4 in Running the Installation Verification Example.)

Running the Verification Example

Confirm that your system meets the installation prerequisites described in Installation Prerequisites, and that the required software is installed in the correct locations.

After installing WebLogic Collaborate, in a Command window, run the set command to confirm that the following environment variables are correct.

Environment Variable	Setting	Example
JAVA_HOME	Location of the Java 2 SDK V1.3 software on your machine.	JAVA_HOME=D:\bea\jdk130\bin
WL_HOME	Location of the WebLogic Server 6 software on your machine.	WL_HOME=D:\bea\wlserver6.0
WLC_HOME	Location of the WebLogic Collaborate software on your machine.	WLC_HOME=D:\bea\wlcollaborate1.0.1

 

 

---

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—><BEA WebLogic E-Business Platform>—>WebLogic Collaborate 1.0.1—>Uninstall WebLogic Collaborate 1.0.1.

     Note: "BEA WebLogic E-Business Platform" is the name of the default program group. If you changed the name of this program group, substitute your name for the default name provided.

   • 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 window 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 window showing the status of the removal process is displayed.

   .

    

   When the uninstall process is complete, a notification message is displayed.

   

    

3. Click Exit.

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