Geneos


This plug-in is deprecated and is no longer supported by Geneos.
We recommend that you not use any deprecated features, as these may be removed in future releases.

For more information, see Deprecated and removed features in Geneos 5.x Compatibility Matrix.

SWX and VirtX Plug-in - Technical Reference

Introduction

GENEOS SWX Plug-in monitors the connections to the SWX & VIRT-X exchange and the services provided.

Views (for multiple views)

SERVER View

Shows the current status of the SWX & Virt-X server.

swx-virtx2

SERVER Headline Legend

Name Description
systemStatus The status of the server - UP or DOWN
systemState Whether the service is running as primary or secondary on this server.
serverName The name of the server
isisProcess State of the ISIS process group.
sybaseProcess State of the Sybase process group.

SERVER Table Legend

Name Description
serverName Name of monitored server.
status State of each detected server, UP or DOWN
remote/local Reports is this is a local or remote connection.

SERVICES View

Shows the current status of the SWX & Virt-X services.

swx-virtx3

SERVICES Headline Legend

Name Description
totalServices Current number of services that are being monitored.
primaryService Total number of services running on the primary box.
secondaryServices Total number of services running on the secondary box.
totalServicesDown Total number of failed services.
primaryServicesDown Total number of failed services on the primary box.
secondaryServicesDown Total number of failed services on the secondary box.

SERVICES Table Legend

Name Description
serviceName Name of the monitored service.
status The phase the service process is currently in.
role Whether the service is running as primary or secondary on this server.
primaryHost Hostname configured as primary server for running the service process.
secondaryHost Hostname configured as secondary server in case the primary fails.

CONNECTIONS View

Shows the state of SWX & VirtX Connections to exchange gateways in the current environment. Hosts typically connect to two gateways for load balancing and resilience.

swx-virtx4

CONNECTIONS Headline Legend

Name Description
totalGateway Total number of the Gateways

CONNECTIONS Table Legend

Name Description
gateway The name of the gateway being monitored.
status Status of network connectivity for RPC requests.
role The role of the gateway connection, active or passive.
connectCount Number of currently established connections to gateway services (should be 2).
errorCount Number of failed gateway connection attempts.
transactionHandlerport The tcp port number on which the transaction handler service is running.
feedHandlerPort The tcp port number on which the feed handler service is running.

USERS View

Shows the users of the of SWX & VirtX servers

swx-virtx5

USERS Headline Legend

Name Description
totalUsers Total number of users

USERS Table Legend

Name Description
userName Account name being used for this connection
client The mnemonic being used by this user
host The host machine where the client application is running
isisAddress The isis address and port being used for this connection.
timestamp Date and time of connection
description User description

Plug-in Configuration

Sample Configuration:

sysmanPath = /usr/swx/bin
environment = swxprod

The following parameters can be configured for this plug-in:

sysmanPath

Full path to the directory containing the ebs_smitty command line executable.

Mandatory: Yes

environment

Name of the environment that SWX and Virt-X executes under. This is the same as the environment parameter passed to the ebs or ebs_smitty command.

Mandatory: Yes

isisProcessToken

The string to identify the ISIS processes ( in the 'ps' listing ) that are relevant to this SWX environment. Two ISIS processes must be running for the isisProcess headline variable in the 'Server' view to show OK.

Mandatory: No
Default: isis

sybProcessToken

The string to identify the Sybase processes ( in the 'ps' listing ) that are relevant to this SWX environment. Five Syb processes must be running for the sybaseProcess headline variable in the 'Server' view to show OK.

Mandatory: No
Default: syb

numSybaseProcs

Expected number of Sybase processes.

Mandatory: No
Default: 5

numIsisProcs

Expected number of Isis processes.

Mandatory: No
Default: 2

overrideCommand

Full path to a script or executable command to use instead of the ebs_smitty command. This is useful for testing purposes.

Mandatory: No