6.22.1.1 Running simpapp to Verify the Oracle Tuxedo ATMI Software Installation on a UNIX System

To configure and run the ATMI version of simpapp on a UNIX system, follow these steps:

1. Log in to the target machine as the Oracle Tuxedo application administrator and open a command-line shell.
2. Create a working directory for your sample application and change to it:

   
   cd /home/me
   mkdir atmi
   cd atmi

3. Set and export the environment variables used by the Oracle Tuxedo system, as explained in Setting Environment Variables on a UNIX System. Set APPDIR and TUXCONFIG as follows:

   
   APPDIR=/home/me/atmi
   TUXCONFIG=$APPDIR/tuxconfig
   export APPDIR TUXCONFIG

   Note:

   You do not have to set the WEBJAVADIR environment variable.
4. Copy the simpapp files to your working directory. You need to edit one of them: the configuration file, ubbsimple. Make sure that the client and server files, simpcl and simpserv, are executable, and that the configuration file, ubbsimple, is writable. For example:

   
   cp $TUXDIR/samples/atmi/simpapp/* .
   chmod 755 simpserv simpcl
   chmod 644 ubbsimple

5. Compile thesimpapp client and server programs by entering the following commands:

   
   buildclient -o simpcl -f simpcl.c
   buildserver -o simpserv -f simpserv.c -s TOUPPER

6. In the sample configuration file,ubbsimple, replace the strings shown in angle brackets with values appropriate to your Oracle Tuxedo system installation. Comments in ubbsimple explain how to customize the file. Set the following parameters in the ubbsimple file:
   • Set IPCKEY to a valid IPC key. This value must be greater than 32,768 and less than 262,143.
   • Set APPDIR to ”/home/me/atmi”.
   • Set TUXCONFIG to the literal pathname corresponding to $APPDIR/tuxconfig (in our example, ”/home/me/atmi/tuxconfig”).
   • Set TUXDIR to the absolute pathname of the product directory of the Oracle Tuxedo software on this machine (for example, ”/home/oracle/tuxedo12cR1”).
   • Set MACHINE-NAME to the name of your system.
     To determine the name of your system on a UNIX machine enter the command:

     uname -n

     Note:

     The APPDIR, TUXCONFIG, and TUXDIR parameter settings in the ubbsimple file must match the APPDIR, TUXCONFIG, and TUXDIR environment variable settings.
7. Create the binary version of your edited configuration file by invokingtmloadcf(1), which produces a file named tuxconfig. This file, referenced by the TUXCONFIG environment variable, provides the Oracle Tuxedo system with a description of the application configuration at run time:

   
   tmloadcf -y ubbsimple

8. Boot simpapp by typing the following command:

   tmboot -y

   If the boot succeeds, output similar to the following appears and you can proceed to step 10. The following listing shows the output produced by tmboot -y:

   
   Booting all admin and server processes in /home/me/atmi/tuxconfig
   INFO: Oracle Tuxedo , Version 22.1.0.0.0
   Booting admin processes ...
   exec BBL -A:
   process id=24180 ... Started.
   Booting server processes ...
   exec simpserv -A :
   process id=24181 ... Started.
   2 processes started.

9. If the boot fails, examine the log named ULOG.mmddyy in your application directory ($APPDIR, /home/me/atmi). The string mmddyy is a placeholder for the date (digits representing the current month, day, and year) that makes up the end of the filename. If you see a message such as the following, near the end of the log:

   can’t create enough semaphores for BB

   then the interprocess communication (IPC) resources configured in your operating system are not adequate for running simpapp.

   To confirm this hypothesis, invoke the Oracle Tuxedo system command tmloadcf(1) and specify the name of your configuration file, as shown in the following example:

   tmloadcf -c $APPDIR/ubbsimple

   If the current value of any IPC parameter configured in your operating system is less than a minimum (either variable or fixed) listed in the tmloadcf output, you must increase the value of that parameter. For instructions on determining and changing the current IPC values for your platform, see the data sheet for your platform in Oracle Tuxedo 22c Release (22.1.0.0.0) Platform Data Sheets.

10. If the boot succeeded, you can invoke the client. For example, enter the following command:

    simpcl “hello world”

    The following is displayed:

    Returned string is: HELLO WORLD

11. When you have finished, shut down simpapp with the following command:

    tmshutdown -y