How To Install / Upgrade / Uninstall Advanced Host Monitor
|How To Install/Update/Repair
Advanced Host Monitor
Run installation program, answer "Yes" on the prompt to install Advanced Host Monitor software. Setup wizard will then ask you to choose between the two available types of installation.
If you continue with selected by default "Install/Update Advanced Host Monitor and utilities" option then setup program allows you to choose 2 different folders for Advanced Host Monitor package:
Also, please see notes regarding UAC and Virtualization
There is also a choice of 4 setup packages:
Beside each setup package there is a help button. Press this button to bring up the reminder about the components that will be installed.
|How To Uninstall
Advanced Host Monitor
|Method 1: Run uninstall.exe from the HostMonitor directory (or from the HostMonitor program group)
and click the "Start" button.
Method 2: Open the Windows Control Panel, double click the "Add/Remove Programs" icon, select "HostMonitor" from the list and click the "Add/Remove" button.
If you are using Windows Vista or newer Windows system, UAC is enabled and you setup software using separate application/data
folders then most applications disable virtualization.
In addition to HostMonitor and RMA Manager (these applications disable virtualization regardless of location), the following modules disable virtualization when data files located in separate folder:
- MIB Browser
- Log Analyzer
- Log Visualizer
- Web Service
- Telnet Service
- WMI Explorer
- HML Manager
If you install software using single destination folder below Program Files\ then configuration files can be virtualized by UAC.
RMA for Windows modules work differently:
- if you install new copy of RMA using setup program, it will disable virtualization regardless of data files location (RMA agent always keeps rma.ini file in the same folder);
- if you update existing old RMA installation using setup program or RMA Manager, it will keep current settings (in such case rma.ini file can be virtualized depending on UAC settings and installation folder location).
Note: you may enable/disable virtualization for RMA agent using the following registry key:
- on 32bit Windows: HKLM\Software\KS-Soft\HostMonitor\RMAVirtualizationOff
- on 64bit Windows: HKLM\Software\Wow6432Node\KS-Soft\HostMonitor\RMAVirtualizationOff
There is another UAC-related problem: if software is running as Win32 service, it may not have "write" access to data folders (this depends on version of the system, location of the folder and UAC settings). HostMonitor may not be able to store settings even if you provide admin account for the service (admin - user that belongs to Administrators and Users groups).
There are several possible solutions:
- disable UAC;
- use BUILT-IN "administrator" account to start service;
- add "write" and "modify" permissions to Users group.
That's why setup program assigns "write" and "modify" permissions to Authenticated Users group when you install (not update) software on Windows Vista+ using separate folder for data files.
If you are sure you will run HostMonitor as service under built-in administrator account or UAC always will be disabled or HostMonitor will be started as application only, then you may adjust folder permissions (for better security) after installation and initial configuration.
Why administrator gets access denied
Inside Windows Vista UAC
Inside Windows 7 UAC
How to install HostMonitor as Win32 Interactive service
1) Install Advanced Host Monitor package on your system. If you already have Advanced Host Monitor installed, skip this step.
2) Start HostMonitor (hostmon.exe) with the command line parameter "/InstallService". E.g. "hostmon.exe /InstallService". HostMonitor will install itself as a service and display "Service options" dialog. "Service options" dialog allows you to specify some important parameters and then lauch the service. If you do not plan to start service right away, select "Launch service later" option and click Ok. In such case service will be started at system startup. Also you may start service at any time using standard Windows "Services" applet or command line like "net start hostmonservice".
Note #1: When HostMonitor starts as a service, it uses the system account (as all interactive services). But this account may not have all the necessary permissions, so some tests will not work correctly (UNC test, "disk free space" test for shared drives, "CPU Usage" test for remote machines, etc). If you need these tests, you will need to assign a special user account on the Service page in the Options dialog. In this case HostMonitor will impersonate the security context of the user.
Do not change the account using the system utility "Services". If you do so, HostMonitor may be unable to interact with the desktop.
Note #2: We do not recommend installing HostMonitor as a service under Windows NT 4.0. At least not as an interactive service. In the case you really need to start HostMonitor as a service on Windows NT, please, disable the "Allow service to interact with desktop" option for HostMonitor service (option provided by Windows Services applet). In this case you will not be able to see HostMonitor's icon in the system tray.
Note #3: In some cases Win32 service is unable to interact with desktop. There are 3 most common reasons:
Note #4: There is common mistake - install HostMonitor as service, start service, then start application.
Please DO NOT start several instances of HostMonitor on the same system using the same installation folder and
configuration files. If you do so, several instances will work simultaneously, monitor the same target systems,
and launch the same actions. If you modify test settings or profiles using 2nd instance of the software
(application), 1st instance (service) will not apply modifications until you restart service. Also, your
log files and statistical information will not be accurate when you are running several instances of the
monitor using the same log files.
That's why HostMonitor warns you when you are trying to start application while service is running as well.
To monitor Oracle servers HostMonitor uses the Oracle Call Interface (OCI.DLL). You should have the Oracle client software installed on the same computer. The same is true for other SQL servers, install the client software for testing your SQL server. HostMonitor uses the following DLLs:
- gds32.dll to monitor Interbase connections
- ntwdblib.dll to monitor MS SQL Server
- libmysql.dll to monitor MySQL
- libpq.dll to monitor PostgreSQL
- libsybdb.dll to monitor Sybase
Important: some versions of libmysql.dll have a bug that can cause HostMonitor to crash. If you experience this problem, you may download stable version of MySQL library from http://www.ks-soft.net/download/LIBMYSQL.DLL
To monitor processes on a remote Windows system, make sure you have the Remote Registry service started on the remote system (to monitor processes HostMonitor must have access to the registry). On Windows 2000 this service is installed by default, for Windows NT you can find this service in the Resource Kit.
If you wish to move the program from one computer to another you do not need to re-implement all the lists and settings again. Simply copy the program files from one computer or install the program on another computer and then copy only the files containing your settings.
|Hostmon.chm||All applications||Help file|
|Hostmon.exe||HostMonitor||Main executable module|
|LogsMan.exe||Log Analyzer||Main executable module|
|Rma.exe||RMA||Main executable module|
|Rma_mgr.exe||RMA Manager||Main executable module|
|Telnetservice.exe||Telnet Service||Main executable module|
|Webservice.exe||Web Service||Main executable module|
|Hostmon.ini||HostMonitor||Includes all global parameters (almost all of them represented in the Options dialog). You can create different ini files and specify the name of ini file in the command line when starting HostMonitor|
|HML_Mgr.ini||HML Manager||Options and settings|
|Logsman.ini||Log Analyzer||Options and settings defined in Options dialog|
|Rma.ini||RMA||Options and settings|
|Rma_Mgr.ini||RMA Manager||Options and settings|
|Telnetservice.ini||Telnet Service||Options and settings|
|Webservice.ini||Web Service||Options and settings|
|Actions.lst||HostMonitor||Contains the action profiles|
|List of Remote Monitoring Agents|
|Custmenu.lst||HostMonitor||Custom menu profiles|
|Holidays.lst||HostMonitor||List of holidays (for schedules)|
|Larep.lst||Log Analyzer||Report profiles|
|Prbypass.lst||HostMonitor||Proxy bypass list|
|Schedule.lst||HostMonitor||Contains the list of schedules|
|Services.lst||HostMonitor||List which includes TCP port descriptions|
|Sscripts.lst||HostMonitor||Shell Script profiles (used by Shell Script test)|
|Udvmacro.lst||HostMonitor||User defined macro variables|
|Users.lst||HostMonitor||User profiles (operators)|
|Wsuserprof.lst||Web Service||User profiles (preference settings for each user)|
|Examples\||-||This directory contains different examples:|
|Example1.hml||-||A sample HML (test list) file. It is recommend that you save your test configurations in a diferent HML file rather than just modify the one shipped with the program, otherwise your changes will get lost during the upgrade process as the sample HML file will be overwriten with the newest version available.|
|Errorlev.exe||-||Example of program for external test|
|Import1.txt||-||The sample import file|
|Script1.hms||-||Example of HMS sript|
|AutoRefresh.html||-||This file can be used as an external header for HTML reports. It contains command to auto refresh HTML. Your browser will be refreshing the page's contents at regular intervals|
|Summary.html||-||Another external header, will display tests' statuses summary|
|StdHeader.html||-||Just an example of external header for HTML reports, can be used as a base for creating your own headers|
|CompactHeader.html||-||Sample of external header for Compact HTML report|
|StdFooter.html||-||Just an example of external footer for HTML reports, can be used as a base for creating your own footers|
|Summary2.html||-||Another external footer, will display tests' statuses summary|
|Examples\LAReports\||-||Directory contains samples of the external header, footer, template for Log Analyzer's Report Manager|
|Examples\Scripts\||-||Directory contains sample scripts for Script test|
If you are using HostMonitor with a license key that had been generated illegally
or using a cracked version of HostMonitor, the program will become unstable causing
frequent software problems and crashes.
If you have any questions, please visit the online forum. There you can find answers to a lot of questions. If not, please do not hesistate ask, we will be happy to help you.