Post-Installation

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

•	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 simpqapp

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 Oracle 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 Oracle Tuxedo Message Queue 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 does not report an error, it means success.

Uninstalling Oracle Tuxedo Message Queue

Uninstalling Oracle Tuxedo Message Queue12c Release 2 (12.1.3) does not remove the Oracle Home directory associated with the installation but does remove all Oracle Tuxedo Message Queue components installed by the installer program. The uninstallation also removes the product directory associated with the installation.

After launching OUI, the Welcome screen appears. Click Deinstall Products. Select the product(s) you want to remove from the Contents tab of the Inventory panel and click Remove.

You can also remove Oracle homes in the same manner. After you have removed an Oracle home, you can reuse its name and location to install other products. Then confirm the deinstallation. After the selected products are deinstalled, the Inventory panel appears.

Reinstalling Oracle Tuxedo Message Queue

When you start the Oracle Tuxedo Message Queue Installation program on system that already has a copy of Oracle Tuxedo Message Queue installed, the installation program detects the existing Oracle Tuxedo Message Queue home directory and displays a warning that the selected ORACLE_HOME already installed Oracle Tuxedo Message Queue. If you want to continue the installation, the components which not exist in the selected ORACLE_HOME are installed. Existing Oracle Tuxedo Message Queue component is not reinstalled by default.