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 Compatibility Matrix.
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.
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.
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.
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
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 = swxprodThe 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.