Allocate Fabric Aware Volumes with Configuration Manager: Service details

This server enables allocation of sets of volumes from the associated infrastructure group through Configuration Manager for use by servers running a generic application. This service accesses the FC switch management service and acquires existing fabric configuration and zoning information when allocating new volumes to the host.

The following service template details apply to the Allocate Fabric Aware Volumes with Configuration Manager service template.

Software and setup prerequisites

For software and setup prerequisites, see Service template prerequisites.

Edit Service settings

The following table lists the Edit Service settings for the Allocate Fabric Aware Volumes with Configuration Manager service template.

Navigation pane	Settings pane	Description
Volume Settings ¹	Configuration Manager Connection	Gives a table from which you can choose the Configuration Manager connection.
	Storage System	Gives a table from which you can choose the storage system.
	Resource Group	Specify a resource group.
	Pool	Gives a table from which you can choose the pool.
	Capacity Format	Specify the volume capacity format as Block or Byte.
	Volume Settings	Specify the parameters to create new volumes.
Resource Criteria ²	Resource Criteria	Specify the Storage Port Configuration Expressions (Name and Value) that meets the specified criteria (Equals, Not Equals, Starts with, and Ends with) based on the selected condition (All or Any).
Host Settings	Port Type	Specify Fibre as the port type.
Host Settings	Host Group Settings	Specify the parameters required to create a new Host Group or specify to use an existing Host Group.
Fabric Settings	Use Fabric Settings	Select this option to enable fabric information collection.
	Target Fabrics	Specify the fabric name. Separate multiple values by commas. If omitted, all fabrics defined as FOS_PrimarySwitch or DCNM in Connections will be used.
	Fabric Connection Type	Specify the fabric type, either FOS_PrimarySwitch or DCNM to filter the Category in Connections.
	Connections	Specify the connection defined in the Web Service Connections on the Administration tab. If this value is omitted, the system uses all connections that are defined for the product name listed in the Web Service Connections.
	Use Existing Zone	Specifies whether to select a predefined zone or any connectable path. If you select this option, the system selects paths within the range of the existing active Zone setting. If you don not select this option, the system selects connectable paths regardless of the existing Zone setting.
	Number of Hops Restriction	Determines whether restrict path selection to within an assigned number of hops. When this property enabled, the service will fail if there is no path that matched the specified collection range.
	Maximum Number of Hops	When using the Number of Hops Restriction option, specify the collection range by the number of hops.
Zone Settings	Update Zone Configurations	Determines whether to add to an existing zone or create a new zone. If Use Existing Zone is true, this setting is ignored even if entered.
	Use Existing Zone Aliases	Determines whether to use existing zone aliases. Specify True to use predefined zone aliases regardless of the specified naming conventions. If you specify False, the system selects zone aliases that follow the naming conventions. In either case, if there are no existing zone aliases, the system creates new ones that follow the naming conventions. When selecting the existing Zone Alias, Zone naming is fixed as `HostZoneAliasName_StorageZoneAliasName`. Note: If the service finds more than one alias candidate which have the same WWN, the alias is chosen based on the following priorities: Search existing aliases which only have that WWN. If more than one alias is found, the system selects the first alias in the list of existing aliases. If no alias is found using the first priority, search existing aliases which have multiple WWNs including that WWN. If more than one alias is found, the system selects the first alias in the list of existing aliases.
	Update Current Active Zone Configuration	Determines whether to use Zone Active configuration when adding or creating a zone.
	Zone Configurations to Update	Lists the zone configuration names to add (separated by commas). If Update Zone Configuration is false, this setting is ignored. Note: An error is generated if this setting is not specified and Update Current Active Zone Configuration is false.
	Script for Zone Naming	Specify the naming convention script that determines the Zone name for the path.
	Script for Host Zone Alias Naming	Specify the naming convention script that determines the Zone Alias name for the host port.
	Script for Storage Zone Alias Naming	Specify the naming convention script that determines the Zone Alias name for the storage port.
The property settings in v8.6.3 or earlier (Number of Volumes, LDEV ID Starts From, Volume Capacity, Volume Label, LUN Starts from, Virtual LDEV ID Starts From) are not carried forward. The property settings in v8.6.3 or earlier are not carried forward.

Submit Service Request settings

The following table lists the Submit Service Request settings for the Allocate Fabric Aware Volumes with Configuration Manager service template.

Navigation pane	Settings pane	Description
Volume Settings ¹	Configuration Manager Connection	Gives a table from which you can choose the Configuration Manager connection.
	Storage System	Gives a table from which you can choose the storage system.
	Resource Group	Specify a resource group.
	Pool	Gives a table from which you can choose the pool.
	Capacity Format	Specify the volume capacity format as Block or Byte.
	Volume Settings	Specify the parameters to create new volumes.
