7. Using the Unattended Agent on Windows

iTivity™ User Guide7. Using the Unattended aAgent on Windows

The unattended agent provides for remote viewing and administration of Windows systems. This agent can be installed from a distribution MSI or custom EXE. It provides a persistent, "always-on" connection. If the connection is lost, the unattended agent automatically attempts to reconnect.

This chapter explains the menu options available on the computer where the unattended agent is installed. For installation instructions, see Chapter 5 in this guide.

Note: For information on installing and running the unattended agent on Linux systems, see Chapter 8.

7.1 Unattended Agent Start Menu Options

When the unattended agent is installed, the following options are made available on the Windows Start menu.

7.1.1 Administrative Tools

The Administrative Tools menu option presents a flyout menu with additional options. Edit iTivity Screen Server Settings

This option can be used to edit the default settings for the TridiaVNC Server module. This module runs as part of the unattended agent to allow remote control and viewing of the computer.

Note: When the unattended agent is active, the computer is considered a VNC host. The term TridiaVNC Viewer refers to the module (part of the console that views the agent on the remote computer. See Section 4.4 for information.

Choosing this option displays the TridiaVNC Server: Default Local System Properties dialog, with the following tabs.

Server Tab

Incoming connections

Accept Socket Connections: When this option is checked (the default), the computer accepts direct, socket-based connections from the viewer program. Clearing this checkbox disables incoming view connections from iTivity console. However, file transfer connections are still allowed.

Primary password: Not used by iTivity. Do not change this option.

View-only password: Not used by iTivity. Do not change this option.

Display or port numbers to use

Auto or Display (Number): Indicates whether the TridiaVNC viewer will use the first display number not already in use on the host machine (Auto) of the display number specified in the adjacent Number field. Default is Auto.

Ports: TridiaVNC server listening ports: This option is not used by iTivity and is disabled by default.

Input handling

Block remote input events: When checked, any new incoming connections will be able to view the screen but not send any input. Default is unchecked.

Block remote input on local activity: When checked, this option disables remote keyboard and pointer when the local user keyboard or mouse is active. Default is unchecked. When checked, you can set the inactivity timeout in seconds in the following field.

No local input during client sessions: When checked, keyboard and mouse input from the local computer user is disabled during a TridiaVNC viewer session. Default is unchecked.

Blank screen on client connections. When checked, the local computer screen is blank during a TridiaVNC Viewer session. Default is unchecked.

When last client disconnects:

This option indicates what action to be taken when the last TridiaVNC viewer disconnects from the local (host) machine:

Do nothing- Take no action (Default).

Lock workstation- Lock the local computer.

Logoff workstation- Log-off the current user.

Enable file transfers

Enable the TridiaVNC Server file transfer function. This is a alternative to the iTivity File Transfer function and is not typically used with iTivity.

Remove desktop wallpaper:

When checked, the TridiaVNC server removes the desktop wall paper during client TridiaVNC viewer sessions. This improves screen update performance. Checked by default.

Hooks Tab

Polling modes

Poll foreground window

When checked, the VNC Viewer polls only the currently selected window for changes. This is less CPU-intensive than full-screen polling and often gives similar results. This is true, for example, when using the Command Prompt, which is not normally compatible with iTivity.

Poll Window Under Cursor

A variation on Poll foreground window, this option causes the window under the mouse cursor to be polled for changes. Both options may be enabled simultaneously, if required.

Poll full screen

When checked, the entire screen is polled for changes. Some applications are incompatible with the methods used by iTivity to trap screen updates. For this reason, it is sometimes useful to be able to poll the entire screen to check for changes. This tends to sacrifice performance for accuracy.

Polling cycle

Determines how often (in milliseconds) the server polls for screen updates. Default 300 ms

Window polling

Poll console windows only

When checked, only Command Prompt windows are polled. This works well in conjunction with Poll Window Under Cursor, to use polling only when the cursor is over a console window.

Poll on event received only

When checked, the screen is only polled for updates when a mouse or keyboard event is received from the iTivity console. This is provided for low-bandwidth networks, where it may be useful to control how often the screen is polled and changes sent.

Mirror driver status

The mirror driver is a third-party device driver for tracking screen updates. Using the mirror driver greatly increases the speed and reliability of updates, and also decreases CPU utilization on the server.

The Mirror driver status area reports on the status of mirror driver usage when the agent is connected to a console.

Note: For information on the installing and using the mirror driver, view the iTivity support site FAQs (at the following URL) and search on "mirror driver":


Mirror driver options

Enable direct access to display the driver's mirror screen: Check this option for optimal performance using the default configuration of the mirror driver. Default is checked.


Don't use mirror display driver even if available: Check this option to disable use of the Mirror driver.

Display Tab

Sharing area

These options indicate the area of the agent screen that is shared and visible to an console user.

Full desktop - Share the entire server desktop. Default.

Primary display- Share the primary console screen.

Rectangular areaSelect and share a region of the screen. When selected, a rectangle appears on the screen that you can drag to resize and indicate the area to be shared.

Window - Select and share a window on the screen. Click and drag the target icon in the dialog to the desired window on the screen. The selected window title appears in the Window text box.

Query Tab

Query settings

The options on this tab are not used with iTivity.

Administration Tab


Disable empty passwords - Allow empty password with client connection authentication.

Caution: Do not check this box as it may cause iTivity authentication to fail. In most cases iTivity controls authentication, and the TridiaVNC Server authentication is disabled. However, if you check this option then iTivity authentication will fail with any authentication setting other than Simple Password.

Allow loopback connections - When checked, allows the VNC connection over the loopback (local) interface. Checked by default. This is required for use with iTivity encrypted or tunneled connections.

Allow only loopback connections - When checked, restricts VNC connections to the loopback (local) interface. This provides extra security because only iTivity's encrypted connections are allowed with the VNC server. This is recommend for use with iTivity encrypted or tunneled connections. Checked by default.

HTTP server

This feature is not used with iTivity.


Log information to WinVNC.log: When checked, the Tridia VNC server writes logging (debug) information to the WinVNC.log file in the iTivity bin directory C:\Program Files\iTivity\Unattended Agent\bin Default is unchecked.

Log detailed debugging information: When the above option is checked, you can check this box to log include low-level troubleshooting information in the WinVNC.log file.

Connection priority

This setting indicates how the TridiaVNC server handles requests for more than one simultaneous connection.

Disconnect existing connections - Drops all existing (previous) connections when a new iTivity connection arrives.

Automatic shared sessions - Allows multiple, simultaneous iTivity connections.

Refuse concurrent connections - (Default) Rejects new iTivity connections when an existing connection is present. FTP Server Configuration

This option is used to configure and launch the unattended agent's included FTP server.

About the FTP Server

The FTP Server is launched automatically whenever the unattended agent starts. The server must be running and properly configured for the unattended agent to allow a File Transfer connection with the iTivity console.

By default, the FTP Server is set to listen on the local host IP address ( and to an arbitrary port number 8882. This allows the FTP server to work automatically in most cases. However, if another program is using port 8882, the FTP server will not work unless you change its port number as described below.

Configuring the FTP Server

You need to use this procedure only if you need to allow File Transfer sessions through the unattended agent and if the default configuration does not work on the local computer.

1. Choose Start > All Programs > iTivity > Unattended Agent > Administrative Tools > FTP Server Configuration.

The Connect to Server dialog is displayed:

2. Click the OK button.

Note: Do not change the Server Address or Port in this dialog.

The FTP Server window is displayed. This window will display the log of FTP server activity. You can also use the menu options available in this window to more fully configure the FTP server.

The following screen image shows an example of the configuration options you can set.

3. Under Connection settings in the right pane, change the Port and/or Server Address as necessary. If you enter an FTP server address other than the default for the local host, you must also enter a password for that server.

4. Click OK. Then close the FTP server main window.

5. To allow the unattended agent to locate the new port number in use by the FTP server, update the following registry setting:

HKEY_LOCAL_MACHINE\Software\iTivity\ Connector_rc\ftpCtlSvcPort

This is a DWORD (integer) setting that must contain the same port number on which the FTP server is listening. For an example registry file that updates this setting, refer to:

C:\Program Files\iTivity\config\ Unattended_FTP_Port_Default.reg

6. Stop and then restart the unattended agent. Set Unattended Agent Simple Password

You can use this option to change the password used by a remote user of iTivity console to view this computer. This password applies only if Simple Password was chosen as the Authentication Method when the unattended agent was installed. If NTLM was chosen, any entry in this dialog is ignored.

Note: If the iTivity console is installed on this computer, you can also set the password on the Security tab of the Tools > Options dialog. See Section, Options.

Enter the password twice, then click OK to reset the password. Start Unattended Agent

You can use this option to start the unattended agent. The agent immediately connects to the hyperserver and the unattended agent icon appears in the system tray. Stop Unattended Agent

You can use this option to stop the unattended agent when it is currently running. The agent immediately disconnects from the hyperserver and the unattended agent icons are removed from the system tray. Reset Unattended Agent Secure Dial Failure

This option appears only if the unattended agent was installed with the secure dial feature enabled.

Use this option to reset the secure dial function. If a console user cannot authenticate or attempts to connect with an unencrypted connection three times, the modem will be locked. If this happens, the Reset unattended agent Secure Dial Failure option must be used to re-enable the connection.

7.1.2 iTivity Licensing

These functions can be used to license the unattended agent separately from the hyperserver. When an agent is licensed separately, its connection to an hyperserver does not count as one of the connections allowed by the hyperserver license. Contact iTivity Corp for more information on this option.

The procedures are the same as for entering or editing license codes on the hyperserver. See Section 2.4, Licensing the Hyperserver on Windows, for instructions.

7.1.3 About iTivity Unattended Agent

Choose Start > All Programs > iTivity > Unattended Agent > About iTivity unattended agent to display an About box showing version information for the unattended agent.

7.1.4 Edit Unattended Agent Hyperserver Connection Settings

You can use this option to edit the information for connecting to the hyperserver and for opening or closing a connection.

Choose Start > All Programs > iTivity > Unattended agent > Edit Unattended agent hyperserver Connection Settings to display following dialog.

You can use this dialog to configure the agent to connect to more than one hyperserver and/or support group. You can also edit and delete the connections. About Multiple Hyperserver Connections

On startup, the agent makes a connection with each connection group defined here. The agent attempts to connect to each hyperserver in a connection group until a successful connection is established. This results in one hyperserver connection per defined connection group. Working with Connection Settings

Click the Add Group or Edit Selected button to display the hyperserver Connection Group Settings dialog. If you are adding a Group, the fields are displayed with default entries.

Use this dialog to define or edit the connection settings. The Advanced button displays the Advanced Connection Settings dialog:

You can use this dialog to enable connection to the hyperserver through a SOCKS V5 proxy server and to enter the proxy server settings. See Section 5.6, Using the iTivity Agents with a Proxy Server for more information.

7.2 System Tray Options

When the unattended agent is running, the following icon is shown in the Windows system tray:

Right-click on this icon to display the following popup menu:

7.2.1 Show Active Sessions

This option displays a dialog showing active remote control sessions currently viewing this computer as host. You can use the buttons to select and close any or all of the sessions. When NTLM authentication is used, the NTLM user name is shown for each session. The name of thehyperserver is shown in the remote host column.

7.2.2 Show Certificate Fingerprint

Selecting the Show Certificate Fingerprint option displays the Certificate Fingerprint.

The unattended agent automatically generates an encryption certificate the first time it runs. This unique certificate is presented to the iTivity console to ensure encryption of all session data transmitted between the unattended agent and the console.

The first time the iTivity console attempts to view the host, the user is asked to confirm the host's certificate fingerprint. After the first connection, the remote machine retains the fingerprint in its cache for the next viewing session.

For more information on certificates, see the iTivity Deployment Guide.

7.2.3 About iTivity Unattended Agent

Select this option to display an About box showing version information for the unattended agent. The Session ID is also shown.

7.2.4 Stop Unattended Agent

You can use this option to stop the unattended agent when it is currently running. The agent immediately disconnects from the hyperserver and the unattended agent icons are removed from the system tray.

7.3 iTivity Product Support

Product support is available from iTivity by web site or email:

Copyright © 2004 - 2019, iTivity Corporation Copyright and License Information