BEA Logo BEA Enabler for RosettaNet Release 1.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   Enabler for RosettaNet Doc Home   |   Installation Guide   |   Previous Topic   |   Next Topic   |   Contents   |   Index

WebLogic Collaborate Enabler for RosettaNet Installation on UNIX Systems

 

The following sections describe BEA WebLogic Collaborate Enabler for RosettaNet installation procedures for a UNIX system:

 


Installing the Prerequisites

You can install WebLogic Collaborate Enabler for RosettaNet as either a Full Installation (if you do not have WebLogic Collaborate 1.0 installed on your system), or a C-Enabler for RosettaNet Only Installation (if you already have WebLogic Collaborate 1.0 installed on your system).

Before you install the WebLogic Collaborate Enabler for RosettaNet software, make sure you have the software and hardware prerequisites for your installation as described in the following sections:

C-Enabler for RosettaNet Only Installation

Installation prerequisites include:

Full Installation

Installation prerequisites include:

Note: See the Download area on the http://www.bea.com Web site for Service Packs.

Notes: 1. To avoid Java errors, modify PATH so that $JAVA_HOME/bin is first in your PATH:

prompt> PATH=$JAVA_HOME/bin:$PATH

2. Additional installation prerequisites include access to a CD reader (if you are installing WebLogic Collaborate Enabler for RosettaNet from the CD ROM distribution), a network connection, and a Web browser (Netscape Navigator 4.7 or above).

Table 3-2 Database Support

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 bundled with your WebLogic Server distribution and installed with WebLogic Server. A valid license entry for WebLogic jDriver for Oracle is needed in your WebLogic Server license file.

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

Note: To use an Oracle database, the following variables should be defined in the user you create for WebLogic Collaborate Enabler for RosettaNet. 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

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

 


Installing the WebLogic Collaborate Enabler for RosettaNet Software

During the installation procedure you are prompted to choose the install set, that is, either the Full installation or the C-Enabler for RosettaNet Only installation. The WebLogic Collaborate Enabler for RosettaNet installation procedure installs the components as described in Table 3-3.

The following sections describe how you can install the WebLogic Collaborate Enabler for RosettaNet software on UNIX systems:

Using the BEA Installation Program on Solaris Systems

You can install WebLogic Collaborate Enabler for RosettaNet on Solaris systems using either a graphical installation program or a text-based installation program. To use the text-based installation program, refer to Using the Console-Mode Installation on UNIX Systems.

To install WebLogic Collaborate Enabler for RosettaNet on a Solaris system using the graphical installation program, complete the following procedure:

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

  2. Log on to the system with administrative privileges.

  3. It is recommended that you create a UNIX user such as WLC to install WebLogic Collaborate Enabler for RosettaNet. This allows you to control access to the distribution and to set permissions for your WebLogic Collaborate Enabler for RosettaNet software. You may also want to create a group that has permissions to access the software.

  4. Log in as the WebLogic Collaborate Enabler for RosettaNet user you created in step 3.

  5. Download the WebLogic Collaborate Enabler for RosettaNet install.bin distribution from http://www.bea.com, or locate the install.bin program in the unix directory on your WebLogic Collaborate Enabler for RosettaNet CD.

    Consult your UNIX documentation for information about mounting and unmounting CDs.

    Note: The Solaris Volume Management software automatically mounts CDs on /cdrom/cdrom0/. It is not necessary to unmount CDs on Solaris systems. However, to open the CD reader, you need to issue an eject command from the root directory.

  6. Invoke the install.bin command to start the installation procedure. The setup screen is displayed.

    Warning: The installation fails if $JAVA_HOME/bin is not in your PATH. If necessary, update your PATH as follows:
    prompt> PATH=$JAVA_HOME/bin:$PATH

  7. Click OK to continue the WebLogic Collaborate Enabler for RosettaNet installation and display the WebLogic Collaborate Enabler for RosettaNet Introduction screen.

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

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

  10. Click Next to display a screen that prompts you to choose an install set:

  11. Choose an install set and click Next to display a dialog box that prompts you to specify a BEA product directory. The BEA product directory serves as the root directory for all BEA products.

  12. Select your BEA home directory and click Next to display a dialog box that prompts you to specify a BEA product directory.

    Note: When the product is installed, the bea home directory is created under $HOME. A beahomelist file which contains a list of known BEA home directories for the current user is created in the bea directory.

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

  14. Select a database and click Next.

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

  15. Click Done to exit the installer.

  16. Install the software license as described in Installing the Software License.

  17. Set the environment variables as described in Customizing the Run-Time Environment.

