Version

Argent Queue Engine 5.0A-2006 Red Hat

Date

Tuesday, 30 June 2020

Summary

This article explains how to install Argent Queue Engine in both Standalone and Dependent modes on a Red Hat Linux platform

Technical Background

Argent Queue Engine for Red Hat Linux can be installed in two different modes:

• Standalone
• Dependent

Standalone mode is the traditional way of installation and requires a unique license key for the Argent Queue Engine

In this mode the Argent Queue Engine runs independent of the Argent Scheduling Engine

Dependent mode is the latest way of installation where the licensing is centrally handled by the Argent Scheduling Engine

The Argent Queue Engine does not need a license of its own but runs only when the Argent Scheduling Engine is running and according to the license provided for the Argent Scheduling Engine

Steps To Install Argent Queue Engine For Red Hat Linux

Argent Queue Engine for Red Hat Linux is packaged in a compressed rpm file

This rpm file must be expanded from / (the root)

1. To install Argent Queue Engine, login as the root user, and execute the following commands, substituting the actual file name (according to the version being installed):

   # mv ARGENT_QUEUE_ENGINE_5_0A_2006_RED_HAT.x86_64.RPM/

   # cd /

   # rpm -i ARGENT_QUEUE_ENGINE_5_0A_2006_RED_HAT.x86_64.RPM

2. The /opt/ARGTqe/bin directory needs to be added to the PATH environment variable for root and any other users of the Argent Queue Engine

   This directory should be added to the MANPATH environment variable as well

3. To update these paths for the Bash shell, please add the following to the .bashrc file in the root directory:

   export PATH=$PATH:/opt/ARGTqe/bin:/opt/ARGTqe

   export MANPATH=$MANPATH:/opt/ARGTqe/man

4. Log back in again after making the above changes and confirm that the path changes have taken effect

   To verify this, please type the following command while logged in as root:

   echo $PATH
   

   You should see :/opt/ARGTqe/bin:/opt/ARGTqe in the path returned by that command

5. The administrative file /opt/ARGTqe/dbf/que_creator.allow is installed with the Argent Queue Engine

   This file contains the names of the users who are permitted to create Queues with the Argent Queue Engine

   The default file contains the root user

   The system administrator needs to edit this file to add the user accounts that are authorized to create Queues

6. Start the Argent Queue Engine using the following command:

   qsystem -x

7. To verify that the Argent Queue Engine has started successfully, please run the following command:

   ps -e | grep qemom

   
   

   If you see qemom listed, then the Argent Queue Engine has started successfully

8. From an Argent Scheduling Engine Windows server, confirm that you can telnet to the Red Hat Linux server on port 3000

   This step is only required when

   1. Argent Queue Engine runs in Standalone mode and Jobs will be submitted to it from Argent Scheduling Engine, or
   2. Argent Queue Engine runs in Dependent mode
9. Confirm that you can manually start the Argent Red Hat Linux Queue Engine by running the following command:

   /etc/init.d/ArgentQe start

10. Check the /opt/ARGTqe/log/err_log file for any error messages
11. Without applying any license, verify that you can start QE right away by running qsystem -x
12. Run qsystem -l and verify that the License Type is ‘Dependent’
    

    The Argent Queue Engine will be inactive by default

    If Argent Queue Engine is to be run in Dependent mode, the Argent Queue Engine will be activated automatically by the Argent Scheduling Engine when the Queue Engine is added to the Scheduling Engine

13. Create the first queue by running qcreate queue1

The following steps will convert Argent Queue Engine from Dependent mode to Standalone mode:

1. Apply the license key by running qsystem -K xxxx-xxxx-xxxx-xxxx or use the -D flag
2. Run ‘qsystem -l’
   

   It should now show ‘Standalone’ mode

3. Check the /opt/ARGTqe/log/err_log file for any error messages
4. If the log contains any error regarding license expiry, you will need to get the new license from your Argent Sales Representative

The following step will convert Argent Queue Engine from Standalone mode to Dependent mode:

1. Remove the Standalone license by running the following command:

   qsystem -K “”

   
   

   or giving an empty license

   Argent Queue Engine will go into ‘Dependent’ mode and will be activated automatically by the Argent Scheduling Engine

If, when you manually run

/etc/init.d/ArgentQe start

you get the error message:

bash: ./ArgentQe: /sbin/sh: bad interpreter: No such file or Directory

then follow these troubleshooting steps:

1. Check where your sh interpreter is by typing

   which sh

2. Edit the /etc/init.d/ArgentQe file
3. The first line should be modified to match the sh path
4. Then save the file and test again by running the below command:

   /etc/init.d/ArgentQe start

5. You should see:

   Argent Queue Engine service starting

   Started Argent Queue Engine

Starting Argent Queue Engine Manually

A message is printed toward the end of the installation process that indicates the directory path that should be added to the PATH variable of root and any other user who will be using the Argent Queue Engine utilities

Once root’s PATH variable has been set properly, the administrator can start or stop the Queue Engine manually:

Shutting down QE Service

De-installing Argent Queue Engine

To de-install Argent Queue Engine, login as root user and execute the following commands, substituting the actual file name (depending on the installed version number):

# rm -rf /etc/.tabfLicense

Resolution

N/A