def restore_install_uninstall(self):
"""Restore a failed install or uninstall attempt.
Clone the snapshot, mount the BE and
notify user of its existence. Rollback
if not operating on a live BE"""
if self.is_live_BE:
# Create a new BE based on the previously taken
# snapshot.
ret, self.be_name_clone, not_used = \
be.beCopy(None, self.be_name, self.snapshot_name)
if ret != 0:
# If the above beCopy() failed we will try it
# without expecting the BE clone name to be
# returned by libbe. We do this in case an old
# version of libbe is on a system with
# a new version of pkg.
self.be_name_clone = self.be_name + "_" + \
self.snapshot_name
ret, not_used, not_used2 = \
be.beCopy(self.be_name_clone, \
self.be_name, self.snapshot_name)
if ret != 0:
logger.error(_("pkg: unable to create "
"BE %s") % self.be_name_clone)
return
if be.beMount(self.be_name_clone, self.clone_dir) != 0:
logger.error(_("pkg: unable to mount BE "
"%(name)s on %(clone_dir)s") % {
"name": self.be_name_clone,
"clone_dir": self.clone_dir })
return
logger.error(_("The Boot Environment %(name)s failed "
"to be updated. A snapshot was taken before the "
"failed attempt and is mounted here %(clone_dir)s. "
"Use 'beadm unmount %(clone_name)s' and then "
"'beadm activate %(clone_name)s' if you wish to "
"boot to this BE.") % { "name": self.be_name,
"clone_dir": self.clone_dir,
"clone_name": self.be_name_clone })
else:
if be.beRollback(self.be_name, self.snapshot_name) != 0:
logger.error("pkg: unable to rollback BE "
"%s" % self.be_name)
self.destroy_snapshot()
logger.error(_("The Boot Environment %s failed to be "
"updated. A snapshot was taken before the failed "
"attempt and has been restored so no changes have "
"been made to %s.") % (self.be_name, self.be_name))
def createBEFromSnapshot(be):
"""Create a BE based off a snapshot."""
be_name, snap_name = be.src_be_name_or_snapshot.split("@")
rc = lb.beCopy(be.trgt_be_name_or_snapshot[0], be_name, snap_name, be.trgt_rpool, be.properties, be.description)[0]
if rc == 0:
msg.printMsg(msg.Msgs.BEADM_MSG_BE_CREATE_SUCCESS, be.trgt_be_name_or_snapshot[0], be.log_id)
return 0
be.msg_buf["0"] = be.trgt_be_name_or_snapshot[0]
if rc == msg.Msgs.BE_ERR_SS_NOENT:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_SNAP_DOES_NOT_EXISTS, be.src_be_name_or_snapshot)
elif rc == msg.Msgs.BE_ERR_BE_EXISTS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_BE_EXISTS, be.trgt_be_name_or_snapshot[0])
elif rc == msg.Msgs.BE_ERR_BE_NOENT:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_BE_DOES_NOT_EXIST, be_name)
elif rc == msg.Msgs.BE_ERR_PERM or rc == msg.Msgs.BE_ERR_ACCESS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_PERMISSIONS, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, -1)
return 1
else:
be.msg_buf["1"] = lb.beGetErrDesc(rc)
if be.msg_buf["1"] == None:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_NO_MSG, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, be.log_id)
return 1
def create_backup_be(self, be_name=None):
"""Create a backup BE if the BE being modified is the live one.
'be_name' is an optional string indicating the name to use
for the new backup BE."""
self.check_be_name(be_name)
if self.is_live_BE:
# Create a clone of the live BE, but do not mount or
# activate it. Do nothing with the returned snapshot
# name that is taken of the clone during beCopy.
ret, be_name_clone, not_used = be.beCopy()
if ret != 0:
raise api_errors.UnableToCopyBE()
if not be_name:
be_name = self.get_new_be_name(
suffix="-backup-1")
ret = be.beRename(be_name_clone, be_name)
if ret != 0:
raise api_errors.UnableToRenameBE(
be_name_clone, be_name)
elif be_name is not None:
raise api_errors.BENameGivenOnDeadBE(be_name)
def createBE(be):
"""Create a Boot Environment."""
rc = lb.beCopy(be.trgt_be_name_or_snapshot[0], be.src_be_name_or_snapshot,
None, be.trgt_rpool, be.properties, be.description)[0]
if rc == 0:
msg.printMsg(msg.Msgs.BEADM_MSG_BE_CREATE_SUCCESS,
be.trgt_be_name_or_snapshot[0], be.log_id)
return 0
be.msg_buf["0"] = be.trgt_be_name_or_snapshot[0]
if rc == msg.Msgs.BE_ERR_BE_NOENT:
be.msg_buf["1"] = \
msg.getMsg(msg.Msgs.BEADM_ERR_BE_DOES_NOT_EXIST,
be.src_be_name_or_snapshot)
elif rc == msg.Msgs.BE_ERR_BE_EXISTS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_BE_EXISTS,
be.trgt_be_name_or_snapshot[0])
elif rc == msg.Msgs.BE_ERR_PERM or rc == msg.Msgs.BE_ERR_ACCESS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_PERMISSIONS, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, -1)
return 1
else:
be.msg_buf["1"] = lb.beGetErrDesc(rc)
if be.msg_buf["1"] == None:
be.msg_buf["1"] = \
msg.getMsg(msg.Msgs.BEADM_ERR_NO_MSG, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, be.log_id)
return 1
def init_image_recovery(self, img, be_name=None):
"""Initialize for an update.
If a be_name is given, validate it.
If we're operating on a live BE then clone the
live BE and operate on the clone.
If we're operating on a non-live BE we use
the already created snapshot"""
self.img = img
if self.is_live_BE:
# Create a clone of the live BE and mount it.
self.destroy_snapshot()
self.check_be_name(be_name)
# Do nothing with the returned snapshot name
# that is taken of the clone during beCopy.
ret, self.be_name_clone, not_used = be.beCopy()
if ret != 0:
raise api_errors.UnableToCopyBE()
if be_name:
ret = be.beRename(self.be_name_clone, be_name)
if ret == 0:
self.be_name_clone = be_name
else:
raise api_errors.UnableToRenameBE(
self.be_name_clone, be_name)
if be.beMount(self.be_name_clone, self.clone_dir) != 0:
raise api_errors.UnableToMountBE(
self.be_name_clone, self.clone_dir)
# record the UUID of this cloned boot environment
not_used, self.be_name_clone_uuid = \
BootEnv.get_be_name(self.clone_dir)
# Set the image to our new mounted BE.
img.find_root(self.clone_dir, exact_match=True)
elif be_name is not None:
raise api_errors.BENameGivenOnDeadBE(be_name)
def createBEFromSnapshot(be):
"""Create a BE based off a snapshot."""
be_name, snap_name = be.src_be_name_or_snapshot.split("@")
rc = lb.beCopy(be.trgt_be_name_or_snapshot[0], be_name, snap_name,
be.trgt_rpool, be.properties, be.description)[0]
if rc == 0:
msg.printMsg(msg.Msgs.BEADM_MSG_BE_CREATE_SUCCESS,
be.trgt_be_name_or_snapshot[0], be.log_id)
return 0
be.msg_buf["0"] = be.trgt_be_name_or_snapshot[0]
if rc == msg.Msgs.BE_ERR_SS_NOENT:
be.msg_buf["1"] = \
msg.getMsg(msg.Msgs.BEADM_ERR_SNAP_DOES_NOT_EXISTS,
be.src_be_name_or_snapshot)
elif rc == msg.Msgs.BE_ERR_BE_EXISTS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_BE_EXISTS, \
be.trgt_be_name_or_snapshot[0])
elif rc == msg.Msgs.BE_ERR_BE_NOENT:
be.msg_buf["1"] = \
msg.getMsg(msg.Msgs.BEADM_ERR_BE_DOES_NOT_EXIST, \
be_name)
elif rc == msg.Msgs.BE_ERR_PERM or rc == msg.Msgs.BE_ERR_ACCESS:
be.msg_buf["1"] = msg.getMsg(msg.Msgs.BEADM_ERR_PERMISSIONS, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, -1)
return 1
else:
be.msg_buf["1"] = lb.beGetErrDesc(rc)
if be.msg_buf["1"] == None:
be.msg_buf["1"] = \
msg.getMsg(msg.Msgs.BEADM_ERR_NO_MSG, rc)
msg.printMsg(msg.Msgs.BEADM_ERR_CREATE, be.msg_buf, be.log_id)
return 1
def init_image_recovery(self, img, be_name=None):
"""Initialize for an image-update.
If a be_name is given, validate it.
If we're operating on a live BE then clone the
live BE and operate on the clone.
If we're operating on a non-live BE we use
the already created snapshot"""
self.img = img
if self.is_live_BE:
# Create a clone of the live BE and mount it.
self.destroy_snapshot()
self.check_be_name(be_name)
# Do nothing with the returned snapshot name
# that is taken of the clone during beCopy.
ret, self.be_name_clone, not_used = be.beCopy()
if ret != 0:
raise api_errors.UnableToCopyBE()
if be_name:
ret = be.beRename(self.be_name_clone, be_name)
if ret == 0:
self.be_name_clone = be_name
else:
raise api_errors.UnableToRenameBE(
self.be_name_clone, be_name)
if be.beMount(self.be_name_clone, self.clone_dir) != 0:
raise api_errors.UnableToMountBE(
self.be_name_clone, self.clone_dir)
# Set the image to our new mounted BE.
img.find_root(self.clone_dir)
elif be_name is not None:
raise api_errors.BENameGivenOnDeadBE(be_name)
def restore_install_uninstall(self):
"""Restore a failed install or uninstall attempt.
Clone the snapshot, mount the BE and
notify user of its existence. Rollback
if not operating on a live BE"""
# flush() is necessary here so that the warnings get printed
# on a new line.
if self.progress_tracker:
self.progress_tracker.flush()
if self.is_live_BE:
# Create a new BE based on the previously taken
# snapshot.
ret, self.be_name_clone, not_used = \
be.beCopy(None, self.be_name, self.snapshot_name)
if ret != 0:
# If the above beCopy() failed we will try it
# without expecting the BE clone name to be
# returned by libbe. We do this in case an old
# version of libbe is on a system with
# a new version of pkg.
self.be_name_clone = self.be_name + "_" + \
self.snapshot_name
ret, not_used, not_used2 = \
be.beCopy(self.be_name_clone, \
self.be_name, self.snapshot_name)
if ret != 0:
logger.error(
_("pkg: unable to create "
"BE {0}").format(self.be_name_clone))
return
if be.beMount(self.be_name_clone, self.clone_dir) != 0:
logger.error(
_("pkg: unable to mount BE "
"{name} on {clone_dir}").format(
name=self.be_name_clone, clone_dir=self.clone_dir))
return
logger.error(
_("The Boot Environment {name} failed "
"to be updated. A snapshot was taken before the "
"failed attempt and is mounted here {clone_dir}. "
"Use 'beadm unmount {clone_name}' and then "
"'beadm activate {clone_name}' if you wish to "
"boot to this BE.").format(name=self.be_name,
clone_dir=self.clone_dir,
clone_name=self.be_name_clone))
else:
if be.beRollback(self.be_name, self.snapshot_name) != 0:
logger.error("pkg: unable to rollback BE "
"{0}".format(self.be_name))
self.destroy_snapshot()
logger.error(
_("The Boot Environment {bename} failed "
"to be updated. A snapshot was taken before the "
"failed attempt and has been restored so no "
"changes have been made to {bename}.").format(
bename=self.be_name))
def copy_be(src_be_name, dst_be_name):
ret, be_name_clone, not_used = be.beCopy(dst_be_name, src_be_name)
if ret != 0:
raise api_errors.UnableToCopyBE()
def restore_install_uninstall(self):
"""Restore a failed install or uninstall attempt.
Clone the snapshot, mount the BE and
notify user of its existence. Rollback
if not operating on a live BE"""
if self.is_live_BE:
# Create a new BE based on the previously taken
# snapshot.
ret, self.be_name_clone, not_used = \
be.beCopy(None, self.be_name, self.snapshot_name)
if ret != 0:
# If the above beCopy() failed we will try it
# without expecting the BE clone name to be
# returned by libbe. We do this in case an old
# version of libbe is on a system with
# a new version of pkg.
self.be_name_clone = self.be_name + "_" + \
self.snapshot_name
ret, not_used, not_used2 = \
be.beCopy(self.be_name_clone, \
self.be_name, self.snapshot_name)
if ret != 0:
logger.error(
_("pkg: unable to create "
"BE %s") % self.be_name_clone)
return
if be.beMount(self.be_name_clone, self.clone_dir) != 0:
logger.error(
_("pkg: unable to mount BE "
"%(name)s on %(clone_dir)s") % {
"name": self.be_name_clone,
"clone_dir": self.clone_dir
})
return
logger.error(
_("The Boot Environment %(name)s failed "
"to be updated. A snapshot was taken before the "
"failed attempt and is mounted here %(clone_dir)s. "
"Use 'beadm unmount %(clone_name)s' and then "
"'beadm activate %(clone_name)s' if you wish to "
"boot to this BE.") % {
"name": self.be_name,
"clone_dir": self.clone_dir,
"clone_name": self.be_name_clone
})
else:
if be.beRollback(self.be_name, self.snapshot_name) != 0:
logger.error("pkg: unable to rollback BE " "%s" % self.be_name)
self.destroy_snapshot()
logger.error(
_("The Boot Environment %s failed to be "
"updated. A snapshot was taken before the failed "
"attempt and has been restored so no changes have "
"been made to %s.") % (self.be_name, self.be_name))
