BEA Logo BEA WebLogic Enterprise Release 5.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   WLE Doc Home   |   BEA WebLogic Enterprise Installation Guide   |   Previous   |   Next   |   Contents   |   Index

WLE Installation on Windows NT, 98, and 95 Systems

This chapter discusses the following topics:

Platforms Supported

The Microsoft Windows platforms listed in Table 2-1 are supported.

Table 2-1 Supported Microsoft Platforms

Operating System

Release/Version

Microsoft Windows NT

4.0 Service Pack 4 (SP4) on Intel

Microsoft Windows 95

Service Pack 1

Microsoft Windows 98

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 Upgrading from a Previous Release

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.

Starting with a Clean System

To ensure that you are starting with a clean system, before you install WLE 5.0, follow these steps:

  1. Use the tmshutdown command to stop any running WLE, M3, or BEA TUXEDO applications. This command is described in the Administration topics in the WebLogic Enterprise online documentation.

  2. If necessary, stop the TListen and TUXEDO IPC Helper services. From the Start menu, click Start -> Settings -> Control Panel -> Services. A screen similar to the following is displayed.

  3. Scroll to the entry for the TListen service, select it, and then click the Stop button. The Status value should change from Started to a blank entry. Then scroll to the TUXEDO IPC Helper service, select it, and click the Stop button. In some cases, you may see an error; however, the service's Status value should change from Started to a blank entry. Click the Close button.

  4. Move to a temporary location any files that you or your coworkers added to the%TUXDIR% directory, where TUXDIR is the directory in which the prior WLE, M3, or BEA TUXEDO software resides. This step is necessary because the Windows Add/Remove uninstall program only knows about the original set of files that were installed by BEA. If additional files are present, older directories may continue to exist after you run the uninstall program.

  5. Back up any existing WLE, M3, or BEA TUXEDO files that you customized for your environment. For example, you should back up the Resource Manager (RM) file in %TUXDIR%\udataobj\Rm. The Rm file contains database vendor-specific settings that are used by commands such as buildtms and buildXAJS . You may also need to back up the BEA Administration Console webgui.ini initialization file to a temporary location. This file is located in the %TUXDIR%\udataobj\webgui , where TUXDIR is the directory in which you installed the prior version of WLE, M3, or BEA TUXEDO.

  6. Run the Windows Add/Remove program to remove the prior WLE, M3, or BEA TUXEDO software version. From the Start menu, click Start -> Settings -> Control Panel -> Add/Remove Programs. A screen similar to the following is displayed:

  7. Scroll to the entry for the prior WLE, M3, or BEA TUXEDO software, select it, and click the Add/Remove button.

  8. In response to the prompt, confirm that you want to uninstall the software. After the program finishes, it displays a screen similar to the following:

  9. If the uninstall program was not able to remove all directories (usually because the files were added after the original installation), you can click the Details button to find out which directories remain on your system. If the files in the directories contain changes that you made, such as a modified sample file, move it to a temporary location.

  10. If the prior version of WLE was 4.2 or 4.1, you may need to uninstall the WLE Java and WLE C++ software as separate steps.

  11. Reboot your system after the uninstall completes.

  12. Install the WLE 5.0 software, as described in this chapter. When the WLE 5.0 software installation finishes, compare the files from a previous release that you moved to a temporary location (such as your RM file described in a previous step) with the installed version. If appropriate, customize the installed file so that it contains the data that is appropriate for your environment.

If You Do Not Uninstall Before Starting the WLE 5.0 Installation

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:

  1. WLE 4.2 C++

  2. M3 2.2

  3. TUXEDO 6.5

  4. TUXEDO 6.4

  5. TUXEDO 6.3

  6. TUXEDO 6.2

  7. TUXEDO 6.1 Volume 2

  8. TUXEDO 6.1

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.

Installing the WLE Software on Microsoft Windows NT Systems

This section describes how to install the WLE software on Microsoft Windows NT systems.

Preinstallation Considerations

This section describes some important tasks that you should perform before starting the WLE installation.

