The following information will assist you in configuring a server check from Binary Canary and calling a Stoneware provided JSP.
These instructions assumed you have configured an account on Binary Canary and have notifications configured.
Something to keep in mind, whatever server monitor software that you use please be sure to not overload the webNetwork servers with constant checks. If you just do a port check, make sure that the check actually opens, then properly closes the port during the test rather than dropping the connection. If the check opens the connection and drops it without closing it then you cause the webNetwork server to build up open connections.
In your system create a user that has access to nothing except login to portal.
The best way to do this is to make an OU under the stoneware container and call it something like ServiceAccounts. Use webadmin to set that serviceaccount OU to an inheritance level of 0. Create the user in there. This makes the account not have access to any links in the portal.
A script can be found /stoneware/webserv/util/examples/authCheck/authCheck.jsp, which can be called using a monitoring system.
Copy the file to /stoneware/webserv/util/
Edit the authCheck.jsp and add the username and password:
String userID = "some-non-privileged-username";
String password = "password";
Depending on your environment you may have to edit the jsp and change the CN in the line :
WebNetworkAuthenticator.setAttribute( waSession, "cn", userID );
To something like samaccountname. Test as it first and if that does not work adjust the JSP if it does not produce a Success.
Next set up the monitor system to call https://portal.example-cloud.com/util/authCheck.jsp and trigger a failure message if it does not see "Success" comes back.
To do this on Binary Canary do the following:
- Click Add Monitor
- Enter in a display name like portal login
- Monitor Type: Simple Http Monitor
- Status : Active
- Frequency : 15 min
- website : https://portal.example-cloud.com/util/authCheck.jsp
- Search page for : Text Contains Success
- Failure Message : Problem logging into portal
- Monitoring Locations : Choose a location to perform this check from
- Choose a notification, Wait for Mins, Contact person, Contact method, Repeat every and Maximum sends.
- Save and wait 15 min and check the Reporting options for the results.
Nagios is another common free server checker program. However the configuration is much more complex to configure. There are many books and internet sites devoted to Nagios that can be referenced.