Several months back I created a DSC Resource for configuring iSCSI Server Targets (including Virtual Disks) as well as iSCSI Initiators using Desired State Configuration (DSC). I created this for several reasons:
- I needed a way for LabBuilder to automatically build Scale-Out File Servers (with CSVs).
- I needed something to use as an example in my Creating Professional DSC Resources series.
- No one else had already created one.
This weekend I decided to add iSNS Server support to the resource – for both the ciSCSIServerTarget and ciSCSIInitiator resources. So with that feature added I thought it might be a good opportunity for me to write a quick blog post on how to use these DSC Resources.
Installing the Resource
You can find the new ciSCSI resource in the PowerShell Gallery.
For those of you using Windows Management Framework 5.0 (or have the PowerShellGet module installed) you can just use the command:
Install-Module -Name ciSCSI
If you don’t have Windows Management Framework 5.0 (and don’t have the PowerShellGet module installed) you will need to download and install the resource from the GitHub Repository.
Using the Resource
If you’d rather just jump right into the resource documentation and examples you can find it here. Otherwise, read on and I’ll cover this resource to configure both an iSCSI Server Target and an iSCSI Initiator. I’ll also show how to register iSCSI Server Targets and Initiators with an iSNS Server.
Important: Although the ciSCSI DSC Resource will work on Windows Management Framework 4.0, these examples require the use of the WaitForAny DSC Resource, which is only available in Windows Management Framework 5.0. This resource is used to ensure that the iSCSI Server Target has been created before trying to connect any iSCSI Initiators to it. The resource could be omitted, but errors will reported by the LCM on the iSCSI Initiator computers if the iSCSI Server Target is not available before the iSCSI Initiator DSC MOF is applied.
The Example Environment
In this example, the DSC Configurations that are being created will refer to the following servers:
- FS1.CONTOSO.COM – this is the file server that will contain the iSCSI Virtual Disks and iSCSI Server Target.
- CLUS1.CONTOSO.COM,CLUS2.CONTOSO.COM,CLUS3.CONTOSO.COM – these are the Windows Server 2012 R2 (or Windows Server 2016) Cluster Server nodes that will be connecting to the iSCSI Server Target.
- ISNS1.CONTOSO.COM – this is a server with the iSNS Server Windows Feature installed on it. The iSNS default domain has been configured on this server already.
The DSC configurations that will be created will create four 128GB dynamic iSCSI Virtual Disks on the D:\ drive of FS1.CONTOSO.COM. An iSCSI Server Target called FS1-Server-Target will be created and the four iSCSI Virtual Disks attached to it.
Configuring the iSCSI Server Target
A DSC configuration that creates an iSCSI Server Target requires the following steps to be performed in the DSC Resource:
- Install the iSCSI Target Server Windows Feature (FS-iSCSITarget-Server).
- Initialize and physical disks that will be used to store the iSCSI Virtual Disks (optional).
- Create the iSCSI Virtual Disks that will be used by the iSCSI Server Target.
- Create the iSCSI Server Target and optionally register it with an iSNS Server.
Here is the DSC Configuration:
Important: Note that the TargetName is set to ‘FS1-Server-Target‘, which will automatically configure the Target IQN to ‘iqn.1991-05.com.microsoft:FS1-FS1-Server-Target-Target’. This is because the Microsoft iSCSI Server Target cmdlets automatically name the Server Target for you using the following format:
This is very important to remember because the iSCSI Initiators use this string to identify the Server Target to connect to.
The rest of the components of this DSC Configuration are self-explanatory as long as you keep in mind the example environment that is being configured.
Configuring the iSCSI Initiator
A DSC configuration for each of the iSCSI Initiators that will connect to the iSCSI Server Target requires the following steps to be performed in the DSC Resource:
- Start the Microsoft iSCSI Initiator Service service (MSiSCSI).
- Use the WaitForAny WMF 5.0 DSC Resource to wait for the iSCSI Server Target to be created (optional).
- Connect the iSCSI Initiator to the iSCSI Server Target and optionally register it with an iSNS Server.
Here is the DSC Configuration for CLUS1.CONTOSO.COM (the configuration for the other nodes would be similar except with different InitiatorPortalAddress values):
Important: We need to make sure the NodeAddress is set to the the Target IQN from the iSCSI Server Target – in this case ‘iqn.1991-05.com.microsoft:FS1-FS1-Server-Target-Target’.
It is also recommended that you use IP Addresses for the TargetPortalAddress and InitiatorPortalAddress parameters rather than server names, as this will force the iSCSI traffic to use the appropriate network adapter.
The components of this DSC Configuration are self-explanatory as long as you keep in mind the example environment that is being configured.
iSNS Server Configuration
There are a few things to keep in mind when you have your iSCSI DSC Configurations registering with an iSNS Server:
- The Default Domain on the iSNS Server should have been created.
- If the iSNS Server is not available or contactable by the iSCSI Server Target or Initiator when the DSC Configuration is applied the DSC configuration will not throw an error, but the iSNS Server Address will not be set. However, next time the DSC configuration is applied by the LCM it will try again (and again the next time etc).
Using iSNS Server is completely optional and is mostly used in larger environments with more than twenty iSCSI Server Targets and where the Initiators will be connected to the iSCSI Server Targets manually or where DSC can’t be used on the iSCSI Server Targets.
That is all there is to using this resource to configure a Windows Server 2012 iSCSI SAN using DSC.
Note: I have submitted this DSC Resource to be included in the Microsoft Community DSC Resources project. If it is accepted then the name of the DSC Resource will change from ciSCSI to iSCSI. The resource hasn’t yet been reviewed and I’m not aware of an ETA for it. The old ‘c’ and ‘x’ nomenclature used by DSC Resources is being phased out.
If you need some additional guidance or other specific examples, please feel free to drop a comment on this blog post (or the GitHub repository) and I’ll do my best to help you out.