Installing the Server on Windows Systems

 

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 Windows systems.

This topic includes the following sections:

• About the Variables Used in This Chapter

• Before You Begin

• The Installation Procedure on Windows

• Updating the License File

• Next Steps

• Uninstalling the Server Software on Windows

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:

c:\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:

c:\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 Service Pack 2 is under BEA_HOME in:

c:\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:

c:\bea\jdk130

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

Also, the default location for the separately installed E-Business Control Center client kit is under BEA_HOME in:

c:\bea\E-BusinessControlCenter

Note that after the installation the E-Business Control Center uses its own copy of the JRE to run the graphical user interface, in: c:\bea\E-BusinessControlCenter\jre\bin.

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.

 

---

Before You Begin

Before you start the server installation procedure on supported Windows 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.

• 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:

  c:\bea\WebLogicCommerce3.5\...

• Plan ahead to determine a target location for the E-Business Control Center software. By default, this client software will be installed in:

  c:\bea\E-BusinessControlCenter\...

• 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 Windows

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 Microsoft Windows systems.

The installation procedure uses InstallAnywhere. 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.

Note: The separate client installation for the E-Business Control Center graphical tool installs its own copy of the JRE. This was done because the graphical tool can be installed on a client system that does not already necessarily contain 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.

1. Start the installation by opening one of the following software installation packages for Windows systems.

   • If the kit is the newer version from the BEA Download site: WLCS_35_with_sp1win32.exe.

   • If the kit is the older version from the product CD (April 2001): WLCS_35.exe.

2. 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.

3. 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.

4. The installation procedure displays the Introduction screen. Click the Next button.

5. 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.

6. 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.

   For information about changing the database type from Cloudscape to another database such as Oracle, see the Deployment Guide. To proceed with the installation, click the Next button.

7. 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 c:\bea. After you select the BEA Home Directory, click the Next button.

8. 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 c:\bea\WebLogicCommerce3.5. After you select the target directory, click the Next button.

9. 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.

10. The installation procedure then transfers the product files to your Windows 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.

11. 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.

12. Click the Done button to complete the software installation.

 

---

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:

1. Create a backup copy of your existing license.bea file in BEA_HOME. By default, BEA_HOME is a directory that was created or updated when you installed WebLogic Server 6.0 with SP2. The default location is:

   c:\bea

2. 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.

3. Open a command shell window.

4. Go to the BEA_HOME directory that contains your existing license.bea file and the license update file.

5. Add the JDK to your PATH by entering:

   set PATH=.\jdk130\bin;%PATH%

6. Then enter the following command:

   UpdateLicense 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.

7. 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 Windows

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 Windows systems are as follows:

1. Shut down the server, if it is running.

2. 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.

3. Select the following option on the Start menu:

   Start —> Programs —>BEA WebLogic E-Business Platform —> BEA WebLogic Commerce Server 3.5 —> Uninstall

   Or run the following program:

   WL_COMMERCE_HOME\UninstallerData\Uninstall WLCS 3.5.exe

4. Click the Uninstall button to start the removal of the product files from your system. (InstallAnywhere usually has a delay enabling the display of its Uninstall button as it gathers information.)

5. The InstallAnywhere Uninstaller displays a progress screen.

6. 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.

7. 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.