One of the keys to Aster’s parallel processing power are Virtual Workers (or v-workers).  V-Workers are the compute and storage units in an Aster cluster, much like AMPS are for Teradata.  In this article, I’ll show you how to easily add another v-worker in a procedure called ‘partition splitting’.  This will double the “parallel computing” of our Aster Express cluster.

With Aster Express, we are showcasing Aster’s features and functionality with only a single Worker node, so we’re limited to what tuning options we have. (If you’re lucky enough to have a very powerful PC with 6GB+ of RAM and at least a quad-core CPU, we’ll have an article soon to show how to add a second Worker to your cluster).  So the default configuration with Aster Express has been only one v-worker on our lone Worker node.  In the following easy steps, we'll go ahead an reconfigure the Aster Express cluster with a second v-worker.   In fact, this step will also be required to leverage some of the SQL-MR components in the Aster analytic library, including the Teradata Aster connector (another article coming soon!).  Hopefully this will again show you how simple the configuration and management of an Aster cluster can be.

Let’s start with the Aster Management Console (AMC) that we’ve already used in our previous tutorials (Aster Express: Getting Started).   Starting at the Admin/Cluster Management screen, which shows us our Queen and Worker nodes, click on the Worker IP address (, which links to the node details screen. 

At the node details screen, you see the Virtual Worker: 1 configuration count.

Now, to increase the number of Virtual Workers, we’ll need to run a configuration script on the Aster Queen node.  To do this, either login to the Queen using an SSH terminal or tool, or simply use the Queen image directly as we’ve done in earlier articles (Using Aster Express: Act 1) and open a GNOME terminal on the Queen’s desktop.

From the command prompt, run the Change Partition Count utility which requires at least one argument: the desired partition count. In our case we will be setting this value to 2.

  /home/beehive/bin/exec/changePartitionCountExec --desiredPartitionCount=2

 You can also use the --help option for a full listing of all the possible options and parameters.

The Aster cluster then reboots automatically as the final step. After this reboot, the partition split is complete.  If the operation fails, you should restart it by re-running command again, using the same parameters you used the first time.

Note that this process may take some time, based on the power of your PC and the amount of data that you may have already loaded onto your Aster cluster.  In my case, the total process took about 15 minutes, so please keep it running until the partition splitting completes and you see a new command prompt in your terminal window. 

Meanwhile, you can go back to the AMC web page and watch the changes that are taking place in your Aster cluster.  Log into the AMC and go to the Node: Partition Map tab to monitor the progress of your partition split. Green squares represent active v-workers (you’ll see a new yellow square when the process first starts). When the number of active v-workers reaches our new partition count, the split is complete.

And going back to the Worker node details screen (clicking on the Worker IP address link), we’ll now see the Virtual Worker count at 2.  Success!  Though, remember to wait for the command on the Queen node to complete – when you see the new command prompt.

Next, we’ll have another Aster configuration tutorial to install the full library of Aster analytic modules.  Until then, be sure to finish the Aster nPath tutorials.  And of course, have fun!

whitestorm2k 2 comments Joined 09/04
20 Aug 2013

Thanks Mike.
Is there any way to reduce/merge existed partitions?

bp186011 2 comments Joined 06/15
26 Oct 2015

"Request to change the partition count is not supported in Aster Express release"
So, it is not allowed to add more vworkers in Aster Express release?

Bo Peng 彭 博 Professional Service

You must sign in to leave a comment.