Resource Criteria ²	Resource Criteria	Specify the Storage Port Configuration Expressions (Name and Value) that meets the specified criteria (Equals, Not Equals, Starts with, and Ends with) based on the selected condition (All or Any).
Host Settings	Port Type	Specify Fibre as the port type.
Host Settings	Host Group Settings	Specify the parameters required to create a new Host Group or specify to use an existing Host Group.
Fabric Settings	Use Fabric Settings	Select this option to enable fabric information collection.
	Target Fabrics	Specify the fabric name. Separate multiple values by commas. If omitted, all fabrics defined as FOS_PrimarySwitch or DCNM in Connections will be used.
	Fabric Connection Type	Specify the fabric type, either FOS_PrimarySwitch or DCNM to filter the Category in Connections.
	Connections	Specify the connection defined in the Web Service Connections on the Administration tab. If this value is omitted, the system uses all connections that are defined for the product name listed in the Web Service Connections.
	Use Existing Zone	Specifies whether to select a predefined zone or any connectable path. If you select this option, the system selects paths within the range of the existing active Zone setting. If you don not select this option, the system selects connectable paths regardless of the existing Zone setting.
	Number of Hops Restriction	Determines whether restrict path selection to within an assigned number of hops. When this property enabled, the service will fail if there is no path that matched the specified collection range.
	Maximum Number of Hops	When using the Number of Hops Restriction option, specify the collection range by the number of hops.
Zone Settings	Update Zone Configurations	Determines whether to add to an existing zone or create a new zone. If Use Existing Zone is true, this setting is ignored even if entered.
	Use Existing Zone Aliases	Determines whether to use existing zone aliases. Specify True to use predefined zone aliases regardless of the specified naming conventions. If you specify False, the system selects zone aliases that follow the naming conventions. In either case, if there are no existing zone aliases, the system creates new ones that follow the naming conventions. When selecting the existing Zone Alias, Zone naming is fixed as `HostZoneAliasName_StorageZoneAliasName`. Note: If the service finds more than one alias candidate which have the same WWN, the alias is chosen based on the following priorities: Search existing aliases which only have that WWN. If more than one alias is found, the system selects the first alias in the list of existing aliases. If no alias is found using the first priority, search existing aliases which have multiple WWNs including that WWN. If more than one alias is found, the system selects the first alias in the list of existing aliases.
	Update Current Active Zone Configuration	Determines whether to use Zone Active configuration when adding or creating a zone.
	Zone Configurations to Update	Lists the zone configuration names to add (separated by commas). If Update Zone Configuration is false, this setting is ignored. Note: An error is generated if this setting is not specified and Update Current Active Zone Configuration is false.
	Script for Zone Naming	Specify the naming convention script that determines the Zone name for the path.
	Script for Host Zone Alias Naming	Specify the naming convention script that determines the Zone Alias name for the host port.
	Script for Storage Zone Alias Naming	Specify the naming convention script that determines the Zone Alias name for the storage port.
The property settings in v8.6.3 or earlier (Number of Volumes, LDEV ID Starts From, Volume Capacity, Volume Label, LUN Starts from, Virtual LDEV ID Starts From) are not carried forward. The property settings in v8.6.3 or earlier are not carried forward.

Zone naming conventions

The following table lists the zone naming conventions for use with the Allocate Fabric Aware Volumes with Configuration Manager service template.

Type	Zone name	Zone alias name (Host side/Storage side)
Input	One object has the following properties: hostName: Host name hostPortWorldWideName: WWN of HBA. Separator notation is based on FC switch manager services. storagePortWorldWideName: WWN of CHA. Separator notation is based on FC switch manager services. storageSystemSerialNumber: Serial number of physical storage system storagePortName: Display port name of the storage system serviceProperties: List of the service properties passed to the plug-in
Output	Zone name to add to the specified Zone Configuration.	Zone alias name to add to the zone specified in the Zone name convention.
Handling when the output is the same name	Same zone name of the same fabric refers to the same zone. In the case of an existing zone: Add an alias in the zone and add to the Zone Configuration. null: Do not create a zone.	Same zone alias name of the same fabric refers to the same alias. In the case of an existing alias: Add WWN in the alias and add to the Zone. null: Do not create an alias.
Handling when unavailable characters are used for output	Characters other than alphanumeric characters and "_" are converted to "_" and become part of the name.
If the output string is too long	When the output string is over 60 characters, the 61st and subsequent characters are truncated.	When the output string is over 64 characters or more, the 65th and subsequent characters are truncated.
Validation	An error occurs if the return value is one of following: Other than String When starting from non-alphabetic characters. When having a non-standard prefix for the zone. ("LSAN_","TI_", "QOS[HML][0-9]+_")(case ignored)	An error occurs if the return value is one of following: Other than String When starting from non-alphabetic characters.