Monitoring tool: checkPortal.sh
The availability of the VISULOX Access Node and its components is essential for operation.
The script checkPortal.sh allows to check the availaiblity from three different viewpoints and can be found in /opt/visulox/setup/examples/.
1) From outside, like the user (-lb)
2) From the VISULOX GATEWAY (-gw)
3) From the VISULOX PORTAL Node (-sgd)
A check from outside (1) will show the result, wether the portal is available or not.
If a single VISULOX GATEWAY (2) or VISULOX PORTAL instance (3) is not available, this will not be detected by (1).
Therefore the explicit checks for each VISULOX GATEWAY and/or each VISULOX PORTAL are needed.
Checking the service:
Service check
checkPortal.sh -lb -server <accessserver> Can run on any system, which has access to the service.
Checking the VISULOX GATEWAY:
Gateway check
checkPortal.sh -gw -server <gwserver> This check runs on each Gateway server
Checking the VISULOX PORTAL:
Portal check
checkPortal.sh -sgd -server <VISULOX Access Node) This check runs on each VISULOX Access Node.
Path: /opt/visulox/setup/example/checkPortal.sh
Available options:
| Command | Description |
|---|---|
| -lb | Test via Loadbalancer |
| -gw | Test via VISULOX GATEWAY |
| -sgd | Test VISULOX PORTAL(default) |
| -server <arg> | Endpoint to test <$ACCESSSERVER> |
| -port <arg> | Port of the endpoint to test <$PORT> |
| -e | Check includes GW-enable file (lb_endpoint.html) |
| -q | Quiet mode |
| -nagios | exitcode related for nagios |
| -verbose | Verbose mode |
| -debug | Debug mode |
Return codes:
| Return code | Description |
|---|---|
| 0 | Ok |
| 1 | Warning |
| 2 | Critical |
| 3 | Unknown |
| 10 | Gateway Java proxy not available |
| 11 | Gateway Apache revers proxy not available |
| 12 | None of the portal Apaches is answering |
| 13 | None of the portal Tomcats is answering |
| 14 | GW cannot see any portal |
| 15 | VISULOX GATEWAY disabled (lb_endpoint.html) |
| 20 | VISULOX PORTAL Array service not available |
| 21 | VISULOX PORTAL Service not available |
| 22 | VISULOX PORTAL Apache not available |
| 23 | VISULOX PORTAL Tomcat not available |
| 126 | Missing or cannot be executed |
| 127 | General error |
Other useful tools
gwApache.sh allows VISULOX GATEWAY Apache start / stop / restart without disconnecting users sessions.
gwCheck.sh to check VISULOX GATEWAY connectivity.
These scripts can be found in /opt/visulox/setup/example/gateway/.