Troubleshooting the ArcaOS Update Procedure

Wikis > ArcaOS > Updating from a prior release > Troubleshooting the ArcaOS Update Procedure

An update may fail to complete for a variety of reasons. Note that there is a difference between an update which has abended (abnormal end), one which appears to be in a hung (stalled, or zombie) state, and one which continuously reboots to the same phase (looping). Different recovery methods are required for these different failures.

Hung update

The most common update failure is a hung update. In this case, during one of the four phases, the progress meter will stop moving, the text above it, which normally indicates the current operation, will remain on the last step in process at the time of the stall, and the system will appear to be waiting. Generally, the keyboard is responsive (NumLock and CapsLock will toggle, and the system can indeed be rebooted using C-A-D).

Luckily, this is the generally easiest recovery, though some care should be taken to preserve the log files before retrying the update. To do this, allow the system to reboot at the end of the looping phase, and instead of rebooting from the hard drive, boot from the installation medium again. Follow the procedures outlined on this wiki page under the section entitled Producing an ArcaOS install log (hung install) to run MkSupZip. If the system would not warm reboot (C-A-D), it may be necessary to run a disk check on the affected volumes. This may be done from the System Management console before running MkSupZip.

You may or may not need to actually open a support ticket for a hung update. Once the logs have been gathered by the MkSupZip script, restart the ArcaOS installer from the System Management menu and proceed to the Installation Types page. Select the option to Update again, and on the next page select the same update candidate. Allow the process to restart. It may or may not run to completion. If not, see the section below entitled Recovering to a bootable state.

Looping update

An update which is unable to fully complete a phase and which continues to boot back into that phase is considered to be stuck in a loop. There is the self-imposed loop, of course, where the user does not allow the update to boot from the hard drive for phase 2, and thus continuously requests an update of the system (this is not a looping update). Instead, a looping update is one where the phase (2, 3, or 4) boots from the target system volume, proceeds with at least some of its work, the system reboots, and apparently begins the same phase again.

Essentially, this is a hung update (see above) without the hang. The resolution is similar to that described above for a hung update, but will usually require a trouble ticket to resolve, and possibly a restore from backup to return the system to a usable state until the update may be completed. In most cases, a minor configuration change will be needed for the system before attempting the update procedure, and the edit “undone” at the conclusion of the update.

Reboot the system (using C-A-D, if at all possible). Follow the procedures outlined on this wiki page under the section entitled Producing an ArcaOS install log (hung install) to run MkSupZip. If the system would not warm reboot (C-A-D), it may be necessary to run a disk check on the affected volumes. This may be done from the System Management console before running MkSupZip. Be sure to attach the log file zip to your ticket as described on the wiki page.

Abended update

There are conditions which may trigger an abend during the update. In this case, an error message will be presented and the update procedure will stop. An abend log set (install_abend.zip) will be created in \sys\install.

Recovery from this condition may or may not require a complete reinstall, depending upon when the abend occurred, what files had been updated, and the resulting state of the target (candidate) system. In most cases, a support ticket will be required. Be sure to attach the install_abend.zip to your ticket. It is generally not recommended to restart the update procedure following an abend until the cause of the abend can be determined.

Recovering to a bootable state

As previously mentioned, during the update procedure, the existing CONFIG.SYS and STARTUP.CMD (if present) is/are renamed and special files created for the purpose of performing each phase of the update. In the event of a failure, the “normal” CONFIG.SYS and STARTUP.CMD must be renamed in order to restore a proper boot configuration. This may be done in several ways.

If the desktop archiving feature has been enabled, this method has the added benefit of restoring the desktop to a usable state, in case the failure occurred during a desktop operation.

If that is not available (or outdated), booting from the installation medium again and accessing System Management is a good alternative. Start by performing a disk check on all potentially affected volumes (the ArcaOS installation medium does not autocheck any volumes during boot).

From the menu, select Disk | Check Disk. The Check Volume(s) dialog will display which volumes are in need of consistency checking.

System Management Disk menu

Check Volume(s) dialog

Select a volume from the dropdown as listed in the lower panel. Allow the disk checker to write corrections to the disk, and let the process run to completion. When the button is available in the results dialog, click Cancel, and then Cancel again to return to the Check Volume(s) dialog to repeat the process for any remaining volumes.

Allow the utility to check each volume in order. When finished, exit the utility and from the menu, open an OS/2 or 4OS/2 window and change to the boot volume on the (failed) target. Copy \sys\install\rsp\CONFIG-UPD-yyyymmdd-nnn.SYS to \CONFIG.SYS and if present, \STARTUP.UPD to \STARTUP.CMD.

Either of these methods (desktop archive recovery or disk check and manual copy) should get the system to a bootable state if the failure was non-critical. In the case of a hung install, it is advisable to retry the update procedure as soon as possible. In the case of an abended update, the cause of the abend should be investigated and corrected before retrying the update.

When recovering to a bootable state from a failed update, the system should not be considered to be finished or in any way stable. Arca Noae does not provide support for subsequent failures (unrelated to updating) for systems left in such an inconsistent state.