aem_curator

Puppet module for installing and configuring a curated set of Adobe Experience Manager (AEM) components

Project URL RSS Feed Report issues

Module Stats

81,957 downloads

134 latest version

4.8 quality score

Version information

released Nov 25th 2018

This version is compatible with:

Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x
Puppet >= 5.0.0 < 7.0.0
,

Start using this module

Installation method

Add this module to your Puppetfile:

mod 'shinesolutions-aem_curator', '1.3.0'

Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add shinesolutions-aem_curator

Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install shinesolutions-aem_curator --version 1.3.0

Tags: aem, cq, adobe-experience-manager, aem-opencloud

Documentation

shinesolutions/aem_curator — version 1.3.0 Nov 25th 2018

Puppet AEM Curator

A Puppet module for installing and configuring a curated set of Adobe Experience Manager (AEM) components.

This module supports AEM installation for various versions along with a combination of Service Packs, Cumulative Fix Packs, and hotfixes. Those combinations are bundled into what this module calls AEM Profiles.

Other than AEM installation, it also supports some common AEM management events:

Deployment of a single AEM package or a single Dispatcher package
Deployment of multiple AEM packages and Dispatcher packages declared in a descriptor file
Enable and disable CRXDE
Promote an AEM Author Standby to AEM Author Primary
Flush AEM Dispatcher cache
Export a single AEM package for backup
Export multiple AEM packages for backup, declared in a descriptor file
Import a single backup AEM package
List AEM packages

Install

puppet module install shinesolutions-aem_curator

Or via a Puppetfile:

mod 'shinesolutions/aem_curator'

If you want to use the master version:

mod 'shinesolutions/aem_curator', :git => 'https://github.com/shinesolutions/puppet-aem-curator'

Usage

TODO

Types in this module release

aem_installer

This is a private type intended to start, monitor, and stop an AEM instance, insuring the repository is created.

Parameters
ensure
name	The name of the AEM Instance.
provider
snooze	Snooze value for wait when monitoring for AEM state transition during installation. Value is in seconds; default = 10 seconds
timeout	Timeout for the start process when monitoring for start and stop. If the system does not enter the necessary state by the timeout, an error is raised. Value is in seconds. Default = 10 minutes

Properties
home	The home directory of the AEM installation.

Providers
default

aem_path

tcp_conn_validator

Verify that a TCP connection can be successfully established between a node and the expected host. Its primary use is as a precondition to prevent configuration changes from being applied if the host cannot be reached, but it could potentially be used for other purposes such as monitoring.

Parameters
ensure
host	An array containing DNS names or IP addresses of the host where the expected service should be running.
name	An arbitrary name used as the identity of the resource.
port	The port that the server should be listening on.
provider
timeout	The max number of seconds that the validator should wait before giving up and deciding that the service is not running; defaults to 60 seconds.
try_sleep	The time to sleep in seconds between 'tries'.

Providers
tcp_port	A provider for the resource type `tcp_conn_validator`, which validates the tcp connection.

aem_truststore

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
file	Full path to the certificate file
force	Force creation of the Truststore via File
name	Description
password	AEM Truststore Password
path	Download path for storing the AEM Truststore
provider
retries_base_sleep_seconds	Starting wait delay in seconds when waiting for package to be uploaded/installed
retries_max_sleep_seconds	Maximum wait delay in seconds when waiting for package to be uploaded/installed
retries_max_tries	Maximum tries when waiting for package to be uploaded/installed

Providers
aem

aem_aem

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
combine_tags_or	AEM HealthCheck change AND to OR
ensure
name	Description
package_groups	AEM Package groups
provider
retries_base_sleep_seconds	Starting sleep duration in seconds
retries_max_sleep_seconds	Maximum sleep duration in seconds
retries_max_tries	Maximum number of tries
run_mode	AEM run mode where the replication agent is
tags	AEM HealthCheck tags

Providers
aem

aem_authorizable_keystore

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
authorizable_id	Authorizable user id
ensure
file	Full path to the Keystore file store.p12.
force	Force creation of the Keystore via File
intermediate_path	User Home Path
name	Description
password	Password of the Keystore.
path	Directory path to archive the Keystore file store.p12.
provider
retries_base_sleep_seconds	Starting wait delay in seconds when waiting for package to be uploaded/installed
retries_max_sleep_seconds	Maximum wait delay in seconds when waiting for package to be uploaded/installed
retries_max_tries	Maximum tries when waiting for package to be uploaded/installed

