Viewing and updating guest images using the CLI

Prev Next

This procedure describes how to use CLI commands to view information about the guest images for a Intelligent Virtual Execution - Server appliance. The command output shows the following information about each guest images on the compute node:

  • Available guest images bundles

  • Available guest images defaults

  • Available guest images profiles

    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

Note

You cannot manage guest image updates for an MVX cluster from the CLI of a member Intelligent Virtual Execution - Server appliance. For information about how to manage guest images for a cluster, see the Distributed Network Security Cloud MVX Guide.

Prerequisites
  • Monitor, Operator, or Admin access

To show information about guest images:
  1. Go to CLI enable mode.

    vx-hostname > enable
  2. Show the available guest images bundles.

    For each guest image, the command output lists the image name, its version number,

    vx-hostname # show guest-images available bundles
    No bundles available other than the default bundle.
    
    Please use "guest-images configure defaults" to select the default bundle or
    	    "guest-images configure profiles <id>" to select profiles.
  3. Show the available guest images defaults.

    vx-hostname # show guest-images available default
    The default bundle contains the following profiles:
    win7-sp1 - Windows 7 SP1 English 32-bit (AMD) .
    winxp-sp3 - Windows XP sp3 English 32-bit (AMD).
    win7x64-sp1 - Windows 7 sp1 English 64-bit (AMD).
  4. Show the available guest images profiles.

    vx-hostname # show guest-images available profiles
    The following profiles are available:
    [0] win7-sp1 - 16.0615 - Windows 7 SP1 English 32-bit (AMD) .
    [1] winxp-sp3 - 16.0615 - Windows XP sp3 English 32-bit (AMD).
    [2] win7x64-sp1 - 16.0615 - Windows 7 sp1 English 64-bit (AMD).
  5. Show the configuration of current guest images.

    vx-hostname # show guest-images config
    Guest-image configuration is set to default:
    win7-sp1 - Windows 7 SP1 English 32-bit (AMD).
    winxp-sp3 - Windows XP sp3 English 32-bit (AMD).
    win7x64-sp1 - Windows 7 sp1 English 64-bit (AMD).
  6. Show downloaded and installed guest images.

    vx-hostname # show guest-images download
    The following Guest-image profiles are installed:
      win7-sp1 (Version 15.1218): Windows 7 SP1 English 32-bit (AMD) .
      winxp-sp3 (Version 15.1218): Windows XP sp3 English 32-bit (AMD).
      win7x64-sp1 (Version 15.1218): Windows 7 sp1 English 64-bit (AMD).
    
    Status of most recent guest-images operation:
    
    Check-Done: completed check for updates
    Fenet source: CMS (10.11.121.13 : single-port)
  7. Update guest images.

    vx-hostname # guest-images download-and-install
    The following profiles will be upgraded:  
        Profile win10x64m has an upgrade from version 24.0102 to 24.0103.  
        Profile win7-sp1m has an upgrade from version 24.0102 to 24.0103.  
        Profile win7x64-sp1m has an upgrade from version 24.0102 to 24.0103.  
        Profile winxp-sp3m has an upgrade from version 24.0102 to 24.0103.  
        Profile osx-10.11.3 has an upgrade from version 16.1201 to 25.1001.
    
    Status of most recent guest-images operation:
    
    Check-Done: completed check for updates
    Fenet source: DTI (cloud.fenet.fireeye.com)