Installation

Software installation

System requirements

  • 256 MB RAM minimum
  • 512 MB RAM recommended
  • 50 MB hard disk space (may vary if history saving feature is enabled)
  • 1024x768 minimum screen resolution

Windows

  • Intel Pentium III/800 MHz or higher (or compatible)
  • Microsoft Windows 2003/XP/2000/NT 4.0 SP6a

Linux

  • Intel Pentium III/800 MHz or higher (or compatible)
  • Red Hat Linux Fedora, Debian, SuSe, Mandrake, Slackware, Gentoo and other distributions with JDK 1.5.0
  • GNOME or KDE desktop

Insider installation

Download the installer and run it. You will be prompted for installation directory. No server components are required for Insider to function. A Windows service can be installed on a Windows server to get an Oracle alert log file and some extended Windows statistics.

Windows service installation

The Windows service is an optional component that can be installed on a Windows server in order to get the Oracle alert log file and some extended statistics.

Simple installation.  The default installation of the Windows service adds InsiderWinMonitor service running under System account. All communication between the service and Insider is encrypted and the service listens on the port 12766. To install the Windows service with the default parameters execute:

InsiderWinMonitor.exe install

Note that the service is not started by default. You need to start it with:

InsiderWinMonitor.exe start

To stop the service execute:

InsiderWinMonitor.exe stop

To uninstall:

InsiderWinMonitor.exe uninstall

The service can also be started/stopped and configured using Windows Services applet. See My Computer > Manage > Services and Applications > Services

Advanced configuration.  To start the Windows service as a console application, change the user account or make it listen to a non-default port or to change any other options run InsiderWinMonitor.exe with non-default parameters.

Usage:

InsiderWinMonitor.exe [ operation ] [ options ] [ parameters ]

Operations:
  [-k] install
  Install service.
  [-k] uninstall
  Uninstall service.
  [-k] console
  Start as console application (default).
  [-k] start
  Start service.
  [-k] stop
  Stop service.
  [-k] restart
  Restart service.
  -i   Install service (alias for -k install).
  -u   Uninstall service (alias for -k uninstall).
  -c   Run as console application (alias for -k console).

Options:
  -n name
 Specifies the name of the service
  -a  Automatic service start (valid with operation "install" only).
  -m  The service will be started manually (valid with operation "install" only).
  -p account password
  Run the service under the specified account.
  Notes:
    This option is valid with operation "install" only.
    Specified user MUST have permissions to logon as service.
    Use form .\username for local accounts.
    Use form domain\username or username@domain for a user registered in a domain.
  -f file
  Use parameter file.

Parameters:
  [parameter_name=] parameter_value

  port=port_number
TCP port number.
  logfile=filepath
Service log file.
  protocol=protocol_flags
Set protocol flags:
  transparent - transparent transmission;
  scramble - scramble network traffic.
            

Notes. 

  • Options -p, -m and -a are valid only when installing the service. Some other options are valid only when installing the service or starting it as a console application. The arguments, specified at the installation are saved in Windows registry and used when starting the service (-p, -m, -a options and parameters)
  • -f option can also be used at the installation or starting as a console application only. If specified at the installation the parameters are copied to the Windows registry. At the subsequent starts the parameter file is not read again
  • The user account, configured with the -p option must have LOGON AS SERVICE permissions. See Programs > Administrative Tools > Local Security Policy > Security settings > User Rights Assignment > Logon as Service. The user account/password can also be changed using Windows Services applet: My Computer > Manage > Services and Applications > Services
  • Permission "Act as part of operating system" should be granted to run on Windows 2000 in console mode
  • If transparent protocol flag has been specified the communication between Insider and the service is not encrypted. However the username and password are still encrypted
  • At the installation or starting as a console application if -f option has not been specified but an InsiderWinMonitor.properties file is found in the same directory where the exe file is located it is used as a parameter file. InsiderWinMonitor.properties is included into the Windows service installation package.
  • The arguments to the service are processed in the following order:
    • .properties file if found
    • command line arguments
    • Windows registry (only when starting the service)