Providers
aem

aem_replication_agent

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
description	AEM replication agent description
dest_base_url	AEM replication agent destination base URL
ensure
force	Set to true to force replication agent to be created if it doesn't exist or updated if it already exists
log_level	AEM replication agent log level
name	AEM replication agent name
provider
retry_delay	AEM replication agent retry delay in milliseconds
run_mode	AEM run mode where the replication agent is
title	AEM replication agent title
transport_password	AEM replication agent transport user's password
transport_user	AEM replication agent transport user's username

Providers
aem

aem_certificate_chain

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
authorizable_id	Authorizable user id
certificate_chain_file_path	Full path to the Certificate Chain in PEM format add to the authorizable Keystore.
ensure
intermediate_path	User Home Path
name	Description
private_key_alias	Alias name of new Private key containing the certificate chain in the AEM Keystore.
private_key_file_path	Full path to the Private key file in DER format.
provider
retries_base_sleep_seconds	Starting wait delay in seconds when waiting for package to be uploaded/installed
retries_max_sleep_seconds	Maximum wait delay in seconds when waiting for package to be uploaded/installed
retries_max_tries	Maximum tries when waiting for package to be uploaded/installed

Providers
aem

aem_sling_resource

This is a type used to perform sling api calls

Parameters
ensure
force_passwords	Force the updates of password properties if they differ.
handle_missing	How to handle missing configurations which exist in AEM.
home	The home directory of the AEM installation.
ignored_properties	The properties to ignore when checking for synchronization.
name	The full path of the content node, or a unique name for this resource.
password	Password used to log into AEM.
password_properties	Properties designated as passwords, these will be ignored on sync check unless force_passwords is true.
path	Path to the resource in the repository.
protected_properties	Properties allowed when creating a node, but not during updates; ignored during synchronization.
provider
retries	Number of retries to communicate with AEM before giving up.
timeout	Timeout for a successful AEM start. Default = 60 seconds
username	Username used to log into AEM.

Properties
properties	Properties for the node.

Providers
ruby

anchor

A simple resource type intended to be used as an anchor in a composite class.

In Puppet 2.6, when a class declares another class, the resources in the interior class are not contained by the exterior class. This interacts badly with the pattern of composing complex modules from smaller classes, as it makes it impossible for end users to specify order relationships between the exterior class and other modules.

The anchor type lets you work around this. By sandwiching any interior classes between two no-op resources that are contained by the exterior class, you can ensure that all resources in the module are contained.

  class ntp {
    # These classes will have the correct order relationship with each
    # other. However, without anchors, they won't have any order
    # relationship to Class['ntp'].
    class { 'ntp::package': }
    -> class { 'ntp::config': }
    -> class { 'ntp::service': }

    # These two resources "anchor" the composed classes within the ntp
    # class.
    anchor { 'ntp::begin': } -> Class['ntp::package']
    Class['ntp::service']    -> anchor { 'ntp::end': }
  }

This allows the end user of the ntp module to establish require and before relationships with Class['ntp']:

  class { 'ntp': } -> class { 'mcollective': }
  class { 'mcollective': } -> class { 'ntp': }

Parameters
name	The name of the anchor resource.

file_line

Ensures that a given line is contained within a file. The implementation matches the full line, including whitespace at the beginning and end. If the line is not contained in the given file, Puppet will append the line to the end of the file to ensure the desired state. Multiple resources may be declared to manage multiple lines in the same file.

Example:

    file_line { 'sudo_rule':
      path => '/etc/sudoers',
      line => '%sudo ALL=(ALL) ALL',
    }

    file_line { 'sudo_rule_nopw':
      path => '/etc/sudoers',
      line => '%sudonopw ALL=(ALL) NOPASSWD: ALL',
    }

In this example, Puppet will ensure both of the specified lines are
contained in the file /etc/sudoers.

Match Example:

    file_line { 'bashrc_proxy':
      ensure => present,
      path   => '/etc/bashrc',
      line   => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
      match  => '^export HTTP_PROXY=',
    }

In this code example match will look for a line beginning with export
followed by HTTP_PROXY and replace it with the value in line.

Examples With `ensure => absent`:

