Installing the Server on UNIX Systems


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \| Glossary

WLCS Documentation \| Installation Guide \| Previous Topic \| Next Topic \| Contents \| Index

This chapter explains how to install the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 software on supported UNIX systems.

This topic includes the following sections:

Note: There is a separate installation procedure for the BEA E-Business Control Center, a graphical client tool that works with all three product packages. For the client installation details, see Installing the E-Business Control Center.

About the Variables Used in This Chapter

In this chapter, the variable BEA_HOME is used to represent a parent directory, into which BEA products and related software are installed in subdirectories. For example, the default BEA_HOME directory is:

/bea

The variable WL_COMMERCE_HOME is used to represent the installation directory for the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 product packages. For example, by default this location is under BEA_HOME in:

/bea/WebLogicCommerce3.5

The variable WEBLOGIC_HOME is used to represent the prerequisite WebLogic Server installation directory. For example, by default the location for WebLogic Server 6.0 with SP2 is under BEA_HOME in:

/bea/wlserver6.0sp2

Other default locations to note while reading this chapter: the JDK_HOME variable is used to represent the directory where the prerequisite Java 2 SDK was installed during the WebLogic Server installation. For example, by default WebLogic Server 6.0 with SP2 installs the Java 2 SDK under BEA_HOME in:

/bea/jdk130

During the installation procedure, these variables (and others) are assigned in a generated file, set-environment.sh. On UNIX systems, this file resides in the WL_COMMERCE_HOME/bin/unix directory. After the installation, this procedure is invoked each time you start the server to locate required software products.

During the installation, the InstallAnywhere-based procedure uses a JRE that is bundled with the installer. However, the running server software uses the Java 2 SDK in the BEA_HOME/jdk130 directory.

Special JDK Note for Non-Solaris UNIX Customers

As discussed in Latest Kits on the Download Site, a new WLCS installer has been added to the BEA Download site for supported, non-Solaris UNIX systems. The download file name for this installer is WLCS_35_with_sp1UNIX.bin. This installer is not on the product CD that was built in April 2001.

If you are installing the kit for non-Solaris UNIX systems, there are two steps that are required before and after the installation.

Before you run the WLCS_35_with_sp1UNIX.bin installation procedure, you must put the <jdk-install-directory>/bin directory in your system PATH environment variable. For example:
```
%PATH=<BEA_HOME>/jdk130/bin:$PATH
%export PATH
```
Where <BEA_HOME> is the location of the BEA Home directory on the target system.
After you run the WLCS_35_with_sp1UNIX.bin installation procedure, you must edit the value of the JDK_HOME variable in the WL_COMMERCE_HOME/bin/unix/set-environment.sh file. Set JDK_HOME to the path of your JDK. For example, if the installation of WebLogic Server 6.0 with service pack 2 (SP2) is using JDK 1.3.0, you should edit the JDK_HOME line as follows:
```
JDK_HOME=<BEA_HOME>/jdk130
```
Where <BEA_HOME> is the location of the BEA Home directory.

Before You Begin

Before you start the server installation procedure on supported UNIX systems, read the product Release Notes and all of Preparing to Install. Also refer to the following checklist:

