Skip to content

Chef Cookbook to install and configure Microsoft KMS

License

Notifications You must be signed in to change notification settings

Annih/kms-server

Repository files navigation

kms-server Cookbook

Cookbook Version Build Status License

Install and configure the Microsoft KMS server role.

Requirements

This cookbook supports and requires Chef 12.6+.

Platforms

  • Windows Server 2012R2
  • Windows Server 2016

Cookbooks

The following cookbook is required as noted:

  • windows (> 1.36.1) to leverage the windows_feature resource

Usage

Configure your kms host key and tweak other attributes. Then just add kms-server::default to your runlist.

Attributes

Below attributes are available in kms_server root namespace. Most of them are adapted from https://technet.microsoft.com/library/dn502532

Attribute Description Default value
host_key The key used to enable KMS Host service. MANDATORY
disable_dns_publishing Determine whether DNS publishing is disable. false
dns_publishing_domains List of domain used for DNS publishing. []
reduce_kms_priority Determine whether KMS priority should be lowered. false
listening_port KMS Tcp listening port. 1688
activation_interval Activation interval in minutes. 120
renewal_interval Renewal interval in minutes. 10080

Contributing

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Copyright 2017 Baptiste Courtois

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.