This type has two behaviors when `ensure => absent` is set.

One possibility is to set `match => ...` and `match_for_absence => true`,
as in the following example:

    file_line { 'bashrc_proxy':
      ensure            => absent,
      path              => '/etc/bashrc',
      match             => '^export HTTP_PROXY=',
      match_for_absence => true,
    }

In this code example match will look for a line beginning with export
followed by HTTP_PROXY and delete it.  If multiple lines match, an
error will be raised unless the `multiple => true` parameter is set.

Note that the `line => ...` parameter would be accepted BUT IGNORED in
the above example.

The second way of using `ensure => absent` is to specify a `line => ...`,
and no match:

    file_line { 'bashrc_proxy':
      ensure => absent,
      path   => '/etc/bashrc',
      line   => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
    }

Note that when ensuring lines are absent this way, the default behavior
this time is to always remove all lines matching, and this behavior
can't be disabled.

Encoding example:

    file_line { "XScreenSaver":
      ensure   => present,
      path     => '/root/XScreenSaver',
      line     => "*lock: 10:00:00",
      match    => '^*lock:',
      encoding => "iso-8859-1",
    }

Files with special characters that are not valid UTF-8 will give the
error message "invalid byte sequence in UTF-8".  In this case, determine
the correct file encoding and specify the correct encoding using the
encoding attribute, the value of which needs to be a valid Ruby character
encoding.

**Autorequires:** If Puppet is managing the file that will contain the line
being managed, the file_line resource will autorequire that file.

Parameters
after	An optional value used to specify the line after which we will add any new lines. (Existing lines are added in place) This is also takes a regex.
append_on_no_match	If true, append line if match is not found. If false, do not append line if a match is not found
encoding	For files that are not UTF-8 encoded, specify encoding such as iso-8859-1
ensure
match	An optional ruby regular expression to run against existing lines in the file. If a match is found, we replace that line rather than adding a new line. A regex comparison is performed against the line value and if it does not match an exception will be raised.
match_for_absence	An optional value to determine if match should be applied when ensure => absent. If set to true and match is set, the line that matches match will be deleted. If set to false (the default), match is ignored when ensure => absent. When `ensure => present`, match_for_absence is ignored.
multiple	An optional value to determine if match can change multiple lines. If set to false, an exception will be raised if more than one line matches
name	An arbitrary name used as the identity of the resource.
path	The file Puppet will ensure contains the line specified by the line parameter.
provider
replace	If true, replace line that matches. If false, do not write line if a match is found
replace_all_matches_not_matching_line	Configures the behavior of replacing all lines in a file which match the `match` parameter regular expression, regardless of whether the specified line is already present in the file.

Properties
line	The line to be appended to the file or used to replace matches found by the match attribute.

Providers
ruby

aem_osgi_config

This is a private type used to manage OSGi configurations via API calls.

Parameters
ensure
handle_missing	How to handle missing configurations which exist in AEM.
home	The home directory of the AEM installation.
name	The name of the OSGi configuration. This should be the SID.
password	Password used to log into AEM.
pid	The Service PID for the OSGi Configuration.
provider
timeout	Timeout for a successful AEM start. Default = 60 seconds
username	Username used to log into AEM.

Properties
configuration	Properties for the OSGi configuration.

Providers
ruby

aem_user_alias

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
force	Set to true to force user creation, if the user already exists then it will be deleted before recreated, default to false
group_name	Group name
group_path	Group path
name	User name
new_password	New user password
old_password	Old user password
password	User password
path	User path
permission	User permission
provider

Providers
aem

aem_repository

concat_fragment

Create a concat fragment to be used by concat. the concat_fragment type creates a file fragment to be collected by concat based on the tag. The example is based on exported resources.

Example:
@@concat_fragment { "uniqe_name_${::fqdn}":
  tag => 'unique_name',
  order => 10, # Optional. Default to 10
  content => 'some content' # OR
  content => template('template.erb') # OR
  source  => 'puppet:///path/to/file'
}

Parameters
content	Content
name	Unique name
order	Order
source	Source
tag	Tag name to be used by concat to collect all concat_fragments by tag name
target	Target

aem_bundle_alias

