System Administration Guide: Oracle Solaris Containers-Resource Management and Oracle Solaris Zones

ProcedureHow to Migrate an lx Branded Zone

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Halt the zone to be migrated, lx-zone in this procedure.

    host1# zoneadm -z lx-zone halt
  3. Detach the zone.

    host1# zoneadm -z lx-zone detach

    The detached zone is now in the configured state.

  4. Move the zonepath for lx-zone to the new host.

    See How to Move the zonepath to a new Host for more information.

  5. On the new host, configure the zone.

    host2# zonecfg -z lx-zone

    You will see the following system message:

    lx-zone: No such zone configured
    Use 'create' to begin configuring a new zone.
  6. To create the zone lx-zone on the new host, use the zonecfg command with the -a option and the zonepath on the new host.

    zonecfg:lx-zone> create -a /export/zones/lx-zone
  7. View the configuration.

    zonecfg:lx-zone> info
    zonename: lx-zone
    zonepath: /export/zones/lx-zone
    brand: lx
    autoboot: false
             physical: bge0
  8. (Optional) Make any required adjustments to the configuration.

    For example, the network physical device might be different on the new host, or devices that are part of the configuration might have different names on the new host.

    zonecfg:lx-zone> select net physical=bge0
    zonecfg:lx-zone:net> set physical=e1000g0
    zonecfg:lx-zone:net> end
  9. Commit the configuration and exit.

    zonecfg:lx-zone> commit
    zonecfg:lx-zone> exit
  10. Attach the zone on the new host.

    • Attach the zone with a validation check.

      host2# zoneadm -z lx-zone attach

      The system administrator is notified of required actions to be taken if either or both of the following conditions are present:

      • Required packages and patches are not present on the new machine.

      • The software levels are different between machines.

    • Force the attach operation without performing the validation.

      host2# zoneadm -z lx-zone attach -F

      Caution – Caution –

      The -F option allows you to force the attach with no validation performed. This is useful in certain cases, such as in a clustered environment or for backup and restore operations, but it does require that the system be properly configured to host the zone. An incorrect configuration could result in undefined behavior later.