dsccommunity / dsccommunity/SqlServerDsc

SqlRS: SQLPS is Required

Open
#929 4 comments 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:

I have a two server setup:

  • Server One running "SQLENGINE" and "SSMS" features
  • Server Two running only "RS" feature

xSQLServerRSConfig fails after successfully installing SQL RS feature on Server Two (installation done with xSqlServerSetup). The failure refers to missing SqlServer or SQLPS module(s). So, it appears that installing SQL with only the RS feature does not install either of those modules. When I added the SSMS feature to Server Two, the configuration was able to proceed (it looks like SSMS installs SQLPS).

So, I am suggesting that the documentation for SqlRS be updated to indicate the dependency. It doesn't currently list it as a requirement, while some other resources do.

Also, I would like to ask what is the best way to proceed for this scenario when using only DSC to setup this server with only the "RS" feature? In other words, how do I get that dependency in there without installing SSMS?

The DSC configuration that is using the resource (as detailed as possible):

xSQLServerRSConfig DefaultConfiguration
{
    InstanceName = $SqlData.InstanceName
    RSSQLServer = $NodeName
    RSSQLInstanceName = $SqlData.InstanceName
    ReportServerVirtualDirectory = $SqlData.ReportServerVirtualDirectory
    ReportsVirtualDirectory = $SqlData.ReportsVirtualDirectory
    PsDscRunAsCredential = $LocalAdminCreds
    DependsOn = "[xSqlServerSetup]InstallSql"
}

Version of the Operating System, SQL Server and PowerShell the DSC Target Node is running:
Windows Server 2012R2, SQL Server 2014 SP2, PowerShell5.1

What module (SqlServer or SQLPS) and which version of the module the DSC Target Node is running:
SQLPS 1.0 (but not really applicable to this issue)

Version of the DSC module you're using, or 'dev' if you're using current dev branch:
9.0.0.0

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

Start by locating the SqlRS documentation for xSQLServerRSConfig and reviewing its requirements against the SQLPS or SqlServer dependency described. Document the dependency and the DSC-only path that avoids SSMS, if confirmed; done when the requirements and supported installation approach are explicit.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.