From the beginning I knew some UBERAlign users would want to go into power user mode. The UBERAlign Console was designed to allow for easy use for the average Joe. But, there are people out there with the desire, guts, and ability to script and automate that want more. So this post will inform you on two other options for UBERAlign.
Each vAligner is a Ubuntu Linux VM. On the VM is a set of binary files that do all work. One is a startup file for initializing, one is a daemon for accepting new jobs via the REST API, and the final is the actual magic behind the scenes. From the beginning UBERAlign was designed to be run from the command line. In fact back months ago the vSpecialist actually got a copy of this to try out and help me test. So for those that do not want to use the Console here are some reasons and instructions on how to run alignment, reclaim, and alignment+reclaim jobs manually.
Some of the reasons you may want to do this:
So here are the steps:
Now that you have everything attached we are running to run a job. If you run ‘./uberalign’ you will see a printout of the command syntax like what follows:
./uberalign MODE DEVICE [OFFSET] [ID] [NAME]
MODE = The mode you want to run in and is formatted. Syntax: -r:[a|r|s|c]
DEVICE = The hardware device your VMDK is mounted on(normally /dev/sdb): Syntax: /dev/sdb
OFFSET = The target offset you want to align to. This defaults to 2048 sectors if not specified.
ID / NAME = Only useful for the API leave these off or use for logging purposes.
./uberalign –r:a /dev/sdb 2048
Once you run this command the uberalign program will process and log to the screen it’s progress while it works. When it completes, disconnect your VMDK from the vAligner and check your VMDK within a VM. It is as simple as that.
The UBERAlign vAligner comes with a REST API that the UBERConsole uses for managing. While the state machine, orchestration for vSphere, and GUI are all a part of the console; you can still use the vAligner API to integrate into any existing processes you may have. Here is a short guide to the REST API. All data is return in JSON format. The first section explains the API get/put and the second explains the object structure in a pseudo format.
Root Path: http://<valigner IP>/uberalign/api/
Get Current State (GET)
Description: Returns the current state of the vAligner
Get Current Job (GET)
Description: Returns the current job of the vAligner. On first boot this is an rather blank object.
Get All Completed(Historical) Jobs (GET)
Description: Returns an array with all completed jobs. This list will include all jobs still the vAligner was first deployed. Can be useful for historical purposes.
Get Session (GET)
Description: Returns the session lock information. This object contains information on the current lock status of the vAligner.
Lock vAligner (PUT)
Return: string (“true” | “false”)
Description: Used to lock a vAligner for 30 seconds. A locked vAligner will not accept new jobs from another source. Once a job is started it will not accept a new job until idle again. Use this method to maintain a lock on a vAligner while using it. Must specify a unique GUID that must match the GUID in the job ticket. GUID is a string and should be unique and not change for the duration of the session.
Submit New Job Ticket (PUT)
Return: string (“true” | “false”)
Description: Used to submit a new job ticket to the vAligner. A job ticket goes into a queue and is picked up by the daemon <15 seconds. The submitted UAJobTicket must have the same GUID as the lock and a lock must exist. Also the vAligner state must either be in Idle(0) or IdleWithError(9). You can use both the Get Current State and Get Current Job to watch for a job starting. The Current Job returns the UAJob object which will have a Name and ID that will match the UAJobTicket Name and GUID fields you submitted.
Idle = 0,
AlignNoZero = 1,
AlignWithZero = 2,
Simulate = 3,
CheckOnly = 4,
ZeroOnly = 5,
GrowOnly = 6,
IdleWithError = 9
The objects above are simplified from my C# class structure.
This workflow for a job submission would look like this:
I know what some of you are going to say now: “But, Nick – how can I use the API now?”. The answer is provided by the vSpecialist rock-star Clint Kitson in his EMC Community release today. Clint built an awesome example of using Powershell to integrate and control UBERAlign via the REST API. This is so cool because if you already have scripting/code toolsets you use for automation, you can integrate UBERAlign right in. Check out more on this in Clint’ post here.
This is a basic overview and I am sure will probably just lead to more questions . Please feel free to play around with both the CLI and API and post questions/comments below.
.nickPost Categories: EMC, Scripts, Tools, VirtualAppliancesTags: API, CLI, Disk Alignment, Disk Utility, EMC, EMC Corporation, Free, orchestration, REST, scripting, UBER, UBER Tool, VMware, vSpecialists, vSphere