VISULOX 4 Documentation

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:

checkPortal.sh -lb -server <accessserver> 

Can run on any system, which has access to the service.


Checking the VISULOX GATEWAY:

checkPortal.sh -gw -server <gwserver> 

This check runs on each Gateway server


Checking the VISULOX PORTAL:

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/.