Backing Up Files

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:

  1. If you are installing one or more of the WLE server software components, back up the RM file to a temporary location. This file is located in the %TUXDIR%\udataobj or $TUXDIR/udataobj directory, where TUXDIR is the directory in which you installed the M3 or WLE software.

  2. If you are installing the BEA Administration Console, back up the webgui.ini file to a temporary location. This file is located in the %TUXDIR%\udataobj\webgui or $TUXDIR/udataobj/webgui directory.

  3. After the installation is complete, restore these files to their original locations.

Stopping WLE or BEA TUXEDO Applications and Related Services

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.

Checking that Your Account Has Administrator Privilege

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.

Microsoft Windows NT Installation Procedure

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:

  1. Insert the BEA WLE software CD in the CD player. The Windows autorun feature is used to automatically begin the installation. (To bypass the autorun feature, hold down the Shift key while inserting the CD in the CD player. You can then run the setup.exe file in the inwnt40 directory on the CD.)

  2. The Setup screen is displayed, followed by the Welcome screen.

  3. Click Next. The Software License Agreement screen is displayed.

  4. To accept the license agreement, click Yes. The User Information screen is displayed.

  5. Enter your name and the name of your company and click Next. The Registration Confirmation screen is displayed.

  6. If the registration information is correct, click Yes; otherwise, click No and correct the information. The Choose Destination Location screen is displayed.

    The default destination folder is c:\wledir . In the previous sample screen, the user selected d:\wledir .

  7. Click Next to accept the location, or click Browse to select a different location. If you enter a path that does not exist, the installation procedure prompts for a confirmation that you want the directory created.

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

  8. By default, all components are selected for installation. The WLE 5.0 installation procedure lets you select or deselect the components that you want to install. You can also select or deselect specific subcomponents within each category.

    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:

  9. For information about the path on this screen, see the section For All Server Platforms Supporting the BEA Administration Console. To specify a nondefault directory for the BEA Administration Console HTML files, click Browse, specify the nondefault directory, and click Next. Otherwise, click Next. Another Choose Destination Location screen is displayed.

  10. For information about the path on this screen, see the section For All Server Platforms Supporting the BEA Administration Console. To specify a nondefault directory for the BEA Administration Console GUI Java applets, click Browse, specify the nondefault directory, and click Next. Otherwise, click Next. Another Choose Destination Location screen is displayed.

  11. For information about the path on this screen, see the section For All Server Platforms Supporting the BEA Administration Console. To specify a nondefault directory for the BEA Administration Console GUI CGI programs, click Browse, specify the nondefault directory, and click Next. Otherwise, click Next. The Enter Information screen is displayed.

  12. For information about the path on this screen, see the section For All Server Platforms Supporting the BEA Administration Console. To specify a nondefault Web Server client prefix for the GUI CGI directory, click Browse, specify the nondefault prefix, and click Next. Otherwise, click Next. The Select Program Folder screen is displayed.

  13. To specify a nondefault program folder name, enter the folder name or select a folder name from the Existing Folders, and click Next.

  14. If a WLE application is running on the target system, the installation program displays the following screen:

    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:

  15. BEA recommends that you not run multiple versions of WLE, M3, or BEA TUXEDO on the same machine. If appropriate, click Yes to confirm the deletion of files under the previous release's WLEDIR . You are prompted about having the installation program back up the target system's performance data:

  16. To back up your performance data files before you install the WLE performance monitor, click Yes. The BEA WebLogic Enterprise TListen Password screen is displayed:

  17. Enter the tlisten password in the Password field and again in the Confirm field and click Ok. If Cancel is clicked, the tlisten password installation is deferred. For information about the tlisten password and instructions for setting it, see the section Selecting an Administrative Password. The Install license screen is displayed.

  18. To install the WLE software license now, click Yes; otherwise, click No to install the license later. If you click Yes, the Insert License Disk screen is displayed.

  19. Your product license is on a 3.5-inch diskette that is included in the WLE product box. To install the license, insert the license diskette in the disk drive on your machine and, if your diskette drive is drive A, click OK; otherwise, enter the correct drive and click OK. An Information screen is displayed informing you that the WLE license file installed successfully.

    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.

  1. Click OK. The Restart System screen is displayed.

  2. Click OK. Your system restarts.

    Note: If you attempt to run the WLE software before you restart your system, the software will fail.