aem_outbox_replication_agent

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
description	AEM outbox replication agent description
dest_base_url	AEM outbox replication agent destination base URL
ensure
force	Set to true to force outbox replication agent to be created if it doesn't exist or updated if it already exists
log_level	AEM outbox replication agent log level
name	AEM outbox replication agent name
provider
run_mode	AEM run mode where the outbox replication agent is
title	AEM outbox replication agent title
user_id	AEM outbox replication agent user ID

Providers
aem

concat_file

Gets all the file fragments and puts these into the target file. This will mostly be used with exported resources.

example:
  Concat_fragment <<| tag == 'unique_tag' |>>

  concat_file { '/tmp/file':
    tag            => 'unique_tag', # Optional. Default to undef
    path           => '/tmp/file',  # Optional. If given it overrides the resource name
    owner          => 'root',       # Optional. Default to undef
    group          => 'root',       # Optional. Default to undef
    mode           => '0644'        # Optional. Default to undef
    order          => 'numeric'     # Optional, Default to 'numeric'
    ensure_newline => false         # Optional, Defaults to false
  }

Parameters
backup	Controls the filebucketing behavior of the final file and see File type reference for its use.
ensure
ensure_newline	Whether to ensure there is a newline after each fragment.
force	Forcibly merge duplicate keys keeping values of the highest order.
format	What data type to merge the fragments as.
group	Desired file group.
mode	Desired file mode.
order	Controls the ordering of fragments. Can be set to alpha or numeric.
owner	Desired file owner.
path	The output file
replace	Whether to replace a file that already exists on the local system.
selinux_ignore_defaults
selrange
selrole
seltype
seluser
show_diff
tag	Tag reference to collect all concat_fragment's with the same tag
validate_cmd	Validates file.

a2mod

Manage Apache 2 modules

Parameters
ensure
identifier	Module identifier string used by LoadModule. Default: module-name_module
lib	The name of the .so library to be loaded
name	The name of the module to be managed
provider

Providers
a2mod	Manage Apache 2 modules on Debian and Ubuntu
gentoo	Manage Apache 2 modules on Gentoo
modfix	Dummy provider for A2mod. `Fake nil resources when there is no crontab binary available. Allows puppetd to run on a bootstrapped machine before a Cron package has been installed. Workaround for: http://projects.puppetlabs.com/issues/2384`
redhat	Manage Apache 2 modules on RedHat family OSs

aem_saml

Parameters
add_group_memberships	Whether or not a user should be automatically added to CRX groups after successful authentication.
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
assertion_consumer_service_url	The (optional) AssertionConsumerServiceURL attribute of an Authn request specifies the location to which a message MUST be sent to the requester.
clock_tolerance	Time tolerance in seconds to compensate clock skew between IDP and SP when validating Assertions.
config_node_name	AEM node name
config_node_path	AEM Node Path
create_user	Whether or not to autocreate nonexisting users in the repository.
default_groups	A list of default CRX groups users are added to after successful authentication.
default_redirect_url	The default location to redirect to after successful authentication.
digest_method	The digest algorithm to use when signing a SAML message.
ensure
file	File path to the SAML certification.
group_membership_attribute	The name of the attribute containing a list of CRX groups this user should be added to.
handle_logout	Whether or not logout (dropCredentials) requests will be processed by this handler.
idp_cert_alias	The alias of the IdPs certificate in the global truststore. If this property is empty the authentication handler is disabled.
idp_http_redirect	Use an HTTP Redirect to the IDP URL instead of sending an AuthnRequest-message to request credentials. Use this for IDP initiated authentication.
idp_url	URL of the IDP where the SAML Authentication Request should be sent to. If this property is empty the authentication handler is disabled. (idpUrl)
key_store_password	The password of the key-store of the authentication-service system user.
logout_url	URL of the IDP where the SAML Logout Request should be sent to. If this property is empty the authentication handler wont handle logouts.
name	Title
name_id_format	The value of the NameIDPolicy format parameter to send in the AuthnRequest message.
node_type	AEM node type
path	Repository path for which this authentication handler should be used by Sling.
provider
serial	Serial number of the SAML certificate in the AEM Truststore
service_provider_entity_id	ID which uniquely identifies this service provider with the identity provider. If this property is empty the authentication handler is disabled.
service_ranking	OSGi Framework Service Ranking value to indicate the order in which to call this service. This is an int value where higher values designate higher precedence. Default value is 0.
signature_method	The signature algorithm to use when signing a SAML message.
sp_private_key_alias	The alias of the SPs private key in the key-store of the authentication-service system user. If this property is empty the handler will not be able to sign or decrypt messages.
synchronize_attributes	A list of attribute mappings (in the format "attributename=path/relative/to/user/node") which should be stored in the repository on user-synchronization.
use_encryption	Whether or not this authentication handler expects encrypted SAML assertions. If this is enabled the SPs private key must be provided in the key-store of the authentication-service system user (see SP Private Key Alias above).
user_id_attribute	The name of the attribute containing the user ID used to authenticate and create the user in the CRX repository. Leave empty to use the Subject:NameId.
user_intermediate_path	User intermediate path to store created users.

