diff --git a/.gitmodules b/.gitmodules index 716fcdd..cdc7805 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,4 +1,3 @@ -[submodule "submodules/quickstart-aws-vpc"] - path = submodules/quickstart-aws-vpc - url = ../../aws-quickstart/quickstart-aws-vpc.git - branch = master +[submodule "docs/boilerplate"] + path = docs/boilerplate + url = https://github.com/aws-ia/aws-ia-documentation-base-common.git diff --git a/README.md b/README.md index 955e8f8..bb3005d 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,37 @@ -# Splunk Enterprise on AWS - Quick Start - -Source code associated with [Splunk Enterprise AWS Quick Start](https://fwd.aws/r7QNJ) - -## Usage - -Use these templates to deploy a highly available Splunk Enterprise environment across multiple AZs (2 or 3) in a given AWS region. -AZ-aware indexer clustering is enabled for horizontal scaling and to guarantee data is replicated in every AZ. -AZ-aware Search head clustering (3 nodes by default) can also be enabled for horizontal scaling and to guarantee data is available for search in every AZ. - -View the accompanying [deployment guide](https://fwd.aws/bGBmy) for everything you need to get started. Refer to 'Deployment Steps' section for a step-by-step walkthrough on how to use these templates in AWS console. - -### Prerequisites - -Before getting started with the template configuration, you will need to make your Splunk Enterprise license privately accessible for CloudFormation template deployment via S3 download. The following steps will guide you through that process. *(Note: This step is not required, and you can upload your license from the Splunk web interface. It is, however, required that you have a non-trial Splunk Enterprise license to fully utilize the deployment our template creates. If you don't already have a Splunk Enterprise license, you can obtain one by contacting sales@splunk.com.)* - - 1. From the AWS Console, select "S3" under the "Storage" heading, or by simply typing "S3" into the search bar. - 2. You can either select an existing private bucket to upload to, or create a new one. If you select an existing bucket, make sure its access policy does not grant public access. By default, all the S3 resources are private, so only the AWS account that created the resources can access them. For this exercise, I'm outlining how to create a new bucket. - 3. Click "create bucket" - 4. Name your bucket, and select your region. In this example, I will use "bbartlett-splunk-config". Your bucket name must be unique, and you should select the same region where you plan on deploying Splunk.