Setting Microsoft Windows NT Environment Variables

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:

  1. Click the Microsoft Windows NT Start button, and click
    Settings->Control Panel->System->Environment.

    The System Properties screen is displayed.

  2. Enter the JDK_HOME environment variable and set its value to the directory containing the JDK, as shown in the sample screen.

    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.

  3. Click Apply and OK to close the System Properties window.

Installing the Product License After You Install the WLE Software

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
-->BEA License Utility 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.

Running Simpapp to Verify the WLE Software Installation on Microsoft Windows NT

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:

  1. Make sure that the directory in which you installed the WLE software is set in the environment variable TUXDIR . For example, if you installed the software in the default directory, perform the following steps to set the TUXDIR environment variable to C:\WLEDIR :

    1. On the Microsoft Windows NT taskbar, click Start->Settings->Control Panel. The Control Panel is displayed.

    2. Click the BEA Administration icon. The BEA Administration screen is displayed.

    3. If the BEA Administration screen is not displaying the Environment page as shown in the above screen, click the Environment tab. The Environment page is displayed.

    4. Click on the TUXDIR variable, enter C:\WLEDIR in the value field, and click OK.

  2. Create a directory under WLEDIR and copy the contents of the simpapp directory to it. If you installed the WLE software in the default directory, the simpapp directory is located at C:\WLEDIR\Samples\Corba\Simpapp .

  3. Change (cd) to the copy directory.

  4. Check the permissions on all the files in the copy directory and, if necessary, change the permissions to allow full access. To set permissions to full access, enter attrib -R /S *.* .

  5. To run simpapp automatically, enter runme . The simpapp application runs and prints the following messages:

Testing simpapp
cleaned up
prepared
built
loaded ubb
booted
ran
shutdown
saved results
PASSED

  1. To run the sample manually to observe the simpapp processes starting and stopping, perform the following steps:

    1. Enter results\setenv .

    2. Enter tmboot -y . The application starts several processes.

    3. Enter simple_client . The prompt String? is displayed.

    4. Enter a word in lowercase letters. The application converts the word to uppercase and then to lowercase letters.

    5. Enter tmshutdown -y . The application shuts down the processes.

  2. To restore the directory to its original state, enter the following:

    1. results\setenv

    2. nmake -f makefile.nt clean

Running a Basic EJB Sample to Verify the WLE J2EE Software Installation

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.

Main Directory Location

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.

Source Files

The following table lists and describes all the files for this sample application.

File Name

Description

ejb-jar.xml

The XML deployment descriptor file used to help add the bean to the EJB container.

weblogic-ejb-extensions.xml

A file containing the WLE extensions to the deployment descriptor DTD.

Client.Java

The Java source code for the client.

TraderBean.java

The Java source code for the stateless session bean. This class contains the business logic method implementations and methods required by the EJB 1.1 specification.

Trader.java

The Java source code for the Remote interface of the TraderBean class.

TraderHome.java

The Java source code for the Home interface of the TraderBean class.

TradeResult.java

Application-specific utility class used to carry a trade execution result between the EJB and the client.

ProcessingErrorException.java

Application-specific exception thrown by the TraderBean class for business methods.

Utility Files

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.

File

Description

runme.cmd

The batch file that contains commands to set the environment, boot the server, and execute the client for this sample.

run_client.cmd

The batch file to run the client on Windows NT systems.

setenv.cmd

The batch file to set the necessary environment variables on Windows NT systems.

ubbconfig.nt

The WLE server configuration file to be used on Windows NT systems.

ejb_basic_statelessSession.jar

The ejb-jar file that contains the source file classes, the container-specific class files generated by the ejbc command, and the deployment descriptor files. This is the ejb-jar file that is deployed on the WLE server.

Variable Descriptions

HOST

The host name portion of the TCP/IP network address used by the ISL process to accept connections from Java clients. The default value is the name of the local machine.

PORT

The TCP port number at which the ISL process listens for incoming requests; it must be a number between 0 and 65535. The default value is 2468.

IPCKEY

The address of shared memory; it must be a number greater than 32769 unique to this application on this system. The default value is 55432.

