Installing the E-Business Control Center for the GA

 

For installation instructions for the latest release, see Installing Service Pack 1.

This chapter explains how to install the E-Business Control Center software on supported client systems. The client can be installed either standalone, or on the same system as the server software if the platform supports both.

Note that WebLogic Portal is used as a product suite name that refers to all portal, campaign, commerce, and personalization features. If you purchased the full WebLogic Portal license, you can use all the features of the product suite. If you purchased the WebLogic Personalization Server license, you can use only the personalization features. The common installation procedure installs all the product software. Run-time license checks determine which features you may use. Text in this document that refers to WebLogic Portal also applies to WebLogic Personalization Server.

You can use the E-Business Control Center to manage the characteristics of portals, promotional campaigns, campaign discounts, stand-alone discounts, customer segments, content selectors, ad placeholders, custom events, and other entities of a Web application.

Note: To see which platforms the E-Business Control Center is supported on, see Supported Platforms.

This topic includes the following sections:

• The E-Business Control Center Installation Procedure

• Updating the License File

• Next Steps

• Uninstalling the Client Software

Note: There is a separate installation procedure for the BEA WebLogic Portal server packages. For details, see Installing the Server on Windows Systems for the GA.

 

---

The E-Business Control Center Installation Procedure

This section steps you through the installation procedure for E-Business Control Center on supported Microsoft Windows and Solaris 8 client systems.

Check the Release Notes for information on service packs or patches for the E-Business Control Center.

Warning: If you are re-installing the E-Business Control Center software on the target system, make sure you first create backup copies of any files that you customized.

1. Exit the E-Business Control Center if it is running.

2. Windows: Start the installation by running this file: ebcc400_win.exe.
   
   Solaris 8:

   1. Download the ebcc400_with_sp2_sol.bin file from the BEA WebLogic Portal Download site.

   2. Run either of the following to begin the installation:

      $ sh ebcc400_with_sp2_sol.bin (for the graphical version), or

      $ sh ebcc400_with_sp2_sol.bin -i console (for the console version)

      Note: The console version of the Solaris 8 E-Business Control Center installer is almost identical to the console installer for the server. For more information, see Console Version of the Installer.

3. The installation procedure displays an InstallAnywhere startup screen, and then displays the product splash screen.

4. In the Introduction window, click Next.

5. In the License Agreement window, please read the entire license agreement. If you agree, select Yes and click Next.

6. In the Choose BEA Home Directory window, select the BEA Home directory that you want to use. If a BEA Home directory does not exist, the installation procedure can create one for you. Click Next.

7. In the Choose Product Directory window, select the subdirectory name under BEA_HOME where you want to install the software files for the E-Business Control Center. By default, this location on Windows systems is BEA_HOME\ebcc4.0. On Solaris 8, the default directory is BEA_HOME/ebcc4.0. After you select the target directory, click Install.

8. The installation procedure transfers the product files to your system. During this step, it displays an informational billboard screen for the BEA Developer Center, an online, technical resource for developers at http://developer.bea.com/index.jsp.

9. After the installation completes, InstallAnywhere displays the Install Complete window. Click Done to complete the software installation.

 

---

Updating the License File

The licensing step for the E-Business Control Center depends on whether you installed it standalone or on a machine that also includes the server software.

If you installed the E-Business Control Center on a supported machine that also has the server software, the E-Business Control Center will use the license file in BEA_HOME. This assumes that you followed the steps to use UpdateLicense.cmd to apply the update license file (by default, license_wlportal400.bea) to the license.bea file. For details, see the licensing sections in Installing the Server on Windows Systems for the GA, or in Installing the Server on UNIX Systems for the GA.

If you installed the E-Business Control Center client tool on a supported machine that does not also have the server software, copy the updated license file from your server system to the BEA_HOME directory on the client system. Before you save or copy the license file into BEA_HOME on the client, check that you are not overwriting an existing license.bea file.

 

---

Next Steps

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

• See Installing the Documentation Files for All Releases, for information about installing the full server and client documentation set. Note that a copy of the E-Business Control Center online Help is also included in the locally installed documentation and on e-docs.

• Post-Installation Considerations for All Releases, for information about starting the server for the first time, starting the E-Business Control Center for the first time, and other tasks.

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

 

---

Uninstalling the Client Software

To uninstall (remove) the E-Business Control Center software:

1. Exit the E-Business Control Center if it is running.

2. Create a backup copy of any files you modified in the BEA_HOME\ebcc4.0\... 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. Windows: Select the following option on the Start menu:

   Start —> Programs —>BEA WebLogic E-Business Platform —> BEA E-Business Control Center 4.0 —> Uninstall

   Or run the following program:

   BEA_HOME\ebcc4.0\uninstaller\Uninstall.exe

   Solaris 8: Run the following program:

   $ sh BEA_HOME/ebcc4.0/uninstaller/
   Uninstall_ebcc400_with_sp2_sol.bin (for the graphical version), or

   $ sh BEA_HOME/ebcc4.0/UninstallerData/
   Uninstall_ebcc400_with_sp2_sol.bin -i console (for the console version)

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

   The InstallAnywhere Uninstaller displays a progress screen.

5. 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 BEA_HOME\ebcc4.0\... or BEA_HOME/ebcc4.0/...directories.

6. Click Exit.

After the uninstall, check any remaining files in the BEA_HOME\ebcc4.0\... or BEA_HOME/ebcc4.0/... directory structure and decide whether you need to set those files aside for subsequent use. If desired, remove the ebcc4.0 folder from the directory structure.