Discovery > Discovery Modules > Cloud and Virtualization > Virtualization > Solaris Zones Discovery > Solaris Zones by TTY Job

Solaris Zones by TTY Job

This section includes details about the job.

Trigger Query

Adapter

The Solaris Zones by TTY Job uses the SolarisZone_Disc_By_TTY adapter.

  • Input Query

    • The Input query contains one Shell CI only:

  • IP Process

  • UNIX Process

Parameters

Parameter Description
reportBasicTopology

Determines whether to report the basic topology (true) or full topology(false).

Default: false
reportNonGlobalZoneWarning

Determines whether to report the warning if the destination is not a global zone.

Default: true
zloginWithConnectedUser

If true, zlogin is executed with a connection to the global user account. If false, zlogin uses the root account.

Default: false.

Created/Changed Entities

  • Additional CI Types:

    • Solaris Zones Config

    • Solaris Resource Pool

  • Additional valid links:

    • Solaris Resource Pool > Containment > CPU

    • Unix > Usage > Solaris Resource Pool

    • Unix > Composition > Solaris Resource Pool

  • Modified views:

    • Solaris Zones view

  • Modified scripts:

    • SolarisZone_Disc_By_TTY.py

  • Additional enrichments:

    • Solaris Zones Networking

Used Scripts

  • vendors.py
  • networking.py
  • solaris_networking.py
  • SolarisZone_Disc_By_TTY.py

Discovered CITs

  • Composition

  • Containment

  • Cpu
  • ExecutionEnvironment

  • Fibre Channel HBA

  • FileSystem

  • FileSystemExport

  • Hypervisor

  • IPMP Group

  • Interface

  • IpAddress

  • IpSubnet

  • Membership

  • Node

  • Parent

  • Realization

  • Solaris Resource Pool

  • Solaris Zone Config

  • Usage

Note To view the topology, see Topology.

Discovery Mechanism

This section includes the following commands:

ClosedVerify the Connected OS is Zone-compliant
Command

uname -r
Example of output

5.10

Values taken

5.10
Comments

This command retrieves the Solaris OS version. If it is 5.10 it is assumed that the version supports zones and discovery continues. If it is not equal to 5.10 (for example, 5.9) it is assumed the host is not zone-compliant and discovery ends with the message Server does not support zones.
ClosedObtain List of Zones, Verify the Connected Host is Global Zone
Command

/usr/sbin/zoneadm list -cp
Example of output 1

0:global:running:/::native:shared

27:zone1:running:/var/opt/zones/zone1
:11559a59-3c6f-6a6e-a723-cc8159351247:
native:excl

-:zone2:configured:/var/opt/zones/
zone2::native:shared

Example of output 2 (no root permissions)

0:global:running:/

1:am-virtual6:running:/export/home/
zones/am-virtual6

5:am-virtual5:running:/export/home/
zones/am-virtual5

7:am-virtual3:running:/virtual/3

9:am-virtual1:running:/am-virtual/1

Values taken

Name of the zone: zone1

Status of the zone: running

Zone path: /var/opt/zones/zone1
Comments

This command gives the list of zones and their configuration including names, status, and path. The following is verified:

  • That global is present in the output. If it is missing, the zone that discovery connected to is not global.

  • There is at least one more non-global zone apart from the global zone.

If this is not true, discovery ends with the message Server does not have zones defined.

ClosedObtain Configuration for Each of the Non-global Zones
Command

/usr/sbin/zonecfg -z <zonename> info
Example of output 1 
zonename: zone1
zonepath: /var/opt/zones/zone1
brand: native
autoboot: true
bootargs: -m verbose
pool:
limitpriv: default,sys_time
scheduling-class:
ip-type: exclusive
fs:
dir: /mnt/globalzone
special: /var/opt/zone1-data
raw not specified
type: lofs
options: []
net:
address not specified
physical: bge2
defrouter not specified
device
match: /dev/bge2
dedicated-cpu:
ncpus: 1
importance: 1
capped-cpu:
[ncpus: 1.00]
capped-memory: 
physical: 16G 
[swap: 8G] 
[locked: 12G]
Example of output 2 
zonename: zone2
zonepath: /var/opt/zones/zone2
brand: native
autoboot: true
bootargs: -m verbose
pool:
limitpriv: default
scheduling-class: FSS
ip-type: shared
fs:
dir: /mnt
special: /var/opt/zone2-data
raw not specified
type: lofs
options: []
net:
address: 134.44.0.100
physical: bge0
defrouter not specified
device
match: /dev/pts*
rctl:
name: zone.cpu-shares
value: (priv=privileged,limit=5,action=none)
Values taken