Make sure that you have already installed the required version and rolling patch number for BEA WebLogic Server. For details, see Supported Platforms and DDL Files.
Check that the disk(s) on the target system have the required amount of temporary disk space (in the operating system's TEMP directory, for use during the installation) and permanent disk space after the installation for the product directories. You will need enough disk space for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5. You might also need enough disk space for the separate E-Business Control Center client tool, plus the locally installed documentation files.
If you are installing the product on a non-Solaris UNIX system, read the pre-install and post-install steps about the JDK. For details, see the section Special JDK Note for Non-Solaris UNIX Customers.
Plan ahead to determine a target location for the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 software. By default, the server software will be installed in:
/bea/WebLogicCommerce3.5/...
The WebLogic Commerce Server and WebLogic Personalization Server installation will not affect data from previous versions of the products. However, you must install this release of the software in a new directory. Do not install the software in a directory that contains prior versions of WebLogic Commerce Server, WebLogic Personalization Server, WebLogic Portal, WebLogic Application Solutions, or BEA JumpStart.

The Installation Procedure on UNIX

This section steps you through the installation procedure for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 on supported UNIX systems.

The installation procedure uses InstallAnywhere and can be run in graphical or console mode.

To launch the graphical version of the installer (for UNIX systems that support a windowing environment) enter one of the following commands.

If the kit is from the April 2001 product CD and Solaris is the platform:

$ sh WLCS_35.bin

If the kit is from the BEA Download site and Solaris is the platform:

$ sh WLCS_35_with_sp1sol.bin

If the kit is from the BEA Download site and a supported, non-Solaris UNIX system is the platform:

$ sh WLCS_35_with_sp1UNIX.bin

To launch the console version of the installer, add the -i console option after the kit's file name. For example:

$ sh WLCS_35_with_sp1sol.bin -i console

For instructions on the procedures, refer to the appropriate subsections:

Graphical Version of the Installer

To run InstallAnywhere, the procedure bundles its own copy of the JRE. After the installation, the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 software uses the Java 2 SDK 1.3.0 that was installed with WebLogic Server.

Warning: If you are re-installing the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 software on the target system, make sure you first create backup copies of any files that you customized, such as the weblogiccommerce.properties, webflow.properties, and pipeline.properties files in the WL_COMMERCE_HOME directory.

Start the installation by opening the software installation package. As noted earlier, to launch the graphical version of the installer (for UNIX systems that support a windowing environment) enter one of the following commands.
If the kit is from the April 2001 product CD and Solaris is the platform:
```
$ sh WLCS_35.bin
```
If the kit is from the BEA Download site and Solaris is the platform:
```
$ sh WLCS_35_with_sp1sol.bin
```
If the kit is from the BEA Download site and a supported, non-Solaris UNIX system is the platform:
```
$ sh WLCS_35_with_sp1UNIX.bin
```
If your UNIX system does not support a windowing environment, see the next section, Console Version of the Installer.
The installation procedure displays an InstallAnywhere startup screen, and then displays the product splash screen.
Note: Regardless of whether you downloaded or purchased a full license or one of the subset licenses, the installation procedure copies all server files for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 to the target system. After the installation completes, run-time license checks determine which features you can use at server startup time.
On the Splash screen, you can select the language of the button text and other InstallAnywhere instructions on screens displayed during the installation. Make your selection and click the OK button.
The installation procedure displays the Introduction screen. Click the Next button.
On the License Agreement screen, please read the entire license agreement. If you agree, click the Yes radio button and then click the Next button.
On the Important Information screen, read the text about the database configuration. Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 are designed to work with multiple types of databases. By default they are installed and configured for an evaluation Cloudscape database that is shipped with this product.
Note: Currently Cloudscape 3.5.1 is not certified for use on Solaris. Please see the Deployment Guide for details about switching from the default Cloudscape configuration to Oracle. Also, there is an issue with Netscape while accessing a Web application that uses Cloudscape 3.5.1. Please see the Release Notes for information about the Netscape/Cloudscape issue.

To proceed with the installation, click the Next button.
On the Choose BEA Home Directory screen, select the BEA Home directory that you want to use. The required, prior installation of BEA WebLogic Server established a parent directory known as BEA_HOME. The installation procedure will detect the location of your BEA_HOME directory and prompt you to install in that location or an alternative location. By default, this location is /bea. After you select the BEA Home Directory, click the Next button.
On the Choose Product Directory screen, select the subdirectory name under BEA_HOME where you want to install the software files for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5. By default, this location is /bea/WebLogicCommerce3.5. After you select the target directory, click the Next button.
On the Create System Password screen, enter the password that will be used with the system account to boot the server. The password must be at least eight characters in length. After you re-enter the password on the screen, click the Install button.
Note: Do not confuse this password that you will use to start the server with the separate administrator account and its password. See the section Starting the JSP-based Administration Tool for information about the default administrator account.
The installation procedure then transfers the product files to your UNIX system. During this step, it displays two informational billboard screens. The first billboard is for the BEA Developer Center, an online, technical resource for developers at http://developer.bea.com/index.jsp. The second billboard is for the "BEA Customer Management Solutions-Partner Pack" offering. When available, it will contain third-party products from software vendors who integrate their software with Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, or WebLogic Personalization Server 3.5.
After the installation completes, InstallAnywhere displays the Install Complete screen. Notice the message about installing the separate documentation kit after you complete the software installation. For more information, see Installing the Documentation Files.
Note: Also, do not forget to run the separate E-Business Control Center client installation procedure. For details, see Installing the E-Business Control Center.
Click the Done button to complete the software installation.

Console Version of the Installer

This section explains how to run the console version of the UNIX installer.

Start the installation by opening the software installation package. As noted earlier, to launch the console version of the installer (for UNIX systems that do not support a windowing environment) enter one of the following commands.
If the kit is from the April 2001 product CD and Solaris is the platform:
```
$ sh WLCS_35.bin -i console
```
If the kit is from the BEA Download site and Solaris is the platform:
```
$ sh WLCS_35_with_sp1sol.bin -i console
```
If the kit is from the BEA Download site and a supported, non-Solaris UNIX system is the platform:
```
$ sh WLCS_35_with_sp1UNIX.bin -i console
```

The installation script displays an informational message and then asks you to select the language that should be used for installation prompts. For example:

Preparing to install...
Preparing CONSOLE Mode Installation...
==========================================================
Choose Locale...
----------------
    1- Bahasa Indonesia
    2- Catal?
    3- Dansk
    4- Deutsch
  ->5- English
    6- Espanol
    7- Euskara
    8- Francais
    9- Francais (Canada)
   10- Italiano
   11- Nederlands
   12- Norsk
   13- Portuguese
   14- Portuguese (Brasil)
   15- Suomi
   16- Svenska

CHOOSE LOCALE BY NUMBER: 5

Make your selection and press the Enter key.

Note: Currently, only English is supported in the console version of the installer.

The installation script displays a banner and the Introduction text. For example:

============================================================
BEA WebLogic Commerce Server 3.5       (created with InstallAnywhere by Zero G)
--------------------------------------------------------------

============================================================
Introduction
------------

This installer will guide you through the installation of 'BEA WebLogic Commerce Server'. On each step, answer the questions provided.  Type "quit" at any time to exit the installer.

PRESS <ENTER> TO CONTINUE:

The installation script displays the License Agreement text, only a portion of which is shown here. Please read the entire agreement. If you agree, press the Enter key. If you disagree, type quit at a prompt and then press the Enter key to exit the installer.

==========================================================
License Agreement
-----------------

Please read before installing:

BEA SYSTEMS, INC.
SOFTWARE EVALUATION AGREEMENT

Please read this software evaluation agreement ("Agreement") carefully...
   .
   .
   .
PRESS <ENTER> TO CONTINUE:

3.   COPYRIGHT
You acknowledge that the Software provided hereunder is owned by BEA and that you shall not acquire any rights to the Software except as explicitly granted under Section 1 of this Agreement.
   .
   .
   .
THIS SECTION 5 SHALL SURVIVE TERMINATION OR EXPIRATION OF THIS AGREEMENT.

PRESS <ENTER> TO CONTINUE:

If you agree, press the Enter key. If you disagree, type quit at the prompt and then press the Enter key to exit the installer.

   .
   .
   .
6.   DISCLAIMER OF AGENCY
This Agreement shall not be construed as creating an agency, partnership or any other form of legal association between parties.
   .
   .
   .

This Agreement shall be governed by California law.

DO YOU AGREE WITH THE TERMS OF THE LICENSE? (Y/N): Y

If you agree with the terms of the license, press the Enter key.

The installer then prompts you to choose the BEA Home directory. The required, prior installation of BEA WebLogic Server established a parent directory known as BEA_HOME. The installation procedure will detect the location of your BEA_HOME directory and prompt you to install in that location or an alternative location.
In the following example, the existing /home/johnsmith/bea directory is selected. For example:
```
============================================================
Choose BEA Home Directory
-------------------------

    1- Create a New BEA Home
    2- Use Existing BEA Home

Enter a number: 2
    1- /home/johnsmith/bea

Existing BEA Home: 1
```
The installer then prompts for the name of the subdirectory under BEA_HOME where you want to install the software files for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5. By default, this location is /bea/WebLogicCommerce3.5.
In the following example, the person performing the installation accepts the default choice (2), /home/johnsmith/bea/WebLogicCommerce3.5.
```
============================================================
Choose Product Directory
------------------------
```
```
    1- Modify Current Selection (/home/johnsmith/bea/WebLogicCommerce3.5)
    2- Use Current Selection (/home/johnsmith/bea/WebLogicCommerce3.5)

Enter a number: 2
```
The installer then prompts for the system password. Enter the password that will be used with the system account to boot the server. The password must be at least eight characters in length. For example:
```
============================================================
Create System Password
----------------------

Password: weblogic
Good Password! Press "Enter" to continue....
```
Note: Do not confuse this password that you will use to boot the server with the separate Administrator account and its password. See the Release Notes for information about the default Administrator account.

The installation procedure then transfers the product files to your UNIX system. During this step, it displays informational messages and then a confirmation message. For example:

============================================================
Installing...
   .
   .
   .
Install Complete
----------------

Congratulations. 'BEA WebLogic Commerce Server' has been successfully installed to:

   /home/johnsmith/bea/WebLogicCommerce3.5

PRESS <ENTER> TO EXIT THE INSTALLER:

After the software installation completes, remember to install the separate documentation kit. For more information, see Installing the Documentation Files. Also, do not forget to run the separate E-Business Control Center client installation procedure. For details, see Installing the E-Business Control Center.

Updating the License File

After you finish the product software installation and before you start the server, apply the license file that you downloaded or purchased for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, or WebLogic Personalization Server 3.5 to the centralized license.bea file. The license.bea file resides in the BEA_HOME directory. It is an XML-format file.

Read the following steps carefully:

Create a backup copy of your existing license.bea file in BEA_HOME. By default, BEA_HOME is a directory that was created when you installed WebLogic Server 6.0. The default location is:
/bea
When you copy the license file that you received for Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, or WebLogic Personalization Server 3.5 into the BEA_HOME directory, be sure to use a name other than license.bea. In other words, do not overwrite the existing license.bea file. On the BEA Download Web site, the default name for the license update file is license_wlcsps35.bea.
Go to the BEA_HOME directory that contains your existing license.bea file and the license update file.

Add the JDK to your PATH by entering:

$ set PATH=./jdk130/bin:$PATH

$ export PATH

Then enter the following command:
```
$ sh UpdateLicense.sh license_update_file 
```
license_update_file is the name to which you saved the license update file that you received via e-mail or download. On the BEA Download Web site, the default name for the license update file is license_wlcsps35.bea. Running the UpdateLicense script updates your license.bea file.
Save a copy of your license.bea file in a safe place outside the WebLogic distribution. Although no one else can use your license file, you should save this information in a place protected from either malicious or innocent tampering by others.

Next Steps

After you complete the product's server installation and you update the license file:

See Installing the E-Business Control Center, for information about installing the client kit.
See Installing the Documentation Files, for information about installing the documentation files.
Post-Installation Considerations, for information about starting the server for the first time, and other tasks.

If you need to uninstall the server software, see the next section.

Uninstalling the Server Software on UNIX

The steps to uninstall (remove) the Campaign Manager for WebLogic 1.1, WebLogic Commerce Server 3.5, and WebLogic Personalization Server 3.5 software on UNIX systems are as follows:

Shut down the server, if it is running.
Create a backup copy of any files you modified in the WL_COMMERCE_HOME/... directory structure. The InstallAnywhere Uninstaller program should leave those files on your system after the uninstall; thus, the backup copy is just in case any unexpected errors occur.
Run the following script:
```
$ sh UninstallerData/UninstallWLCS3.5
```
Note: The previous command invokes the graphical version of the uninstaller. To invoke the console version, add -i console to the command. For example:
```
$ sh UninstallerData/UninstallWLCS3.5 -i console
```
When the uninstall operation completes, the InstallAnywhere Uninstaller program displays a screen that details which folders could not be removed. Not removing certain directories or files is intentional; InstallAnywhere will not remove any directories that contain files that you modified or added to the WL_COMMERCE_HOME directories.
Click the Exit button.

After the uninstall, check any remaining files in the WL_COMMERCE_HOME directory structure and decide whether you need to set those files aside for subsequent use. If desired, remove the WebLogicCommerce3.5 folder from the directory structure.