I am sponsoring this case for Kenichiro Kagoshima. Timeout is set for
06/04/08.
The functional spec is in the case directory.
Release binding is Minor.
Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
SAM-QFS Support for Solaris Zones
1.2. Name of Document Author/Supplier:
Author: Kenichiro Kagoshima
1.3 Date of This Document:
28 May, 2008
4. Technical Description
Proposal:
Modify SAM-QFS packaging to be zone-aware; provide mechanism and
documentation to configure zones to use SAM-QFS filesystems and tools;
and provide a mechanism to boot relevant zones after the required
Shared-QFS filesystems are available for lofs mounts within those
zones.
Packaging:
All SAM-QFS packages will be updated with the following attributes and
settings, to allow installs into the global zone and to prevent the
install from propagating into non-global zones and prevent the package
from being visible in any non-global zones [1]:
SUNW_PKG_ALLZONES=false
SUNW_PKG_HOLLOW=false
SUNW_PKG_THISZONE=true
This does not, however, prevent the packages from being installed
directly into a non-global zone. To address this the packaging will
fail to install unless the zonename is 'global'.
Booting zones that use Shared-QFS filesystems:
When Shared-QFS filesystems are intended to be accessible from
multiple non-global zones those filesystems must be mounted in the
global zone and then non-global zones must use loopback mounts to
access those filesystems.
Problem:
Any zones marked as autoboot=true can be booted before the Shared-QFS
filesystems are mounted in the global zone, and loopback mounts of
those filesystems executed by the zone boot process will get the
covered mountpoint.
Solution:
To address this issue, the zones will be booted only after the
Shared-QFS filesystems have been mounted in the global zone. The
existing sam-fsd daemon will be modified to monitor the filesystems
and will boot the zones when their required filesystems become
available.
Zones being booted by sam-fsd must be marked as autoboot=false,
and they must be listed in /etc/opt/SUNWsamfs/samzone.conf with the
names of the filesystems on which they depend. The sam-fsd
daemon will start any zone as soon as the Shared-QFS filesystems
requested by that zone become available.
Configuring zones for Shared-QFS:
The new samzone.conf file will be used to indicate which Shared-QFS
filesystems are being used in zones, and will map filesystems to
specific zones.
The new samzoneops tool will configure zones to use SAM-QFS. This
tool uses libxml2 to parse the zone config files in /etc/zones. This
tool will run zonecfg(1m) to configure the zone to loopback mount the
SAM-QFS /devices/pseudo/samioc at 0:syscall device required by some
SAM-QFS commands. It will also configure the zone to loopback mount
/opt/SUNWsamfs/zone from the global zone as /opt/SUNWsamfs in the
non-global zone. It will configure the zone to loopback mount any
filesystems from samzone.conf that are specified for that zone.
The new /opt/SUNWsamfs/zone directory hierarchy will contain all
SAM-QFS commands, libraries, and manpages that are relevant in the
non-global zones.
Deliverables:
/etc/opt/SUNWsamfs/samzone.conf
/opt/SUNWsamfs/sbin/samzoneops
/opt/SUNWsamfs/zone
/opt/SUNWsamfs/zone/bin
/opt/SUNWsamfs/zone/lib
/opt/SUNWsamfs/zone/man
/opt/SUNWsamfs/zone/sbin
/opt/SUNWsamfs/man/man4/samzone.conf.4
/opt/SUNWsamfs/man/man1m/samzoneops.1m
Exported Interfaces:
samzoneops Committed Private Commandline syntax
samzone.conf Committed Private Configuration syntax
sam-fsd Committed Private Commandline syntax
/etc/opt/SUNWsamfs/samzone.conf Committed Configuration location
/opt/SUNWsamfs/sbin/samzoneops Committed Executable location
/opt/SUNWsamfs/zone Committed Private Directory
/opt/SUNWsamfs/zone/bin Committed Private Directory
/opt/SUNWsamfs/zone/lib Committed Private Directory
/opt/SUNWsamfs/zone/man Committed Private Directory
/opt/SUNWsamfs/zone/sbin Committed Private Directory
Imported Interfaces:
SUNWlxml Library (libxml2.so.2)
References:
[1] http://jurassic.sfbay/shared/sac/PSARC/2004/789/attr-matrix.txt
6. Resources and Schedule
6.4. Steering Committee requested information
6.4.1. Consolidation C-team Name:
N/A
6.5. ARC review type: FastTrack
6.6. ARC Exposure: open
