Post-Installation

The following sections describe the tasks you perform after installing Oracle Tuxedo:

•	Running Samples to Verify Your Installation

•	Uninstalling Oracle Tuxedo Message Queue

•	Reinstalling Oracle Tuxedo Message Queue

Running Samples to Verify Your Installation

One of the ways to verify that your Oracle Tuxedo Message Queue software is installed correctly is to run one or more of the sample applications included with the installation. The simpqapp application is a non-distributed application, meaning that it runs on a single machine. It is designed so that it can be up and running within minutes after the Oracle Tuxedo Message Queue software is installed.

The simpqapp sample consists of a queue server TuxMsgQ offering the queue service, and three clients: enqclt, deqclt and filter.

The enqclt client attaches the queue QSPACE.QUEUE1 and enqueues one message into the queue QSPACE.QUEUE2.

The deqclt client attaches the queue QSPACE.QUEUE2 and dequeues the message from the enqclt client .

The filter client demo illustrates how to use the simple filter and complex filter to dequeue messages from the queue

QSPACE is the queue space name and is advertised as a service by queue server TuxMsgQ. QUEUE1 and QUEUE2 are the queues in queue space QSPACE.

Running simpapp

On a UNIX system, it can be found in the directory $TUXDIR/samples/OTMQ/simpqapp.

Note:

Samples are not installed unless they are selected to be installed during Tuxedo Message Queue installation. The procedure presented in the following section is also provided in the README.txt file in the simpqapp directory.

To configure and run the sample on a UNIX system, do the following steps:

1.	Log in to the target machine

2.	Change to the directory where the OTMQ is installed.

cd $TUXDIR

./tux.env

3.	Modify the environment variables IPCKEY or QIPCKEY in samples/OTMQ/simpqapp/setenv.sh if there is a conflict with other application.

4.	Set the environment

cd $TUXDIR/samples/OTMQ/simpqapp

. ./setenv.sh

5.	Compile and run simpqapp

sh runme.sh

This command is a script that builds the client, create the QUEUE and transaction log, boot the application, run the client, and then remove everything. Once this script has been run successfully, it may be instructive to run each command individually outside of the script. If the script not report Error, it means success.

Uninstalling Oracle Tuxedo Message Queue

Uninstalling Oracle Tuxedo12c Release 1 (12.1.1), 11.0, 10.0, 9.1, 9.0, 8.1 or 8.0 does not remove the Oracle Home directory associated with the installation but does remove all Oracle Tuxedo components installed by the installer program. The uninstallation also removes the product directory associated with the installation unless one of the following is true:

•	The product directory contains customer-created configuration or application files—the uninstallation does not delete customer-created configuration or application files.

•	The uninstall was invoked from within the product directory structure—specifically, within the uninstaller directory.

To uninstall Oracle Tuxedo 12c Release 1 (12.1.1), complete the procedures for the appropriate platform, provided in Table 5‑1. To uninstall Oracle Tuxedo 9.1 or 10.0, substitute “Tuxedo 9.1 or 10.0” for “Tuxedo 12c Release 1 (12.1.1)” in Table 5‑1.

 

Table 5‑1 Uninstall Oracle Tuxedo

To Uninstall Oracle Tuxedo on This Platform . . .

Perform the Following Procedure . . .

UNIX

1. Shut down any Oracle Tuxedo servers that are running. For instructions on using the tmshutdown command to shut down Oracle Tuxedo applications, see reference page tmshutdown(1) in the Oracle Tuxedo Command Reference. 2. Go to the tux_prod_dir/uninstaller directory, where tux_prod_dir represents the product directory in which you installed the Oracle Tuxedo software. 3. Choose one of two methods for uninstalling the software: • To use the GUI-mode installation program, go to step 4. • To use the console-mode procedure, go to step 5. 4. (GUI-mode method) Enter the sh Uninstall_Tuxedo_12c command at the prompt. In the Uninstaller window, click Uninstall to start the uninstall program, then click Exit in the Uninstall Complete window to complete the uninstallation. 5. (Console-mode method) Enter the sh Uninstall_Tuxedo_12c -i console command at the prompt. When the uninstall process is complete, press Enter to exit the uninstaller.

Reinstalling Oracle Tuxedo Message Queue

When you start the Oracle Tuxedo Installation program on system that already has a copy of Oracle Tuxedo installed, the installation program detects the existing Oracle Tuxedo home directory and asks if you want to:

•	Copy the new installation directory over the existing one

•	Create a new installation directory

Table 5‑2 shows the reinstallation screen.

 

Table 5‑2 Reinstalling Oracle Tuxedo Message Queue

Click . . .	To . . .
Continue	Close the warning window and continue with the installation. This option overwrites the previous installation.
Cancel	Return to the Choose Oracle Home Directory window. To continue installing the software using a different Oracle Home directory, select an existing Oracle Home directory that does not contain the release 12c Release 1 (12.1.1) software or create a new Oracle Home directory.
Exit	Exit the installation program and uninstall the previous installation. You can invoke the uninstall program as described in “Uninstalling Oracle Tuxedo Message Queue” on page 5‑2, and reinstall the software as described in one of the following: • “Installing OTMQ Using GUI-Mode Installation” on page 2‑1 • “Installing OTMQ on UNIX Systems Using Console-Mode Installation” on page 3‑1 • “Installing OTMQ Using Silent Installation” on page 4‑1