|dim_STAT User's Guide. by Dimitri|
Now, installation is finished, Database and Web servers are running. Be sure STAT-service is installed and running on all servers you want to monitor... (Note: you'll be surprised, but 90% of cases with initial troubles are due to this stupid thing - people just forgetting to start STAT-service :))
Once it's done, you are ready to open your preferred Web browser (Java enabled or not - it's up to you) and connect to the dim_STAT Web server. Index page contains some links to documentation, presentation, tool history, etc., but the link you'll need to click is: "Main Page"... (do you believe some people meet a problem to find it? :))
Here is a small snapshot of the screen you'll see (Note: blue/red histogram has nothing in common with current host activity, it's just an example of working Java applet (since v.7.0 it's converted into image to simplify and speed-up main interface, if you want to be sure Java plug-in is working correctly within your browser and you may click on the 'Preference' link and then on Java Applet testing link). Since v.7.0 you have a choice for graph generation: interactive Java applet or static PNG image. Until v.8.0 for Solaris/SPARC users there was an old Netscape Navigator 4.5 shipped in /apps/httpd directory - I don't ship it anymore as there are at least FireFox and Opera are available for free to download from Internet. So well - 'Main Page' :))
As you already supposed, the Main Page will re-group all main actions... And you're right! :))
I'll not present action by action, but rather functionality by functionality, in order of operation. However, the most short working cycle should be composed at least of:
- Starting STAT collect
- Analyze/Monitor collecting data
- Stop STAT collect
Few words about User Interface - don't be surprise you did not find any "Back" button once you enter somewhere from the Main Page: there in no one! You have to use your browser's navigation back button for it, and it's not because I'm just lazy :)) The reason is very simple: dim_STAT may use Java applet to present data in graphical mode, but it seems for every showing graph-applet Web browser is running dedicated JVM for each one, and if you never come back in navigation - all JVMs will stay keeping suspended in the browser memory till it will crash with out of memory error... To prevent crashing I'm forcing you to use browser's button.
Since v.7.0 you'll see a small toolbar in the top of your page presenting:
- Currently used Database Name
- Short links into Home/ Preferences/ Log Admin
Navigation become more simple, but be aware about running applets in case you're using them!
|ERROR: No X_ROOT configuration for SERVER: ...|
Sometime instead of Main Page you can see this kind of error message...
Don't worry, nothing going wrong, but it seems your DNS translation simply did not match configuration settings. Just go into WebX home directory (ex: /opt/WebX) and open "x.config" file with your preferred text editor. Find the line containing in first column your host name. Duplicate this line and replace in one of them your hostname:port pair by the string given in error message after "SERVER:". Save file and try to connect again. It should work immediately!
Example: Error Message: "No X_ROOT configuration for SERVER: harms.France.Sun.COM:88"- vi /opt/WebX/x.config - duplicate line with "harms:88" - replace in on of the lines "harms:88" by "harms.France.Sun.COM:88" - save file - reload the Main Page in your browser
Note: X_ROOT is a one of WebX configuration parameters. As WebX is an interpreter, there should be a way to protect of "interpreting" something else than application pages (ex: /etc/passwd). X_ROOT points WebX into its main "root" directory, so only pages coming from this given directory tree may be executed, nothing else...
Since v.7.0 you may use any web browser having PNG image format support (mostly true for all available browsers).
However, if you prefer interactive graphs with dim_STAT's Java Applet, you'll need to use a browser supporting Java (plug-in or integrated). Here are few notes about already used/observed programs...FireFox - most stable web browser for today, works perfectly with Java applets and maybe the best choice actually!There are some others, but general rule is if instead of graphics you'll see error message "Browser BUG" - upgrade/patch your browser or move to any working one...
Opera - seems to work perfectly since v.5 (and I'm using a lot), there is even working(!) and free(!) version for Solaris! In v.8.5 sometime loosing mouse focus with applet, but generally ok.
Konqueror - working out of the box (generally), maybe the best choice for KDE-lovers :))
Mozilla - you should upgrade to at least to v.1.7 to get fully functionally working tool (in previous versions there was a bug starting an applet before receiving all given parameters), also v.1.7 and later is MUCH more faster comparing to all previous!...
IE - never used it myself, but seems to work for customers, etc. so may also work for you...