Providers
aem

http_conn_validator

Verify that a connection can be successfully established between a node and an HTTP server. Its primary use is as a precondition to prevent configuration changes from being applied if the HTTP server cannot be reached, but it could potentially be used for other purposes such as monitoring.

Parameters
ensure
expected_code	The HTTP status code that should be expected; defaults to 200.
host	An array containing DNS names or IP addresses of the host where the expected service should be running.
name	An arbitrary name used as the identity of the resource.
port	The port that the server should be listening on.
provider
test_url	URL to use for testing if the HTTP server is up
timeout	The max number of seconds that the validator should wait before giving up and deciding that the service is not running; defaults to 60 seconds.
try_sleep	The time to sleep in seconds between 'tries'.
use_ssl	Whether the connection will be attemped using https
verify_peer	Whether to verify the peer credentials, if possible. Verification will not take place if the CA certificate is missing

Providers
http_conn_validator	A provider for the resource type `http_conn_validator`, which validates an HTTP connection by attempting an http(s) connection to the server.

aem_flush_agent

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
description	AEM flush agent description
dest_base_url	AEM flush agent destination base URL
ensure
force	Set to true to force flush agent to be created if it doesn't exist or updated if it already exists
log_level	AEM flush agent log level
name	AEM flush agent name
provider
retry_delay	AEM flush agent retry delay in milliseconds
run_mode	AEM run mode where the flush agent is
title	AEM flush agent title

Providers
aem

aem_node

aem_package

Parameters
activate	Set to true to activate all filters in the package after installation, default to false
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
filter	AEM package filter
force	Set to true to force package installation even if it is already installed, default to false
group	AEM package group
name	AEM package name
path	Path where the package file to be uploaded is located at
provider
replicate	Set to true to replicate package after installation, default to false
retries_base_sleep_seconds	Starting wait delay in seconds when waiting for package to be uploaded/installed
retries_max_sleep_seconds	Maximum wait delay in seconds when waiting for package to be uploaded/installed
retries_max_tries	Maximum tries when waiting for package to be uploaded/installed
version	AEM package version

Providers
aem

aem_certificate

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
file	Full path to the certificate file
force	Force uploading of certificate
name	Description
provider
retries_base_sleep_seconds	Starting wait delay in seconds when waiting for package to be uploaded/installed
retries_max_sleep_seconds	Maximum wait delay in seconds when waiting for package to be uploaded/installed
retries_max_tries	Maximum tries when waiting for package to be uploaded/installed
serial	Serialnumber of the certificate in the AEM Truststore
truststore_password	AEM Truststore Password

Providers
aem

aem_crx_package

This is a private type used to manage CRX Packages via API calls.

Parameters
ensure	Upload, install/uninstall or remove the package.
home	The home directory of the AEM installation.
name	Namevar, Unique value to allow multiple resources in one manifest.
password	Password used to log into AEM.
provider
retries	Number of retries to communicate with AEM before giving up.
retry_timeout	Seconds to wait between retries to communicate with AEM before giving up.
source	The source package file to upload/install.
timeout	Timeout for a successful AEM start. Default = 60 seconds
username	Username used to log into AEM.

Properties
group	The group of the CRX Package.
pkg	The name of the CRX package.
version	The version of the CRX Package.

Providers
ruby

aem_group

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
force	Set to true to force group creation, if the group already exists then it will be deleted before recreated, default to false
member_group_name	Member group name
member_group_path	Member group path
name	Group name
parent_group_name	Parent group name
parent_group_path	Parent group path
path	Group path
provider

Providers
aem

aem_bundle