Building the EJB Sample Applications

Use the following steps to build the EJB samples:

  1. Make sure that the directory in which you installed WLE is set in the environment variable TUXDIR . Make sure to set the JAVA_HOME environment variable.

  2. Make a copy of the %TUXDIR%\samples\j2ee\ejb directory into a working directory.

  3. Change directory to the working directory.

  4. Change the permissions on all the files to give them write-access. For example:

    prompt>attrib /S -r *

  5. Run the JavaServer version of the sample automatically by entering the runme command:

    prompt>runme basic statelessSession

  6. A number of messages are displayed, along with information about whether the build procedure was successful. The sample is built, the servers are booted, and the client is run once.

After you have executed the runme command, you can run the samples manually if you like. To run the samples manually:

  1. Change the current directory to your work samples directory.

  2. Make sure that your environment is set correctly by entering the following command:

    prompt>setenv

  3. Boot the server, run the client, and shut down the server by entering the following commands:

    prompt>tmboot -y

    prompt>run_client.cmd

    prompt>tmshutdown -y

To restore the sample application directory to its original state:

  1. Set the directory to the directory containing the sample application.

  2. Enter the following command:

prompt>%TUXDIR%\samples\j2ee\ejb\clean.cmd

Installing the WLE Software on Microsoft Windows 98 and 95 Systems

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.

  1. Insert the BEA WLE software CD in the CD player. The Windows autorun feature is used to automatically begin the installation. (To bypass the autorun feature, hold down the Shift key while inserting the CD in the CD player. You can then run the setup.exe file in the inwnt40 directory on the CD.)

  2. The Setup screen is displayed, followed by the Welcome screen.

  3. Click Next. The Software License Agreement screen is displayed.

  4. To accept the license agreement, click Yes. The User Information screen is displayed.

  5. Enter your name and the name of your company and click Next. The Registration Confirmation screen is displayed.

  6. If the registration information is correct, click Yes; otherwise, click No and correct the information. The Choose Destination Location screen is displayed.

  7. The default destination folder is c:\wledir . Click Next to accept this location, or click Browse to select a different location. If you enter a path that does not exist, the installation procedure prompts for a confirmation that you want the directory created.

  8. After you complete the directory path screen, the BEA WebLogic Enterprise Software Component Selection screen is displayed. For an installation on a Windows 98 or Windows 95 system, you can only install components from the client list.

  9. Select one or more of the following client components for the client-only installation:

  10. The WLE software is installed. When the software installation completes, the Update AUTOEXEC.BAT screen is displayed.

  11. Click Yes to update the AUTOEXEC.BAT file. The Set APPDIR environment variable screen is displayed.

  12. Click Yes. The WebLogic Enterprise Application Directory screen is displayed.

  13. To accept the default directory, click Next. To specify a nondefault directory, click Browse, enter the desired directory, and click Next. If BEA /WS Client was selected, the Set WSENVFILE environment variable screen is displayed.

  14. To set the WSENVFILE environment variable, click Yes. The WebLogic Enterprise /WS Environment File screen is displayed.

  1. To accept the default directory, click Next. To specify a nondefault directory, click Browse, enter the desired directory, and click Next. The Setup is verifying installation screen is displayed.

  2. After the Setup program verifies the installation, the Setup has successfully verified installation of product screen is displayed.

  3. The Restart System screen is displayed.

  4. Click OK to restart your system. If you attempt to run the WLE software before you restart your system, the software may fail.

Removing (Uninstalling) the WLE Software from Your System

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:

  1. Log on to the system. If you are using a Microsoft Windows NT system, log on as the administrator or as a member of the Administrator group.

  2. Make sure that no BEA TUXEDO or WLE client or server applications are running. Use tmshutdown to shut down all WLE applications.

  3. On the Microsoft Windows taskbar, click Start -> Programs-> BEA WebLogic Enterprise 5.0-> UnInstall BEA WebLogic Enterprise 5.0. The Confirm File Deletion screen is displayed:

  4. Click Yes to confirm the removal and uninstall the WLE software. The Remove Programs From Your Computer screen is displayed.

    The WLE product is removed from your system and from the Windows Registry.