[Top] [Prev] [Next] [Bottom]

WLE (C++) Installation on Microsoft Windows NT, 95, and 98 Systems

This chapter discusses the following topics:

Platforms Supported

The Microsoft Windows platforms listed in Table 2-1 are supported.
Table 2-1 Supported Platforms
Vendor Operating System Release/Version

Microsoft

Microsoft Windows NT

4.0 (Intel) with Service Pack 4

Microsoft Windows NT

4.0 (Alpha) with Service Pack 4

Microsoft Windows 95

Not applicable

Microsoft Windows 98

Not applicable

WLE (C++) Full System (client and server) software can be installed and used on the Intel NT and Alpha NT operating systems. The WLE (C++) Client Only software can be installed and used on the Microsoft Windows 95 and 98 operating systems. Microsoft Windows 95 and 98 systems cannot be used as WLE (C++) server systems.

For the hardware and software requirements for these operating systems, see Appendix A, "WLE (C++) Platform Data Sheets."

Installing the WLE (C++) Software on Microsoft Windows NT Systems

This section describes how to install the WLE (C++) software on Microsoft Windows NT systems.

Preinstallation Consideration: Backing Up Files

If you are installing WLE (C++) 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 the WLE (C++) Full System software, back up the RM file to a temporary location. This file is located in the M3DIR\udataobj directory.

  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 M3DIR\udataobj\webgui directory.

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

Microsoft Windows NT Installation Procedure

To install the WLE (C++) software on a Microsoft Windows NT operating system, perform the following procedure:

Note: Before beginning installation, make sure no BEA TUXEDO or WLE client or server applications are running.

Note: It will take approximately 5 minutes to install the software on a local disk; installation on a remote disk may take as long as 10 minutes.

Note: You need administrative privileges to perform the installation. If you attempt to install the WLE (C++) software without administrative privileges, the following error message will be displayed: "Cannot Install WLE IPC Helper Service."

  1. Insert the BEA WLE CD in the CD drive and use the Taskbar to click
    Start->Programs->Windows NT Explorer.

  2. Click the CD drive and then click the Winnt folder.

  3. Double-click the Setup.exe program. The Setup screen is displayed, followed by the Welcome screen.

    .

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

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

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

  7. If the registration information is correct, click Yes; otherwise, click No and correct the information. The BEA WebLogic Enterprise (C++) System Selection screen is displayed.

  8. The BEA WebLogic Enterprise Server System is selected as the default. This selection includes both the server software and the client software. To install the client software only, click the bottom radio button and click Next; otherwise, just click Next. The BEA WebLogic Enterprise (C++) Installation Selection screen is displayed.

  9. Respond to the BEA WebLogic Enterprise Installation Selection screen as follows:

  10. If you chose to install the BEA Administration Console, the Choose Destination Location screen is displayed. Go to the next step. Otherwise, the Select Program Folder screen is displayed. Skip to step 15 and continue.

  11. To specify a nondefault directory for the BEA Administration Console GUI HTML, click Browse, specify the nondefault directory, and click Next. Otherwise, click Next. Another Choose Destination Location screen is displayed.

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

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

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

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

  16. The Setup Program installs the WLE (C++) software. When the software installation is completed, 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" on page 1-12. The Install performance monitor screen is displayed.

  18. To back up your performance data files before you install the WLE performance monitor, click Yes. The Setup is verifying installation... screen is displayed.

  19. After the Setup program verifies the installation, the installation successful screen is displayed.

  20. The Install license screen is displayed.

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

  22. Your product license is on a 3.5-inch disk that is included in the software box. To install the license, insert the license disk in the disk drive on your machine and, if your disk drive is drive A, click OK; otherwise, enter the correct drive and click OK. An Information screen is displayed informing you that the WLE (C++) 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 disk 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.

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

  24. Click OK. Your system restarts.

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

Setting Microsoft Windows NT Environment Variables

Before you use the WLE (C++) software, you may need to set two environment variables, NETSCAPE and JDK_HOME.

Note: If you run the University Sample applications, these variables will be automatically set for you and you can ignore this section.

To set these variables, 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 following environment variables as user variables:

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

Installing the Product License After You Install the WLE (C++) Software

If you elected not to install your software license when you installed the WLE (C++) 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 (C++) 4.2->BEA License Utility 4.2.

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 (C++) Software Installation on Microsoft Windows NT

To verify that you have successfully installed the WLE (C++) client and server software, execute the simpapp application. This "simple application" is a WLE (C++) client/server application that converts strings to uppercase and lowercase letters.

Note: Before attempting to run simpapp, refer to the section "Software Requirements" on page A-14 (for Windows NT/Intel) or the section "Software Requirements" on page A-16 (for Windows NT/Alpha) and ensure that software requirements are satisfied.

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 (C++) 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 Control Panel is displayed.

    3. If the Control Panel is not displaying the Environment page as shown in the above screen, click on 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 (C++) 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

Installing the WLE (C++) Software on Microsoft Windows 95 and 98 Systems

Note: Before beginning installation, make sure no BEA TUXEDO or WLE client applications are running.

Note: It takes approximately 5 minutes to install the software on a local disk; installation on a remote disk may take as long as 10 minutes.

To install the BEA WLE (C++) software on a Microsoft Windows 95 or 98 operating system, use the following procedure:

  1. Insert the BEA WLE CD in the CD drive and use the taskbar to click
    Start->Programs->Windows Explorer.

  2. Click the CD drive and then click the Winnt folder.

  3. Double click the Setup.exe program. The Welcome screen is displayed.

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

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

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

  7. If the registration information is correct, click Yes. Otherwise, click No and correct the information. The BEA WebLogic Enterprise (C++) Installation Selection screen is displayed.

  8. Respond to the Installation Selection screen as follows:

  9. Verify that your machine has enough free disk space and click Next. The Select Program Folder screen is displayed.

  10. To specify a nondefault program folder name, enter the folder name or select a folder name from the Existing Folders, and click Next. The WLE (C++) 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 (C++) 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. The Set WSENVFILE environment variable screen is displayed.

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

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

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

  17. The Restart System screen is displayed.

  18. Click OK to restart your system. To restart your system later, click the No radio button and click OK.

    Note: If you attempt to run the WLE (C++) software before you restart your system, the software may fail.

Removing (Uninstalling) the WLE (C++) Software from Your System

To remove the WLE (C++) 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 NT taskbar, click Start->Settings->Control Panel.

The Control Panel is displayed.

  1. Double click the Add/Remove Programs icon.

The Add/Remove Programs Properties window is displayed.

  1. Click BEA WebLogic Enterprise (C++) 4.2 and click Add/Remove.

  2. Click Yes to confirm the removal.

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


[Top] [Prev] [Next] [Bottom]