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

Chapter 3 . Installation on UNIX Systems

This chapter provides procedures for:

Platforms Supported

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

Digital

Digital UNIX

4.0d (Alpha)

HP

HP-UX

10.20 and 11.00

IBM

AIX

4.2.1 (RS/6000, SP2)

Sun

Solaris

2.5.1 and 2.6 (UltraSPARC)

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

Installing the M3 Software on UNIX Systems

This section describes how to install the M3 software on UNIX 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.

UNIX Installation Procedure

Note: Before beginning installation, use the tmshutdown command to shut down any active M3 or BEA TUXEDO applications.

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.

Note: On most systems, you need superuser privileges to mount the CD.

To install the BEA M3 software on a UNIX operating system, use the following procedure:

  1. Log on to the system with administrative privileges.

  2. Insert the BEA M3 CD into the reader.

  3. Mount the CD as a file system. For platform-specific instructions on how to do this, see Appendix A, "Platform Data Sheets." On most systems you need superuser privileges to perform the mount.

    Note: If your system does not have a directly connected CD reader, you can mount the CD on a remote system, share (export) the CD file system, and then mount the remote file system. For detailed instructions for each platform, see Appendix A, "Platform Data Sheets." Alternatively, you can mount the CD on a remote system, copy the contents of the CD directory for your platform to the system in which you plan to install the BEA M3 software, and continue with the remainder of the installation procedure. Table 3-2 lists the CD directory names.
    Table 3-2 BEA M3 CD Directory Name for UNIX Platforms
    Platform Directory

    Digital UNIX v4.0d on DEC Alpha

    alpha/dux40

    HP UX v10.20 on HP 9000 Series 800

    hp/hpux1020

    HP UX v11 on HP 9000 Series 800

    hp/hpux11

    IBM AIX v4.2.1 on RS/6000 and SP2

    ibm/aix421

    Solaris v2.5.1 on UltraSPARC

    sun5x/sol251

    Solaris v2.6 on UltraSPARC

    sun5x/sol26

  4. Log on to the M3 account, if it was set up.

  5. Change directory to the root of the mounted CD.

  6. To invoke the installation procedure, enter sh ./INSTALL.SH. The following prompt is displayed: 

    01) ALPHA/DUX40  02) HP/HPUX1020    03) HP/HPUX11   
    04)IBM/AIX421    05) SUN54/SOL251   06) SUN54/SOL26
    Install which platform's files [01-06, q to quit, l for list]:

  7. Select the desired operating system. For example, if you select Digital UNIX, the following prompt is displayed: 

    ** You have chosen to install from ALPHA/DUX40 **
    BEA M3 System Release 2.2
     
    This directory contains the BEA M3 Core System for Digital Unix 4.0 on DEC Alpha.
     
    Is this correct [y,n,q]:

  8. Enter y. The following prompt is displayed: 

    To terminate the installation at any time 
    press the interrupt key, 
    typically <del>, <break>, or <ctrl+c>.
    The following packages are available:
     
      1    m3           BEA M3 Core System
     
    Select the package(s) you wish to install (or 'all' to install all packages) (default: all) [?,??,q]:

  9. Enter 1. The following prompt is displayed: 

    BEA M3 Core System
    (alpha) Release 2.2
    Copyright (c) 1998 BEA Systems, Inc.
    All Rights Reserved.
    BEA and M3 are trademarks of BEA Systems, Inc.
    The following installation options are available:
     
     1 both        Install the full M3 System - client and server
     2 client      Install the client only

    Select an option (default: both) [?,??,q]:

    Note: The following steps assume that you select option 1.

  10. Select the desired option. The following prompt is displayed: 

    Directory where M3 files are to be installed [?,q]:

  11. Enter the name of the desired directory (for example, /usr/local/M3DIR). If you elected to install the full M3 system, the following prompt is displayed: 

    Determining if sufficient space is available...
    63292 blocks are required
    658976 blocks are available to /usr/local/M3DIR
    Using /usr/local/M3DIR as the M3 base directory
     
    Directory where BEA Administration Console documents and images are to be installed (default: /usr/local/M3DIR/udataobj/webgui) [?,q]:

  12. This prompt allows you to choose between (a) accepting default locations for files being installed, or (b) specifying nondefault pathnames for these files. For details, see the section "Selecting Directories for the M3 Files" on page 1-8. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/M3DIR/udataobj/webgui
    Using /usr/local/M3DIR/udataobj/webgui as the BEA Administration Console document tree
     
    Directory where BEA Administration Console java applets are to be installed (default:/usr/local/M3DIR/udataobj/webgui/java) [?,q]:

  13. Again, you have a choice. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/M3DIR/udataobj/webgui/java
    Using /usr/local/M3DIR/udataobj/webgui/java as the BEA Administration Console document tree
     
    Directory where BEA Administration Console CGI programs are to be installed (default: /usr/local/M3DIR/udataobj/webgui/cgi-bin) [?,q]:

  14. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/M3DIR/udataobj/webgui/cgi-bin
    Using /usr/local/M3DIR/udataobj/webgui/cgi-bin as the BEA Administration Console CGI directory
     
    Web server client prefix for CGI directory. /cgi-bin is a good choice for most web servers. (default: /cgi-bin) [?,q]:

  15. If you accept the default, the following prompt is displayed and the install program proceeds to install the M3 files: 

    Using /cgi-bin as the BEA Administration Console CGI prefix
    Unloading /kits/dec/pxx/alpha/dux40/iceberg/WS.Z...

  16. After the installation of the M3 files is completed, the following prompt is displayed: 

    ... finished
    Moving BEA Administration Console files to their proper
               location...
    ... finished
     
    Changing file permissions...
    ... finished
     
    Processing default license file...
    ... finished
     
    Install tlisten password? [y/n]:

  17. If you want to specify a tlisten password, enter y; otherwise enter n. For information about the tlisten password and instructions for setting it, see the section "Selecting an Administrative Password" on page 1-10. If you enter y, the following prompt is displayed: 

    Please enter the tlisten password:

  18. Enter the tlisten password. The following prompt is displayed: 

    Please verify the password:

  19. Enter the tlisten password again. The following prompt is displayed: 

    tlistpwd: INFO: Password appended to file "/usr/local/M3DIR/udataobj/tlisten.pw".
    Verifying installation... 
    ... Installation successful!
     
    If your license file is accessible, you may install it now.
    Install license file? [y/n]:

  20. If you want to install the BEA M3 software license now, enter y; otherwise, enter n and install the license later. If you enter y, the following prompt is displayed: 

    To terminate the license update at any time
    press the interrupt key,
    typically <del>, <break>, or <ctrl+c>.
    Directory containing source license text file [?,q]:

  21. Insert the license disk, which is shipped in the BEA M3 software box, in the disk reader on your machine, mount the disk (if necessary), copy the lic.txt file to a system directory, and enter the location of the lic.txt file at the prompt. For example, if you copy the lic.txt file to /usr, enter /usr. The following prompt is displayed: 

    Using /usr/lic.txt to copy license information.
    Updating /usr/local/M3DIR/udataobj/lic.txt with license information.
     
    Please don't forget to fill out and send in your registration card

  22. After the installation is completed, unmount the CD file system and remove the CD from the reader. For platform-specific instructions for unmounting the CD, see Appendix A, "Platform Data Sheets."

