EPAM Cloud Infrastructure

Orchestrator ver. 2.1.15

What’s New

April 2014

CI2WN-S13-15

Version 1.0

EPAM SYSTEMS 2

Content

Content .................................................................................................................................... 2

1. Overview.......................................................................................................................... 3

2. New Features .................................................................................................................. 3

2.1. Load Balancing Service ...................................................................................... 3

2.1.1. Configuring Load Balancing. General Info. ............................................. 3

2.1.2. Configure Balancing ................................................................................ 4

2.1.3. Configure Limits ...................................................................................... 4

2.1.4. Configure Bans........................................................................................ 4

2.1.5. Configure Cache ..................................................................................... 5

2.2. Auto Configuration Audit ..................................................................................... 5

2.3. Services Audit ..................................................................................................... 5

2.4. Deep Dive Analytics Improvements .................................................................... 6

3. Knowledge Base Updates ............................................................................................... 8

3.1. CLI Reference Guide and Quick Reference Card Restructuring ........................ 8

3.2. Other Documentation Updates ........................................................................... 9

3.3. Knowledge Sharing ............................................................................................. 9

4. Feature Requests Processing ....................................................................................... 10

Version History .............................................................................................................. 11

EPAM Cloud Orchestrator 2.1.15 - What's New

3 EPAM SYSTEMS

1. Overview

EPAM Orchestration Framework version 2.1.15 was released on April 26th, 2014.

In this release, we introduce a set of important service updates, improved analytics and

some significant document updates. We would also like to announce the users’ feature

requests processing progress and the growth of our knowledge base.

The full list of changes and brief description of fixed issues bugs can be found in the

‘Release Notes’ document accompanying this paper.

2. New Features

As it was mentioned above, EPAM Cloud Orchestration v.2.1.15 introduces a set of significant

service changes. This includes adding a new Load Balancing service, and introducing new

service management and audit capabilities.

We also expanded the Deep Dive analytics possibilities.

Another important change is total restructuring of CLI Reference Guide, which now represents

CLI commands as grouped in functional sections, for easier search and reference.

You can find the details on the listed features below in this section.

2.1. Load Balancing Service

EPAM Cloud Orchestrator provides the users with a Nginx-based Load Balancing Service

that allows the user to arrange load balancing with a set of CLI commands.

As the other services, Load Balancing Service is activated with or2-manage-service

command:

> or2-manage-service –p <project> -r <region> -s load-balancer

--activate

The command runs a maestro stack that creates and configures a load balancer VM.

2.1.1. Configuring Load Balancing. General Info.

All the Load Balancer configuration actions are performed with or2-load-balancer-config

(or2lbconf) command.

This command allows to set up the following Load Balancer configurations:

Load Balancer server, balancing members, the details on the balancer connections.

User connections and requests limits

IP- and URL-based bans

Caching

For each of these points, there is a specific configuration area, which is to be specified in the

command before you add other configuration parameters.

EPAM Cloud Orchestrator 2.1.15 - What's New

EPAM SYSTEMS 4

2.1.2. Configure Balancing

General balancing settings are set with the --balancing flag:

Below, you can see a set of command examples:

or2lbconf --balancing --instance <instance1> - adds instance1 to

balancing group

or2lbconf --balancing --instance <instance1> --port 2752 - changes

port of instance1 to 2752

or2lbconf --balancing --remove --instance <instance1> - removes

instance1 from group

or2lbconf --balancing --permanent 10 - enables feature: caches 10

connections to hosts

2.1.3. Configure Limits

You can set up the balancer limits with the --limit flag:

or2lbconf --limit --connections --perIp 10 - sets maximum connections

from a unique IP to 10

or2lbconf --limit --connections --perIp 0 - removes the limit by IP

on connections

or2lbconf --limit --requests --total 50 - sets maximum requests per

second to balancer to 50

2.1.4. Configure Bans

The balancer bans are set with the --ban flag:

or2lbconf --ban --ip 192.168.1.1 - adds 192.168.1.1 to banlist

or2lbconf --ban --url /maestro/ - sets /maestro/ to return 403

Forbidden status