The following information is obtained from the output:

  • brand (if it is not specified it is assumes to be native)

  • autoboot

  • resource pool name

  • limit privileges

  • scheduling class

  • ip type

  • all mounted file systems

  • networking information (IP and/or network interface)

  • dedicated CPUs and their importance

  • memory caps

  • cpu caps

  • cpu shares
Comments

This command is run for each non-global zone found. Most of these properties are stored in the Solaris Zone Config CI. File systems are reported as a File System Export from global zone to non-global. The resource pool name is used to create a link to a corresponding resource pool CI.
ClosedObtain MAC Addresses for Interfaces of Global Zone
Command

/usr/bin/netstat -np
Example of output

Net to Media Table: IPv4

Device IP Address Mask Flags Phys Addr

------ -------------------- --------------- -------- ---------------

bge0 134.44.0.101 255.255.255.255 o 00:15:f2:05:9e:ff

bge0 134.44.1.150 255.255.255.255 o 00:15:f2:9b:2d:96

bge0 134.44.0.100 255.255.255.255 SPLA 00:14:4f:82:74:a4

bge0 134.44.98.135 255.255.255.255 o 00:1c:c0:2b:57:35

bge0 224.0.0.0 240.0.0.0 SM 01:00:5e:00:00:00

Values taken

MAC addresses of corresponding interfaces.

Comments

This command retrieves the list of all interfaces except for the dedicated interface used in exclusive zones.

Interfaces in the global zone are shared with shared zones, so this command runs only once.

MAC addresses and information in the zonecfg output enables the creation of shared non-global zone Host CIs.
ClosedObtain IP Information for Global Zone
Command

/usr/sbin/ifconfig -a
Example of output 
lo0: flags=2001000849<UP,LOOPBACK,
RUNNING,MULTICAST,IPv4,VIRTUAL> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000 
lo0:1: flags=2001000849<UP,LOOPBACK,RUNNING,
MULTICAST,IPv4,VIRTUAL> mtu 8232 index 1
zone zone2
inet 127.0.0.1 netmask ff000000 
e1000g1: flags=1000843<UP,BROADCAST,RUNNING,
MULTICAST,IPv4> mtu 1500 index 2
inet 134.44.0.50 netmask ffffff00
 broadcast 134.44.0.255
e1000g1:1: flags=1000843<UP,BROADCAST,RUNNING,
MULTICAST,IPv4> mtu 1500 index 2
zone zone2
inet 134.44.0.100 netmask ffffff00
 broadcast 134.44.0.255
Values taken

The MAC addresses of corresponding interfaces.

Comments

This command retrieves the IP configuration for the global zone that is shared with corresponding shared non-global zones.

This information is used to report IP addresses and link them to corresponding network interfaces.
ClosedObtain IP Information of Exclusive Zones
Command

/usr/sbin/zlogin -l <username> <zonename> /usr/sbin/ifconfig -a
Example of output 
lo0: flags=2001000849<UP,LOOPBACK,RUNNING,
MULTICAST,IPv4,VIRTUAL> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
bge2: flags=201004843<UP,BROADCAST,RUNNING,
MULTICAST,DHCP,IPv4,CoS> mtu 1500 index 2
inet 134.44.0.200 netmask fffffc00
broadcast 134.44.0.255
ether 0:14:4f:82:74:a6
Values taken

All IPs that are present except loopback.
Comments

This command retrieves the IP information for exclusive non-global zones. The -l <user> switch is added to simplify setting up the sudo pattern for zlogin, but it can be removed from the job parameters.

Note: Discovery runs zlogin for zones in a running state only.
ClosedObtain MAC Addresses for Dedicated Interfaces of Exclusive Zones
Command

/usr/sbin/zlogin -l <username> <zonename> /usr/bin/netstat -np

Example of output

Net to Media Table: IPv4

Device IP Address Mask Flags Phys Addr

------ -------------------- --------------- -------- ---------------

bge2 134.44.0.200 255.255.255.255 SPLA 00:14:4f:82:74:a6

