This page is intended to instruct users on how to import a Stingray Traffic Manager ServerTemplate and how to launch servers into a deployment.
Table of Contents
In order to create a high-availability load-balanced web server solution in the cloud, Riverbed has published ServerTemplates that run Stingray Traffic Manager. This is a software load balancer with high reliability that automatically checks the health of your application and decides whether to forward traffic to a particular server based on state of these health checks. Extra functionality (such as SSL-offload) can be provded through the use of additional recipes and through Stingray's Web-based Graphical User Interface.
The conceptual overview diagram (right) illustrates high-level traffic flow. Stingray proxies and load-balances request traffic as it enters the deployment. Once a response is received from the application or web server, it is forwarded back to the original client.
To deploy a Stingray Traffic Manager, take the following steps. If you already have a deployment in mind, skip to the Import a ServerTemplate section.
Create a new Deployment. Later, you will add the Stingray Traffic Manager Server into this Deployment. See Create a New Deployment.
Follow the instructions for Importing a ServerTemplate.
Note: You can find all of the Stingray Traffic Manager ServerTemplates in the Load Balancer category, or by searching for Stingray in the Search field.
Note: In some clouds (Rackspace, for example) the name of the server is used for the hostname of the instance. It is strongly advised to use the server's fully-qualified domain name as the server's name at the time of creation.
The only input that needs to be defined in order to launch a Stingray server is the lb_stingray/password field in the LB_STINGRAY category. The required fields below in the STINGRAY category are automatically filled in by the lb_stingray provider when the instance boots. The lb_stingray/password field can be either a text input or a RightScale credential.
For the pools field in the LB category, you may define only one pool name. This is a known issue, and support for multiple pool names will be added in an subsequent release.
Click on the deployment's Inputs tab. Click Edit and provide values for the following missing Inputs.
|Input Name ||Description ||Example Value|
|LB_STINGRAY/lb_stingray/password||Sets the password for the admin user of the Stingray Traffic Manager admin server.||cred:LB_STINGRAY_PASSWORD|
|LB/lb/pools||Associates this traffic manager with a specific application. This field can only contain a single string.||text:default|
Note: You are strongly encouraged to use a RightScale credential in this field rather that a plain-text password. This is for both for security and ease-of-management reasons.
Click Save when you are done.
You are now ready to launch the Server. Go to the deployment's Servers tab and click the Launch action icon next to the all-in-one Server.
Go to the deployment's Servers tab and launch the database server. When you view the input confirmation page, there should not be any required inputs with missing values. If there are any required inputs that are missing values (highlighted in red), cancel the launch and add the missing values at the deployment level before launching the server again. Refer to the instructions in Launch a Server if you are not familiar with this process.
In a few minutes the server will become operational.
This runbook assumes that you have a least one operational server that has been launched from an imported Stingray Traffic Manager template. The attach and detach functionality provided by the lb_stingray cookbook will automatically associate (or disassociate) your application instances to your load-balancers. If you would like to change the configuration of the load-balancer, or add extra functionality (such as SSL-offload), there are several ways that you can use to administer your Stingray instance:
The Stingray Traffic Manager series ServerTemplates can currently only support one pool input name. This will be fixed in an upcoming release.
Stingray ServerTemplates come with a default iptables configuration that prevents access to the admin UI. Even if you have applied a security group (ec2 only) that allows access, you will also need to run the sys_firewall::setup_rule recipe in order to open port 9090 so that you can access the WebGUI.
To allow access to the Stingray WebUI, follow the steps below.
Once the sys_firewall::setup_rule recipe completes, you should be able to connect to http://<your servers fqdn>:9090 in order to administer your traffic manager. Please locate the appropriate product documentation at Riverbed's Stingray Family Documentation site for detailed usage instructions.
© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.