dsccommunity / dsccommunity/SqlServerDsc

SqlSetup: FailoverCluster feature doesn't support network share as storage

Open
#1,638 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement help wanted
Dominant language
PowerShell
Stars
385
Forks
224
PR merge metrics
No merged PRs in 30d

Description

Details of the scenario you tried and the problem that is occurring
Currently the FCI setup only supports using shared volumes. However, SQL Server FCI can also use a network share instead of shared volumes. This scenario needs to be added to the module.

Verbose logs showing the problem
VERBOSE: [SQLFSX1]: LCM: [ End Set ] [[SqlSetup]InstallFCINode1] in 6.6640 seconds.
PowerShell DSC resource DSC_SqlSetup failed to execute Set-TargetResource functionality with error message: System.Exception: Unable to map the specified paths to valid cluster storage. Drives mapped: .
+ CategoryInfo : InvalidOperation: (:) [], CimException
+ FullyQualifiedErrorId : ProviderOperationExecutionFailure
+ PSComputerName : localhost

Suggested solution to the issue
Add the option to not use any shared volumes, and instead simply provide network share UNC for MSSQL directories.

The DSC configuration that is used to reproduce the issue (as detailed as possible)

insert configuration here

SQL Server edition and version the target node is running
MSSQL 2019, Developer Edition

SQL Server PowerShell modules present on the target node
None

The operating system the target node is running
OsName : Microsoft Windows Server 2019 Datacenter
OsOperatingSystemSKU : DatacenterServerEdition
OsArchitecture : 64-bit
WindowsVersion : 1809
WindowsBuildLabEx : 17763.1.amd64fre.rs5_release.180914-1434
OsLanguage : en-US
OsMuiLanguages : {en-US}

Version and build of PowerShell the target node is running
Name Value

PSVersion 5.1.17763.1490
PSEdition Desktop
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0...}
BuildVersion 10.0.17763.1490
CLRVersion 4.0.30319.42000
WSManStackVersion 3.0
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1

Version of the DSC module that was used
Name Version Path

SqlServerDsc 14.2.1 C:\Program Files\WindowsPowerShell\Modules\SqlServerDsc\14.2.1\SqlServerDsc.psd1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the SqlSetup FailoverCluster/FCI setup path described in the issue and trace where valid cluster storage is required. Reproduce the reported network-share scenario on the stated SQL Server 2019 and Windows Server 2019 environment, then verify that an FCI configuration using UNC paths without shared volumes completes successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
databases, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.