or2lbconf --ban --url /maestro/ --status 404 - sets /maestro/ to

return 404 Not found

or2lbconf --ban --remove --ip 192.168.1.1 - removes 192.168.1.1 from

IP banlist

or2lbconf --ban --removeAll --ip - clears IP banlist

NB: When used with --project and –region parameters only, the command displays the

list of the configuration settings applied to the Load Balancer.

EPAM Cloud Orchestrator 2.1.15 - What's New

5 EPAM SYSTEMS

2.1.5. Configure Cache

The caching settings are set with the --ban flag:

or2lbconf --cache --url /images/ --expiration 10 - enables caching on

/images/ with 10 minutes expiration

or2lbconf --cache --url /images/ --remove - removes /images/ caching

or2lbconf --cache --extension jpg --extension gif --expiration 30 -

enables caching on all ".jpg" and ".gif" files with 30 minutes

expiration

or2lbconf --cache --removeAll - disables caching at all

2.2. Auto Configuration Audit

The other new option of the or2audit command is --group ACS property. The command with

this property returns the list of the Auto Configuration events that took place in the specified

period of time (the last 3 days by default). The following response elements are displayed:

Date: the action date and time

User: the user that invoked the action. The user here is always “System”

Action: the action name. There are the following possible actions:

PROCESSED_BY_AUTO_CONFIGURATION: typically invoked when the

user tries to run a new instance

AUTO_CONFIGURATION_STATE_UPDATED: There are three possible

states: STARTED (when the instance is being created), SUCCESS (when an

action is performed without errors), FAILED(when issues during action

execution occur)

Message: A message describing the action details

Instance ID: The ID of the affected instance

Region: Virtualization Region

Project: The project ID

2.3. Services Audit

In this release, we implemented a tool for monitoring the service events. This can be done

with the or2audit command with the --group PROJECT property:

or2audit --group PROJECT

Such command will return the list of the service-related actions, invoked by the users or the

system.

NB: When caching option is activated, Nginx server will return the cached page for

coming requests, even if the VM from where the page was taken, is not available any

more.

EPAM Cloud Orchestrator 2.1.15 - What's New

EPAM SYSTEMS 6

The following response elements are displayed:

Date: The action date and time

User: The user that invoked the action. Can be a Cloud User or System

Action: The name of the performed action, e.g:

|SERVICE_ACTIVATION_STARTED|

Message: The message describing the action details, e.g:

|Service LOAD-BALANCER activation started. See or2audit -s

EPMC-CLONginxServer-d55a2ece command for details.|

Region: The virtualization region

Project: The affected project

2.4. Deep Dive Analytics Improvements

There are two Deep Dive analytics improvements that make the obtained statistics more

customizable for your needs:

Manual scaling allows you to change the analyzed time period. The Scale field is

placed under the main Graph area and covers the whole information on the reviewed

time specified by the Zoom option (one week, two weeks, one month). To see the

details on a smaller time gap, click on the target place on the Scale and drag the

mouse cursor right or left, thus specifying the scope to be viewed:

Figure 1 - Deep Dive Scaling

Graphs Types. Deep Dive graphs representation can be switched between Value

and Percentage. The Value-based graphs are the standard ones, they represent

the values of the selected KPI at different points of time. The Percentage-based

EPAM Cloud Orchestrator 2.1.15 - What's New

7 EPAM SYSTEMS

graphs show the relative difference in percent between a “starting” point and the

other points on the graph.

By default, the “starting” point is the first point on the graph (but you can move it by

dragging in the graph area). It is marked as 0%. The other points show the

percentage difference between them and the “starting” point.

Figure 2 - Percentage-based graph

Re-scaling y-axis allows to switch between two axis modes:

The Axis is limited by the maximum and minimum difference relative to the

“starting” point

The Axis includes the maximum difference between the values on the

graph.

EPAM Cloud Orchestrator 2.1.15 - What's New

EPAM SYSTEMS 8

3. Knowledge Base Updates

In this release, we introduce several significant documentation and knowledge base updates.

3.1. CLI Reference Guide and Quick Reference Card Restructuring

Maestro CLI Reference Guide always contained the list of the existing Maestro CLI