Using the Console-Mode Installation on UNIX Systems

Console-mode installation provides a method to install WebLogic Collaborate Enabler for RosettaNet using a text-based installation program that offers the same capabilities as the graphics-based installation program. You can install WebLogic Collaborate Enabler for RosettaNet on Solaris, HP-UX, and AIX operating systems using the console mode.

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

  2. Log on to the system with administrative privileges.

  3. It is recommended that you create a UNIX user, such as WLC, to install WebLogic Collaborate Enabler for RosettaNet. This allows you to control access to the distribution and to set permissions for your WebLogic Collaborate Enabler for RosettaNet software. You may also want to create a group that has permissions to access the software.

  4. Log in as the WebLogic Collaborate Enabler for RosettaNet user you created in step 3.

  5. Download the WebLogic Collaborate Enabler for RosettaNet install.bin distribution from http://www.bea.com, or locate the install.bin program in the unix directory on your WebLogic Collaborate Enabler for RosettaNet CD.

    Consult your AIX, HP-UX, or Solaris documentation for information on mounting and unmounting CDs.

    Note: The Solaris Volume Management software automatically mounts CDs on /cdrom/cdrom0/. It is not necessary to unmount CDs on Solaris systems. However, to open the CD reader, you need to issue an eject command from the root directory.

  6. Invoke the installation procedure:

    prompt> sh install.bin -i console

    A series of prompts is displayed.

    Warning: The installation fails if $JAVA_HOME/bin is not in your PATH. If necessary, update your PATH as follows:
    prompt> PATH=$JAVA_HOME/bin:$PATH

  7. Respond to the prompts by entering the number associated with your choice, or by pressing Enter to accept the default. To exit the installation process, enter quit in response to any prompt. The console-based installation process is divided into sections outlined in the following table.

  8. Install the software license as described in Installing the Software License.

  9. Set the environment variables as described in Customizing the Run-Time Environment.

 


Installing the Software License

If you download WebLogic Collaborate Enabler for RosettaNet from the BEA Web site, an evaluation license is included with the distribution.

If you purchase WebLogic Collaborate Enabler for RosettaNet on a CD, you will receive a license by email from BEA.

How you install the license file depends on which installation set you chose:

Full Installation

Copy the rosettanet_license.bea file into the <WLC_HOME>/license directory, and name the file license.bea

where

C-Enabler for RosettaNet Only Installation

The following procedure assumes that you have a license.bea file in your existing <WLC_HOME>/license directory (where <WLC_HOME> is the product directory where WebLogic Collaborate is installed on your system).

  1. Change directory to the WebLogic Collaborate product directory; for example, /usr/local/bea/wlcollaborate1.0.

  2. Prepare the environment by running the setenv script:

    prompt> . ./setenv.sh

    Note: You must run the setenv.sh script in a Bourne or Korn shell. If you use a csh, change to the Korn shell by typing ksh at your UNIX prompt.

  3. Run the license update utility to merge the WebLogic Collaborate Enabler for RosettaNet license with the existing WebLogic Collaborate (license.bea) file:

    prompt> cd license

    prompt> . UpdateLicense.sh rosettanet_license.bea

    where rosettanet_license.bea is the license you received for the WebLogic Collaborate Enabler for RosettaNet software.

 


Customizing the Run-Time Environment

The installation procedure configures some of your WebLogic Collaborate Enabler for RosettaNet system. Before you proceed to use the software, confirm the environment variables in the setenv.sh script as follows:

  1. Change to the root directory in which the BEA WebLogic Collaborate Enabler for RosettaNet software was installed; for example, /usr/local/bea/wlcollaborate1.0/rosettanet.

  2. Open the setenv.sh file in a text editor and set the following variables to match your environment:

  3. Save, close, and execute the setenv.sh script.

 


Uninstalling the WebLogic Collaborate Enabler for RosettaNet Software

Your WebLogic Collaborate Enabler for RosettaNet product directory structure is dependent on how you installed the software, that is whether you chose the Full Installation (you did not have WebLogic Collaborate 1.0 installed on your system) or the C-Enabler for RosettaNet Only installation option (you already had WebLogic Collaborate 1.0 installed on your system). You can uninstall the product as follows: