jianyunt/xscsma

xSCSMA

The xSCSMA module contains DSC resources for installation of System Center Service Management Automation (SMA).

Contributing

Please check out common DSC Resources contributing guidelines.

Resources

• xSCSMAPowerShellSetup installs SMA PowerShell
• xSCSMAWebServiceServerSetup installs an SMA Web Service server
• xSCSMARunbookWorkerServerSetup installs an SMA Runbook Worker server

xSCSMAPowerShellSetup

• Ensure: (Key) Ensures that the SMA PowerShell components are Present or Absent on the machine.
• SourcePath: (Required) UNC path to the root of the source files for installation.
• SourceFolder: Folder within the source path containing the source files for installation.
• SetupCredential: (Required) Credential to be used to perform the installation.

xSCSMAWebServiceServerSetup is used for installation of the SMA Web Service server, and has the following properties:

• Ensure: (Key) Ensures that the SCSCMA Web Service server components are Present or Absent on the machine.
• SourcePath: (Required) UNC path to the root of the source files for installation.
• SourceFolder: Folder within the source path containing the source files for installation.
• SetupCredential: (Required) Credential to be used to perform the installation.
• FirstWebServiceServer: (Required) Binary value defining if this the first Management Server
• ApPool: (Required) Service account of the web service application pool.
• ApPoolUsername: Output user name of the web service application pool.
• AdminGroupMembers: A comma-separated list of users to add to the IIS Administrators group.
• SqlServer: (Required) Name of the SQL Server for the SMA database.
• SqlInstance: (Required) Name of the SQL Instance for the SMA database.
• SqlDatabase: Name of the SMA database.
• SiteName: Name of the SMA website.
• WebServicePort: Port of the SMA website.
• InstallFolder: Installation folder for SMA.
• UseSSL: Binary value defining whether or not to use SSL.
• SpecifyCertificate: Specify an existing certificate for the SMA web site.
• CertificateName: Name of the existing certificate to use.
• ETWManifest: Log to ETW.
• SendCEIPReports: { 0 | 1 } 0: Do not opt in to the Customer Experience Improvement Program (CEIP). 1: Opt in to CEIP.
• MSUpdate: { 0 | 1 } 0: Do not opt in to Microsoft Update. 1: Opt in to Microsoft Update.
• ProductKey: Product key for licensed installations.
• RunbookWorkerServers: Array of Runbook Worker servers in this deployment.

xSCSMARunbookWorkerServerSetup

• Ensure: (Key) Ensures that the SMA Runbook Worker server is Present or Absent on the machine.
• SourcePath: (Required) UNC path to the root of the source files for installation.
• SourceFolder: Folder within the source path containing the source files for installation.
• SetupCredential: (Required) Credential to be used to perform the installation.
• Service: (Required) Service account of the web service application pool.
• ServiceUserName: Output user name of the Service account of the web service application pool.
• SqlServer: (Required) Name of the SQL Server for the SMA database.
• SqlInstance: (Required) Name of the SQL Instance for the SMA database.
• SqlDatabase: Name of the SMA database.
• InstallFolder: Installation folder for SMA.
• ETWManifest: Log to ETW.
• SendCEIPReports: { 0 | 1 } 0: Do not opt in to the Customer Experience Improvement Program (CEIP). 1: Opt in to CEIP.
• MSUpdate: { 0 | 1 } 0: Do not opt in to Microsoft Update. 1: Opt in to Microsoft Update.
• ProductKey: Product key for licensed installations.

Versions

1.2.1.0

• Increased timeout for setup process to start to 60 seconds.
• xSCSMAWebServiceServerSetup
  • Fixed bug when using named SQL instance
  • Added SMA service account to admin group.
• xSCSMARunbookWorkerSetup
  • Fixed bug when using named SQL instance.

1.1.0.0

• Initial release with the following resources:
  • xSCSMAPowerShellSetup
  • xSCSMAWebServiceServerSetup
  • xSCSMARunbookWorkerServerSetup

Examples

Three example configurations are included in the Examples folder. All three examples also use the xSQLServer module.

Single Server Installation

SCSMA-SingleServer.ps1 installs all SMA roles including prerequisites and SQL on a single server.

Separate SQL

SCSMA-SeperateSQL.ps1 installs all SMA roles on one server and SQL on a separate server.

Multiple Instances

SCSMA-MultiInstance.ps1 installs all SMA roles including multiple instances of both Web Service and Runbook Worker servers and SQL on a separate server.

Notes:

All three examples use the exact same Configuration and just modify the behavior based on input ConfigurationData.

In the Examples folder you will see a version of each file with "-TP" appended to the name. These are the equivalent examples for deployment of System Center Technical Preview on Windows Server Technical Preview.

The samples require the use of the Windows Management Framework (WMF) 5.0 Preview.

System Center 2012 R2 Service Management Automation Web Service and Runbook Worker installers have a hard check for PowerShell 4.0. If you are using these resources to install on a system that has WMF 5.0 preview installed, you must copy the transform (MST) files from the Web Service and Runbook Worker DSC resource folders to the SMA installation folder.