![new bucket example](https://s3-us-west-2.amazonaws.com/splk-bbartlett/splunk_newbucket.png)

- 5. Once you've created your bucket, select your new bucket from the list of buckets. - 6. Click "Upload" on the upper left of the page - 7. Click "Add Files" - 8. Select your license file. - 9. Click "Start Upload" on the lower right of the page. - 10. Once the license has finished uploading, you'll need the bucket name and the filename to use with the CloudFormation template. - -## License - -This project is licensed under Apache License 2.0 - see [LICENSE.txt](./LICENSE.txt) file for details - -## Help - -If you have any problems or general questions, please file an issue in the parent repository: -https://github.com/aws-quickstart/quickstart-splunk-enterprise/issues - - +# Splunk Enterprise on AWS - Quick Start + +Source code associated with [Splunk Enterprise AWS Quick Start](https://fwd.aws/r7QNJ) + +## Usage + +Use these templates to deploy a highly available Splunk Enterprise environment across multiple AZs (2 or 3) in a given AWS region. +AZ-aware indexer clustering is enabled for horizontal scaling and to guarantee data is replicated in every AZ. +AZ-aware Search head clustering (3 nodes by default) can also be enabled for horizontal scaling and to guarantee data is available for search in every AZ. + +View the accompanying [deployment guide](https://fwd.aws/bGBmy) for everything you need to get started. Refer to 'Deployment Steps' section for a step-by-step walkthrough on how to use these templates in AWS console. + +### Prerequisites + +Before getting started with the template configuration, you will need to make your Splunk Enterprise license privately accessible for CloudFormation template deployment via S3 download. The following steps will guide you through that process. *(Note: This step is required. A non-trial Splunk Enterprise license is required to allow our template to configure the Splunk deployment. If you don't already have a Splunk Enterprise license, you can obtain one by contacting sales@splunk.com.)* + + 1. From the AWS Console, select "S3" under the "Storage" heading, or by simply typing "S3" into the search bar. + 2. You can either select an existing private bucket to upload to, or create a new one. If you select an existing bucket, make sure its access policy does not grant public access. By default, all the S3 resources are private, so only the AWS account that created the resources can access them. For this exercise, I'm outlining how to create a new bucket. + 3. Click "create bucket" + 4. Name your bucket, and select your region. In this example, I will use "bbartlett-splunk-config". Your bucket name must be unique, and you should select the same region where you plan on deploying Splunk.

![new bucket example](https://s3-us-west-2.amazonaws.com/splk-bbartlett/splunk_newbucket.png)

+ 5. Once you've created your bucket, select your new bucket from the list of buckets. + 6. Click "Upload" on the upper left of the page + 7. Click "Add Files" + 8. Select your license file. + 9. Click "Start Upload" on the lower right of the page. + 10. Once the license has finished uploading, you'll need the bucket name and the filename to use with the CloudFormation template. + +## License + +This project is licensed under Apache License 2.0 - see [LICENSE.txt](./LICENSE.txt) file for details + +## Help + +If you have any problems or general questions, please file an issue in the parent repository: +https://github.com/aws-quickstart/quickstart-splunk-enterprise/issues + + diff --git a/ci/defaults.json b/ci/defaults.json deleted file mode 100644 index 7d1bc77..0000000 --- a/ci/defaults.json +++ /dev/null @@ -1,38 +0,0 @@ -[ - { - "ParameterKey": "AvailabilityZones", - "ParameterValue": "$[taskcat_genaz_2]" - }, - { - "ParameterKey": "WebClientLocation", - "ParameterValue": "72.21.196.66/32" - }, - { - "ParameterKey": "HECClientLocation", - "ParameterValue": "10.0.0.0/16" - }, - { - "ParameterKey": "KeyName", - "ParameterValue": "$[taskcat_getkeypair]" - }, - { - "ParameterKey": "SSHClientLocation", - "ParameterValue": "10.0.0.0/16" - }, - { - "ParameterKey": "SplunkAdminPassword", - "ParameterValue": "$[taskcat_genpass_10]" - }, - { - "ParameterKey": "SplunkClusterSecret", - "ParameterValue": "$[taskcat_genpass_10]" - }, - { - "ParameterKey": "SplunkIndexerDiscoverySecret", - "ParameterValue": "$[taskcat_genpass_10]" - }, - { - "ParameterKey": "QSS3BucketName", - "ParameterValue": "$[taskcat_autobucket]" - } -] diff --git a/ci/taskcat.yml b/ci/taskcat.yml deleted file mode 100644 index 9e108f4..0000000 --- a/ci/taskcat.yml +++ /dev/null @@ -1,27 +0,0 @@ -global: - marketplace-ami: true - owner: quickstart@amazon.com - qsname: quickstart-splunk-enterprise - regions: - - ap-northeast-1 - - ap-northeast-2 - - ap-south-1 - - ap-southeast-1 - - ap-southeast-2 - - ca-central-1 - - eu-central-1 - - eu-west-1 - - eu-west-2 - - sa-east-1 - - us-east-1 - - us-east-2 - - us-west-1 - - us-west-2 - reporting: true -tests: - splunk-enterprise: - parameter_input: defaults.json - template_file: splunk-enterprise-master.template - regions: - - us-west-1 - - us-east-2 diff --git a/docs/_deployment_guide.adoc b/docs/_deployment_guide.adoc new file mode 100644 index 0000000..fa896ef --- /dev/null +++ b/docs/_deployment_guide.adoc @@ -0,0 +1 @@ +:type: cfn diff --git a/docs/boilerplate b/docs/boilerplate new file mode 160000 index 0000000..4ef16b7 --- /dev/null +++ b/docs/boilerplate @@ -0,0 +1 @@ +Subproject commit 4ef16b77d6020a462feba269030c80f9088e6d1b diff --git a/docs/deployment_guide/images/cfn_outputs.png b/docs/deployment_guide/images/cfn_outputs.png new file mode 100644 index 0000000..aefe01f Binary files /dev/null and b/docs/deployment_guide/images/cfn_outputs.png differ diff --git a/docs/deployment_guide/images/cluster-master-sfrf-met.png b/docs/deployment_guide/images/cluster-master-sfrf-met.png new file mode 100644 index 0000000..7799b8a Binary files /dev/null and b/docs/deployment_guide/images/cluster-master-sfrf-met.png differ diff --git a/docs/deployment_guide/images/indexer-clustering-menu.png b/docs/deployment_guide/images/indexer-clustering-menu.png new file mode 100644 index 0000000..28b3b00 Binary files /dev/null and b/docs/deployment_guide/images/indexer-clustering-menu.png differ diff --git a/docs/deployment_guide/images/search-head-distributed-search-menu.png b/docs/deployment_guide/images/search-head-distributed-search-menu.png new file mode 100644 index 0000000..e06c1eb Binary files /dev/null and b/docs/deployment_guide/images/search-head-distributed-search-menu.png differ diff --git a/docs/deployment_guide/images/search-head-distributed-search-success.png b/docs/deployment_guide/images/search-head-distributed-search-success.png new file mode 100644 index 0000000..96e4186 Binary files /dev/null and b/docs/deployment_guide/images/search-head-distributed-search-success.png differ diff --git a/docs/deployment_guide/images/splunk-enterprise-architecture-on-aws.png b/docs/deployment_guide/images/splunk-enterprise-architecture-on-aws.png new file mode 100644 index 0000000..11a9c2f Binary files /dev/null and b/docs/deployment_guide/images/splunk-enterprise-architecture-on-aws.png differ diff --git a/docs/deployment_guide/partner_editable/_settings.adoc b/docs/deployment_guide/partner_editable/_settings.adoc new file mode 100644 index 0000000..22b64ce --- /dev/null +++ b/docs/deployment_guide/partner_editable/_settings.adoc @@ -0,0 +1,10 @@ +:quickstart-project-name: quickstart-splunk-enterprise +:quickstart-github-org: aws-quickstart +:partner-product-short-name: Splunk Enterprise +:partner-company-name: Splunk Inc. +:doc-month: May +:doc-year: 2021 +:partner-contributors: Bill Bartlett, {partner-company-name} +:aws-contributors: Shivansh Singh, Amazon Web Services +:deployment_time: 25 minutes +:default_deployment_region: us-east-1 diff --git a/docs/deployment_guide/partner_editable/additional_info.adoc b/docs/deployment_guide/partner_editable/additional_info.adoc new file mode 100644 index 0000000..1e36aa0 --- /dev/null +++ b/docs/deployment_guide/partner_editable/additional_info.adoc @@ -0,0 +1,35 @@ +// Add steps as necessary for accessing the software, post-configuration, and testing. Don’t include full usage instructions for your software, but add links to your product documentation for that information. +//Should any sections not be applicable, remove them + +== Post deployment steps +// If steps are required to test the deployment, add them here. If not, remove the heading + +After the Quick Start has successfully completed, you can log into your {partner-product-name} deployment from a web browser and verify configuration. + +==== Verify Distributed Search +. Begin by logging into {partner-product-name} search head to verify all of the indexers are available for search. To log into the {partner-product-name} search head, navigate your browser to the URL shown in the CloudFormation Outputs labeled "SearchHeadURL" with the credentials of "admin" and the password configured with the "SplunkAdminPassword" parameter when launching the Quick Start. +. Navigate to Settings -> 'Distributed search' menu item as shown below + +image:../images/search-head-distributed-search-menu.png[distributed_search_menu,width=850,height=294,link="../docs/images/search-head-distributed-search-menu.png"] +[start=3] +. Click on "Search peers" + +. A screen similar to the screenshot below indicates that distributed search in good standing. (This example was created with a 4 node indexer cluster.) + +image:../images/search-head-distributed-search-success.png[distributed_search_success,width=850,height=202,link="../docs/images/search-head-distributed-search-success.png"] + +==== Verify Indexer Replication Status +. Begin by logging into {partner-product-name} cluster master to verify all of the indexers are successfully replicating buckets across the cluster. To log into the {partner-product-name} cluster master, navigate your browser to the URL shown in the CloudFormation Outputs labeled "ClusterMasterURL" with the credentials of "admin" and the password configured with the "SplunkAdminPassword" parameter when launching the Quick Start. +. Navigate to Settings -> 'Indexer clustering' menu item as shown below + +image:../images/indexer-clustering-menu.png[indexer_clustering_menu,width=850,height=294,link="../docs/images/indexer-clustering-menu.png"] +[start=3] +. A screen similar to the screenshot below indicates that both the search factor and replication factor are in good standing. (This example was created with a 4 node indexer cluster across 2 AZ) +.. _Please note that it will likely take a few minutes after the Quick Start has successfully launched before the buckets are replicated and this status window shows both search factor and replication factor being met. If there are errors for replication and/or search factor after 10 minutes, please see the link:#_faq[FAQ section] below._ + +image:../images/cluster-master-sfrf-met.png[indexer_clustering_success,width=850,height=202,link="../docs/images/cluster-master-sfrf-met.png"] + +== Security +// Provide post-deployment best practices for using the technology on AWS, including considerations such as migrating data, backups, ensuring high performance, high availability, etc. Link to software documentation for detailed information. + +The {partner-product-name} Quick Start exposes three user-configurable security group access parameters: 'WebClientLocation', 'HECClientLocation', and 'SSHClientLocation'. Be sure that the 'SSHClientLocation' parameter is accessible only on tightly controlled authorized network ranges as this allows direct access to the instances. The parameter 'WebClientLocation' allows connections to the {partner-product-name} web interfaces, while 'HECClientLocation' controls access to the load balancer in front of the {partner-product-name} HTTP Event Collector listener. diff --git a/docs/deployment_guide/partner_editable/architecture.adoc b/docs/deployment_guide/partner_editable/architecture.adoc new file mode 100644 index 0000000..0d16a15 --- /dev/null +++ b/docs/deployment_guide/partner_editable/architecture.adoc @@ -0,0 +1,25 @@ +:xrefstyle: short + +Deploying this Quick Start for a new VPC with default parameters builds the following {partner-product-name} environment in the AWS Cloud. +[#architecture1] +.Quick Start architecture for {partner-product-name} on AWS +[link=images/splunk-enterprise-architecture-on-aws.png] +image::../images/splunk-enterprise-architecture-on-aws.png[Architecture,width=648,height=439] + +As shown in <>, the Quick Start sets up the following: + +* A VPC configured across two or three Availability Zones, depending on your selection. The Quick Start provisions one public subnet in each Availability Zone. +* Two Elastic Load Balancing (ELB) load balancers: one to load-balance HTTP web traffic to the search head instances, and the other to load-balance HTTP event traffic destined for the Splunk HTTP Event Collector (HEC) across all indexer instances. +* An IAM user with fine-grained permissions for access to AWS services necessary for the initial deployment process. +* Appropriate security groups for each instance or function to restrict access to only necessary protocols and ports. +* Amazon Simple Storage Service (Amazon S3) bucket for Splunk SmartStore usage. +* In the public subnets, EC2 instances for {partner-product-name}, including the following: +** {partner-product-name} indexer cluster with the number of indexers you specify (3-10), distributed across the number of Availability Zones you specify (2 or 3). The Splunk receiver (splunktcp) and Splunk HEC are enabled across all indexers. +** Splunk search head(s), either stand-alone or in a 3-node cluster, based on your input during deployment. In the latter case, the search heads are distributed across the number of Availability Zones you specify. +** Splunk license server and indexer cluster master, co-located. +** Splunk search head deployer, where applicable. + + +If you decide to deploy Splunk Enterprise into your existing VPC, please see link:#_deployment_options[deployment options] later in this guide. The Quick Start assumes that the infrastructure components already exist, and deploys Splunk Enterprise into the environment you specify. + + diff --git a/docs/deployment_guide/partner_editable/deployment_options.adoc b/docs/deployment_guide/partner_editable/deployment_options.adoc new file mode 100644 index 0000000..49faba6 --- /dev/null +++ b/docs/deployment_guide/partner_editable/deployment_options.adoc @@ -0,0 +1,11 @@ +// There are generally two deployment options. If additional are required, add them here + +This Quick Start provides two deployment options: + +* *Deploy {partner-product-name} into a new VPC (end-to-end deployment)*. This option builds a new AWS environment consisting of the VPC, subnets, security groups, load balancers, and other infrastructure components. It then deploys {partner-product-name} into this new VPC. + +* *Deploy {partner-product-name} into an existing VPC*. This option provisions {partner-product-name} in your existing AWS infrastructure. + +The Quick Start provides separate templates for these options. It also lets you configure Classless Inter-Domain Routing (CIDR) blocks, instance types, and {partner-product-name} settings, as discussed later in this guide. + +For further information about the dimensions of a Splunk Enterprise deployment, see the {partner-product-name} https://docs.splunk.com/Documentation/Splunk/latest/Capacity/DimensionsofaSplunkEnterprisedeployment[capacity planning manual^]. Finally, for additional information specific to an AWS deployment, see {partner-product-name} https://www.splunk.com/pdfs/technical-briefs/deploying-splunk-enterprise-on-amazon-web-services-technical-brief.pdf[AWS tech brief^] for instance sizing considerations. diff --git a/docs/deployment_guide/partner_editable/licenses.adoc b/docs/deployment_guide/partner_editable/licenses.adoc new file mode 100644 index 0000000..0c03d03 --- /dev/null +++ b/docs/deployment_guide/partner_editable/licenses.adoc @@ -0,0 +1 @@ +This Quick Start requires a subscription to the Amazon Machine Image (AMI) for {partner-product-name}, which is available from AWS Marketplace. For subscription instructions, see step 2 under "Subscribe to the {partner-product-name} AMI" in the link:#_deployment_steps[deployment steps]. In addition, to fully utilize the Quick Start environment, a {partner-product-name} license is required. If you do not have one, please contact sales@splunk.com diff --git a/docs/deployment_guide/partner_editable/overview.adoc b/docs/deployment_guide/partner_editable/overview.adoc new file mode 100644 index 0000000..4cc9fe2 --- /dev/null +++ b/docs/deployment_guide/partner_editable/overview.adoc @@ -0,0 +1,3 @@ +This Quick Start provides architectural guidance and step-by-step instructions for a high availability deployment of {partner-product-name} on AWS. The guide addresses common scalability, high-availability, and security considerations for your deployment. + +This guide is intended for a variety of audiences, including IT infrastructure architects, administrators, and DevOps professionals who are planning to implement or extend their Splunk Enterprise deployments on the AWS Cloud. It also provides direct links for viewing and launching AWS CloudFormation templates that assist with automating the deployment diff --git a/docs/deployment_guide/partner_editable/post_deployment.adoc b/docs/deployment_guide/partner_editable/post_deployment.adoc new file mode 100644 index 0000000..e69de29 diff --git a/docs/deployment_guide/partner_editable/pre-reqs.adoc b/docs/deployment_guide/partner_editable/pre-reqs.adoc new file mode 100644 index 0000000..b0751a6 --- /dev/null +++ b/docs/deployment_guide/partner_editable/pre-reqs.adoc @@ -0,0 +1,9 @@ +// If no preperation is required, remove all content from here. +There are two important steps to verify prior to launching this Quick start: + +* Ensure that the SmartStore bucket that is defined in the "SmartStoreBucketName" parameter *does not exist*. This Quick Start will attempt to create that bucket with an appropriate bucket policy. If that bucket already exists, the Quick Start will fail. +* Upload a valid Splunk license to an S3 bucket owned by the user launching the Quick Start. Take note of the bucket name as well as the path to the license file. An example may look something like this: +** Splunk license file is named "splunk.license" and uploaded to an S3 bucket called "my-s3-bucket" under the 'directory' called "license" +*** Parameter "SplunkLicenseBucket" should be configured to: my-s3-bucket +*** Parameter "SplunkLicensePath" should be configured to: license/splunk.license (note the lack of a leading "/" on the license path) + diff --git a/docs/deployment_guide/partner_editable/pre_deployment.adoc b/docs/deployment_guide/partner_editable/pre_deployment.adoc new file mode 100644 index 0000000..c225957 --- /dev/null +++ b/docs/deployment_guide/partner_editable/pre_deployment.adoc @@ -0,0 +1,49 @@ +// We need to work around Step numbers here if we are going to potentially exclude the AMI subscription +=== Sign in to your AWS account + +. Sign in to your AWS account at https://aws.amazon.com with an AWS Identity and Access Management (IAM) user role that has the necessary permissions. For details, see link:#_planning_the_deployment[Planning the deployment] earlier in this guide. +. Make sure that your AWS account is configured correctly, as discussed in the link:#_technical_requirements[Technical requirements] section. + +// Optional based on Marketplace listing. Not to be edited +ifdef::marketplace_subscription[] +=== Subscribe to the {partner-product-name} AMI + +This Quick Start requires a subscription to the Amazon Machine Image (AMI) for {partner-product-name} in AWS Marketplace. + +. Sign in to your AWS account. +. {marketplace_listing_url}[Open the page for the {partner-product-name} AMI in AWS Marketplace], and then choose *Continue to Subscribe*. +. Review the terms and conditions for software usage, and then choose *Accept Terms*. + + A confirmation page loads, and an email confirmation is sent to the account owner. For detailed subscription instructions, see the https://aws.amazon.com/marketplace/help/200799470[AWS Marketplace documentation^]. + +. When the subscription process is complete, close AWS Marketplace without further action. *Do not* provision the software from AWS Marketplace, as the Quick Start deploys the AMI for you. +endif::marketplace_subscription[] +// \Not to be edited + +=== Launch the Quick Start + +NOTE: You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using this Quick Start. For full details, see the pricing pages for each AWS service used by this Quick Start. Prices are subject to change. + +. Sign in to your AWS account, and choose one of the following options to launch the AWS CloudFormation template. For help with choosing an option, see link:#_deployment_options[deployment options] earlier in this guide. + +[cols=",] +|=== +|https://fwd.aws/MNRVe[Deploy {partner-product-name} into a new VPC on AWS^] +|https://fwd.aws/DD3gQ[Deploy {partner-product-name} into an existing VPC on AWS^] +|=== + +WARNING: If you’re deploying {partner-product-name} into an existing VPC, make sure that your VPC has at least two subnets in different Availability Zones for the indexers and search head(s), and that the subnets aren’t shared. If you choose to deploy into three AZ, then your VPC will require at least three available AZ with three separate subnets. This Quick Start doesn’t support https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html[shared subnets^]. + +Each deployment takes about {deployment_time} to complete. + +[start=2] +. Check the AWS Region that’s displayed in the upper-right corner of the navigation bar, and change it if necessary. This Region is where {partner-product-name} will be deployed. The template is launched in the {default_deployment_region} Region by default. + +[start=3] +. On the *Create stack* page, keep the default setting for the template URL, and then choose *Next*. +. On the *Specify stack details* page, change the stack name if needed. Review the parameters for the template. Provide values for the parameters that require input. For all other parameters, review the default settings and customize them as necessary. + +// In the following tables, parameters are listed by category and described separately for the two deployment options: + +// * Parameters for deploying {partner-product-name} into a new VPC + +// * Parameters for deploying {partner-product-name} into an existing VPC diff --git a/docs/deployment_guide/partner_editable/product_description.adoc b/docs/deployment_guide/partner_editable/product_description.adoc new file mode 100644 index 0000000..bfcf6dc --- /dev/null +++ b/docs/deployment_guide/partner_editable/product_description.adoc @@ -0,0 +1,7 @@ +This Quick Start deploys {partner-product-name} on the AWS Cloud + +{partner-product-name} is the platform for turning data into doing. By monitoring and analyzing everything from customer clickstreams and transactions to security events and network activity, {partner-product-name} is a scalable and reliable data platform for investigating, monitoring, analyzing and acting on your data. With a full range of powerful search, analysis, alert, and visualization capabilities along with prepackaged content for many typical use cases, users can quickly discover and share insights. + +For more details about the features and functionality of {partner-product-name}, see the https://docs.splunk.com/Documentation/Splunk[Splunk Enterprise documentation^]. + + diff --git a/docs/deployment_guide/partner_editable/regions.adoc b/docs/deployment_guide/partner_editable/regions.adoc new file mode 100644 index 0000000..662f665 --- /dev/null +++ b/docs/deployment_guide/partner_editable/regions.adoc @@ -0,0 +1 @@ +- All AWS Regions diff --git a/docs/deployment_guide/partner_editable/service_limits.adoc b/docs/deployment_guide/partner_editable/service_limits.adoc new file mode 100644 index 0000000..0a5ae89 --- /dev/null +++ b/docs/deployment_guide/partner_editable/service_limits.adoc @@ -0,0 +1,15 @@ +// Replace the in each row to specify the number of resources used in this deployment. Remove the rows for resources that aren’t used. + +|=== +|Resource |This deployment uses + +// Space needed to maintain table headers +|VPCs |1 +|AWS Identity and Access Management (IAM) security groups |2 or more +|IAM roles |2 or more +|Auto Scaling groups |1 +|Classic Load Balancers |2 +|EC2 Instances |5 or more +|EBS Volumes|5 or more +|S3 Buckets |1 +|=== diff --git a/docs/deployment_guide/partner_editable/specialized_knowledge.adoc b/docs/deployment_guide/partner_editable/specialized_knowledge.adoc new file mode 100644 index 0000000..96939ad --- /dev/null +++ b/docs/deployment_guide/partner_editable/specialized_knowledge.adoc @@ -0,0 +1,3 @@ +// Describe or link to specific knowledge requirements; for example: “familiarity with basic concepts in the areas of networking, database operations, and data encryption” or “familiarity with .” + +This Quick Start assumes familiarity with basic concepts of networking and Linux system administration, as well as basic knowledge of {partner-product-name} diff --git a/docs/deployment_guide/partner_editable/troubleshooting.adoc b/docs/deployment_guide/partner_editable/troubleshooting.adoc new file mode 100644 index 0000000..fc28704 --- /dev/null +++ b/docs/deployment_guide/partner_editable/troubleshooting.adoc @@ -0,0 +1,6 @@ +// Add any tips or answers to anticipated questions. This could include the following troubleshooting information. If you don’t have any other Q&A to add, change “FAQ” to “Troubleshooting.” + +== FAQ +*Q.* Why is my search factor and/or replication factor not being met? + +*A.* The most common reason for this is the cluster replication or search factor is set higher than the minimum indexers in a site. For example, if you create a 5 node cluster across two sites, you will have 3 indexers in site1, and 2 indexers in site2. In this example, if you also configured RF and/or SF = 3, Splunk will not be able to meet the required replication or search factor. (RF or SF = 3, but you only have 2 indexers in site2) For further reading, this topic is outlined in https://docs.splunk.com/Documentation/Splunk/8.1.2/Indexer/Bucketreplicationissues#Multisite_cluster_does_not_meet_its_replication_or_search_factors[Splunk documentation^]. diff --git a/submodules/quickstart-aws-vpc b/submodules/quickstart-aws-vpc deleted file mode 160000 index ac8786c..0000000 --- a/submodules/quickstart-aws-vpc +++ /dev/null @@ -1 +0,0 @@ -Subproject commit ac8786cff8fd030798dc26d6c9566ef730536bd4 diff --git a/templates/splunk-enterprise-master.template b/templates/splunk-enterprise-master.template deleted file mode 100644 index 0ed0c23..0000000 --- a/templates/splunk-enterprise-master.template +++ /dev/null @@ -1,577 +0,0 @@ -{ - "AWSTemplateFormatVersion": "2010-09-09", - "Description": "Splunk deployment with indexer, search head clustering and cluster master.", - "Parameters": { - "AvailabilityZones": { - "Description": "List of Availability Zones to use for the subnets in the VPC (logical order preserved). This must match the Number of Availability Zones parameter value.", - "Type": "List" - }, - "NumberOfAZs": { - "AllowedValues": [ - "2", - "3" - ], - "Default": "2", - "Description": "Number of Availability Zones to use in the VPC. This must match your selections in the list of Availability Zones parameter.", - "Type": "String" - }, - "WebClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to connect to the Splunk web interface. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "HECClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to send data to Splunk HTTP Event Collector. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "IndexerInstanceType": { - "AllowedValues": [ - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "c5.2xlarge", - "c5.4xlarge", - "c5.9xlarge", - "c5.18xlarge", - "i3.2xlarge", - "i3.4xlarge", - "i3.8xlarge" - ], - "Description": "EC2 instance type for Splunk Indexers", - "ConstraintDescription": "must be a valid EC2 instance type.", - "Default": "c5.4xlarge", - "Type": "String" - }, - "SearchHeadInstanceType": { - "AllowedValues": [ - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "r4.4xlarge", - "r4.8xlarge", - "r4.16xlarge", - "c5.2xlarge", - "c5.4xlarge", - "c5.9xlarge", - "m5.2xlarge", - "m5.4xlarge", - "m5.12xlarge" - ], - "Description": "EC2 instance type for Splunk Search Heads", - "ConstraintDescription": "must be a valid EC2 instance type.", - "Default": "c5.4xlarge", - "Type": "String" - }, - "IndexerApps": { - "Description": "Comma separated list of URLs of Splunk App (or Add-on) tarballs (.spl) to pre-install on indexer(s)", - "Default": "", - "Type": "CommaDelimitedList" - }, - "SearchHeadApps": { - "Description": "Comma separated list of URLs of Splunk App (or Add-on) tarballs (.spl) to pre-install on search head(s)", - "Default": "", - "Type": "CommaDelimitedList" - }, - "KeyName": { - "ConstraintDescription": "Must be the name of an existing EC2 KeyPair.", - "Description": "Name of an existing EC2 KeyPair to enable SSH access to the instance", - "Type": "AWS::EC2::KeyPair::KeyName" - }, - "PublicSubnet1CIDR": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x.", - "Default": "10.0.1.0/24", - "Description": "The address space that will be assigned to the first Splunk server subnet. (x.x.x.x/x notation)", - "Type": "String" - }, - "PublicSubnet2CIDR": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x.", - "Default": "10.0.2.0/24", - "Description": "The address space that will be assigned to the second Splunk server subnet. (x.x.x.x/x notation)", - "Type": "String" - }, - "PublicSubnet3CIDR": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x.", - "Default": "10.0.3.0/24", - "Description": "The address space that will be assigned to the second Splunk server subnet. (x.x.x.x/x notation)", - "Type": "String" - }, - "QSS3BucketName": { - "Default": "splk-quickstart-testing", - "Description": "S3 bucket name for the Quick Start assets.", - "Type": "String" - }, - "QSS3KeyPrefix": { - "Default": "quickstart-splunk-enterprise/", - "Description": "S3 key prefix for the Quick Start assets.", - "Type": "String" - }, - "SHCEnabled": { - "AllowedValues": [ - "yes", - "no" - ], - "Default": "no", - "Description": "Do you want to build a Splunk search head cluster?", - "Type": "String" - }, - "SSHClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to SSH to the EC2 instances. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "SplunkAdminPassword": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Admin password for Splunk. Must be at least 8 characters containing letters, numbers and symbols", - "MaxLength": "32", - "MinLength": "6", - "NoEcho": "true", - "Type": "String" - }, - "SplunkIndexerCount": { - "ConstraintDescription": "must be a valid number, 3-10", - "Default": "3", - "Description": "How many Splunk indexers to launch. [3-10]", - "MaxValue": "10", - "MinValue": "3", - "Type": "Number" - }, - "SplunkIndexerDiskSize": { - "ConstraintDescription": "must be a valid number, 320-16000", - "Default": "320", - "Description": "The size of the attached EBS volume to the Splunk indexers. (in GB)", - "MaxValue": "16000", - "MinValue": "320", - "Type": "Number" - }, - "SplunkSearchHeadDiskSize": { - "ConstraintDescription": "must be a valid number, 320-16000", - "Default": "320", - "Description": "The size of the attached EBS volume to the Splunk search head(s). (in GB)", - "MaxValue": "16000", - "MinValue": "320", - "Type": "Number" - }, - "SplunkLicenseBucket": { - "Default": "", - "Description": "Name of private S3 bucket with licenses to be accessed via authenticated requests", - "Type": "String" - }, - "SplunkLicensePath": { - "Default": "", - "Description": "Path to license file in S3 Bucket (without leading '/')", - "Type": "String" - }, - "SplunkReplicationFactor": { - "ConstraintDescription": "must be a valid number, 2-4", - "Default": "2", - "Description": "How many copies of data should be stored in the Splunk Indexer Cluster", - "MaxValue": "4", - "MinValue": "2", - "Type": "Number" - }, - "SplunkSearchFactor": { - "ConstraintDescription": "must be a valid number, 2-4", - "Default": "2", - "Description": "How many copies of data should be searchable in the Splunk indexer clusters", - "MaxValue": "4", - "MinValue": "2", - "Type": "Number" - }, - "SplunkClusterSecret": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Shared cluster secret for Search Head and Indexer clusters. Must be at least 8 characters containing letters, numbers and symbols.", - "MaxLength": "32", - "MinLength": "6", - "NoEcho": "true", - "Type": "String" - }, - "SplunkIndexerDiscoverySecret": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Security key used for communication between your forwarders and the cluster master. This value should also be used by forwarders in order to retrieve list of available peer nodes from cluster master. Must be at least 8 characters containing letters, numbers and symbols.", - "MaxLength": "32", - "MinLength": "8", - "NoEcho": "true", - "Type": "String" - }, - "VPCCIDR": { - "AllowedPattern": "(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})/(\\d{1,2})", - "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x.", - "Default": "10.0.0.0/16", - "Description": "The address space that will be assigned to the entire VPC where Splunk will reside. (Recommend at least a /16)", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - } - }, - "Metadata": { - "AWS::CloudFormation::Interface": { - "ParameterGroups": [ - { - "Label": { - "default": "AWS Instance and Network Settings" - }, - "Parameters": [ - "IndexerInstanceType", - "SearchHeadInstanceType", - "KeyName", - "WebClientLocation", - "HECClientLocation", - "SSHClientLocation", - "AvailabilityZones", - "NumberOfAZs", - "VPCCIDR", - "PublicSubnet1CIDR", - "PublicSubnet2CIDR", - "PublicSubnet3CIDR" - ] - }, - { - "Label": { - "default": "Splunk Settings" - }, - "Parameters": [ - "SplunkAdminPassword", - "SplunkClusterSecret", - "SplunkIndexerDiscoverySecret", - "SplunkLicenseBucket", - "SplunkLicensePath", - "SplunkIndexerCount", - "SplunkIndexerDiskSize", - "SplunkSearchHeadDiskSize", - "SplunkReplicationFactor", - "SplunkSearchFactor", - "SHCEnabled", - "IndexerApps", - "SearchHeadApps" - ] - }, - { - "Label": { - "default": "AWS Quick Start Configuration" - }, - "Parameters": [ - "QSS3BucketName", - "QSS3KeyPrefix" - ] - } - ], - "ParameterLabels": { - "AvailabilityZones": { - "default": "Availability Zones" - }, - "NumberOfAZs": { - "default": "Number of Availability Zones" - }, - "WebClientLocation": { - "default": "Permitted CIDR for Splunk web interface" - }, - "HECClientLocation": { - "default": "Permitted CIDR for Splunk HTTP event collector input" - }, - "IndexerInstanceType": { - "default": "EC2 instance type for Splunk indexer" - }, - "SearchHeadInstanceType": { - "default": "EC2 instance type for Splunk search head" - }, - "KeyName": { - "default": "Key Name" - }, - "PublicSubnet1CIDR": { - "default": "Public Subnet 1 CIDR" - }, - "PublicSubnet2CIDR": { - "default": "Public Subnet 2 CIDR" - }, - "PublicSubnet3CIDR": { - "default": "Public Subnet 3 CIDR" - }, - "QSS3BucketName": { - "default": "QuickStart S3 Bucket Name" - }, - "QSS3KeyPrefix": { - "default": "QuickStart S3 Key Prefix" - }, - "SHCEnabled": { - "default": "Enable Search Head Cluster?" - }, - "SSHClientLocation": { - "default": "Permitted CIDR for ssh" - }, - "SplunkAdminPassword": { - "default": "Splunk Admin Password" - }, - "SplunkIndexerCount": { - "default": "No. of Splunk Indexers" - }, - "SplunkIndexerDiskSize": { - "default": "Indexer Disk Size" - }, - "SplunkLicenseBucket": { - "default": "Splunk License Bucket" - }, - "SplunkLicensePath": { - "default": "Splunk License S3 Bucket Path" - }, - "SplunkReplicationFactor": { - "default": "Index Cluster Replication Factor" - }, - "SplunkSearchFactor": { - "default": "Index Cluster Search Factor" - }, - "SplunkClusterSecret": { - "default": "Shared Security Key for Cluster Nodes" - }, - "SplunkIndexerDiscoverySecret": { - "default": "Shared Security Key for Forwarders using Indexer Discovery" - }, - "IndexerApps": { - "default": "Apps/Add-ons to pre-Install on Splunk Indexers" - }, - "SearchHeadApps": { - "default": "Apps/Add-ons to pre-Install on Splunk Search Heads" - }, - "VPCCIDR": { - "default": "VPC CIDR" - } - } - } - }, - "Conditions": { - "Create3AZ": { - "Fn::Equals": [ - { - "Ref": "NumberOfAZs" - }, - "3" - ] - } - }, - "Resources": { - "VPCStack": { - "Type": "AWS::CloudFormation::Stack", - "Properties": { - "TemplateURL": { - "Fn::Sub": "https://${QSS3BucketName}.s3.amazonaws.com/${QSS3KeyPrefix}submodules/quickstart-aws-vpc/templates/aws-vpc.template" - }, - "Parameters": { - "AvailabilityZones": { - "Fn::Join": [ - ",", - { - "Ref": "AvailabilityZones" - } - ] - }, - "CreatePrivateSubnets": "false", - "KeyPairName": { - "Ref": "KeyName" - }, - "NumberOfAZs": { - "Ref": "NumberOfAZs" - }, - "PublicSubnet1CIDR": { - "Ref": "PublicSubnet1CIDR" - }, - "PublicSubnet2CIDR": { - "Ref": "PublicSubnet2CIDR" - }, - "PublicSubnet3CIDR": { - "Ref": "PublicSubnet3CIDR" - }, - "VPCCIDR": { - "Ref": "VPCCIDR" - } - }, - "TimeoutInMinutes": 15 - } - }, - "SplunkStack": { - "Type": "AWS::CloudFormation::Stack", - "Properties": { - "TemplateURL": { - "Fn::Sub": "https://${QSS3BucketName}.s3.amazonaws.com/${QSS3KeyPrefix}templates/splunk-enterprise.template" - }, - "Parameters": { - "VPCID": { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.VPCID" - ] - }, - "VPCCIDR": { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.VPCCIDR" - ] - }, - "PublicSubnet1ID": { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.PublicSubnet1ID" - ] - }, - "PublicSubnet2ID": { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.PublicSubnet2ID" - ] - }, - "PublicSubnet3ID": { - "Fn::If": [ - "Create3AZ", - { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.PublicSubnet3ID" - ] - }, - { - "Fn::GetAtt": [ - "VPCStack", - "Outputs.PublicSubnet2ID" - ] - } - ] - }, - "NumberOfAZs": { - "Ref": "NumberOfAZs" - }, - "IndexerInstanceType": { - "Ref": "IndexerInstanceType" - }, - "SearchHeadInstanceType": { - "Ref": "SearchHeadInstanceType" - }, - "SplunkAdminPassword": { - "Ref": "SplunkAdminPassword" - }, - "SplunkClusterSecret": { - "Ref": "SplunkClusterSecret" - }, - "SplunkIndexerDiscoverySecret": { - "Ref": "SplunkIndexerDiscoverySecret" - }, - "SplunkLicenseBucket": { - "Ref": "SplunkLicenseBucket" - }, - "SplunkLicensePath": { - "Ref": "SplunkLicensePath" - }, - "KeyName": { - "Ref": "KeyName" - }, - "SSHClientLocation": { - "Ref": "SSHClientLocation" - }, - "HECClientLocation": { - "Ref": "HECClientLocation" - }, - "WebClientLocation": { - "Ref": "WebClientLocation" - }, - "SplunkIndexerCount": { - "Ref": "SplunkIndexerCount" - }, - "SHCEnabled": { - "Ref": "SHCEnabled" - }, - "SplunkIndexerDiskSize": { - "Ref": "SplunkIndexerDiskSize" - }, - "SplunkReplicationFactor": { - "Ref": "SplunkReplicationFactor" - }, - "IndexerApps": { - "Fn::Join": [ - ",", - { "Ref": "IndexerApps" } - ] - }, - "SearchHeadApps": { - "Fn::Join": [ - ",", - { "Ref": "SearchHeadApps" } - ] - } - }, - "TimeoutInMinutes": 60 - } - } - }, - "Outputs": { - "SearchHeadURL": { - "Description": "Splunk Enterprise - Search Head URL", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.SearchHeadURL" - ] - } - }, - "ClusterMasterURL": { - "Description": "Splunk Enterprise - Cluster Master URL", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.ClusterMasterURL" - ] - } - }, - "ClusterMasterManagementURL": { - "Description": "Splunk Enterprise - Cluster Master Management URL (required for Indexer Discovery)", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.ClusterMasterManagementURL" - ] - } - }, - "DeployerURL": { - "Description": "Splunk Enterprise - Search Head Cluster Deployer URL", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.DeployerURL" - ] - } - }, - "HttpEventCollectorURL": { - "Description": "HTTP Event Collector URL", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.HttpEventCollectorURL" - ] - } - }, - "HttpEventCollectorToken": { - "Description": "HTTP Event Collector Token", - "Value": { - "Fn::GetAtt": [ - "SplunkStack", - "Outputs.HttpEventCollectorToken" - ] - } - } - } -} diff --git a/templates/splunk-enterprise.template b/templates/splunk-enterprise.template deleted file mode 100644 index 756fbe4..0000000 --- a/templates/splunk-enterprise.template +++ /dev/null @@ -1,2704 +0,0 @@ -{ - "AWSTemplateFormatVersion": "2010-09-09", - "Description": "Splunk deployment with indexer, search head clustering and cluster master. QS(5030)", - "Parameters": { - "WebClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to connect to the Splunk web interface. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "HECClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to send data to Splunk HTTP Event Collector. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "IndexerInstanceType": { - "AllowedValues": [ - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "m4.2xlarge", - "m4.4xlarge", - "m4.10xlarge", - "c5.2xlarge", - "c5.4xlarge", - "c5.9xlarge", - "c5.18xlarge", - "i3.2xlarge", - "i3.4xlarge", - "i3.8xlarge" - ], - "Description": "EC2 instance type for Splunk Indexers", - "ConstraintDescription": "must be a valid EC2 instance type.", - "Default": "c5.4xlarge", - "Type": "String" - }, - "SearchHeadInstanceType": { - "AllowedValues": [ - "c4.2xlarge", - "c4.4xlarge", - "c4.8xlarge", - "r4.4xlarge", - "r4.8xlarge", - "r4.16xlarge", - "c5.2xlarge", - "c5.4xlarge", - "c5.9xlarge", - "m5.2xlarge", - "m5.4xlarge", - "m5.12xlarge" - ], - "Description": "EC2 instance type for Splunk Search Heads", - "ConstraintDescription": "must be a valid EC2 instance type.", - "Default": "c5.4xlarge", - "Type": "String" - }, - "IndexerApps": { - "Description": "Comma separated list of URLs of Splunk App (or Add-on) tarballs (.spl) to pre-install on indexer(s)", - "Default": "", - "Type": "CommaDelimitedList" - }, - "SearchHeadApps": { - "Description": "Comma separated list of URLs of Splunk App (or Add-on) tarballs (.spl) to pre-install on search head(s)", - "Default": "", - "Type": "CommaDelimitedList" - }, - "KeyName": { - "ConstraintDescription": "Must be the name of an existing EC2 KeyPair.", - "Description": "Name of an existing EC2 KeyPair to enable SSH access to the instance", - "Type": "AWS::EC2::KeyPair::KeyName" - }, - "NumberOfAZs": { - "AllowedValues": [ - "2", - "3" - ], - "Default": "2", - "Description": "Number of Availability Zones to use in the VPC. This must match the number public subnet IDs entered as parameters", - "Type": "String" - }, - "PublicSubnet1ID": { - "Description": "ID of Splunk public subnet 1 in Availability Zone 1 (e.g., subnet-xxxxxxxx)", - "Type": "AWS::EC2::Subnet::Id" - }, - "PublicSubnet2ID": { - "Description": "ID of Splunk public subnet 2 in Availability Zone 2 (e.g., subnet-xxxxxxxx)", - "Type": "AWS::EC2::Subnet::Id" - }, - "PublicSubnet3ID": { - "Description": "ID of Splunk public subnet 3 in Availability Zone 3 (e.g., subnet-xxxxxxxx)", - "Type": "AWS::EC2::Subnet::Id", - "Default": "" - }, - "QSS3BucketName": { - "Default": "splk-quickstart-testing", - "Description": "S3 bucket name for the Quick Start assets.", - "Type": "String" - }, - "QSS3KeyPrefix": { - "Default": "quickstart-splunk-enterprise/", - "Description": "S3 key prefix for the Quick Start assets.", - "Type": "String" - }, - "SHCEnabled": { - "AllowedValues": [ - "yes", - "no" - ], - "Default": "no", - "Description": "Do you want to build a Splunk search head cluster?", - "Type": "String" - }, - "SSHClientLocation": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "Must be a valid IP range in x.x.x.x/x notation. Use 0.0.0.0/0 for no restrictions.", - "Description": "The IP address range that is allowed to SSH to the EC2 instances. Note: a value of 0.0.0.0/0 will allow access from ANY ip address", - "MaxLength": "19", - "MinLength": "9", - "Type": "String" - }, - "SplunkAdminPassword": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Admin password for Splunk. Must be at least 8 characters containing letters, numbers and symbols.", - "MaxLength": "32", - "MinLength": "6", - "NoEcho": "true", - "Type": "String" - }, - "SplunkIndexerCount": { - "ConstraintDescription": "must be a valid number, 3-10", - "Default": "3", - "Description": "How many Splunk indexers to launch. [3-10]", - "MaxValue": "10", - "MinValue": "3", - "Type": "Number" - }, - "SplunkIndexerDiskSize": { - "ConstraintDescription": "must be a valid number, 320-16000", - "Default": "320", - "Description": "The size of the attached EBS volume to the Splunk indexers. (in GB)", - "MaxValue": "16000", - "MinValue": "320", - "Type": "Number" - }, - - "SplunkSearchHeadDiskSize": { - "ConstraintDescription": "must be a valid number, 320-16000", - "Default": "320", - "Description": "The size of the attached EBS volume to the Splunk search head(s). (in GB)", - "MaxValue": "16000", - "MinValue": "320", - "Type": "Number" - }, - "SplunkLicenseBucket": { - "Default": "", - "Description": "Name of private S3 bucket with licenses to be accessed via authenticated requests", - "Type": "String" - }, - "SplunkLicensePath": { - "Default": "", - "Description": "Path to license file in S3 Bucket (without leading '/')", - "Type": "String" - }, - "SplunkReplicationFactor": { - "ConstraintDescription": "must be a valid number, 2-4", - "Default": "2", - "Description": "How many copies of data should be stored in the Splunk Indexer Cluster", - "MaxValue": "4", - "MinValue": "2", - "Type": "Number" - }, - "SplunkSearchFactor": { - "ConstraintDescription": "must be a valid number, 2-4", - "Default": "2", - "Description": "How many copies of data should be searchable in the Splunk indexer clusters", - "MaxValue": "4", - "MinValue": "2", - "Type": "Number" - }, - "SplunkClusterSecret": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Shared cluster secret for Search Head and Indexer cluster nodes. Must be at least 8 characters containing letters, numbers and symbols.", - "MaxLength": "32", - "MinLength": "8", - "NoEcho": "true", - "Type": "String" - }, - "SplunkIndexerDiscoverySecret": { - "AllowedPattern": "(?=^.{6,255}$)((?=.*\\d)(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[^A-Za-z0-9])(?=.*[a-z])|(?=.*[^A-Za-z0-9])(?=.*[A-Z])(?=.*[a-z])|(?=.*\\d)(?=.*[A-Z])(?=.*[^A-Za-z0-9]))^.*", - "ConstraintDescription": "Must be at least 8 characters containing letters, numbers and symbols.", - "Description": "Security key used for communication between your forwarders and the cluster master. This value should also be used by forwarders in order to retrieve list of available peer nodes from cluster master. Must be at least 8 characters containing letters, numbers and symbols.", - "MaxLength": "32", - "MinLength": "8", - "NoEcho": "true", - "Type": "String" - }, - "VPCCIDR": { - "AllowedPattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\\/([0-9]|[1-2][0-9]|3[0-2]))$", - "ConstraintDescription": "must be a valid IP CIDR range of the form x.x.x.x/x.", - "Description": "VPC CIDR Block (x.x.x.x/x notation)", - "Type": "String" - }, - "VPCID": { - "Description": "VPC ID", - "Type": "AWS::EC2::VPC::Id" - } - }, - "Metadata": { - "AWSAMIRegionMap":{ - "Filters":{ - "SPLUNKENTHVM":{ - "name":"splunk_marketplace_AMI_*", - "owner-alias":"aws-marketplace", - "product-code.type":"marketplace" - } - } - }, - "AWS::CloudFormation::Interface": { - "ParameterGroups": [ - { - "Label": { - "default": "AWS Instance and Network Settings" - }, - "Parameters": [ - "IndexerInstanceType", - "SearchHeadInstanceType", - "KeyName", - "WebClientLocation", - "HECClientLocation", - "SSHClientLocation", - "VPCID", - "VPCCIDR", - "PublicSubnet1ID", - "PublicSubnet2ID", - "PublicSubnet3ID", - "NumberOfAZs" - ] - }, - { - "Label": { - "default": "Splunk Settings" - }, - "Parameters": [ - "SplunkAdminPassword", - "SplunkClusterSecret", - "SplunkIndexerDiscoverySecret", - "SplunkLicenseBucket", - "SplunkLicensePath", - "SplunkIndexerCount", - "SplunkIndexerDiskSize", - "SplunkSearchHeadDiskSize", - "SplunkReplicationFactor", - "SplunkSearchFactor", - "SHCEnabled", - "IndexerApps", - "SearchHeadApps" - ] - } - ], - "ParameterLabels": { - "WebClientLocation": { - "default": "Permitted CIDR for Splunk web interface" - }, - "HECClientLocation": { - "default": "Permitted CIDR for Splunk HTTP event collector input" - }, - "IndexerInstanceType": { - "default": "EC2 instance type for Splunk indexer" - }, - "SearchHeadInstanceType": { - "default": "EC2 instance type for Splunk search head" - }, - "KeyName": { - "default": "Key Name" - }, - "PublicSubnet1ID": { - "default": "Public Subnet 1 ID" - }, - "PublicSubnet2ID": { - "default": "Public Subnet 2 ID" - }, - "PublicSubnet3ID": { - "default": "Public Subnet 3 ID" - }, - "NumberOfAZs": { - "default": "Number of Availability Zones" - }, - "SHCEnabled": { - "default": "Enable Search Head Cluster?" - }, - "SSHClientLocation": { - "default": "Permitted CIDR for ssh" - }, - "SplunkAdminPassword": { - "default": "Splunk Admin Password" - }, - "SplunkIndexerCount": { - "default": "No. of Splunk Indexers" - }, - "SplunkIndexerDiskSize": { - "default": "Indexer Disk Size" - }, - "SplunkSearchHeadDiskSize": { - "default": "Search Head(s) Disk Size" - }, - "SplunkLicenseBucket": { - "default": "Splunk License Bucket" - }, - "SplunkLicensePath": { - "default": "Splunk License S3 Bucket Path" - }, - "SplunkReplicationFactor": { - "default": "Index Cluster Replication Factor" - }, - "SplunkSearchFactor": { - "default": "Index Cluster Search Factor" - }, - "SplunkClusterSecret": { - "default": "Shared Security Key for Cluster Nodes" - }, - "SplunkIndexerDiscoverySecret": { - "default": "Shared Security Key for Forwarders using Indexer Discovery" - }, - "IndexerApps": { - "default": "Apps/Add-ons to pre-Install on Splunk Indexers" - }, - "SearchHeadApps": { - "default": "Apps/Add-ons to pre-Install on Splunk Search Heads" - }, - "VPCCIDR": { - "default": "VPC CIDR" - }, - "VPCID": { - "default": "VPC ID" - } - } - } - }, - "Conditions": { - "Create3AZ": { - "Fn::Equals": [ - { - "Ref": "NumberOfAZs" - }, - "3" - ] - }, - "CreateSingleSearchHead": { - "Fn::Equals": [ - { - "Ref": "SHCEnabled" - }, - "no" - ] - }, - "CreateSHC": { - "Fn::Equals": [ - { - "Ref": "SHCEnabled" - }, - "yes" - ] - }, - "InstallIndexerApps": { - "Fn::Not": [ - { - "Fn::Equals": [ - { - "Fn::Join": [ - "", - { - "Ref": "IndexerApps" - } - ] - }, - "" - ] - } - ] - }, - "InstallSearchHeadApps": { - "Fn::Not": [ - { - "Fn::Equals": [ - { - "Fn::Join": [ - "", - { - "Ref": "SearchHeadApps" - } - ] - }, - "" - ] - } - ] - }, - "ConfigureLicense": { - "Fn::And": [ - { - "Fn::Not": [ - { - "Fn::Equals": [ - "", - { - "Ref": "SplunkLicenseBucket" - } - ] - } - ] - }, - { - "Fn::Not": [ - { - "Fn::Equals": [ - "", - { - "Ref": "SplunkLicensePath" - } - ] - } - ] - } - ] - } - }, - "Mappings": { - "AWSAMIRegionMap": { - "AMI": { - "SPLUNKENTHVM": "splunk_marketplace_AMI_2018-10-16_22_07_36-7b65de6c-5006-4ca2-bd75-fdba95ae5d9d-ami-0d494b5a999e1c49f.4" - }, - "ap-northeast-1": { - "SPLUNKENTHVM": "ami-0db36f11d65f551fb" - }, - "ap-northeast-2": { - "SPLUNKENTHVM": "ami-09c7965888207979b" - }, - "ap-south-1": { - "SPLUNKENTHVM": "ami-07c20db6edfd45f98" - }, - "ap-southeast-1": { - "SPLUNKENTHVM": "ami-0e7b7ca1bdcdd93a6" - }, - "ap-southeast-2": { - "SPLUNKENTHVM": "ami-0c8a4d5bdf83f0df8" - }, - "ca-central-1": { - "SPLUNKENTHVM": "ami-02f085f4514fa7145" - }, - "eu-central-1": { - "SPLUNKENTHVM": "ami-09ce965c3b1a9a1cb" - }, - "eu-west-1": { - "SPLUNKENTHVM": "ami-0fafe9e81915f154e" - }, - "eu-west-2": { - "SPLUNKENTHVM": "ami-060d9e50d310e0ebb" - }, - "sa-east-1": { - "SPLUNKENTHVM": "ami-0dacd4005280936e5" - }, - "us-east-1": { - "SPLUNKENTHVM": "ami-0484972f36720ea7f" - }, - "us-east-2": { - "SPLUNKENTHVM": "ami-04b6874c649721f0a" - }, - "us-west-1": { - "SPLUNKENTHVM": "ami-0377011a3f771e353" - }, - "us-west-2": { - "SPLUNKENTHVM": "ami-0c3e33232b6c07537" - } - }, - "SplunkConfig": { - "dedicated-instance-type": { - "clusterMaster": "c5.xlarge", - "shclusterDeployer": "c5.xlarge" - }, - "shcluster-replication-factor": { - "num": "3" - }, - "labels": { - "cluster": "IndexerCluster", - "shcluster": "SearchHeadCluster" - } - } - }, - "Resources": { - "SplunkSearchHeadSecurityGroup": { - "Type": "AWS::EC2::SecurityGroup", - "Properties": { - "VpcId": { - "Ref": "VPCID" - }, - "GroupDescription": "Enable port 8000 for Splunk web interface, port 8090 for SHC replication, and port 8191 for KV store replication", - "SecurityGroupIngress": [ - { - "IpProtocol": "tcp", - "FromPort": 8000, - "ToPort": 8000, - "CidrIp": { - "Ref": "WebClientLocation" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 8090, - "ToPort": 8090, - "CidrIp": { - "Ref": "VPCCIDR" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 8191, - "ToPort": 8191, - "CidrIp": { - "Ref": "VPCCIDR" - } - } - ], - "Tags": [ - { - "Key": "Application", - "Value": { - "Ref": "AWS::StackId" - } - }, - { - "Key": "Name", - "Value": "SplunkSearchHeadSecurityGroup" - } - ] - } - }, - "SplunkIndexerSecurityGroup": { - "Type": "AWS::EC2::SecurityGroup", - "Properties": { - "VpcId": { - "Ref": "VPCID" - }, - "GroupDescription": "Enable port 9997 for splunktcp input, port 8088 for HEC input, port 514 for tcp/udp input, and port 9887 for data replication", - "SecurityGroupIngress": [ - { - "IpProtocol": "tcp", - "FromPort": 9997, - "ToPort": 9997, - "CidrIp": { - "Ref": "VPCCIDR" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 8088, - "ToPort": 8088, - "SourceSecurityGroupId": { - "Ref": "SplunkHttpEventCollectorLoadBalancerSecurityGroup" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 514, - "ToPort": 514, - "CidrIp": { - "Ref": "VPCCIDR" - } - }, - { - "IpProtocol": "udp", - "FromPort": 514, - "ToPort": 514, - "CidrIp": { - "Ref": "VPCCIDR" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 9887, - "ToPort": 9887, - "CidrIp": { - "Ref": "VPCCIDR" - } - } - ], - "Tags": [ - { - "Key": "Application", - "Value": { - "Ref": "AWS::StackId" - } - }, - { - "Key": "Name", - "Value": "SplunkIndexerSecurityGroup" - } - ] - } - }, - "SplunkSecurityGroup": { - "Type": "AWS::EC2::SecurityGroup", - "Properties": { - "VpcId": { - "Ref": "VPCID" - }, - "GroupDescription": "Enable administrative ports like restricted SSH and management port", - "SecurityGroupIngress": [ - { - "IpProtocol": "tcp", - "FromPort": 22, - "ToPort": 22, - "CidrIp": { - "Ref": "SSHClientLocation" - } - }, - { - "IpProtocol": "tcp", - "FromPort": 8089, - "ToPort": 8089, - "CidrIp": { - "Ref": "VPCCIDR" - } - } - ], - "Tags": [ - { - "Key": "Application", - "Value": { - "Ref": "AWS::StackId" - } - }, - { - "Key": "Name", - "Value": "SplunkSecurityGroup" - } - ] - } - }, - "SplunkHttpEventCollectorLoadBalancerSecurityGroup": { - "Type": "AWS::EC2::SecurityGroup", - "Properties": { - "VpcId": { - "Ref": "VPCID" - }, - "GroupDescription": "Enable port 8088 on ELB for HEC input", - "SecurityGroupIngress": [ - { - "IpProtocol": "tcp", - "FromPort": 8088, - "ToPort": 8088, - "CidrIp": { - "Ref": "HECClientLocation" - } - } - ], - "Tags": [ - { - "Key": "Application", - "Value": { - "Ref": "AWS::StackId" - } - }, - { - "Key": "Name", - "Value": "SplunkHttpEventCollectorLoadBalancerSecurityGroup" - } - ] - } - }, - "SplunkSearchHeadInstance": { - "Type": "AWS::EC2::Instance", - "Condition": "CreateSingleSearchHead", - "CreationPolicy": { - "ResourceSignal": { - "Timeout": "PT60M" - } - }, - "Properties": { - "ImageId": { - "Fn::FindInMap": [ - "AWSAMIRegionMap", - { - "Ref": "AWS::Region" - }, - "SPLUNKENTHVM" - ] - }, - "InstanceType": { - "Ref": "SearchHeadInstanceType" - }, - "KeyName": { - "Ref": "KeyName" - }, - "Tags": [ - { - "Key": "Application", - "Value": { - "Ref": "AWS::StackId" - } - }, - { - "Key": "Role", - "Value": "splunk-search-head" - }, - { - "Key": "Name", - "Value": "search-head" - } - ], - "NetworkInterfaces": [ - { - "GroupSet": [ - { - "Ref": "SplunkSecurityGroup" - }, - { - "Ref": "SplunkSearchHeadSecurityGroup" - } - ], - "AssociatePublicIpAddress": true, - "DeviceIndex": "0", - "DeleteOnTermination": true, - "SubnetId": { - "Ref": "PublicSubnet1ID" - } - } - ], - "BlockDeviceMappings": [ - { - "DeviceName": "/dev/xvda", - "Ebs": { - "VolumeType": "gp2", - "VolumeSize": { - "Ref": "SplunkSearchHeadDiskSize" - } - } - } - ], - "UserData": { - "Fn::Base64": { - "Fn::Join": [ - "", - [ - "#!/bin/bash -v\n", - "# First make cloud-init output log readable by root only to protect sensitive parameter values\n", - "chmod 600 /var/log/cloud-init-output.log\n", - "yum update -y aws-cfn-bootstrap\n", - "export LOCALIP=$(curl -s http://169.254.169.254/latest/meta-data/local-ipv4)\n", - "export INSTANCEID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)\n", - "export SPLUNK_USER=splunk\n", - "export SPLUNK_BIN=/opt/splunk/bin/splunk\n", - "export SPLUNK_HOME=/opt/splunk\n", - "printf '%s\t%s\n' \"$LOCALIP\" 'splunksearch' >> /etc/hosts\n", - "hostname splunksearch\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/web.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/outputs.conf </dev/null)\n", - "export SPLUNK_USER=splunk\n", - "export SPLUNK_BIN=/opt/splunk/bin/splunk\n", - "export SPLUNK_HOME=/opt/splunk\n", - "# remove stale splunkd.log that ships with AMI.\n", - "rm -f $SPLUNK_HOME/var/log/splunk/splunkd.log\n", - "printf '%s\t%s\n' \"$LOCALIP\" 'splunklicense' >> /etc/hosts\n", - "hostname splunklicense\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/web.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/outputs.conf <>$SPLUNK_HOME/etc/system/local/server.conf < /tmp/token\n", - "TOKEN=`sed -n 's/\\ttoken=//p' /tmp/token` && rm /tmp/token\n", - "echo $TOKEN\n", - "mkdir -p $SPLUNK_HOME/etc/master-apps/peer-base-autogenerated/local\n", - "mv $SPLUNK_HOME/etc/apps/splunk_httpinput/local/inputs.conf $SPLUNK_HOME/etc/master-apps/peer-base-autogenerated/local\n", - "# Peer config 2: Enable splunktcp input\n", - "cat >>$SPLUNK_HOME/etc/master-apps/peer-base-autogenerated/local/inputs.conf <> /etc/hosts\n", - "hostname splunk-shc-deployer\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/web.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/server.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/outputs.conf <>$SPLUNK_HOME/etc/shcluster/apps/member-base-autogenerated/local/outputs.conf <> /etc/hosts\n", - "hostname splunksearch\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <$SPLUNK_HOME/etc/system/local/web.conf <>$SPLUNK_HOME/etc/system/local/server.conf <> /etc/hosts\n", - "hostname splunksearch\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <$SPLUNK_HOME/etc/system/local/web.conf <>$SPLUNK_HOME/etc/system/local/server.conf <> /etc/hosts\n", - "hostname splunksearch\n", - "mv $SPLUNK_HOME/etc/passwd $SPLUNK_HOME/etc/passwd.bak\n", - "cat >>$SPLUNK_HOME/etc/system/local/user-seed.conf <$SPLUNK_HOME/etc/system/local/web.conf <>$SPLUNK_HOME/etc/system/local/server.conf <>$SPLUNK_HOME/etc/system/local/user-seed.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/web.conf <>$SPLUNK_HOME/etc/apps/base-autogenerated/local/server.conf <