EOL
Effective 30 April 2017, SWX and Virt-X reached end of life. This documentation is archived and will no longer be updated.
SWX and Virt-X
Introduction Copied
GENEOS SWX Plug-in monitors the connections to the SWX & VIRT-X exchange and the services provided.
Views (for multiple views) Copied
SERVER View Copied
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 Copied
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 Copied
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 Copied
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 Copied
Sample Configuration:
sysmanPath = /usr/swx/bin
environment = swxprod
The following parameters can be configured for this plug-in:
sysmanPath Copied
Full path to the directory containing the ebs_smitty command line executable.
Mandatory: Yes
environment Copied
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 Copied
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 Copied
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 Copied
Expected number of Sybase processes.
Mandatory: No
Default: 5
numIsisProcs Copied
Expected number of Isis processes.
Mandatory: No
Default: 2
overrideCommand Copied
Full path to a script or executable command to use instead of the ebs_smitty command. This is useful for testing purposes.
Mandatory: No