bge2 224.0.0.0 240.0.0.0 SM 01:00:5e:00:00:00

Values taken

MAC addresses.
Comments

MAC addresses of the interfaces are obtained together with interface names.

Note Discovery runs zlogin for zones in a running state only.
ClosedObtain CPU Information in Global Zone
Command

/usr/sbin/psrinfo -v
Example of output

Status of virtual processor 0 as of: 05/03/2010 16:00:15

on-line since 04/26/2010 19:45:40.

The sparcv9 processor operates at 1200 MHz,

and has a sparcv9 floating point processor.

Status of virtual processor 1 as of: 05/03/2010 16:00:15

on-line since 04/26/2010 19:45:42.

The sparcv9 processor operates at 1200 MHz,

and has a sparcv9 floating point processor.

Values taken

Number of virtual CPUs with IDs

Virtual processor names (sparcv9)

Processors speeds (1200)
Comments

For each instance of the virtual processor, discovery creates a CPU with a name (sparcv9) and speed (1200). They are linked to the global zone. They are also linked to the corresponding resource pool.
ClosedObtain Resource Pools
Command

/usr/sbin/pooladm
Example of output

system default

string system.comment

int system.version 1

boolean system.bind-default true

string system.poold.objectives wt-load

pool SUNWtmp_zone1

int pool.sys_id 1

boolean pool.active true

boolean pool.default false

int pool.importance 1

string pool.comment

boolean pool.temporary true

pset SUNWtmp_zone1

pool pool_default

int pool.sys_id 0

boolean pool.active true

boolean pool.default true

int pool.importance 1

string pool.scheduler FSS

string pool.comment

pset pset_default

Example of output(cont'd)

pset SUNWtmp_zone1

int pset.sys_id 1

boolean pset.default false

uint pset.min 1

uint pset.max 1

string pset.units population

uint pset.load 0

uint pset.size 1

string pset.comment

boolean pset.temporary true

cpu

int cpu.sys_id 0

string cpu.comment

string cpu.status on-line

Values taken

  • Pools:

    • Name

    • Is default

    • Is active

    • Importance

    • Scheduler

  • Pset:

    • Name

    • Min CPUs

    • Max CPUs

    • Objectives

Relations from Pool to Pset and from Pset to assigned CPUs by IDs
Comments

This information enables reporting pools and links them to corresponding CPUs of the global zone by IDs. Currently discovery reports pool and its pset as one entity.

If the resource pools facility is not used or not active discovery cannot read the configuration, but still reports the default (dummy) pool without attributes; all CPUs are linked there.

If the non-global zone includes the name of the pool in the configuration discovery links the zone to this pool.

If the non-global zone has a dedicated-cpu property set, discovery calculates the name of the temporary dynamic pool for linkage. The name takes the following format: SUNWtmp_<zonename>.
ClosedObtain Fibre Channel Adapters
Command

/usr/sbin/fcinfo hba-port
Example of output 
HBA Port WWN: 2100001c3491b18a
OS Device Name: /dev/cfg/c1
Manufacturer: QLogic Corp.
Model: 555-1156-02
Firmware Version: 05.01.00
FCode/BIOS Version: BIOS: 2.2; 
  fcode: 2.1; EFI: 2.0;
Serial Number: 0708R00-4259732555
Driver Name: qlc
Driver Version: 20090610-3.21
Type: N-port
State: online
Supported Speeds: 1Gb 2Gb 4Gb
Current Speed: 2Gb
Node WWN: 2000001c3491b18a
HBA Port WWN: 2101001c34b1b18a
OS Device Name: /dev/cfg/c2
Manufacturer: QLogic Corp.
Model: 555-1156-02
Firmware Version: 05.01.00
FCode/BIOS Version: BIOS: 2.2; 
  fcode: 2.1; EFI: 2.0;
Serial Number: 0708R00-4259732555
Driver Name: qlc
Driver Version: 20090610-3.21
Type: N-port
State: online
Supported Speeds: 1Gb 2Gb 4Gb
Current Speed: 2Gb
Node WWN: 2001001c34b1b18a
Values taken

  • Port WWN

  • Os Device Name

  • Manufacturer

  • Model

  • Type

  • Serial

  • Driver version
Comments

This information enables discovery to report the Fibre Channel HBA. The OS Device Name is held by the name attribute. The Port WWN is held by the HBA WWN attribute.