Installing the Server on Windows Systems for the GA

 

This chapter explains how to install the WebLogic Portal software on supported Microsoft Windows systems.

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.

This topic includes the following sections:

• 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, that works with WebLogic Portal. For the client installation details, see Installing the E-Business Control Center for the GA.

 

---

The Installation Procedure on Windows

This section steps you through the installation procedure for WebLogic Portal on supported Windows systems.

The WebLogic Portal installation procedure uses InstallAnywhere. To run InstallAnywhere, the procedure bundles its own copy of the JRE. After the installation, the WebLogic Portal software uses the Java 2 SDK 1.3.1 that was installed with WebLogic Server.

Note: The separate client installation for the E-Business Control Center installs its own copy of the JRE.

Warning: If you are re-installing the WebLogic Portal software on the target system, make sure you first create backup copies of any files that you customized, such as the weblogiccommerce.properties file in the PORTAL_HOME directory.

1. Stop any running WebLogic Portal servers.

2. Start the installation by opening wlportal400_win.exe.

3. 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 WebLogic Portal license or the WebLogic Personalization Server only license, the installation procedure copies all server files to the target system. After the installation completes, run-time license checks determine which features you can use at server startup time.

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. WebLogic Portal is designed to work with multiple types of databases. By default it is 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, refer to Configuring Other Databases 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. After you select the BEA Home Directory, click the Next button.

   If a message appears that says a previous installation exists at BEA_HOME\wlportal4.0, click Continue.

   If the WebLogic Portal installation detects that the required version and service pack number of WebLogic Server does not exist the BEA_HOME directory you selected, an error screen will appear. Figure 6-4 shows a sample screen:

   Figure 6-4 Selected BEA_HOME Does Not Contain Required WLS Version and Service Pack Number

   
    

   If you encounter this error, exit the installation. Then either:

   • Restart the WebLogic Portal installation and select a different BEA_HOME directory, if it contains the required WebLogic Server version and service pack number.

   • Or install the WebLogic Server 6.1 software and service pack number that WebLogic Portal requires. Then restart the WebLogic Portal installation.

8. On the Choose Product Directory screen, select the subdirectory name under BEA_HOME where you want to install the software files for WebLogic Portal. By default, this location is BEA_HOME\wlportal4.0. 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 Administration Tools 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 four informational billboard screens.

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 for All Releases.

    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 for the GA.

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

2. When you copy the license file that you received for WebLogic Portal 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_wlportal400.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=.\jdk131\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_wlportal400.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 the GA, for information about installing the client kit.

• See Installing the Documentation Files for All Releases, for information about installing the documentation files.

• Post-Installation Considerations for All Releases, 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 WebLogic Portal software on Windows systems are as follows.

Note: If you installed the separate WebLogic Portal documentation files in PORTAL_HOME\applications\wlpDocsApp\wlpDocs\..., as explained in Manually Integrated Documentation Option Instructions, you may want to copy or remove the documentation files in advance of the WebLogic Portal software uninstall operation.

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

2. Create a backup copy of any files you modified in the PORTAL_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 Portal 4.0 —> Uninstall BEA WebLogic Portal 4.0

   Or run the following program:

   PORTAL_HOME\uninstaller\uninstall.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 PORTAL_HOME directories.

7. Click the Exit button.

After the uninstall, check any remaining files in the PORTAL_HOME directory structure and decide whether you need to set those files aside for subsequent use. If desired, remove the wlportal4.0 folder under the BEA_HOME directory.