Next Topic

Previous Topic

Book Contents

Creating Custom Agent Icons

Four Agent Icons

To incorporate custom agent icons in the system tray (Windows) or Menu Bar (Mac OS X) of each managed machine, create four icons. These icons must be named:

For Windows Agents

  • online.ico – By default, this is the blue K icon displayed when agent is connected to the KServer.
  • offline.ico – By default, this is the gray K icon displayed when agent is not connected to the KServer.
  • blink.ico – By default, this is the white K icon displayed when agent requires the user to click the icon to display a message that has been received using Remote Control > Send Message.
  • noremote.ico – By default, this is the red K icon displayed when the user has selected the Disable remote control menu item from the agent popup menu.

For Mac Agents

  • macOnline.tif - By default, this is the blue K icon displayed when agent is connected to the KServer.
  • macOffline.tif - By default, this is the gray K icon displayed when agent is not connected to the KServer.
  • macNoremote.tif - By default, this is the white K icon displayed when agent requires the user to click the icon to display a message that has been received using Remote Control > Send Message.
  • macBlink.tif - By default, this is the red K icon displayed when the user has selected the Disable remote control menu item from the agent popup menu.

Creating Your Own Agent Icons for Windows .ico Files

To create an icon in the Windows format, use an editor such as one in the Microsoft Visual Studio development environment.

  1. Select New > File... from the File menu in Microsoft Visual Studio.
  2. Select an Icon File template and click the OK button.
  3. Edit a standard 32x32 size icon image and save it as one of the four *.ico names listed above.
  4. Repeat this step and create four icons.

    Note: The color depth must not exceed 256 colors nor be larger than 32x32 pixels.

Uploading Your Custom Agent Icons into the KServer

  1. Select System > Customize.
  2. Click the Customize the graphical user interface link.
  3. Scroll to the bottom of the page and update the agent icon images for each of the following items. The agent displays the default VSA icons if any of the custom icons are omitted.
    • Agent system tray icon when agent is online (must be .ico format)
    • Agent system tray icon when agent is offline (must be .ico format)
    • Agent system tray icon when agent is blinking (must be .ico format)
    • Agent system tray icon when remote control is disabled (must be .ico format)
  4. Optionally enter four different agent icons for Macintosh machines just as you did in step 3. The agent displays the default VSA icons if any of the custom icons are omitted.

Formatting Custom Agent Icons

For Windows custom agent icons:

  • The format must use the Windows icon format. A simple bitmap file cannot simply be renamed using the .ico extension.
  • The size cannot be larger than 32x32 pixels.
  • The color depth cannot exceed 8 bit color (256 colors).

For Macintosh custom agent icons:

  • The format must be .tif.
  • The recommended size is 48x48 pixels and cannot be any larger.
  • The color depth should be RGB 32 bit color.

Updating Existing Agents with Custom Agent Icons

Schedule an agent update using Agent > Update Agent. You will need to check the Force update check box to update agents that are already at the current version.

Creating Agent Install Packages with Custom Agent Icons

The custom icons are included in install packages created using the Create Package wizard in Deploy Agent. If you are using a KcsSetup.exe file created by Agent Deploy in a domain logon script, then you must replace the KcsSetup.exe file on the domain server with the version updated with the new custom icons.