|
|
|
|
|
This chapter discusses the following topics:
The Microsoft Windows platforms listed in Table 2-1 are supported.
Platforms Supported
Operating System |
Release/Version |
|---|---|
You can install all or selected WLE server, client, and administration components on a Microsoft Windows NT 4.0 SP4 (Intel) operating system. You can install only the WLE client components on the Microsoft Windows 95 and 98 operating systems. Windows 95 and 98 systems cannot be used as WLE server systems.
For the hardware and software requirements for these operating systems, see WLE Platform Data Sheets.
If you are installing the WLE 5.0 software on a Windows NT, Windows 98, or Windows 95 system that contains a previous version of WLE, M3, or BEA TUXEDO software, there are important upgrade considerations.
In general, BEA recommends that you use the Windows Add/Remove (uninstall) program to remove a previous version of WLE, M3, or BEA TUXEDO software on the target system, before you install WLE 5.0. Although the WLE 5.0 installation program detects most prior versions of the WLE, M3, and BEA TUXEDO software on your Windows system and could remove them for you during the WLE 5.0 installation, in some cases older Registry key values or Windows Start menu items could continue to exist after the WLE 5.0 installation completes.
Note: BEA strongly recommends that you not run more than one version of WLE, M3, or BEA TUXEDO software on the same system. Unexpected problems can occur.
To ensure that you are starting with a clean system, before you install WLE 5.0, follow these steps:
Although BEA does not recommend it, it is possible to install the WLE 5.0 software on a system that contains a previous version of WLE, M3, or BEA TUXEDO.
During the WLE 5.0 installation, before asking the installer for the destination path, the program checks whether the WLE 5.0 software is already installed by looking into the Registry for the following known key:
HK_LOCAL_MACHINE\\SOFTWARE\\BEA Systems\\WebLogic Enterprise\\5.0
If the WLE 5.0 installation program finds this key, it defaults to the path found under that key in the Environment\\TUXDIR key.
If the procedure does not find the key, it defaults to C:\WLEDIR .
After selecting the destination path and components to install, the program looks for older versions of BEA software in the following order:
If any of the prior software product versions are found, the WLE 5.0 program checks to see if the TUXEDO IPC Helper & TListen services are running. If they are running, the procedure asks if you want the program to stop them. If you click No, the installation program exits. If you click Yes, the program attempts to stop the services.
If successful, the program identifies the existing product name and version that it found on your system. The program then asks if you want to delete the detected previous release. If you click No, a message box is displayed telling you that the previous release is not removed, and the installation continues in the destination directory you selected earlier (not the directory where the previous version resides).
Note: Although this multiple version configuration is not recommended, it is possible to have multiple versions on the same system. One potential problem is that the WLE 5.0 services overwrite the previous software's services in the Startup settings.
If you indicated that you want the older software release removed, the following happens:
To summarize, the best and recommended option is to first uninstall the previous software, as outlined in the section Starting with a Clean System.
This section describes how to install the WLE software on Microsoft Windows NT systems.
This section describes some important tasks that you should perform before starting the WLE installation.
If you are installing WLE software on a system that already has M3 or WLE software installed, there are some files that you may want to back up prior to the installation, and then restore them after the installation is complete. This is because some files that you may have modified for your M3 or WLE software are overwritten when the WLE software is installed.
To avoid having to modify these files again, proceed as follows:
Installing the WLE Software on Microsoft Windows NT Systems
Preinstallation Considerations
Backing Up Files
Before beginning the installation, make sure no BEA TUXEDO or WLE client or server applications are running. For information about the tmshutdown command, see Starting and Shutting Down Applications in the Administration section of the WebLogic Enterprise online documentation.
You need administrator privileges to perform the installation. If you attempt to install the WLE software without administrator privileges, the following error message will be displayed:
Cannot Install TUXEDO IPC Helper Service.
It will take approximately 10 minutes to install the software.
Warning: If you are re-installing the WLE 5.0 software on your system, and you also already installed the optional WLE Security Service software (56-bit or 128-bit) on your system, you must:
To install the WLE software on a Microsoft Windows NT operating system, perform the following steps:
The default destination folder is c:\wledir . In the previous sample screen, the user selected d:\wledir .
After you complete the directory path screen, the BEA WebLogic Enterprise Software Component Selection screen is displayed.
Note: Depending on the resolution of your screen, the Administration Console option might appear in an abbreviated form, such as "Administration" or "Administration Co."
You must select at least one component or subcomponent for installation. Selecting a main component category causes all of its subcomponents to be selected. Deselecting a component causes all of its subcomponents to be deselected. Deselecting all subcomponents causes their parent component to be deselected.
The main component categories are:
Within the Servers category, the options are:
This feature allows you to install one or more server components on the target system.
If you select the Clients component, you can indicate which types of clients you want to install. Depending on the selections you made in the Servers category, the Client options are:
The Administration category consists of the Administration Console and does not have any subcomponents. For information about how to start this Console after it is installed, refer to BEA Administration Console Startup. For information about how to use this Console, refer to the online help that is accessible through the Console's Help button.
When you have made your selections, click Next. If you indicated that you wanted to install the Administration component, the Choose Destination Location screen for the Administration Console HTML files is displayed.
If stopping a running WLE application and its related services on the target system is appropriate, select Stop WebLogic Enterprise Services and click Next to proceed. The WLE installation program attempts to stop the application and its services for you. If the installation program cannot stop the application, exit the installation and use the tmshutdown command. For information about the tmshutdown command, see Starting and Shutting Down Applications in the Administration section of the WebLogic Enterprise online documentation.
If there were no WLE applications running, or if the WLE applications were successfully stopped, the installation procedure proceeds. If a prior version of M3 or WLE was installed on the target system, the installation program asks whether you want to remove it, as shown in the following screen:
BEA recommends that you not run multiple versions of WLE, M3, or BEA TUXEDO on the same machine. If appropriate, click Yes to remove the prior version or an earlier installation of WLE 5.0. The Delete Directory screen is displayed:
Note: If you decide that you do not want to install the license now, but you want to complete the installation procedure and install the license later, do not click Cancel. Clicking Cancel terminates the installation. Instead, remove the license diskette from the disk drive and click OK. A screen is displayed that states that the lic.txt could not be found and you can elect to complete the installation without installing the license.
Note: If you attempt to run the WLE software before you restart your system, the software will fail.
Before you use the WLE software, you may need to define the JDK_HOME environment variable.
Note: If you run the University Sample applications, this variable will be automatically set for you and you can ignore this section.
The JAVA_HOME variable is needed only to build and run Java clients.
To set this variable, perform the following procedure:
Settings->Control Panel->System->Environment.
The System Properties screen is displayed.
Note: For instructions on how to set environment variables, click the Microsoft Windows NT Start button, click Help, and enter environment variables on the Index tab.
If you elected not to install your software license when you installed the WLE software, you can install the license using the BEA License Utility.
Note: Your product license is on a 3.5-inch disk that is included in the software box.
To install the license, perform the following steps:
1. Insert the license disk into the disk drive on your machine.2. Use the taskbar to click Start-->Programs-->BEA WebLogic Enterprise 5.0
The BEA License Utility screen is displayed.
3. If the disk drive on your machine is drive A, click OK; otherwise, enter the correct drive and click OK. The license is installed and the License File updated message is displayed.
To verify that you have successfully installed the WLE client and server software, execute the simpapp application. This "simple application" is a WLE client/server application that converts text strings to uppercase and lowercase letters.
Note: This section assumes you installed all WLE server components, or one of the CORBA server components. If you installed only the J2EE server component, see the next section, Running a Basic EJB Sample to Verify the WLE J2EE Software Installation, for information about running an EJB sample to verify the installation.
Before attempting to run simpapp , refer to the section Software Requirements to ensure that the software requirements are satisfied. For example, the path to the Microsoft Visual C++ 6.0 environment must be known on this system, because nmake is used.
To run simpapp , open an MS-DOS window and perform the following steps:
Testing simpapp
cleaned up
prepared
built
loaded ubb
booted
ran
shutdown
saved results
PASSED
If you installed only the WLE J2EE server component, you can run a stateless session EJB sample provided by the WLE software to verify the installation.
Before running the sample application, see Appendix A, "WLE Platform Data Sheets" for important information about prerequisite software. For example, on NT systems, you must first download and install the Java 2 SDK version 1.2.2.
This sample demonstrates the usage of stateless session EJBs using a simple stock trader application. This sample demonstrates how the client must maintain any persistent state -- such as the change in the cash account -- across repeated calls to the session EJB. All the logic for the balance is encapsulated in the client, where all the persistence is provided by the container and the logic is maintained in the EJB.
The EJB in this sample provides basic trading methods, such as buying and selling stocks. Because there are no persistent stores involved in this sample, all the stock data are set in the deployment descriptor of the EJB as environment properties. The container supplies the data to the EJB through a JNDI lookup operation.
The following directory contains the Java source files and XML-based deployment descriptors, where TUXDIR is the directory in which you installed the WLE software:
%TUXDIR%\samples\j2ee\ejb\basic\statelessSession
A common build script, runme.cmd , is provided for all the EJB samples and is in the following directory:
%TUXDIR%\samples\j2ee\ejb
This rumme.cmd file contains commands to set the environment, boot the server, and execute the client for this sample.
The following table lists and describes all the files for this sample application.
The following table lists and describes the utility files for this sample application. These files are generated based on the WLE installation environment. Because a common build script is provided for all the EJB samples, instructions to build and execute the samples are provided in the section Building the EJB Sample Applications. The runme.cmd
file resides in the %TUXDIR%\samples\j2ee\ejb
directory. The other utility files are in the %TUXDIR%\samples\j2ee\ejb\basic\statelessSession
directory.
Utility Files
File |
Description |
|---|---|
|
The batch file to set the necessary environment variables on Windows NT systems.
|
|
|
The WLE server configuration file to be used on Windows NT systems.
|
|
HOST
PORT
IPCKEY
Use the following steps to build the EJB samples:
Variable Descriptions
Building the EJB Sample Applications
prompt>attrib /S -r *
prompt>runme basic statelessSession
After you have executed the runme command, you can run the samples manually if you like. To run the samples manually:
prompt>setenv
prompt>tmboot -y
prompt>run_client.cmd
prompt>tmshutdown -y
To restore the sample application directory to its original state:
prompt>%TUXDIR%\samples\j2ee\ejb\clean.cmd
Notes: Before beginning installation, ensure that no BEA TUXEDO or WLE applications are running.
It takes approximately 10 minutes to install the software.
Warning: If you are re-installing the WLE 5.0 software on your system, and you also already installed the optional WLE Security Service software (56-bit or 128-bit) on your system, you must:
To install the BEA WLE software on a Microsoft Windows 98 or 95 operating system, follow the steps listed below.
Note: In this section, installation screens that are identical to the screens shown in the Windows NT section are not repeated.
This section explains how to remove the WLE software from your system.
Warning: If you also installed the optional WLE Security Service software (56-bit or 128-bit) on your system, you must:
To remove the WLE software from your system, proceed as follows:
The WLE product is removed from your system and from the Windows Registry.
|
|
|
Copyright © 1999 BEA Systems, Inc. All rights reserved.
|