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

Chapter 2 . Installation on Microsoft Windows NT, 95, and 98 Systems

This chapter provides procedures for:

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)

Microsoft Windows NT

4.0 (Alpha)

Microsoft Windows 95

Not applicable

Microsoft Windows 98

Not applicable

M3 client and server software can be installed and used on the Intel NT and Alpha NT operating systems. The M3 client 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 M3 server systems.

For the hardware and software requirements for these operating systems, see Appendix A, "Platform Data Sheets."

Installing the M3 Software on Microsoft Windows NT Systems

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

Preinstallation Consideration: Backing Up Files

If you are installing M3 software on a system that already has M3 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 are overwritten when the M3 software is re-installed.

To avoid having to modify these files again, proceed as follows:

  1. If you are installing the BEA M3 server 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 M3 software on a Microsoft Windows NT operating system, perform the following procedure:

Note: Before beginning installation, make sure no BEA TUXEDO or BEA M3 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 M3 software without administrative privileges, the following error message will be displayed: "Cannot Install M3 IPC Helper Service."

  1. Insert the BEA M3 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 M3 System Selection screen is displayed.

  8. The BEA M3 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 M3 Installation Selection screen is displayed.

  9. Respond to the BEA M3 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 BEA M3 software.

  17. If your system does not have the required version of Netscape Navigator installed, the Netscape Navigator not found screen is displayed to assist you in installing the correct version.

  18. When the software installation is completed, the BEA M3 TListen Password screen is displayed.

  19. 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-10. The Install performance monitor screen is displayed.

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

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

  22. The Install license screen is displayed.

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

  24. 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 M3 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.

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

  26. Click OK. Your system restarts.

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

Setting Microsoft Windows NT Environment Variables

Before you use the M3 software, you may need to set two environment variables, NETSCAPE and JDK_HOME.

Note: If you run the M3 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 M3 Software Product License After You Install the M3 Software

If you elected not to install your software license when you installed the M3 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 M3 System v2.2->BEA License Utility 2.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 M3 Software Installation on Microsoft Windows NT

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

To run simpapp, open an MS-DOS window and perform the following steps:

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

    1. On the Microsoft Windows NT Task Bar, 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:\M3DIR in the value field, and click OK.

  2. Create a directory under M3DIR and copy the contents of the simpapp directory to it. If you installed the M3 software in the default directory, the simpapp directory is located at C:\M3DIR\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 M3 Software on Microsoft Windows 95 and 98 Systems

Note: Before beginning installation, make sure no BEA TUXEDO or BEA M3 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 M3 software on a Microsoft Windows 95 or 98 operating system, use the following procedure:

  1. Insert the BEA M3 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 M3 Installation Selection screen is displayed.

  8. Respond to the BEA M3 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 BEA M3 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 M3 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 M3 /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.

    Note: If your system does not have the required version of Netscape Navigator installed, the Netscape Navigator not found screen is displayed to assist you in installing the correct version.

  16. The Setup is verifying installation... screen is displayed.

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

  18. The Restart System screen is displayed.

  19. 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 M3 software before you restart your system, the software may fail.

Removing (Uninstalling) the M3 Software from Your System

To remove the M3 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 BEA M3 client or server applications are running. Use tmshutdown to shut down all M3 applications.

  3. Use the Taskbar to click Start->Programs->BEA M3 System v2.2, and click M3 UnInstall 2.2.

  4. Click Yes to confirm the removal. The BEA M3 product is removed from your system and from the Windows Registry.


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