aem_user

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
ensure
force	Set to true to force user creation, if the user already exists then it will be deleted before recreated, default to false
group_name	Group name
group_path	Group path
name	User name
new_password	New user password
old_password	Old user password
password	User password
path	User path
permission	User permission
provider

Providers
aem

aem_config_property

Parameters
aem_id	AEM instance ID
aem_password	AEM password
aem_username	AEM username
config_node_name	AEM config node name
ensure
name	AEM property name
provider
run_mode	AEM run mode where the config property is
type	AEM property type (e.g. String, Boolean)
value	AEM property value

Providers
aem

1.3.0

Add feature to configure SAML
Add feature to configure AEM Trusttore
Add feature to configure AEM Authorizable Keystore
Add feature to manage AEM Truststore certificates
Add feature to manage AEM Authorizable Keystore certificates
Add action manifests for enabling/disabling SAML

1.2.4

Fix parameters for "Wait until login page is ready" to consume parameters from aem-aws-stack-provisioner for all checks #76
Add Amazon Linux 2 to supported OS list in Puppet metadata

1.2.3

Change default JMX ports to 5982 for AEM Author and 5983 for AEM Publish
Add wait until AEM Author Standby port is listening #75
Add Puppet resource stopped status check for AEM services at the end of installation
Disable collectd repo management to avoid any outbound connection #71
Upgrade aem_resources to 3.2.1

1.2.2

Remove collectd installation due to collectd provisioning already exists on Packer AEM #71

1.2.1

Add parameter to enable/disable installation of collectd #68
Add step to install collectd after installation of AEM for Author & Publish #71
Upgrade InSpec to 2.3.10 with new vendoring structure #60

1.2.0

Updated parameters for "Wait until login page is ready" to consume parameters from aem-aws-stack-provisioner
Add additional checks during configuring AEM Author & AEM Publisher #63
Add parameter deployment_sleep_seconds for resource deploy_packages
Lock inspec version to 2.2.78 #60
Remove support for Ruby 2.1 & 2.2 due to dependency issues
Add feature to delete old bak files from the repository during offline-compaction
Add install AEM profile action
Simplify AEM profile installation logic #7
Introduce pdk as Puppet module build
Drop Puppet 4 support, add Puppet 6 support
Upgrade aem_resources to 3.2.0
Add new AEM profile: aem64_sp2

1.1.2

Upgrade aem_resources to 3.1.1 for aem_user_alias support

1.1.1

Fix pre-6.4 incorrect config path for AEM Password Reset and AEM Health Check

1.1.0

Add support for reconfiguring existing AEM installations
Place AEM Healthcheck installation to own manifest
Place AEM Configuration to own manifest
Add feature to change existing system users passwords
Improved credentials handling for system users

1.0.3

Fix temp directory clean up at the end of artifacts deployment

1.0.2

Set repository ownership when configuring AEM Author Primary, Author Standby, and Publish

1.0.1

Add 1.x.x AEM profiles: aem62_sp1_cfp15, aem63_sp2_cfp2, aem64_sp1

1.0.0

Modify config path to /apps/system/config for AEM 6.4 support

0.10.2

Add log rotation to author standby promotion

0.10.1

Rename AEM 6.3 SP2 asset name to be identical to Adobe Package Share's

0.10.0

Switch InSpec deps to released versions
Add manifest for logrotation configuration
Add AEM profiles: aem63_sp2, aem63_sp2_cfp1

0.9.30

Add retries setting for deploying a single artifact #28

0.9.29

Add AEM start opts support to AEM instance installation
Backup import no longer fails when the package already exists

0.9.28

Move snapshot attachment step to aem-aws-stack-provisioner
Extract all scheduled jobs provisioning to config_aem_scheduled_jobs
Fix missing Puppet exit code translation on all aem-tools

0.9.27

Fix path conflict on flush dispatcher cache action

0.9.26

Modify flush dispatcher cache action to remove only JCR sub-directories under docroot
Add timeout setting to author and publish configuration manifests

0.9.25

Clean up temp directory at the end of deploy artifacts
Add parameter allowing additional java opts settings for author and publish

0.9.24

Fix parameter passing on deploy artifact and export backups

0.9.23

Add log_dir parameter to deploy artifact templates processing
Add list packages support to aem-tools

0.9.22

Fix incorrect match regex for Collectd CloudWatch config #25

