--- title: "Upgrading the appliance using the CLI" slug: "upgrading-the-appliance-using-the-cli-4" tags: ["Product Usage", "CMS 11.x", "EX 11.x", "FX 11.x", "AX 11.x", "NX 11.x", "IVX 11.x", "Network Security"] updated: 2026-09-09T14:18:46Z published: 2026-09-09T14:18:46Z canonical: "docs.trellix.com/upgrading-the-appliance-using-the-cli-4" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrading the appliance using the CLI Use the commands in the following sections to upgrade the Intelligent Virtual Execution - Server appliance. ### Task list for upgrades Perform the following steps (detailed in the sections that follow) to upgrade the appliance. 1. [Download and install the appliance software image](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#download-and-install-the-appliance-software-image). 2. [Restart the appliance and accept the EULA](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#restart-the-appliance-and-accept-the-eula). 3. [Download guest images](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#download-guest-images). 4. [Install downloaded guest image profiles](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#install-downloaded-guest-image-profiles). 5. [Download and install guest images in a single command](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#download-and-install-guest-images-in-a-single-command). 6. [Verify the upgrade](/network-and-platform/docs/upgrading-the-appliance-using-the-cli-4#verify-the-upgrade). > [!WARNING] > Important > > Be sure to download the software image and guest image files from the configured DTI source server before beginning any installations. ### Download and install the appliance software image **To download and install the software image:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Check for downloads: ```plaintext hostname (config) # fenet image check hostname (config) # show fenet image status ``` 3. Download the software image: ```plaintext hostname (config) # fenet image fetch ``` 4. View the download progress: ```plaintext hostname (config) # show fenet image status ``` ```plaintext   Progress of latest action taken:   action fetch initiated                      Fri Dec 19 00:07:42 2025   applying fetch for image                    vx   action fetch completed                      Fri Dec 19 00:07:42 2025   check-done: New OS-image available: 11.0.1 status   ``` > [!NOTE] > Note > > If you have already downloaded the latest software, you may see an error: "Latest image already downloaded and ready to install (error)." To check which images are downloaded, use the following command: > > `hostname (config) # show fenet image list` 5. Install the downloaded software image: ```plaintext hostname (config) # image install image-vx.img hostname (config) # image boot next ``` > [!NOTE] > Note > > If an upgrade process is interrupted or fails, the appliance software automatically falls back to the currently installed image. 6. Save your changes: ```plaintext hostname (config) # write memory ``` ### Restart the appliance and accept the EULA **To restart the appliance and accept the EULA:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Restart the appliance: ```plaintext hostname (config) # reload ``` 3. After restarting the appliance, the system could display the Trellix End User License Agreement [(EULA](https://www.fireeye.com/company/legal.html)). Read the EULA. Click **Yes** if you agree to its terms, and then click **Submit**. If you do not accept the EULA, the appliance will not function. After accepting the EULA, the login page is displayed. Wait a few minutes before logging in because database records are undergoing an update in preparation for the upgrade. > [!NOTE] > Note > > You must access the appliance through the serial port if you want to monitor appliance boot activities. You can enter CLI commands through direct keyboard and monitor connection only before the boot loader begins loading the kernel, for example, to post output, and after the boot is completed. ### Download guest images > [!WARNING] > Important > > Default guest images are automatically downloaded and installed from the DTI source server. To download and install a guest image bundle or profile, you must first use the `guest-images configure` command to select the guest image. This procedure describes how to install default and non-default guest images. **To download guest images:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. View the guest images configured for the appliance: ```plaintext hostname (config) # show guest-images config ``` 3. Download the guest images, but do not install them yet. Downloading guest images will take some time, so allow the download to run in the background. ```plaintext hostname (config) # guest-images download ``` Wait for the appliance to fully download the guest images before beginning any installations. > [!NOTE] > Note > > You can perform automatic downloads of available guest images. For details, see the `fenet guest-images auto download` and `fenet guest-images auto update` commands in the *CLI Command Reference*. 4. Confirm the guest image downloads are completed: ```plaintext hostname (config) # show guest-images download ``` To cancel a download in progress: ```plaintext hostname (config) # guest-images download cancel ``` To resume a download that has been interrupted for any reason: ```plaintext hostname (config) # guest-images download resume ``` 5. To download non-default guest images by specifying the server manifest: > [!NOTE] > Note > > Perform this step if you do not need all available guest images. 1. Download the server manifest: ```plaintext hostname (config) # guest-images download manifest [version ``` 2. Display available guest image bundles: `hostname (config) # show guest-images available bundles` 3. Note the bundle ID of the bundle of guest images that you want from the list displayed (only one bundle can be selected). 4. Select the guest image bundle to be installed, where `bundle_id` is obtained from the previous step: `hostname (config) # guest-images configure bundle` 5. Verify that the bundle is properly selected: ```plaintext hostname (config) # show guest-images config ``` 6. To update guest images with one or more profiles (mutually exclusive with default and bundle sets): 1. Download the server manifest: ```plaintext hostname (config) # guest-images download manifest [version ] ``` 2. Display available guest image profiles: ```plaintext hostname (config) # show guest-images available profiles ``` 3. Note the profile ID of the needed profile(s) from the list displayed. 4. Select the guest image profile to be installed: ```plaintext hostname (config) # guest-images configure profile ``` where `<profileID>` is the profile you noted in the previous step. 5. Repeat the previous step for each additional profile needed. 6. Verify that all needed profiles are configured: ```plaintext hostname (config) # show guest-images configuration ``` 7. Download the guest images: ```plaintext hostname (config) # guest-images download ``` 8. Monitor the download progress: ```plaintext hostname (config) # show guest-images download ``` > [!NOTE] > Note > > If you encounter a problem with a download, the output of the `show guest-images download` command will describe the issues, including notification about the specific file that was involved in the failure. Network connectivity issues cause download failures. Repeat the download using the `guest images download` command. The system will restart the download at the point at which it was interrupted or failed. If the problem persists, contact Trellix Technical Support. 7. Save your changes: ```plaintext hostname (config) # write memory ``` ### Install downloaded guest image profiles **To download default guest images:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. After the download is complete, install the guest images: ```plaintext hostname (config) # guest-images install ``` 3. Verify that guest images are properly installed: ```plaintext hostname (config) # show guest-images ``` 4. Save your changes: ```plaintext hostname (config) # write memory ``` ### Download and install guest images in a single command **To download and install default guest images:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Download and install guest images: ```plaintext hostname (config) # guest-images download-and-install ``` > [!NOTE] > Note > > When the appliance is managed by a Central Management System appliance, the guest image download process is automated. The managed appliance is scheduled to check for guest image updates daily and then trigger the Central Management System appliance to download the requested guest image update for hosting. The managed appliance will automatically download and install the updates after the Central Management System appliance completes the download. 3. View the download status of the guest images: ```plaintext hostname (config) # show guest-images download ``` To cancel a download in progress: ```plaintext hostname (config) # guest-images download cancel ``` To resume a download that has been interrupted for any reason: ```plaintext hostname (config) # guest-images download-and-install resume ``` To delete the partial download of Guest Images: ```plaintext hostname (config) # guest-images download delete ``` 4. Verify that the guest images are properly installed: ```plaintext hostname (config) # show guest-images ``` ### Verify the upgrade **To verify the upgrade:** 1. Go to CLI configuration mode: ```plaintext hostname > enable hostname # configure terminal ``` 2. Display the version information for the current system image: ```plaintext hostname (config) # show version ``` 3. Display all guest images: ```plaintext hostname (config) # show guest-images ```