Focus

PAN-OS Upgrade Guide

Upgrade Log Collectors When Panorama Is Internet-Connected

Table of Contents

Upgrade Log Collectors When Panorama Is Internet-Connected

Upgrade Log Collector software to PAN-OS® 10.1 and install content updates using Panorama™ when Panorama is connected to the internet.

For a list of software or content updates you can install on Log Collectors, see Supported Updates.

PAN-OS® 10.1 introduces a new log format. On upgrade from PAN-OS 10.0 to PAN-OS 10.1, you can choose to migrate logs generated in PAN-OS 8.1 or earlier release. Otherwise, these logs are automatically deleted on successful upgrade to PAN-OS 10.1. During migration, log data is not visible in the ACC or Monitor tabs. While the migration takes place, log data continues forwarding to the appropriate Log Collector but you may experience some impacts to performance.

If you are upgrading from PAN-OS 8.1, PAN-OS 9.0 introduced a new log data format for local and Dedicated Log Collectors. On your upgrade path to PAN-OS 10.1, existing log data is automatically migrated to the new log data format when you upgrade from PAN-OS 8.1 to PAN-OS 9.0.

You must upgrade all Log Collectors in a collector group at the same time to avoid losing log data. No log forwarding or log collection occurs if the Log Collectors in a collector group are not all running the same PAN-OS version. Additionally, the log data for the Log Collectors in the collector group is not visible in the ACC or Monitor tabs until all Log Collectors are running the same PAN-OS version. For example, if you have three Log Collectors in a collector group and you upgrade two of the Log Collectors, then no logs are forwarded to any Log Collectors in the collector group.

Palo Alto Networks recommends that you upgrade Log Collectors during a maintenance window. Due to log format migration, the entire upgrade procedure takes an additional number of hours depending on the amount of log data on the local and Dedicated Log Collectors.

Before you upgrade Log Collectors, ensure that you are running the appropriate Panorama™ software release on the Panorama management server.
Palo Alto Networks® highly recommends that Panorama and Log Collectors run the same software release version and that Panorama, Log Collectors, and all managed firewalls run the same content release version. For important software and content compatibility details, see Panorama, Log Collector, Firewall, and WildFire Version Compatibility.

Panorama must be running the same (or later) software release as Log Collectors but must have the same or later content release version:
- Software release version—If your Panorama management server is not already running the same or a later software release than the release to which you intend to update Log Collectors, then you must install the same or a later Panorama release on Panorama (see Install Content Updates and Software Upgrades for Panorama) before you update any Log Collectors.
- Content release version—For content release versions, you should ensure that all Log Collectors are running the latest content release version or, at minimum, running a later version than is running on Panorama; if not, then first update managed firewalls (using Panorama) and then update Log Collectors before you update the content release version on the Panorama management server.
To check software and content versions:
- Panorama management server—To determine which software and content versions are running on the Panorama management server, log in to the Panorama web interface and go to General Information settings (Dashboard).
- Log Collectors—To determine which software and content versions are running on Log Collectors, log in to the CLI of each Log Collector and run the show system info command.
Determine the Upgrade Path to PAN-OS 10.1.
You cannot skip installation of any feature release versions in the path from the currently running PAN-OS version to PAN-OS 10.1.0.

Review PAN-OS Upgrade Checklist, the known issues and changes to default behavior in the Release Notes and Upgrade/Downgrade Considerations for each release through which you pass as part of your upgrade path.
Install the latest content updates.

Refer to the Release Notes for the minimum content release versions required for a Panorama software release.
1. Log in to the Panorama web interface.
2. Select PanoramaDevice DeploymentDynamic Updates and Check Now for the latest updates. If an update is available, the Action column displays a Download link.
3. If not already installed, Download the appropriate content updates. After a successful download, the link in the Action column changes from Download to Install.
4. Install the content update (Applications and Threats update) before any others.
  If your subscription includes both Applications and Threats content, install the Apps content first. This automatically installs both Application and Threats content.
  
  Regardless whether your subscription includes both Applications and Threats content, Panorama installs and needs only the Applications content. For details, see Panorama, Log Collector, Firewall, and WildFire Version Compatibility.
5. Repeat the substeps above for any other updates (Antivirus, WildFire, or URL Filtering) as needed, one at a time, and in any sequence.
Upgrade the Log Collector to the PAN-OS releases along your upgrade path to PAN-OS 10.1.

If upgrading more than one Log Collector, streamline the process by determining the upgrade paths for all Log Collectors you intend to upgrade before you start downloading images.
1. Upgrade Log Collectors When Panorama is Internet-Connected to PAN-OS 8.1.
2. Upgrade Log Collectors When Panorama is Internet-Connected to PAN-OS 9.0.
  PAN-OS 9.0 introduced a new log format. Logs are automatically migrated to the new format after you successfully upgrade the Log Collector to PAN-OS 9.0.
  
  Do not continue on your upgrade path until you verify the automatic log migration completed successfully.
3. Upgrade Log Collectors When Panorama is Internet-Connected to PAN-OS 9.1.
4. Upgrade Log Collectors When Panorama is Internet-Connected to PAN-OS 10.0.
Upgrade the Log Collector to PAN-OS 10.1.
1. On Panorama, Check Now (PanoramaDevice DeploymentSoftware) for the latest updates. If an update is available, the Action column displays a Download link.
2. Download the model-specific file for the release version of the PAN-OS 10.1 release. For example, to upgrade an M-Series appliance to Panorama 10.1.0, download the Panorama_m-10.1.0 image.
  After a successful download, the Action column changes from Download to Install for that image.
3. Install PAN-OS 10.1 and select the appropriate Log Collectors.
4. Select one of the following depending on your needs:
  - Upload only to device (do not install).
  - Reboot device after install.
5. Click OK to start the upload or installation.
6. (Logs generated in PAN-OS 8.1 or earlier releases only) If the Log Collector stores logs generated in PAN-OS 8.1 or earlier release, the upgrade to PAN-OS 10.1 is blocked to alert you that logs generated in PAN-OS 8.1 or earlier release are automatically deleted on upgrade to PAN-OS 10.1.
  Acknowledge the alert and Install PAN-OS 10.1 again.
  
  After successful upgrade to PAN-OS 10.1, CLI commands are provided to recover and migrate all logs generated in PAN-OS 8.1 or earlier release to the log format introduced in PAN-OS 10.1.
(Optional) After successful upgrade to PAN-OS 10.1, migrate the log format for logs generated in PAN-OS 8.1 and earlier releases.
Skip this step if you do not need to preserve logs generated in PAN-OS 8.1 or earlier release or if there are no logs that need to be migrated.

Migrating the log format is required to access logs generated in PAN-OS 8.1 and earlier releases after successful upgrade to PAN-OS 10.1. Logs generated in PAN-OS 8.1 or earlier release that are not migrated are automatically deleted.
1. Log in to the Panorama CLI of the Log Collector.
2. Enter the CLI commands automatically displayed in the previous step to migrate logs.
  The commands displayed to migrate logs are dynamic and unique to each Log Collector.
3. View the status of the log migration.
```
admin> debug logdb migrate-lc status
```
4. Repeat for all Log Collectors you upgraded to PAN-OS 10.1
Verify the software and content update versions that are installed on the Log Collector.
Enter the show system info operational command. The output will resemble the following:
```
sw-version: 10.1.0 
app-version: 8270-6076 
app-release-date: 2020/05/08 18:21:51 
```

Panorama, Log Collector, Firewall, and WildFire Version Compatibility

Upgrade Log Collectors When Panorama Is Not Internet-Connected