0.9.21

Set retry settings to AEM package deployment actions #28
Add new AEM profile: aem64
Move stack prefix and component details as a constant value dimension for Collectd CloudWatch config #25

0.9.20

Add aem_id parameter to actions with on-demand AEM target

0.9.19

Fix injection of aem_username & aem_password to action manifests #26
Move export backup and import backup scripts provisioning to aem-aws-stack-provisioner
Move AEM Author standby promotion instance rename to aem-aws-stack-provisioner
Add InSpec testing for aem-tools actions
Fix incorrect artifact name for aem63_sp1_cfp13

0.9.18

Allow default aem_id via Hiera configuration for action manifests

0.9.17

Add new AEM profile: aem63_sp1_cfp13 #21
Add ssl_cert parameter to dispatcher templates
Move aem_resources-generated virtual hosts config to virtual hosts directory

0.9.16

Add complete dispatcher template parameters to all dispatcher template processing #19

0.9.15

Move AEM Tools directory ensure to aem-aws-stack-provisioner
Remove flush dispatcher cache script from config_aem_tools

0.9.14

Add new manifest for Dispatcher aem-tools
Add new aem-tool flush-dispatcher-cache

0.9.13

Fix incorrect manifest for deploy-artifact aem-tools script
Add integrated export-package,export-packages and import-packages from aem-aws-stack-provisioner to aem-curator

0.9.12

Add multi AEM instances support to collectd config
Fix aem63_sp1_cfp2 artifact file name and package name #6
Add Author Standby component bean whitelisting

0.9.11

Add new AEM profile: aem63_sp1_cfp2 #6
Add aem_version to Author Standby and Author Primary OSGI configuration

0.9.10

Migrate artifacts deployment tools from aem-aws-stack-provisioner to aem_curator
Add feature enable jmxremote at AEM Author and Publish java instances
Configure CloudWatch collectd plugin's proxy support only if proxy fact is set
Add disable-crxde to aem-tools
Drop Ruby 2.0 support

0.9.9

Migrate all AEM Tools files and templates from aem-aws-stack-provisioner to aem_curator
Migrate AWS-related scripts from aem_curator to aem-aws-stack-provisioner
Parameterise all references to AWS S3
Add multi AEM instances support to offline compaction and enable CRXDE
Extract deployment support to config_aem_deployer manifest

0.9.8

Localise global facts aem_password_reset_version, oak_run_version

0.9.7

Remove publish_dispatcher_allowed_client, pairinstanceid, and publishdispatcherhost global facts
Add config_author_dispatcher class
Add config_author_standby class

0.9.6

Add readiness checks during installation and configuration of AEM Dispatcher
Added variable jvm_mem_opts to configure JVM Memory for AEM Author and Publisher

0.9.5

config_publish_dispatcher no longer deploys artifacts (moved to aem-aws-stack-provisioner) due to AWS-specific check
Fix Dispatcher artifacts descriptor generator script name

0.9.4

Add enable_default_password flag for creating system users password with default value (i.e. same as username)
Add enable_crxde flag for enabling CRXDE access

0.9.3

Add new AEM profiles: aem62_sp1_cfp2, aem62_sp1_cfp9, aem63_sp1
Rename jvm_opts param to aem_jvm_opts

0.9.2

Introduce AEM profile concept which defines AEM base installation along with extra packages (hotfixes, service packs, cumulative fix packs)
AEM and license files now have predetermined names, consistent with extra packages
Add aem63 profile for vanilla AEM 6.3 base installation

0.9.1

Add dependencies to metadata

0.9.0

Initial version
config_publish_dispatcher: Publisher Host definitions replaced: $publish_host class variable replaced $::publishhost
config_publish: Flush agent definitions replaced: $publishdispatcherhost, $pairinstanceid class variable replaced $::publishdispatcherhost, $::pairinstanceid
Move AEM Tools into its own manifest config_aem_tools.pp
Migrate AEM installation manifests from packer-aem
Add multi AEM instances support at manifests level by replacing classes with definitions and by introducing aem_id attributes
Move collectd into its own manifest config_collectd.pp
Each AEM installation has its own user and group named aem-<aem_id>
Introduce vanilla AEM 6.2 option without hotfix, service pack, and cumulative fix pack packages

                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "[]"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright 2017 Shine Solutions

   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.