commands, given with descriptions and examples in alphabetical order. This structure had

been convenient until the number of CLI commands started growing fast. As the CLI

possibilities grow, and the new actions and commands appear, the alphabetical structuring of

the guide became awkward, and it took much effort to find a necessary command details,

especially if the user didn’t know the correct spelling of the command.

Therefore, we made a decision to restructure the CLI Reference guide and to group the

commands into logical blocks according to their purpose. We also added theoretical

information and practical tips to each section so that all the necessary information is now near

at hand. The restructured CLI Reference guide contains the following sections:

Getting Started section gives the instructions on how to start working with Maestro

CLI, set credentials and see the regions and projects available for the user.

Working With Instances section lists the commands dealing with the instance

manipulation and info.

Instance Properties section lists the commands dealing with instance properties

Creating Images section gives image-related commands and the instructions on

preparing an instance for image creation.

Security and Connection section describes keys and console commands

Working with Volumes section lists the volume-related command and gives

instructions on volumes mounting and usage.

Working with Checkpoints section lists checkpoint-related commands and tips.

Audit and Billing section gives report, prices and audit-related commands.

Using Tags section lists the tag-related commands

Working with Files section lists files manipulation commands

Automating Infrastructure Manipulation section gives the commands and

recommendations on working with Amazon Cloud Formation and Maestro Stacks.

Services section gives the detailed instructions on working with the services

manipulated via Maestro CLI.

As there are a lot of significant changes in Maestro CLI commands, we updated the Quick

Reference Card by adding the new commands and restructuring it according to the new

structure of the CLI Reference Guide.

EPAM Cloud Orchestrator 2.1.15 - What's New

9 EPAM SYSTEMS

3.2. Other Documentation Updates

We also introduced some changes to the following documents:

Auto Configuration: Box Solutions - Updated browsers versions for Cross-browser for

Cross-Browser Installation

CLI Admin Guide - Updated the command parameters

3.3. Knowledge Sharing

EPAM Private Cloud team keeps on sharing their knowledge and experience with those who

are interested in Cloud technologies. This month, we are glad to introduce three new articles

that appeared in our Cloud Blog:

“AWS Test Drive - Amazon Sandbox” by Oleksandr Molchanov

“Scaling Out Real Project Database with SQL Azure Federations” by Pavlo Revenkov

“Chef in 21 days Part III” by Ievgen Kabanets

These articles will also appear in our Cloud Blog on EPAM Systems web-site an in our

BlogPost blog.

EPAM Cloud Orchestrator 2.1.15 - What's New

EPAM SYSTEMS 10

4. Feature Requests Processing

EPAM Private Cloud team has always been appreciative and attentive to your feedbacks and

suggestions that help us to make our product better. In winter, we announced Feature

Requests collection and voting. The aim was to define which of the possible features are more

essential for you and to add the implementation of these features into our improvements plan.

We are glad to announce that two of the features, suggested by you, are already implemented.

They are:

Cloud Permissions Management

Log Aggregation Service

Private Load Balancer Service

There are also three features that are currently under development:

Infrastructure Improvements (EO-CSA integrgation, Hyper-V hosting)

Push notification via RabbitMQ messaging

Clone VM

We would like to thank all who took part in voting and discussions, and inform you, that there

is still a set of new features to vote for. You can find the poll on this page. Please, note that

you can vote for only one item.

Do not hesitate to leave your comments and suggestions on the mentioned page or mail them

to our Consulting team.

EPAM Cloud Orchestrator 2.1.15 - What's New

11 EPAM SYSTEMS

Version History

Version Date Summary

1.0 March 22, 2014 Initial version is published

Global 41 University Drive Suite 202,

Newtown (PA), 18940, USA

Phone: +1-267-759-9000

Fax: +1-267-759-8989

EU Corvin Offices I. Futó st 47-53

Budapest, H-1082, Hungary

Phone: +36-1-327-7400

Fax: +36-1-577-2384

CIS 9th Radialnaya Street, Building 2

Moscow, 115404, Russia Phone: +7-495-730-6360

Fax: +7-495-730-6361

© 1993-2013 EPAM Systems. All Rights Reserved.