Troubleshooting Upgrades

Configuration guides, troubleshooting and practical advice for AZTCOFW.

Articles

11 results

CLI Troubleshooting

If the GUI update is not functioning as expected, there are a handful of shell commands that can help gather information or resolve problems. Force pkg Metadata Update Often times DNS or connectivity problems will preven

Cosmetic Problems Post-Upgrade

If cosmetic problems occur after performing an upgrade, this is nearly always due to stale browser cache entries for CSS, JavaScript, or other files where the browser does not pull the updated version. Force a refresh of

Forced pkg Reinstall

Forcing a reinstallation of all packages may resolve problems that otherwise may require a full reinstall. This is not ideal, as a clean install is more likely to have a positive result, but that is not always an option

IPv6 Connectivity Problems

If IPv6 is configured on the firewall, the AZTCO-FW software will prefer to use it when performing an update. There are cases when a firewall may have broken IPv6 connectivity, however, that contribute to problems updati

Last Resort

If nothing else works then a reinstall will eliminate any possibility of problems related to the upgrade itself. AZTCO-FW software supports multiple options to easily restore the configuration. The fastest method is Reco

pkg.AZTCO-FW.org Has no A/AAAA Record

pkg does not use A/AAAA records. It uses service (SRV) records. The update server meta names such as pkg. AZTCO-FW.org are not meant to be accessed directly using a browser. To find the actual update servers, lookup the

Repository Metadata Version Errors

If pkg is unable to update and complains about the repository metadata version, the pkg utility may need to be updated manually to version 1.13.x or later. Example metadata version error: > >> Updating repositories metad

Rewrite Repository Information

In some cases the repository information may need to be rewritten: Navigate to System > UpdatesSet the Branch to Latest Development Snapshots Wait for the page to refreshSet the Branch to Latest stable version If the upd

Segmentation Fault in pkg

Certain cryptographic hardware can have a software-induced race condition which leads to a problematic state. In this state, pkg will crash with a segmentation fault: 1085486128:error:14099044:SSL routines:ssl3_send_clie

Upgrade Log

AZTCO-FW -upgrade keeps a log of the last update attempt, which may contain additional useful information. This log is located at /conf/upgrade_log.latest.txt. Please include the contents of this log with any post or sup

Upgrade not Offered / Library Errors

If the update system does not offer an upgrade to the most recent version, the upgrade will not proceed, or the upgrade process encounters errors with shared libraries, take the following steps: Navigate to System > Upda