Menu
Magento on AWS
Quick Start Reference Deployment Guide

Step 3. 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 you will be using in this Quick Start.

  1. Choose one of the following options to launch the AWS CloudFormation template into your AWS account. For help choosing an option, see Deployment Scenarios earlier in this guide.

    Option 1

    Deploy Magento into a new VPC on AWS

    
                                                Quick Start launch button for Magento in new VPC

    Option 2

    Deploy Magento into an existing VPC

    
                                                Quick Start launch button for Magento in existing VPC

    Important

    If you’re deploying Magento into an existing VPC, make sure that your VPC has two private and two public subnets in different Availability Zones with NAT gateways in their route tables, to allow the instances to download packages and software without exposing them to the Internet. You’ll also need the domain name option configured in the DHCP options as explained in the Amazon VPC documentation. You’ll be prompted for your VPC settings when you launch the Quick Start.

    Each deployment takes approximately 25-45 minutes to create, depending on whether you chose to download Magento with sample data in step 2.

  2. Check the region that’s displayed in the upper-right corner of the navigation bar, and change it if necessary. This is where the network infrastructure for Magento will be built. The template is launched in the US West (Oregon) Region by default.

  3. On the Select Template page, keep the default setting for the template URL, and then choose Next.

  4. On the Specify Details page, change the stack name if needed. Review the parameters for the template. Provide values for the parameters that require your input. For all other parameters, review the default settings and customize them as necessary. When you finish reviewing and customizing the parameters, choose Next.

    In the following tables, parameters are listed by category and described separately for the two deployment options:

    Option 1: Parameters for deploying Magento into a new VPC

    View template

    VPC Network Configuration:

    Parameter label Parameter name Default Description
    Availability Zones AvailabilityZones Requires input Choose two Availability Zones that will be used to deploy the components for Magento. The Quick Start preserves the logical order you specify.
    VPC CIDR VPCCIDR 10.0.0.0/16 CIDR block for the VPC to create.
    Private Subnet 1 CIDR PrivateSubnet1CIDR 10.0.0.0/19 CIDR block for the private subnet in Availability Zone 1.
    Private Subnet 2 CIDR PrivateSubnet2CIDR 10.0.32.0/19 CIDR block for the private subnet in Availability Zone 2.
    Public Subnet 1 CIDR PublicSubnet1CIDR 10.0.128.0/20 CIDR block for the public subnet in Availability Zone 1.
    Public Subnet 2 CIDR PublicSubnet2CIDR 10.0.144.0/20 CIDR block for the public subnet in Availability Zone 2.
    Permitted IP range AccessCIDR Requires input IP CIDR for connecting to the Magento instance via SSH. We recommend that you set this value to a trusted CIDR block. For example, you might want to grant only your corporate network access to the software.

    Amazon EC2 Configuration:

    Parameter label Parameter name Default Description
    Key Name KeyPairName Requires input An existing public/private key pair, which allows you to connect securely to your instance after it launches. This is the key pair you created in step 1, when you prepared your AWS account.
    Web Server Cluster Launcher Instance Type WebServerInstanceType m4.large EC2 instance type for web server instances.
    Minimum Number of Web Server Instances WebServerMinSize 1 Minimum number of EC2 instances in the Auto Scaling group of web servers.
    Maximum Number of Web Server Instances WebServerMaxSize 1 Maximum number of EC2 instances in the Auto Scaling group of web servers.
    Desired Number of Web Server Instances WebServerDesiredCapacity 1 Desired number of EC2 instances in the Auto Scaling group before deployment is considered successful.

    Amazon RDS Configuration:

    Parameter label Parameter name Default Description
    DB Storage Size (in GiB) DBAllocatedStorage 16 Size of the MySQL database (in GiB).
    Automatic Upgrade To New MySQL Minor Versions DBAutoMinorVersionUpgrade true Determines whether the DB instance will automatically be upgraded to new MySQL minor versions as they are supported by Amazon RDS. Set to false to disable auto-upgrades.
    DB Backup Retention Period DBBackupRetentionPeriod 7 Number of days for which automatic DB snapshots are retained.
    DB Instance Type DBInstanceClass db.m4.2xlarge DB instance class for Amazon RDS.
    DB Name DBName QuickstartMySQLDB Name of the initial database for the MySQL RDS instance.
    DB IOPS DBIops 1000 Provisioned IOPS for DB storage. Used only when the DBStorageType parameter is set to io1 (that is, when Provisioned IOPS is chosen).
    DB Master Username DBMasterUsername admin User name for the database administrator account.
    DB Master Password DBMasterUserPassword Requires input Password for the database administrator account.
    Enable Multi-AZ Deployment For DB Instance DBMultiAZ true Set to false if Multi-AZ RDS deployment isn’t needed.
    DB Storage Type DBStorageType gp2 Storage type associated with the database instance.

    Amazon ElastiCache Configuration:

    Parameter label Parameter name Default Description
    ElastiCache Automatic Failover ElastiCacheAutomaticFailover true Automatic failover setup. Select false to disable automatic failover.
    ElastiCache Node Type ElastiCacheNodeType cache.m4.large Compute and memory capacity class of the ElastiCache instance.
    Number of ElastiCache Nodes ElastiCacheNodes 2 Number of nodes in the ElastiCache cluster. This must be a value between 2 and 5.

    Magento Configuration:

    Parameter label Parameter name Default Description
    Public DNS Name DNSName Optional DNS name for the Magento site. If you provide a DNS name, you should create an alias for the ELB load balancer after stack creation.
    Administrator First Name AdminFirstName Requires input First name of the Magento site administrator.
    Administrator Last Name AdminLastName Requires input Last name of the Magento site administrator.
    Administrator email AdminEmail Requires input Email of the Magento site administrator.
    Administrator user name AdminUserName Requires input User name of the Magento site administrator.
    Administrator password AdminPassword Requires input Password of the Magento site administrator.
    Email Address to Notify NotificationEmail Requires input Email address to notify if there are any scaling operations.
    Magento Currency MagentoCurrency EUR The currency you’d like to use to display prices in the Magento store.
    Magento Language MagentoLanguage en_US The language you’d like to use for the text that appears throughout the Magento store.
    Magento Timezone MagentoTimezone Europe/Lisbon The time zone setting that specifies the primary market served by the Magento store.
    S3 File Path To Download Magento MagentoReleaseMedia Requires input The full path to the Magento tar.gz file downloaded in step 2, entered as https://s3.amazonaws.com/mybucket/agento.tar.gz-file.
    SSL Certificate ARN SSLCertificateId Optional The ARN of the SSL certificate to use for the web server.

    AWS Quick Start Configuration:

    Parameter label Parameter name Default Description
    Quick Start S3 Bucket Name QSS3BucketName quickstart-reference S3 bucket name for the Quick Start assets. This bucket name can include numbers, lowercase letters, uppercase letters, and hyphens (-), but should not start or end with a hyphen. You can specify your own bucket if you copy all of the assets and submodules into it, if you want to override the Quick Start behavior for your specific implementation.
    Quick Start S3 Key Prefix QSS3KeyPrefix magento/latest S3 key prefix for the Quick Start assets. This prefix can include numbers, lowercase letters, uppercase letters, hyphens (-), and forward slashes (/), but should not start or end with a forward slash (which is automatically added). This parameter enables you to override the Quick Start behavior for your specific implementation.

    Option 2: Parameters for deploying Magento into an existing VPC

    View the template for existing VPC

    VPC Network Configuration:

    Parameter label Parameter name Default Description
    VPC ID VPCID Requires input ID of your existing VPC (e.g., vpc-0343606e).
    VPC CIDR VPCCIDR Requires input The CIDR block for your existing VPC (e.g., 10.0.0.0/16).
    Private Subnet 1 ID PrivateSubnet1ID Requires input ID of the private subnet in Availability Zone 1 in your existing VPC (e.g., subnet-a0246dcd).
    Private Subnet 2 ID PrivateSubnet2ID Requires input ID of the private subnet in Availability Zone 2 in your existing VPC (e.g., subnet-b58c3d67).
    Public Subnet 1 ID PublicSubnet1ID Requires input ID of the public subnet in Availability Zone 1 in your existing VPC.
    Public Subnet 2 ID PublicSubnet2ID Requires input ID of the public subnet in Availability Zone 2 in your existing VPC.
    Permitted IP range AccessCIDR Requires input IP CIDR for connecting to the Magento instance via SSH. We recommend that you set this value to a trusted CIDR block. For example, you might want to grant only your corporate network access to the software.

    Amazon EC2 Configuration:

    Parameter label Parameter name Default Description
    Key Name KeyPairName Requires input An existing public/private key pair, which allows you to connect securely to your instance after it launches. This is the key pair you created in step 1, when you prepared your AWS account.
    Web Server Cluster Launcher Instance Type WebServerInstanceType m4.large EC2 instance type for web server instances.
    Minimum Number of Web Server Instances WebServerMinSize 1 Minimum number of EC2 instances in the Auto Scaling group of web servers.
    Maximum Number of Web Server Instances WebServerMaxSize 1 Maximum number of EC2 instances in the Auto Scaling group of web servers.
    Desired Number of Web Server Instances WebServerDesiredCapacity 1 Desired number of EC2 instances in the Auto Scaling group before deployment is considered successful.

    Amazon RDS Configuration:

    Parameter label Parameter name Default Description
    DB Storage Size (in GiB) DBAllocatedStorage 16 Size of the MySQL database (in GiB).
    Automatic Upgrade To New MySQL Minor Versions DBAutoMinorVersionUpgrade true Determines whether the DB instance will automatically be upgraded to new MySQL minor versions as they are supported by Amazon RDS. Set to false to disable auto-upgrades.
    DB Backup Retention Period DBBackupRetentionPeriod 7 Number of days for which automatic DB snapshots are retained.
    DB Instance Type DBInstanceClass db.m4.2xlarge DB instance class for Amazon RDS.
    DB Name DBName QuickstartMySQLDB Name of the initial database for the MySQL RDS instance.
    DB IOPS DBIops 1000 Provisioned IOPS for DB storage. Used only when the DBStorageType parameter is set to io1 (that is, when Provisioned IOPS is chosen).
    DB Master Username DBMasterUsername admin User name for the database administrator account.
    DB Master Password DBMasterUserPassword Requires input Password for the database administrator account.
    Enable Multi-AZ Deployment For DB Instance DBMultiAZ true Set to false if Multi-AZ RDS deployment isn’t needed.
    DB Storage Type DBStorageType gp2 Storage type associated with the database instance.

    Amazon ElastiCache Configuration:

    Parameter label Parameter name Default Description
    ElastiCache Automatic Failover ElastiCacheAutomaticFailover true Automatic failover setup. Select false to disable automatic failover.
    ElastiCache Node Type ElastiCacheNodeType cache.m4.large Compute and memory capacity class of the ElastiCache instance.
    Number of ElastiCache Nodes ElastiCacheNodes 2 Number of nodes in the ElastiCache cluster. This must be a value between 2 and 5.

    Magento Configuration:

    Parameter label Parameter name Default Description
    Public DNS Name DNSName Optional DNS name for the Magento site. If you provide a DNS name, you should create an alias for the ELB load balancer after stack creation.
    Administrator First Name AdminFirstName Requires input First name of the Magento site administrator.
    Administrator Last Name AdminLastName Requires input Last name of the Magento site administrator.
    Administrator email AdminEmail Requires input Email of the Magento site administrator.
    Administrator user name AdminUserName Requires input User name of the Magento site administrator.
    Administrator password AdminPassword Requires input Password of the Magento site administrator.
    Email Address to Notify NotificationEmail Requires input Email address to notify if there are any scaling operations.
    Magento Currency MagentoCurrency EUR The currency you’d like to use to display prices in the Magento store.
    Magento Language MagentoLanguage en_US The language you’d like to use for the text that appears throughout the Magento store.
    Magento Timezone MagentoTimezone Europe/Lisbon The time zone setting that specifies the primary market served by the Magento store.
    S3 File Path To Download Magento MagentoReleaseMedia Requires input The full path to the Magento tar.gz file downloaded in step 2, entered as https://s3.amazonaws.com/mybucket/agento.tar.gz-file.
    SSL Certificate ARN SSLCertificateId Optional The ARN of the SSL certificate to use for the web server.

    AWS Quick Start Configuration:

    Parameter label Parameter name Default Description
    Quick Start S3 Bucket Name QSS3BucketName quickstart-reference S3 bucket name for the Quick Start assets. This bucket name can include numbers, lowercase letters, uppercase letters, and hyphens (-), but should not start or end with a hyphen. You can specify your own bucket if you copy all of the assets and submodules into it, if you want to override the Quick Start behavior for your specific implementation.
    Quick Start S3 Key Prefix QSS3KeyPrefix magento/latest S3 key prefix for the Quick Start assets. This prefix can include numbers, lowercase letters, uppercase letters, hyphens (-), and forward slashes (/), but should not start or end with a forward slash (which is automatically added). This parameter enables you to override the Quick Start behavior for your specific implementation.
  5. On the Options page, you can specify tags (key-value pairs) for resources in your stack and set advanced options. When you're done, choose Next.

  6. On the Review page, review and confirm the template settings. Under Capabilities, select the check box to acknowledge that the template will create IAM resources.

  7. Choose Create to deploy the stack.

  8. Monitor the status of the stack. When the status is CREATE_COMPLETE, as shown in Figure 5, the Magento cluster is ready.

    Note

    This Quick Start deployment is automated by nested AWS CloudFormation templates. The main template builds the network-related resources first, using the VPC template, and then launches four separate templates for security groups, Amazon ElastiCache, web server instances, and Amazon RDS MySQL. Deleting the main template deletes the entire stack.

    
                        Successful Creation of the Magento Cluster

    Figure 5: Successful creation of the Magento cluster