Self-Service Portal

This page presents working with the Weka Self-Service Portal when installing the Weka system in AWS.

Overview

The Weka Self-Service Portal is a planning tool for Weka clusters to meet storage requirements when installing in AWS.

It is possible to start by just entering the capacity required, configuring advanced parameters such as required performance and even provision of a multi-AZ cluster for added reliability.

Each configuration can be immediately deployed as a CloudFormation stack by redirecting to the AWS console.

Note: CloudFormation should only be used for initial deployment. To expand cluster resources, refer to Expanding & Shrinking Cluster Resources.

Once the cluster is deployed:

  1. Refer to Managing the Weka System for getting started with Weka CLI and GUI.

  2. Refer to Performing the First IO to quickly get familiar with creating, mounting and writing to a WekaFS filesystem.

Planning a Cluster

The Self-Service Portal is available at https://start.weka.io. Its main screen is divided into two panes: the left pane, which is used for inputting requirements, and the right pane which displays possible configurations for the defined requirements.

Self-Service Portal Main Screen

As shown in the screen above, configuration options include the total capacity, the desired deployment model and additional performance requirements. For more information about deployment types, refer to Deployment Types.

Deploying a Cluster

Once the configuration to be deployed has been found, click the Deploy to AWS button next to the desired configuration. At this point, it is possible to specify additional options for the deployment, such as adding client instances or selecting the Weka system version to be deployed.

Additional Deployment Options Dialog Box

Once everything is ready to deploy the cluster, click the Deploy to AWS button. This will display the AWS CloudFormation screen with a template containing the configured cluster. **

Note: Before deploying the configuration, check that your AWS account limits allow for the deployment of your selected configuration (it is possible to check your limits under the Limits tab in the EC2 console).

CloudFormation Screen

After clicking the Deploy to AWS button, the AWS CloudFormation screen is displayed, requiring the creation of stacks.

AWS Create Stack Screen

In the Create Stack screen, define the parameters which are specific to your AWS account:

Parameter

Description

Stack name

The name that will be given to the stack in CloudFormation. This name has to be unique in the account.

SSH Key

The SSH-key for the ec2-user that will be used to connect to the instances.

VPC

The VPC in which the Weka cluster will be deployed.

Subnet

The subnet in which the Weka cluster will be deployed.

Define the parameters for Weka cluster configuration:

Parameter

Description

Load-Balancer Type

Load balancer type for serving the cluster UI:

  • Internet Facing sets up the load balancer with a public IP.

  • Internal sets up the load balancer with a private IP address in the selected subnet.

  • No Load Balancer skips load balancer creation, in which case the UI can be accessed through port 14000 of any of the backend instances.

API Token

The API token for Weka's distribution site. This can be obtained at https://get.weka.io/ui/account/api-tokens.

Admin Password

Sets the admin password after the cluster has been created. If no value is provided, the password is set to admin.

Define the following optional parameters if tiering to S3 is desired:

Parameter

Description

New S3 Bucket

The new S3 bucket name to create and attach to the filesystem created by the template. The bucket will not be deleted when the stack is destroyed.

Existing S3 Bucket

The existing S3 bucket name to attach to the filesystem created by the template. The bucket has to be in the same region where the cluster is deployed. If this parameter is provided, the New S3 Bucket parameter is ignored.

Tiering SSD Percent

Sets how much of the filesystem capacity (in percent) should reside on SSD. This parameter is applicable only if New S3 Bucket or Existing S3 Bucket parameters have been defined.

Important Note Concerning Internet Connectivity: Weka deployment requires **internet connectivity. Ensure that there is either a NAT or public subnet, and configure the stack parameters accordingly.

If using a NAT, make sure not to set the load balancer type asInternet Facing.

For public subnets, make sure to select a subnet that has the Enable Auto-Assign Public IPv4 Address setting turned on, or select a subnet that has Internet connectivity.

Once all required parameters have been filled-in, make sure to check the "I acknowledge that AWS CloudFormation might create IAM resources” checkbox at the bottom and click the Create Stack button:

AWS Check Box and Creation Dialog Box

Cluster Deployment Process

The cluster deployment process takes about 10 minutes. During this time, the following occurs:

  1. The AWS resources required for the cluster are provisioned.

  2. The Weka system is installed on each of the instances provisioned for the cluster.

  3. A cluster is created using all backend instances.

  4. All client instances are created.

  5. A filesystem is created using all the available capacity and is mounted on all client instances.This shared filesystem is mounted on /mnt/weka in each of the cluster instances.

Once the deployment is complete, the stack status will be updated to CREATE_COMPLETE. At this point, it is possible to access the Weka system cluster GUI by going to the Outputs tab of the CloudFormation stack and clicking the GUI link (or by http://<backend-host>:14000, if No Load Balancer has been selected).

Visit Managing the Weka System for getting started with Weka CLI and GUI, and Performing the First IO to quickly get familiar with creating, mounting and writing to a WekaFS filesystem.

Note: If the deployment is unsuccessful, see Troubleshooting for how to resolve common deployment issues.