Upgrade a WildFire Appliance

Use the following workflow to upgrade the WildFire appliance operating system. If you want to upgrade an appliance that is part of a WildFire cluster, see Upgrade WildFire Appliances in a Cluster. The appliance can only use one environment at a time to analyze samples, so after upgrading the appliance, review the list of available VM images and then choose the image that best fits your environment. In the case of Windows 7, if your environment has a mix of Windows 7 32-bit and Windows 7 64-bit systems, it is recommended that you choose the Windows 7 64-bit image, so WildFire will analyze both 32-bit and 64-bit PE files. Although you configure the appliance to use one virtual machine image configuration, the appliance uses multiple instances of the image to perform file analyses.
Depending on the number of samples the WildFire appliance has analyzed and stored, the time required to upgrade the appliance software varies; this is because upgrading requires the migration of all malware samples and 14 days of benign samples. Allow 30 to 60 minutes to upgrade a WildFire appliance that you have used in a production environment.
  1. If you’re setting up a WildFire appliance for the first time, start by configuring the WildFire appliance.
  2. Temporarily suspend sample analysis.
    1. Stop firewalls from forwarding any new samples to the WildFire appliance.
      1. Log in to the firewall web interface.
      2. Select
        Device
        Setup
        WildFire
        and edit
        General Settings
        .
      3. Clear the
        WildFire Private Cloud
        field.
      4. Click
        OK
        and
        Commit
        .
    2. Confirm that analysis for samples the firewalls already submitted to the appliance is complete:
      admin@WF-500>
      show wildfire latest samples
      If you do not want to wait for the WildFire appliance to finish analyzing recently-submitted samples, you can continue to the next step. However, consider that the WildFire appliance then drops pending samples from the analysis queue.
  3. Install the latest WildFire appliance content update.
    These updates equip the appliance with the latest threat information to accurately detect malware.
    admin@WF-500>
    request wf-content upgrade install version latest
    If you do not have direct connectivity to the Palo Alto Networks Update Server, you can download and Install WildFire Content Updates from an SCP-Enabled Server.
  4. Download the PAN-OS 8.0.1 software version to the WildFire appliance.
    You cannot skip any major release versions when upgrading the WildFire appliance. For example, if you want to upgrade from PAN-OS 6.1 to PAN-OS 7.1, you must first download and install PAN-OS 7.0.
    The examples in this procedure demonstrate how to upgrade to PAN-OS 8.0.1. Replace 8.0.1 with the appropriate target release for your upgrade.
    Download the 8.0.1 software version:
    • Direct Internet Connectivity:
      1. admin@WF-500> request system software download version 8.0.1
      2. To check the status of the download, use the following command:
        admin@WF-500> show jobs all
    • Without Internet Connectivity:
      1. Navigate to the Palo Alto Networks Support site and in the Tools section, click on
        Software Updates
        .
      2. Download the WildFire appliance software image file to be installed to a computer running SCP server software.
      3. Import the software image from the SCP server:
        admin@WF-500> scp import software from <username@ip_address>/<folder_name>/<imagefile_name>
        For example:
        admin@WF-500> scp import software from user1@10.0.3.4:/tmp/WildFire_m-8.0.1
      4. To check the status of the download, use the following command:
        admin@WF-500> show jobs all
  5. Confirm that all services are running.
    admin@WF-500>
    show system software status
  6. Install the 8.0.1 software version.
    admin@WF-500>
    request system software install version 8.0.1
  7. Complete the software upgrade.
    1. Confirm that the upgrade is complete. Run the following command and look for the job type
      Install
      and status
      FIN
      :
      admin@WF-500>
      show jobs all
      Enqueued Dequeued ID Type Status Result Completed --------------------------------------------------- 14:53:15 14:53:15 5
      Install
      FIN
      OK 14:53:19
    2. Restart the appliance:
      admin@WF-500>
      request restart system
      The upgrade process could take 10 minutes or over an hour, depending on the number of samples stored on the WildFire appliance.
  8. Check that the WildFire appliance is ready to resume sample analysis.
    1. Verify that the
      sw-version
      field shows 8.0.1:
      admin@WF-500>
      show system info | match sw-version
    2. Confirm that all processes are running:
      admin@WF-500>
      show system software status
    3. Confirm that the auto-commit (
      AutoCom
      ) job is complete:
      admin@WF-500>
      show jobs all
  9. (
    Optional
    ) Enable the VM image the WildFire appliance uses to perform analysis. Each available VM image represents a single operating system, and supports several different analysis environments based on that operating system.
    If your network environment has a mix of Windows 7 32-bit and Windows 7 64-bit systems, it is recommended that you choose the Windows 7 64-bit image, so WildFire will analyze both 32-bit and 64-bit PE files.
    • View the active virtual machine image by running the following command and refer to the
      Selected VM field
      :
      admin@WF-500>
      show wildfire status
    • View a list of available virtual machines images:
      admin@WF-500>
      show wildfire vm-images
      The following output shows that
      vm-5
      is the Windows 7 64-bit image:
      vm-5 Windows 7 64bit, Adobe Reader 11, Flash 11, Office 2010. Support PE, PDF, Office 2010 and earlier
    • Set the image to be used for analysis:
      admin@WF-500#
      set deviceconfig setting wildfire active-vm
      <vm-image-number>
      For example, to use vm-5, run the following command:
      admin@WF-500#
      set deviceconfig setting wildfire active-vm vm-5
      And commit the configuration:
      admin@WF-500#
      commit
  10. Next steps:
    • (
      Optional
      ) Upgrade firewalls to PAN-OS 8.0.1. See the firewall upgrade instructions included in the PAN-OS 8.0 New Features Guide. Firewalls running release versions earlier than PAN-OS 8.0.1. can still continue to forward samples to a WildFire appliance running 8.0.1.
    • (
      Troubleshooting
      ) If you notice data migration issues or an error following the upgrade, restart the WildFire appliance to restart the upgrade process—restarting the WildFire appliance will not cause data to be lost.

Related Documentation