Assuming you have followed the above important read-me note, and have verified that our server-side code works for you in TEST mode, the following are additional requirements for this program:
Portrait versus Landscape
Version 2.0 of Ultra Monitor works differently than previous versions. With Versoin 2.0, the orientation of the device decides what you can see and do:
THE PORTRAIT SCREEN
Holding your iPhone or iPad in PORTRAIT orientation displays the Server Pane which lists all your servers and allows you to manage the list.
In PORTRAIT mode, both devices have a very similar layout with identical buttons in similar places. The following gives a description of each item on the screen.
When you tap the EDIT button the list of servers changes to add a DELETE control on the left of each server and a MOVE control on the right of each server.
Use the DELETE control to remove servers from the list, or tap and drag the MOVE control to change the position of a server in the list.
On an iPhone, the CPU is shown as C: followed by the load percentage, then a P: followed by the total process count, and finally a U: followed by the number of logged in users.
On an iPad the statistics are displayed in the same order, but the key is fully spelled out.
Note that if a server is set to PING ONLY, no stats (other than ping timing) are displayed for that server.
If a server is set to PING ON, a number will appear first on the field that indicates the ping time of the last ping request in seconds.
When the button is green, that particular server will be monitored.
When the button is orange, that particular server will not be monitored.
Use this button to temporarily ignore servers.
When the key symbol is green, all controls on all screens are active.
When the key symbol is red, most controls are locked.
Use this button if you carry your iPhone or iPad in your pocket or backpack while using Ultra Monitor to avoid accidental screen taps from causing unwanted action.
When locked (red) the ONLY controls that work are:
All other buttons are locked until unlocked.
The results of the PING are shown as the first value on the second line for each server in the server list.
If PING is turned off in SETTINGS, the Ping Countdown will display the word OFF.
Depending on the settings of the server and the results of the ping - you can see different messages for the Ping:
The ADD SERVER Pane is identical on the iPhone and the iPad.
To use the ADD SERVER Pane orient your device to PORTRAIT mode - the Server List Pane should be visible.
Next tap the small square green plus (+) button in the upper left corner. The ADD SERVER Pane should slide into view.
Note that while the Add Server pane is visible, no monitoring or pinging of servers is performed.
When you are ready to save the new server, hit the Save button. The server will be added to the end of your list of servers and the ADD SERVER Pane will slide out of view.
Name (Short Name) Field
Tap the field and a keyboard will slide into view. Enter the desired short name for your server. This name is displayed in both the LANDSCAPE and PORTRAIT views to identify which server your are looking at.
Address (IP Address or Host Name) Field
Tap the field and a keyboard will slide into view.
Enter an IP address or domain name for the server you wish to monitor. Do not enter a full URL (e.g., do not include the http or https), just the IP address or the domain name.
The following are valid examples:
However, if you have changed the name of the server-side Ultra Monitor binary (the executables name), tap this field and modify it to be the same as the name of your cgi-bin (you only need to do this if you are NOT using the server-side code in stand-alone mode, and you have changed the executables name for increased security).
If you are using the Server-Side code as a cgi-bin through a web server, the software will automatically figure the proper port based on the Use HTTPS switch.
However, if you are running the Server-Side code in Stand-Alone mode, set this field to the Port you are running on.
If you are running via a web server that is on a non-standard port, you should also put the non-standard port into this field.
Use HTTPS Switch
Set the switch to HTTPS (green 'Y') if you have a secure certificate (SSL) and wish the access to be encrypted (it will automatically be directed to port 443 unless you overrode the port assignment in the Port field).
If you do not have a secure certificate, tap the SECURE switch till it reads HTTP (red 'N'). This causes normal access to the server via the web port 80, unless you have overrode the port assignment in the Port field.
Note that this only affects Ultra Monitor when it is run as a cgi-bin (never as a stand-alone server, in which case the setting on this switch doesn't matter).
This serves the same function as the big round green Play/Pause buttons on the Server List view and the Server Stats view.
If set to the green "Y", once saved it will be actively monitored.
If set to the red "N", once saved it will be in PAUSE mode and skipped over until monitoring is turned back on (either by using this switch or the PLAY/PAUSE buttons on the other screens).
Delay Between Tries
You can set a maximum time of 60 minutes and 60 seconds (61 minutes total), and a minimum time of zero.
Note that times below 5 seconds generally still require 2 to 4 seconds for the request to complete. It is not recommended setting the total time below 5 seconds for any server.
In versions of Ultra Monitor previous to 2.0, servers were scanned in the order they appeared on the list - and there was only one global time between attempts.
With version 2.0 of Ultra Monitor, each server is scheduled independently of the others servers and each server receives its own thread and can run concurrently with access to other servers. This gives overall better performance and monitoring.
Note that you can, on the LANDSCAPE screen, force a server to be immediately scanned by tapping the Next/Lag area at the top of that screen.
In previous versions you could ping your servers and 5 additional servers (such as public servers). This was done on a special Ping Page.
With version 2.0 this all changes. Now you can specify servers that should be pinged, and servers that should not. You can also specify servers that should ONLY be pinged.
The Ping Mode switch has three states:
Once you have entered all the fields and set the switches as you want, click the green SAVE in the upper right of the pane to save this server (if it is still dim, some informaton is missing). To abort and not save the server, click the red CANCEL in the upper left corner of the pane.
The EDIT SERVER Pane is identical on the iPhone and the iPad.
Once you have added one or more servers, you can edit any server which is the PORTRAIT Server List.
To use the EDIT SERVER Pane orient your device to PORTRAIT mode - the Server List Pane should be visible.
To the right of each server in your list is a blue button with a white, right-pointing arrow. Tap this button.
Once you tap the button the EDIT SERVER Pane will slide into view and will be populated with all the information and settings for the server you selected.
The EDIT SERVER Pane is identical in functionality to the ADD SERVER Pane. Please refer to the ADD SERVER documentation for a description of all the fields.
Once you have made the desired change tap the green Save button. If you wish to abort making any changes tap the red Cancel button.
Note that while the Edit Server pane is visible, no monitoring or pinging of servers is performed.
When the device is in PORTRAIT mode with the Server List visible you can reposition servers in the list and remove servers from the list.
To being the process tap the blue Edit button near the upper left of the device. You must have servers in your Server List or the Edit button will not be tappable.
Once you tap the Edit button the Server List will change to look like this:
You will see that the Edit button has change to a Done button. Tap the Done button to get out of Edit mode.
Once in Edit mode, a red Delete Circle will appeared at the left of each server in the list, and a Move Icon will appear at the right of each server in the list.
To Delete Servers...
To delete a server from the list (and from the application) tap your finger on the red Delete Icon circle at the very left of the server you wish to remove.
Once you tap it, the icon will rotate (so the line is vertical) and a red Delete button will appear on the right:
If you do not wish to delete that server, tap the red circle again and the Delete button will slide away.
If you wish to delete the server, tap the red Delete button on the right side of the device. The selected server will be removed from the list and application.
To Move Servers In The List...
You can reposition servers in the server list.
When servers are monitored by accessing the Server-Side software, they are done by independent threads based on the last time they were accessed. Thus the order of the servers in the list does not really indicate the order they are being monitored.
However, the server list order does impact the order servers are seen when in BOUNCE mode, as well as when you are in MANUAL mode and move through the list manually.
Additionally, when the device is in PORTRAIT mode, the order the Servers are pinged is the order they appear in the list.
To move the position of a server in the list, tap and hold the very right MOVE icon on server you would like to move:
Move up to move the server higher in the list, or move down to move the server lower in the list. As you move, the other servers in the list will reposition themselves to be above or below the server you are moving.
When you have the server positioned where you want, remove your finger from the screen and the server will be saved in the new position.
Both the LANDSCAPE and PORTRAIT views have a Setting button that you can use to access Ultra Monitor settings and preferences.
The Setting Pane itself is identical for both iPads and iPhones.
Note that while the Setting pane is visible, no monitoring or pinging of servers is performed.
This pane features a number of switches, buttons, scroll wheels, and a text area:
THE LANDSCAPE SCREEN
Placing your iPad or iPhone in LANDSCAPE orientation allows you to monitor the servers. Any server that is set to PING ONLY will not appear in LANDSCAPE orientation - all other servers should appear.
The screen is composed of a number of buttons, sliding tables, graphs, and informational text.
While the layout of the iPad and iPhone is very similar, the one primary difference is that the iPad always shows the Log for each server, while the iPhone has a button to toggle the Log view in and out.
The following describes each area of the LANDSCAPE view and what it does:
Tap these buttons to move through the servers in your Server List. Tap the right button to move to the Next server in the list. Tap the left button to move to the Previous server in the list.
Note that these buttons work whether or not you are in Bounce mode (see below).
If you only have one server, these buttons will be dim and un-selectable.
This button will either be purple and read Bounce or yellow and read Manual. The text indicates the mode it is in.
To switch the states, simply tap the button. It will alternate between purple-Bounce and yellow-Manual modes.
When in Bounce mode (purple), each server in your Server List will appear, one after the other (in the order of the Server List) - with a delay. You can set the amount of time each server is displayed in the Setting Pane.
When in Manual mode (yellow), Bounce is disabled. The server that is shown will continue to be shown until you move to a different server. Use the Previous and Next buttons (see above) to move you through your Server List.
Note that you can always use the Previous and Next buttons, even when in Bounce mode, to move more quickly to a particular server.
If you only have one server, this button will be dim and un-selectable.
This button lets you control whether or not this server is being monitored.
When the button is green, this particular server is being monitored.
When the button is orange, this particular server is not being monitored.
Use this button to temporarily ignore servers.
You can also PAUSE and PLAY server in the PORTRAT Server List.
Tap SETTINGS to display a pane that lets you customize global settings for Ultra Monitor. These include:
You can also access this button in the PORTRAIT Server List Pane.
The iPad has no corresponding button because it displays all the information all the time.
The text on the button tells you what it will show if you tap it.
If the button reads Log View tap the button to view the Ultra Monitor log for that server. You can use your finger to scroll backwards through the history of messages. The button will now read Info View.
If the button reads Info View tap the button to view the Partitions, Processes, and Users for that server. You can use your finger to scroll each of the lists if they are long. The button will now read Info View.
This info area is also touch sensitive and acts as a hidden button.
The Next value is a count-down timer in Minutes and Seconds and shows how long it will be before this server is polled again.
The Lag value is the number of seconds that it took for the request to be sent to the server and the response received. You can expect more lag when monitoring over cellular services than over WiFi. A large lag on cellular may indicate a poor signal in your area.
If you tap anywhere in this area you will reset the countdown timer and force the server to be monitored within the next second or two. This allows you to immediately see a servers status rather than waiting for the normal countdown to expire.
If you do not see the countdown counting, then the server is not being monitored. Make sure it is not in PAUSE mode. (If it looks like it should be monitoring, try rotating the device into PORTRAIT and back to LANDSCAPE - if that does not restart it, the server may be having problems).
The countdown will also stop if the server is set to PAUSE. It will resume when the server is set to PLAY.
The amount of time for each server can be set in that servers Edit Pane in PORTRAIT orientation.
The graph is colored from green on the bottom, to yellow, to red. The placement of the yellow will depend on your settings in the Server-Side configuration file. The closer yellow (minimum warning load) is to zero, and farther from red (maximum cpu load), the closer it will be to green on the chart, and vice versa. A yellow positioned equally between red and 0.0 will be equally between red and green in the chart.
The chart always shows the dim colors - and the current load will be shown with a bright gradient. This updates with each new poll of the server.
The load is represented by a bright gradient with the most recent value on the very left, and the oldest value on the very right.
The iPad shows more history than the iPhone due to the larger screen area.
Below each corresponding area is the information from your server pertaining to that area.
The left, PARTITIONS (green) area shows each partition you are monitoring. The name appears in white and below the name is the amount free. This will be colored according to your trigger points in the Server-Side configuration file (green is ok, yellow is approaching critical, and red is at or over your maximum point).
The middle, PROCESSES (blue) area shows each process you are monitoring. The name appears in white and below the name is the number of those processes currently running. If the number of processes is lower then your minimum, or higher than your maximium for each process (in the configuration file) it will be colored red. Otherwise it appears in cyan.
The right, USERS (purple) area shows each user you are monitoring. The name appears in white and below the name is the number of times that user is logged in, in purple.
Each of the three info areas can be scrolled independently up and down to see more (if you have a lot of items).
On the iPhone, the Monitor Log is turned on by tapping the Log View button - and turned off by tapping the Info View button. When turned on the Monitor Log replaces the PARTITIONS/PROCESSES/USERS Info Area.
The Monitor Log shows the most recent 200 transctions. The top most transaction is the most recent. Use your finger to scroll through the list.
Each server attempt is recorded, even if the outcome produces no errors. The color of the message is an indication of the level of problem. Green means everything is fine. Yellow indicates a warning, and Red is some problem.
Each server maintains an independent log for that server (the logs are not combined).
You will find that there is a correlation between the Monitor Log and CPU History (each point in the history corresponds to a message in the log).
Depending on how many servers you are monitoring and how frequently you have the program set to monitor, Ultra Monitor can run your battery down rather quickly.
To get the most out of your battery life while running Ultra Monitor, try the following tips:
To see a list of frequently asked questions and troubleshooting tips, click here.
© 2012 David Cook.