Monthly Archives: November 2014

Tips for first time book author

I wanted to share the tips while they are fresh on my mind. I’ve been working closely with Packt Publishing. My first book is scheduled for December. A nice Christmas present for myself 🙂

Be a Contributor first. This lets you contribute a chapter before you attempt to write the whole darn book. Even 1 chapter, which should be around 20 – 25 pages, is not a small undertaking. Writing a chapter is much harder than writing a series of blogs. I know a few friends who have tried that and could not pass 1-2 chapters. Yes, they have been blogging for years! By being a contributor, you also get to experience the book publication process. Speaking of process….

Work with a close friend who have published before. The entire process of publication is more complex and longer than you may assume. Working with a good buddy who have gone through the process and have established working relationship with the editor mean you can focus on the content instead of the process. I used the word friend, not acquaintance. It has to be a person you know well, both in personal and professional capacity. You can avoid a lot of pains with a coach 🙂

Certainly, you may skip the points above. I did that (which kind of explains the unnecessary pains I went through). If you do, keep it short. Aim for 100 pages for your first book. The other reason for 100 page is you can always add later. My book started with 100 and ended up at 200, and eventually became 250 after the publisher formatted it. How I wish it was 100 page only! BTW, a publisher may ask you to write for at least 200 pages. That’s not a hard and fast rule.

Once you are ready to be the main author, try to do it alone. Working with multiple authors can have its complication. I know a friend whose book is delayed because a co-author was busy for an extended time. If you need multiple authors, make sure the outline is solid and finalized first. A book has to be very structured and precise, so differences in opinion can occur as there are many details to iron out. It is also hard to have consistent writing style.

Write around 50 pages before you approach a publisher. If you are using that 100-page target, you are half way done! At least complete the first 2 chapters, so you have something to show. A publisher will certainly appreciate real content when assessing the viability of your book proposal to them. It lets them judge better and faster.

Use the publisher template early. This avoids reformatting, and let you visualize what it will look like early. If you are writing for Packt, I can pass you the template. The template helps you to be mindful of keywords and texts that appear on screen. They also have guidelines on quotes and tables. I spent a lot of time on this because I did not use the template.

Give it time. Believe me, you may get sick of reading your own book! After you finish a chapter, leave it for at least 1 week. Come back to read it with a fresher perspective. Do this a few times. You should also read multiple chapters to see if they flow well, avoid any repeated content and ensure the entire structure is completely logical. I call this the process of stabilization. Some may just call it “Soaking It”.

Be clear on the Primary audience and Secondary audience. Virtualization touches a lot of things in IT, so there are many roles that you can target. In my case, the primary audience is VMware engineers, architects and administrators. They may work in VMware, partners or customers. As you know well, a VMware professional deals with many different roles in his/her organization. Do not be afraid to target different Secondary audience in different chapter.

Get reviewer early. But know them well. By knowing the reviewer knowledge and perspective, you can better understand the feedback. A feedback is always contextual, written from the reviewer view point. Know the context, and you can better decide whether you want to include it or not. Choose the wrong reviewers, and you get wrong reviews.

If you are writing about a product (e.g. vSphere), avoid working with versions that are not released yet. Minor details can change, even after a long period of beta. In my case, I have a lot of screenshots and metrics. Reviewing every screenshot and metric to see if there is any change was time consuming.

If English is not your first language, reduce the theory part, and focus on the hands-on part. English is my second language, and those chapters where I focus on the concept were harder to write. I kept rewriting and reshuffling the contents. There were occasion where I shifted an entire sub-chapter!

Decide the writing style. For my case, in my region a lot of readers don’t speak English well. I remember how I myself struggled with basic English when I first learned it. So I’m keeping it simple and conversational. In addition, infrastructure is also a dry topic in my opinion, so I want a light language. I also want to build relationships with readers via my blogs, Facebook and LinkedIn, so the language is very casual and personal. I want you to feel as if I’m talking to you as a friend. I deliberately do not want a written English.

For screenshot, keep the width below 800 pixels. Otherwise, the text will be too small on iPad or 13″ laptop. The length is less of an issue due to the book format. I had to retake quite a number of screenshots.