Installing the M3 Software 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, use the following steps:

  1. Insert the license disk, which is shipped in the M3 software box, in the disk reader on your machine, mount the disk (if necessary), and copy the lic.txt file to a directory of your choice, but not to the M3DIR directory or any of its subdirectories.

  2. Enter the following command to change to the /bin directory: 

    cd /usr/local/M3DIR/bin

  3. Enter sh ./lic.sh. The following prompt is displayed: 

    To terminate the license update at any time
    press the interrupt key,
    typically <del>, <break>, or <ctrl+c>.
    Directory containing source license text file [?,q]:

  4. Enter the name of the directory that contains the lic.txt file (for example, /kits/license). The following prompt is displayed: 

    Using /kits/license/lic.txt to copy license information.
    Directory where M3 files are installed. [?,q]:

  5. Enter /usr/local/M3DIR or the name of the directory where you installed the M3 software. The following prompt is displayed: 

    Updating /usr/local/M3DIR/udataobj/lic.txt with license information.

Running Simpapp to Verify the M3 Software Installation

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, perform the following steps:

  1. Make sure that the directory in which you installed M3 is set in the environment variable TUXDIR. For example, if you installed the M3 software in the default directory, enter the following to set the TUXDIR environment variable:
    TUXDIR=/usr/local/M3DIR; export TUXDIR

  2. Create a directory under M3DIR and copy the content of the simpapp directory to it. If you installed the M3 software in the default directory, the simpapp directory is located at usr/local/M3DIR/samples/corba/simpapp.

  3. Change (cd) to the copy directory.

  4. To change the permissions on all the files to allow full access, enter:
    chmod 777 *.

  5. Make sure make is in your path.

  6. To run the simpapp automatically, enter ./runme.ksh. 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 simpapp manually to observe the processes starting and stopping, do the following:

    1. Enter . ./results/setenv.ksh.

    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.

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

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

    1. . ./results/setenv.ksh

    2. make -f makefile.mk clean

Removing (Uninstalling) the M3 Software from Your System

To remove the software from your system, use the following procedure:

  1. Log on as the M3 administrator.

  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. Enter the following command: 

    # rm -rf M3DIR

    where M3DIR is the BEA M3 base directory.


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