Maintaining the Integrity of the Boot Archives

The boot administration interface, bootadm, enables you to perform the follow tasks for maintaining the boot archives:

• List the files and directories that are included in a system's boot archive.

• Manually update the current boot archives on a system.

The syntax of the command is as follows:

bootadm [subcommand] [-option] [-R altroot]

For more information about the bootadm command, see the bootadm(1M) man page.

How to Clear a Failed Automatic Boot Archive Update by Manually Updating the Boot Archive

During the process of booting the system, if a warning message that is similar to the following is displayed, take action accordingly:

WARNING: Automatic update of the boot archive failed.
Update the archives using 'bootadm update-archive'
command and then reboot the system from the same device that
was previously booted.

The following procedure describes how to manually update an out-of-date boot archive by using the bootadm command.

1. Become the root role.
2. To update the boot archive, type the following command:

   # bootadm update-archive

   ---

   Note - To update the boot archive on an alternate root file system, type the following command:

   # bootadm update-archive -R /a

   -R altroot

   Specifies an alternate root path to apply to the update-archive subcommand.

   ---

   Caution - The root file system of any non-global zone must not be referenced with the -R option. Doing so might damage the global zone's file system, compromise the security of the global zone, or damage the non-global zone's file system. See the zones(5) man page.

   ---

   ---

3. Reboot the system.

   # reboot