If you are quoting, ask for permission. Include the exact quotation, and why you’re using it. Assure the owner that you will provide proper acknowledgement.

Hope you find the tips useful. Feel free to add or correct in the comments section below.

vRealize Operations 6: Configuration Management

A much welcomed enhancement in vRealize Operations 6 is on the area of Configuration Management. This is part of an on-going effort to bring the VCM functionalities into the vRealize Operations platform. vR Ops does not have the full VCM capability. It focuses on the vSphere environment. So no Guest OS level configuration management.

There are 3 default dashboards, which comes with the standard installation. You can customise it, which I will show in this blog. The first dashboard shows the VM configuration, shown below:

VM

The above dashboard is actually pretty long; notice the scroll bar. The second dashboard shows the ESXi configuration, shown below:

ESXi

You can configure the date rate. In the above screenshot, I’ve selected the date range from one of the widget. The 3rd dashboard covers the Cluster, shown below:

Cluster

Ok, it only has 4 widgets, while my screen is a full HD resolution. So let’s go and customise it. I will add another widget. I’m curious to know which of my ESXi does not have MS AD authentication configured. I will add a widget that shows the distribution.

The first step is to go and edit the dashboard. A large dialog box, shown below, pops up. As you can see, having a full HD screen helps 🙂

Cluster 2

From the Widget List area, I chose a View widget. A blank View widget is shown below

Cluster 3

From here, I can actually use an existing View, as you can see from the screenshot below. However, I want to show that you can create your own. I clicked the green + icon.

Cluster 4

The View dialog box below popped up, guiding me in the View creation. I’ve named is “Host AD Integration”

Cluster 5

I clicked Step 2, and chose Distribution. I selected Pie Chart as I wanted to see ratio. I chose “Discrete” as the distribution.

Cluster 6

I moved on to Step 3. I chose Host since I want to display how many hosts do not have the AD authentication.

Cluster 7

In Step 4, I saw the familiar metric groups. Now, this is where the new feature comes in. Remember that most of these metrics are about performance counter. They are not about configuration. So how do we show the configuration metrics? Can you notice something new on the screen?

Cluster 8

Yes, there is that little button. I showed it below, highlighted with an arrow (my drawing is bad, using Windows Snipping Tool). I clicked on it, and voila, the metric group changes! Now you see a lot of things that are configuration related! I have selected the AD authentication metric, as you can see the line is highlighted.

Cluster 9

From here, it’s about configuring a View widget as usual. So let’s just proceed and complete it.

I chose the “Preview Source”. The dialog box below popped up, allowing me to choose. I chose the World object as I wanted to see across vCenter Servers. You can choose a specific cluster if you want it too.

Cluster 91

I closed the dialog box, and you can see below I got the preview already. You can click on the refresh icon on the top corner, as highlighted below.

Cluster 92

We are basically done configuring the View object, now we need to add it back to the Dashboard. I closed the wizard, and got the following screen. You can see my newly created View has been added to the View repository. This will enable other users to use it. Nice!

Cluster 93

Before you the Save button, do not forget to choose the “Self Provider’ radio button, as shown below. This means this widget is not getting its value defined by other Widget. Another word, no interaction required.

Cluster 94

I saved the dialog box, and was taken back to the Dashboard edit wizard. The new View widget is now showing properly.

Cluster 95

At this junction, it’s a matter of saving it, and we got back to the main screen. That’s all folks!

Cluster 96

Part 4: vRealize Operations – It’s done!

In Part 3, we have added 3 vCenters and data started being collected. Now that is all setup, let’s see some of the screenshots!

Notice that there is now a configuration functionality. This is a simplified version of what’s available in the VCM product. It has been ported here, which makes life a little simpler.

49b

This is one of the most famous dashboards of vRealize Operations. Look at it carefully. Can you notice what’s been added and what’s been removed? There are subtle changes, which again makes the product better.

49c

This is the new Diagnose dashboard. I’ve chosen a VM. Its relationship to the ESXi and datastore is shown. Which folder it is residing is also shown.

49d

That’s it for now. Happy playing of vRealize Operations! Find out more here.