Viewing Guest Images Using the CLI

This topic describes how to view guest images using CLI commands on an Malware Analysis appliance.

You cannot manage guest image updates from the CLI. For information about how to manage guest images, refer to Managing Guest Images Using the Web UI.

Prerequisites

To view guest images on your Malware Analysis appliance, ensure you have:

  • An established connection to the Internet
  • A connection to the DTI Cloud or a CM server
  • Admin or Operator access to the Malware Analysis appliance
  • A CONTENT_UPDATES license
  • A FIREEYE_SUPPORT license

Viewing Guest Images Using the CLI

The Malware Analysis CLI commands allow you to view the following information about guest images:

  • Available guest images

    NOTE: The Guest Images list is dynamic: new guest images and version updates for the current guest images are automatically made available to your appliance from the DTI cloud through security content updates.
  • Guest images configurations
  • Downloaded and installed guest images

To show guest images:

  1. Enable the CLI configuration mode. 
    hostname > enable
    hostname # configure terminal
  2. Show the available bundles, defaults, or profiles for guest images. 
    hostname (config) # show guest-images [available {bundles | defaults | profiles}]
  3. Show the configuration for current guest images. 
    hostname (config) # show guest-images config
  4. Show downloaded and installed guest images. 
    hostname (config) # show guest-images download

Output Examples for show guest images Commands

The following examples show output for the show guest images commands.

To show available default guest images:

  1. Enable the CLI configuration mode.
    hostname > enable
    hostname # configure terminal
  2. Show the available default guest images. 
    hostname (config) # show guest-images available defaults
    The default bundle contains the following profiles:
    winxp-sp3m - Windows XP sp3 English 32-bit (Intel).
    winxp-sp2m - Windows XP sp2 English 32-bit (Intel).
    win7x64-sp1m - Windows 7 sp1 English 64-bit (Intel).
    win7-sp1m - Windows 7 SP1 English 32-bit (Intel).
    osx-10.8.2 - Mac OS X 10.8.2 English 64-bit.
    osx-10.9 - Mac OS X 10.9 English 64-bit.

To show available profiles for guest images:

  1. Enable the CLI configuration mode. 
    hostname > enable
    hostname # configure terminal
  2. Show the available profiles for guest images. 
    hostname (config) # show guest-images available profiles
    The following profiles are available:
    [0] winxp-sp3m - Windows XP sp3 English 32-bit (Intel).
    [1] winxp-sp2m - Windows XP sp2 English 32-bit (Intel).
    [2] win7x64-sp1m - Windows 7 sp1 English 64-bit (Intel).
    [3] win7-sp1m - Windows 7 SP1 English 32-bit (Intel).
    [4] osx-10.8.2 - Mac OS X 10.8.2 English 64-bit.
    [5] osx-10.9 - Mac OS X 10.9 English 64-bit.

To show the configuration for current guest images:

  1. Enable the CLI configuration mode. 
    hostname > enable
    hostname # configure terminal
  2. Show the configuration for current guest images. 
    hostname (config) # show guest-images config
    Guest-image configuration is set to default:
    winxp-sp3m - Windows XP sp3 English 32-bit (Intel).
    winxp-sp2m - Windows XP sp2 English 32-bit (Intel).
    win7x64-sp1m - Windows 7 sp1 English 64-bit (Intel).
    win7-sp1m - Windows 7 SP1 English 32-bit (Intel).
    osx-10.8.2 - Mac OS X 10.8.2 English 64-bit.
    osx-10.9 - Mac OS X 10.9 English 64-bit.

To show downloaded and installed guest image updates:

  1. Enable the CLI configuration mode: 
    hostname > enable
    hostname # configure terminal
  2. Show downloaded and installed guest images. 
    hostname (config) # show guest-images download
    The following Guest-image profiles are installed:
    winxp-sp3m (Version 14.0528): Windows XP sp3 English 32-bit (Intel).
    winxp-sp2m (Version 14.0528): Windows XP sp2 English 32-bit (Intel).
    win7x64-sp1m (Version 14.0528): Windows 7 sp1 English 64-bit (Intel).
    win7-sp1m (Version 14.0528): Windows 7 SP1 English 32-bit (Intel).
    osx-10.8.2 (Version 14.0721): Mac OS X 10.8.2 English 64-bit.
    osx-10.9 (Version 14.0721): Mac OS X 10.9 English 64-bit.