Tuesday, September 6, 2016

Windows IIS and weird cookie expiration

So the authentication cookies served by your lovely ASP.NET site (whether MVC or WebForms) are mysteriously not taking effect in Google Chrome and Firefox, but are, for whatever reason, working in Internet Explorer and Microsoft Edge.

Did you, by any chance, play with your server's (or dev box's) clock recently?

Turns out that IIS can get "stuck in the future", even after you turn the clock back.

After many hours of wasted time, I came across this - and hopefully my little post here and the keywords in it will help you find it much, much sooner and save you hours:

http://serverfault.com/questions/217343/date-header-returned-by-iis7-is-wrong

In short?  Restart the service called "http".  (net stop http, net start w3svc)  Or reboot.

Restarting just w3svc (which I had already tried) is not enough.

Enjoy all those extra hours of you life you just got back!  :)

Wednesday, August 31, 2016

Two-finger trackpad scroll in Slack Windows desktop app and Gmail

You have a Dell laptop running Windows.

Two-finger scroll works in most websites, but sometimes doesn't in Google Chrome (e.g. in Gmail), and never works in the Slack desktop app.

The solution appears to be here, although note that it did not work for me, but then after a reboot some time later, it worked.  So maybe you'll need to fully shut down Google Chrome and restart it, or restart the entire computer, after making the change.

I am delighted to now be able to scroll easily using two-finger scrolling on the laptop's built-in trackpad, in the Slack desktop app, and in Gmail.

Sunday, January 4, 2015

appendChild loses keyboard focus

Scenario : Multi-user editable task list in a web browser, running as a DHTML app.  Changes made by any operator automatically stream to all other operators.  Thus, the task list is frequently being updated by client-side javascript to show changes that have been made by other operators.

Additionally, each entry in the list has an editable text input field that can receive keyboard focus and allow the operator to write notes.

As the contents of the list change, you're likely ultimately going to be using appendChild or a related DOM-manipulation function to ensure each operator has a realtime view of what other operators are doing as they add and remove entries and drag items around to change their sequence.

Turns out, in Firefox at least, that relocating a DOM element causes it to lose keyboard focus.

So for example, suppose Fred is busily typing a note into the text input field for work item #87, and Sally comes along and drags the same work item to reposition it, before Fred finishes his changes.  If we're not careful, Fred instantly sees the updated list order (which is good), but is frustrated because his typing is suddenly going to dev/null (not literally, but you get idea).  Tip : It is bad, bad user experience to steal the keyboard input focus when the user is not expecting it, and most especially so whilst he's in the middle of typing furiously at full speed!  Talk about a good way to destroy the operator's trust in the computer software system!!!  :o)

The solution is simple : onfocus for each input field, record in a global variable (or elsewhere) which input field currently has the keyboard input focus, and then after doing DOM manipulation that might've caused that input field to lose input focus (and assuming the input field is still relevant - e.g. if Sally deleted the work item, well, sorry Fred, your work is lost anyhows), simply invoke mostRecentlyFocussedElement.focus().

And now, your users take it entirely for granted that a) your application works very well; and b) actions by other operators are seen by all operators instantly but without disrupting the other operators.  As I say, the best software works so well that non-technical users will take it for granted and think nothing of it.  This trick is one trick in your arsenal for accomplishing that.

Friday, December 12, 2014

ASP.NET "page has not been precompiled" after publishing


The file '/bla.aspx' has not been pre-compiled, and cannot be requested.


Yeah, thanks ASP.NET!  The site was most definitely pre-compiled.  This very un-useful error message has myriad causes, but for me, 8 wasted hours later, I discovered that at least this time, it was due to use of NTFS compression on my development computer.

Microsoft invented the NTFS compression scheme, so you'd think they knew how to make products that worked well with it..  Or at worst, give an error message clearly stating that use of NTFS compression is incompatible with whatever you're trying to do at the time.  But no, we get useless error messages like the above.

8 extra hours spent on a website deployment that should've only taken 30 to 60 minutes!  It was enough to have me seriously wondering whether I should join the band of happy Ruby On Rails developers!  But then I suspect they have their fair or unfair share of technology gripes too.

My main gripe is that this was what programming was like 20 years ago - extremely unhelpful error messages, things that should work but don't, and many hours and days of wasted time for no good reason.  It is the 21st century now.  We've made so much progress.  Programming is so much easier - by far - than it's ever been before.  But c'mon, we still have stupid problems like this?  Yes, I know, it's a major advance on how things were, but these vestiges of "the old way" have to go.

And as for the particular project I was working on : an extra full day of work for what should've been a simple deployment, might well have cost me a sale.  Not impressed!

If you've published your website using Microsoft Visual Studio .NET (VS.NET) and you chose the option to precompile, and yet are getting this "has not been pre-compiled" message on the server you deploy to, check to see whether any *.compiled files exist in the website's "bin" folder.  If not, then go back to your development machine, and ensure NTFS compression is disabled for the "obj" directory nested within the top-level website project directory - or whatever other location is hosting the files you're precompiling.

Here's hoping you don't lose 8 hours on this stupid bug!

And thanks to a commenter on this blog for helping me find the problem after many hours of searching.

Thursday, December 11, 2014

ASP.NET, symbolic links, and directory junctions

We like to put new versions of live ASP.NET websites in version-numbered folders.

Hitherto, that involved updating the IIS metabase so that the web site or web application "physical path" would point to the new location.

I thought it might be a little easier to use mklink to create a directory symbolic link or a directory junction with a name that I don't change (e.g. "curver" for "current version"), pointing to whatever is the current website version folder at the time.

It doesn't work.

For directory symbolic links, ASP.NET seems to totally fail to use them properly.  Instead of getting the output of each ASPX page when visiting it in a web browser, I get the ASPX source!

For directory junctions, ASP.NET seems to use them just fine, but at the point you update where the directory junction points to, it's hit & miss whether ASP.NET will notice the change or not.  If you're happy to trigger a restart of the website in IIS, then it works but if you're back to mucking around with IIS (i.e. to trigger the website restart), you might as well stick to updating the "physical path" setting of the website.

Conclusion?  It was worth a try - would've been nice if it worked, but it doesn't.

Wednesday, November 5, 2014

Beware: Android Studio ain't all you need

New dev VM, new client, new Android app to build.  Clean O/S install, so I'll just grab Android Studio beta and I'll have everything I need, right?

Would that it were so simple!

The Android Studio download page sure doesn't make it clear that it's just one of many parts to the full picture, and Google searching reveals little.

Most people, it seems, have installed Android Studio after installing the more traditional Eclipse+SDK combination, and in that context, Android Studio works very well.

But on a new machine, if you just install Android Studio, and try to run it, you get an error message stating that no JRE can be found.  Hmph.  Not all-in-one.  Fair enough, but they could've made a note of it in the download page.

So I download & install the Java JDK+JRE, and now Android Studio starts up & looks beautiful.  Yay!  Until I try to create a new project.  Then it complains that the Android SDK isn't found.

Again Google, I'm fine with you not making the Android Studio installer an all-in-one, but could you at least have made it obvious?  Mention on the Android Studio download page that you'll also need to install the Java JRE and the Android SDK!  Then we won't feel somewhat frustrated by having to waste time figuring how to do what was obvious to you, but not necessarily immediately obvious to every one of us.

And this is the general rule, all we developers can learn from, and a rule I see broken over and over again in computer systems of all shapes and sizes : a cumbersome user experience is ok, IF you explain the steps to the user!  But if you have a cumbersome process and DON'T explain the steps to the user, some users will give up, and most users will be frustrated even if they finally figure it out.  And Android Studio is far from the most egregious example.

So my advice?  New dev box, and you want minimal digital clutter but you also want to keep the installation process simple?  Install Java JDK, then install Android SDK+Eclipse bundle, then follow the Android SDK installation page notes about downloading the latest SDK updates, and finally install the Android Studio.  Certainly, Microsoft Visual Studio installation is very polished and absolutely shines in contrast, but hey, we do finally arrive at a working Android Studio, and whilst it did waste time and mental effort, we're there, so I'm moving on, and leaving this "here be dragons" for all ye subsequent travelers.

Tschus!

Monday, October 20, 2014

Inbox zero Gmail hack

UPDATE : Several major improvements on the following :
  1. Create a Gmail filter for an asterisk inside quotation marks - i.e. :

    "*"

    (but INCLUDE the quotation marks)

    The action for this filter should be to apply a label to new messages.  The label should be something like "aaa new" or "0new" or "0" or whatever you choose.
  2. Why the "aaa" or "0" or similar at the start of the label name?  If you're like me, you have dozens of labels, so much so that only a small set are visible in the default Gmail view.

    They are sorted alphabetically, and so putting "aaa" or "0" or punctuation at the start of the label name, means the label will handily appear at the top of the label list, always readily accessible.

    But do note that there is advantage to this label name being short, because the longer the label name, the less of each email's subject line is visible when skimming through newly received emails.  (Of course, if you view the newly received emails by clicking on the label, Gmail is smart enough to not additionally show that label on each email in the list, but I like to have the flexibility to efficiently use this system both from the dedicated label and from the Priority Inbox, which I love.)
  3. Finally, add a pleasant label color to this new label.
Voila!  Now all newly received emails have a little splash of color, alerting you to their arrival, and now you remove the "aaa new" label to indicate you've seen it.  You still get all the benefits of the approach described in the original article (below), with the added benefit that if you remove the "aaa new" label from a conversation, and then a new message arrives as part of that conversation, voila - the conversation is labeled "aaa new" again, which is exactly what we want!

---

I like the idea of looking at a nice, empty inbox, but in practice I find it almost impossible with the state of email management tools today.

Yes, I can tell you how email should work, and that would result in "inbox zero".

But say we're stuck in 2014 and Gmail is about the best we have, and we like the Priority Inbox and Non-Priority Inbox distinction and we want to leave emails showing as Unread until we actually get around to reading them, ...

... but we also want an easy way to sweep older emails out of the way so we can tell at a glance what has newly arrived?

e.g. once or several times daily batch reviewing of new emails.

My first thought was to make a cool custom Gmail plugin.  Nice, but obviously lots of work.  Very nice, but very lots of work.  I imagined having a divider you could drag up or down to mark the point below which you have reviewed emails and above which are emails you haven't yet seen.

Much simpler, of course, would be to make a Gmail label and have all new mail automatically get that label, and then on your daily or other occasional look in your Gmail, search for "label:inbox label:newarrival", or such like.  Once you've skimmed through the emails and are happy for them to disappear from your "new arrivals - not yet seen" list, you bulk select and remove the label.

Or, even simpler to set up, do what I did just now, and create a label called "seen".  As a once-off setup step, bulk select all thousands of emails cluttering your Inbox, and label them "seen".  Now, when you want to find out what emails are new arrivals, search for "label:inbox -label:seen".  Once you've skimmed through them, and left in the inbox anything you want to read later (hence you don't want to mark it read) or otherwise action later (hence you don't want to "Archive" it, which is the only way to remove it from the Inbox), you bulk select them and add the "seen" label to them.

Voila!  Now you have an email system that actually fits the way you use the system - "inbox" means "I plan or hope or would like to do something about this one day", "unread" means "I plan or hope or would like to read this one day", and "seen" means (drumroll) "I saw this email in the list and have determined that it should stay in the list, but I don't need to see it again when I next check for new emails".  And that leaves stars - those oft-abused little creatures - to actually be used for what we intuitively think a star should represent, which is something special, not something commonplace.  Read/unread, inboxed/archived, seen/unseen are commonplace distinctions, and stars have no business representing them.

And that's how I finally got the blissful peace of an uncluttered email "inbox" that works pretty well, and only took minutes to set up, and is trivially easy to maintain - so easy to maintain that I can even easily catch up again in future if I fall behind due to sickness or travel or whatever!  Nice!  Viva labels!

UPDATE : Of course, what this does not give me is notification of new emails added to previously-seen conversations still in my inbox.  That is a problem, although in my particular case, not too great a problem, because a) emails that are likely to be part of ongoing conversations are likely to end up in the Priority Inbox for me; and b) I like the Priority Inbox and still periodically look through it; and c) when a new email arrives for an existing conversation, that conversation jumps to the top of the Priority Inbox.  Altogether, this means I have a good chance of noticing that an older conversation has jumped atop the list.  (Most of the emails I receive go into Inbox not Priority Inbox.)

Wednesday, August 6, 2014

Issues transitioning ASP.NET website to Windows Server 2012 R2

Background :


Approx. 9 year old ASP.NET website.

Originally ASP.NET 2.0 (or maybe even 1.1?), and upgraded over time to now being ASP.NET 4.0.

Running fine on a Windows Server (2003?).

We decide to virtualize our servers.  The new virtual server is Windows Server 2012 R2.

I copy the ASP.NET files across and lose DAYS trying to get it working.

It was an unexpectedly painful process, with lots of obtuse error messages.

Here are a few of the "gotchas" that got me - and hopefully will help un-got you :

Bye bye DAO & 32-bit mode


Due to its age, the system was using DAO against a Microsoft Access database for part of the system (including integration with a third-party system).

DAO only has a 32-bit version.

For no apparent reason - and I've never had this problem on any other server - but when I put the application pool in 32-bit mode, I would get extremely strange errors I could not resolve.

How did I solve it?

Switch back to 64-bit mode, and modify the database connection string to use Microsoft's "ACE" library instead of DAO.  (Scroll halfway down this article for example connection strings.)

This also requires installing ACE on the server - not installed by default.  (Go here and download AccessDatabaseEngine_x64.exe)

No HTTP Handler For The Request Type 'GET'


This is up there with the weirdest problems I've seen.

Turns out - for no apparent reason - there can somehow end up being a deficiency in the configuration of ASP.NET.  Copying web.config.default over web.config in the .NET Framework config folder magically solved the problem - thanks to these guys for saving me a huge bunch of frustration and time wastage!

Unhandled exceptions only intermittently going in to the Event Log


I wasted a lot of time trying to find details of error messages at the very start of my testing.

The web page returned to me would say that an unhandled exception had occurred and an unhandled exception had occurred in the error handler.

Not very useful, but exception details would sometimes appear in the Event Log.

Here's the big problem : it was highly unreliable.

Sometimes the .NET exception dump would appear in an Event Viewer entry pretty quickly.

Other times it seemed to take minutes.

And other times the error messages never appeared in the log at all.

I could not determine the cause of the inconsistency.

Fortunately, at some point I sufficiently adjusted file permissions to enable my web application's error handler to write its own exception dumps to text files in a log folder, and then with the detailed error messages available immediately after each page hit, I was able to solve the problems much faster.

(The error handler was quite complex and was still triggering its own unhandled exception, but after dumping the primary exception's details to text file.)

SMTP services installation was not obvious to me


I found lots of articles explaining that to use the IIS SMTP server with IIS 7.5, you need to install various things.  I started using IIS so long ago and have done sufficiently little server administration that somewhere along the line I failed to notice that with the design of Windows Server these days I had to add the SMTP server as a feature not as a role.  Why IIS is a role whilst SMTP is not, I don't know and don't intend to bother investigating, but that explains why after quite some minutes poring carefully over the list of installable items, I never saw SMTP.  I had to click "Next" to go from the Roll selection page to the Feature selection page.  That one was kinda-obvious, but it tripped me up, so I mention it in case it helps anyone else.

And I had quite a lot of other pain during the transition process - a process that I had naively imagined in advance might only take an hour or two.  But those are the main ones that stick in my mind.

HTH!

Sunday, July 20, 2014

Using vmrun on Mac OS/X (VMware Fusion)

The skinny :

To use VMware Fusion's vmrun from the command line (i.e. Terminal), you must invoke it with its FULL PATH, even if you are already in the same directory as vmrun lives in.

The fat :

Continuing to prove that VMware is great when it works and quite lousy when it doesn't, get this :

I opened Terminal.

I cd'ed to /Applications/VMware\ Fusion.app\Contents\Library.

I tried to execute "vmrun".

"Command not found"

How can that be?!!  The command is definitely in that directory!

ls -l

Yup - there it is, vmrun, and all users have execute permission.

I lost probably half an hour on this stupid bug.

Turns out that the solution is simple, but horribly inobvious :

You must include the full path to vmrun every time you invoke it, even if you are already in the same directory as it!!!

So instead of bothering to cd to the enclosing directoy, just always use :

/Applications/VMware\ Fusion.app/Contents/Library/vmrun

Note : I tried adding the directory to my PATH to see if that way I could run vmrun just with "vmrun", but it didn't work.

Thursday, July 17, 2014

VMware Fusion Converter VSS issues

VMware is simultaneously both very nice and very frustrating.

I have a 4.5 year old laptop (Sony Vaio Z) running Windows 7 Ultimate, and decided to virtualize it.  Great idea!

VMware Fusion comes with a physical-to-virtual converter.  Piece of cake!

But every time I try, I get the big bad message :

"An Error Occurred

"The VSS snapshots cannot be stored because there is not enough space on the source volumes or because the source machine does not have any NTFS volumes.  Error code: 2147754783 (0x8004231F)."

Thanks VMware!

So here are some of the things I tried that have helped not a bit :
  • I spent a long time clearing stuff off the 147GB C: drive until there was over 10% of the drive free.  Still kept complaining.
  • I disabled my R: drive RAM disk.  It was an NTFS drive, but just in case somehow it was causing trouble, I completely turned off the RAM drive system.  (Note that I had P2V'ed a Windows 8.1 machine with a RAM disk successfully, using the same tool, so this never seemed likely to be the problem.)
  • I suspended BitLocker in case that was somehow interfering (although note that I had P2V'ed a Windows 8.1 machine with BitLocker successfully, using the same tool, so this also seemed unlikely to cause the problem).
  • I adjusted a MaxTokenSize registry setting.
  • I completely disabled "previous versions".
  • I fully enabled "previous versions" (both for my files and for operating system files - i.e. the highest level) and allocated it 10% of the available space.
  • I deleted all existing previous versions.  If you're doing the maths, this means there are roughly 14GB available and allocated to VSS.  So space shortage is not the problem here!
  • I confirmed that there are no other mounted drive letters - I removed all USB sticks and external drives.
  • I confirmed that there are no unmounted volumes on the one internal drive, other than a 15MB one that appears to be a boot volume and is nearly entirely full but I doubt there's anything much I can do about it.
  • I created a new administrative user and tried using that account instead of my normal administrative account when doing the physical-to-virtual conversion.
  • I did a full checkdisk scan on a reboot - i.e. whilst the C: drive was not in use.
  • I rebooted the Mac OS/X computer that was on the receiving end of the process.
  • And of course, throughout the above I rebooted the Windows laptop many times over.
  • I discovered a "bakk" (yes - double 'k') entry in HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProfileList as discussed here, deleted it and rebooted, and same problem (although strangely & interestingly, laptop shutdown and boot times were much improved, or so it seemed to my subjective impression!).
  • I also verified that the other SIDs in that registry key were all valid (using psgetsid from PSTools as described here).

The VSS service was creating error log entries claiming that there is an "Unexpected error calling routine ConvertStringSidToSid" (0x80070539).  This is what led me to wonder if checkdisk might be needed - but that didn't help - and is also what led me to the MaxTokenSize trick linked above, which also didn't help.  However, after deleting that "*.bakk" registry entry, the VSS service has produced no more error messages - yet the error message from the VMware Converter remains the same, blaming VSS.

It's not inspiring that multiple other people online seem to have given up on this one.  (e.g.)

I also report with disappointment that this was not my first unfavourable experience with this supposedly easy physical-to-virtual conversion tool.  About a week ago I converted a Surface Pro 2 (Windows 8.1) physical to virtual prior to sending it in for servicing.  I also had a lot of trouble then, although finally managed to get it to work.  Two bad experiences out of two attempts.  Relatively useless documentation.  Sadly, this is my experience of VMware so far : It is awesome when it works, and an extreme pain when it doesn't, which is far too often.

VMware Fusion PC Migration Assistant requires HFS

The skinny :

The VMware Fusion PC Migration Assistant must have an HFS-formatted drive as the destination for the physical-to-virtual conversion.

The fat :

Thanks VMware for the helpful error messages - not!

Here's the error message I got trying to convert a four-and-a-half-year-old laptop to a virtual machine :

"VMware Fusion was unable to share a folder to receive your migrated pc"

Hmmm.

Retry.

Same problem.

Google.

An obtuse comment, which leads me to suspect... voila!

I was trying to convert the physical machine into a virtual machine on an exFAT drive.

Try again, converting it to an HFS drive for later copying to the exFAT destination - problem solved!

Friday, July 11, 2014

VMware Fusion on exFAT

The skinny :

VMware Fusion wastes 30 seconds of your life accomplishing apparently absolutely nothing every time you start or resume-from-disk a virtual machine on an exFAT volume.

There appears to be no workaround.

The fat :

I love virtualization.  And the more I use it, the more I love it.

It has come a long way.

I remember 12 years ago giving up in frustration when I tried to virtualize my entire software development environment.

The big issue back then was the storage system.

Now with so many so-awesome SSDs to choose from, virtualization is a pleasure.

I'm running my virtualized software development environment with I'd guess about a 10-20% performance penalty, vs the literally 200-2000% performance penalty I was experiencing 12 years ago.

And since computers are generally so fast these days, 10-20% performance penalty largely translates into no significant difference at all.

Mac & PC

I happen to be a dual-mode man.  Surface Pro 2 256GB (love it!), and Mac Mini quad-core i7 16GB RAM.  I mainly do Windows stuff, and prefer the more extensive range of keyboard shortcuts in Windows for maximum productivity (whereas with Mac you are forced to keep moving your hand back to the mouse/trackpad whether you like it or not).  But I'm very comfortable and proficient in both environments.

I wonder, could I...  Get an external SSD and put my virtual machines on it.  Then, using VMware Fusion on the Mac and VMware Player or Workstation in Windows, I can run my virtual machines on the faster more powerful Mac Mini when inside, whilst still being able to take my work on the road and run exactly the same VMs on the Surface Pro 2.

Great idea!

But so many snags.

First off, you are going to encrypt that external SSD, right?  I mean, nobody puts sensitive data on an unencrypted external storage device I hope?  (Other than government departments of course - but who expects competence from them?)

Problemo : Windows has BitLocker, and Mac has FileVault, and ne'er the twain shall meet!

And whilst you can get cool third-party utilities to read+write Mac disk format from Windows, and likewise to read Windows disk format from Mac, none of these utilities support encrypted volumes.  Major problem!  Looks like we're scuttled right at the git go!

Well, there is TrueCrypt of course.  It's discontinued, there are question marks over its actual security level, and it's open-source, which leaves one wondering whether it might just go ahead and destroy all your data mysteriously and irrecoverably due to some strange previously-unencountered bug (or worse yet a known bug that has been languishing in the support queue for years, as happens sometimes with open-source and even commercial products).

But, TrueCrypt appears to be the only strong contender.  After all, we need something cross-platform, and that alone rules out a bunch of options.  And whilst performance and reliability have to be assessed, we do know that TrueCrypt has zillions of users, so we take the punt that it'll do the job well - of course making regular VM backups just in case.

Next snag : Filesystem?  I end up opting for exFAT, because it is natively supported in read+write mode by both Windows and OS/X.

Score!  My VMs run fast, and yes, I can transfer the external SSD back & forth between Mac Mini and Surface Pro 2 and it all works!

At this point, I'm super-excited.

However, I'm bothered by something.

It seems that every time I build a VM on the Mac Mini, then run it on the SP2, then take it back to the Mac Mini, there is a strange 30 second delay at the very start of booting the VM.

I Google - no answers.

It's been frustrating me around a month now, but I finally found the answer.

It has nothing directly to do with whether the VM is in the "Shared Virtual Machines" vs "Virtual Machines" folder, and nothing directly to do with running the VM on the Windows host.

It seems to be wholly & solely the VM being on an exFAT volume.

I can take the VM that has the 30 second delay at the very start of the boot process, copy it to a native Mac partition, and it boots immediately without the 30 second delay.

I tried some configuration tweaks that seemed unlikely to help, and indeed they didn't help.

My conclusion?  Lovely conceptually as it is to be able to share VMs twixt Mac & Windows via this external SSD, it's proving all told a little on the painful side.  Not hugely painful, but having to connect the SSD, run TrueCrypt, mount the TrueCrypt volume, use VMs, unmount the TrueCrypt volume, unmount the SSD - that's a little tedious - and now add that there is an absolute waste of 30 seconds of your life at the very outset of every VM boot (and I tend to be starting & stopping VMs a lot throughout the day), and it gets a little frustrating.

The VMs once running run just fine, so it's clearly something VMware could fix.

But I found no-one else anywhere else mentioning the same problem, so I doubt it's even on VMware's radar.

I'll stick with the system for now - it does work - but I'm thinking of changing to a setup where both the Mac and the SP2 have a full copy of all VMs, on their native filesystems with their native full-disk-encryption technologies, and using any of the zillions of backup / file-replication utilities out there so that when I run the VM on one and shut it down, any changes get copied across to the other copy of the same VM.  If that works, then I'll have a truly blissful and hassle-free experience of using the same VMs on two different machines, one being an OS/X host and the other being a Windows host.

The big problem then will simply be storage space disparity.  I might end up paying the small fortune to get a 512GB Surface Pro 2 or 3, just so I can fit everything.  Or else I might use an external SSD just for the less-frequently-used VMs.  Or I might augment the SP2's storage with an external SSD encrypted with BitLocker and formatted with NTFS and used only by the SP2.

The short of it?  VMware Fusion runs VMs off exFAT partitions just fine, but for no apparent reason will waste 30 seconds of your life every time you boot a VM, at the very start of the boot process, before even the VMware Fusion logo pops up on the VM screen.  Please fix it, VMware!

P.S. The problem does not occur with VMware Workstation / Player - i.e. on the Windows host, the 30 second boot delay does not occur.  It is only a problem with VMware Fusion.

P.P.S. I'm using VMware Fusion 6 Professional (paid) and VMware Workstation 10 (trial), about to change to the latter being VMware Player Plus (using the VMware Player Plus license that comes free with VMware Fusion 6 Professional).

Saturday, April 26, 2014

Surface Pro 2 "System Interrupts" high CPU

The Surface Pro 2 is excellent hardware, but the software lets it down in various ways.

All told, it's still the best Windows machine I've ever owned, but it definitely needs a lot more work.

Here's a weird thing I hit today : I was losing around 15%-25% CPU on "System" and "System Interrupts".

I had installed c. 1.5GB of updates in the last several days - maybe that caused it?

Hmmm - there was one other thing I changed, this morning.  Maybe that caused it?

I changed it back - and the problem went away!

So : if your Surface Pro 2 runs fine after a reboot, but is wasting a lot of CPU (and hence slashing battery runtime to just an hour or two) with "System" and "System Interrupts" after putting the machine to sleep and then waking it up, there is a chance it might have something to do with this :

This morning, I went into Device Manager and disabled "Allow this device to wake the computer" in the "Power Management" tab in the Device Properties for each of the two "Mice and other pointing devices".  (I suspect one was the touchscreen and the other the Type Cover's trackpad, but they both simply showed as "HID-compliant mouse".)

I had already - weeks or months prior - done the same for the Keyboards, but that had seemed to have no effect at the time.

What I was trying to accomplish was have it that any accidental keypresses or mouse movements would not wake the device from sleep.  I wanted to know that only pressing the power button, or perhaps the Windows button, would wake it.

I at last had that behavior!  When I had only disabled wake-the-computer for the keyboards but not the mice, the keyboard would still wake the device.  I guess that because the Type Cover has both keyboard and mouse together, I must've needed to disable the wake-the-device option for both or else power would remain to both and both would remain able to wake the device.

So this morning I was very happy for a short while, because no action on the Type Cover would wake the device.  Just what I wanted!  But I quickly discovered serious side-effects.  nircmd no longer worked to turn the screen off.  And this "System" and "System Interrupts" high CPU usage bug!!!

I lost a few hours trying to get things working, and finally realized the "System" and "System Interrupts" high CPU usage might've been a strange side-effect from disabling the allow-to-wake-computer options for those two mice.  I reverted that setting, and voila - nircmd resumed working and the "System" and "System Interrupts" problem went away without even a reboot!

Don't ask me how to fix the problem in your case, and don't ask me why changing that particular setting would have such seemingly unrelated side-effects, but if you're desperately searching for clues, my case adds a few more.  I hope it helps someone!

Monday, October 14, 2013

phoneSWIPE, PanopticSecurity, myPCI, PCI compliance

phoneSWIPE is cool, so you get one.

Then you get this email from "PanopticSecurity" on behalf of "North American Bancard", telling you that you need to complete a PCI compliance questionnaire.

The very first page of the questionnaire asks you what kind of credit card processing system you're using.  At the moment, phoneSWIPE is not even listed on the page.  Anywhere.

So you take a stab at it, and end up going through a tedious and time-wasting questionnaire with loads of questions you're pretty sure don't even apply.

Finally at the end, PantopticSecurity helpfully tells you that you require quarterly external "network scans" which they can oh so helpfully do for just $60 a year.  But if you did your homework before you joined phoneSWIPE, you knew that phoneSWIPE encrypts the cardholder data on the swiper and you shouldn't need network scans.

I had a frustrating time trying to complete the questionnaire, and a frustrating time with their text chat staff, who initially sent me down the wrong track.

What they told me in the end is that if you use phoneSWIPE on a cell phone running over 3g or 4g (i.e. not running via ADSL, cable internet, or some other wired or wireless shared internet connection), then at the very start of the process you need to say you have a dial-up credit card processing system.  Dial-up.  Yeah, like an Android 4.2 phone with a sophisticated phoneSWIPE audio port dongle with built-in encryption is dial-up.  But that's what they told me.

They also told me that if you dare actually ever use your office wifi for credit card processing, you do have to go through the ridiculously long questionnaire with a zillion questions that seem entirely irrelevant and which ends with them absolutely insisting you must spend the $60 annually for external network monitoring.  I suspect it's a rip-off, but I'll end my investigations here since at least I've determined that rip-off is inapplicable in my case.

Chat transcript, to shame Panoptic Security for making such a confusing system.  (I'll give them points for a) the politeness of the text chat operator, even if they at least twice were clearly not paying attention to what I said; and b) for a few things in their questionnaire that make it clear they're trying to make it less onerous ------- but unfortunately they need to do a WHOLE LOT BETTER at least when it comes to phoneSWIPE customers.)

[Natasha] Hi, my name is Natasha on the PCI DSS Program Help Desk. How can I help you today?

[Me] This is an extremely confusing questionnaire. We have a phoneSWIPE device, but it is not in the list of options to choose from at the outset of the questionnaire.
[Me] So I tried to answer the questions as best I could, and now I'm being asked a gadzillion questions that I'm pretty sure are irrelevant.

[Natasha] is your phone swipe connected to your wifi or 4g network?

[Me] 3g Verizon network
[Me] For example, I've just come to this one : "Since your payment applications do handle sensitive authentication data, are processes in place to securely delete the data and to verify that the data is unrecoverable?" Um, no actually, I was told that the cardholder data is encrypted within the phoneSWIPE device, meaning that there is no way anything on my Android phone could ever decrypt it. It goes encrypted from the phoneSWIPE device over to the back-end processing systems. So why is this question assuming that my "payment applications DO handle sensitive authentication data"?

[Natasha] Is that the phone internet?

[Me] 3g Verizon network is the internet the phone uses, if that's what you're asking
[Me] We also have a wifi network that we leave off all the time, except that if Verizon coverage is not good enough, we turn it on just for the phone. There are no other devices on that wireless network.
[Me] It's extremely confusing trying to answer the questions in this questionnaire - they seem to presuppose a setup entirely different from our own.

[Natasha] As you use the Verizon you need to complete the questionnaire that has been assigned to you today.  If you find the question difficult you can call our help desk we do have agents that are here to assist you with completing the process today

[Me] So when I come across questions that presuppose things that simply aren't true, am I supposed to just flip a coin which way I answer?
[Me] Also, is there any reason why phoneSWIPE wasn't listed on the very first screen, where you select the technology you're using? phoneSWIPE wants us to believe they're big and important - but their non-existence on that list implies YOU think they're basically irrelevant. Are they really that small a player? If so, I should probably ditch them. If not, then list them on the main page so people like me can have more confidence the questionnaire is appropriately tailored to our situation.

[Natasha] You can answer yes to them questions.
[Natasha] They are in the process of updating that onto the portal but as for at the moment if your phone swipe is connected to your wireless then you need to click on standard internet terminal and if it is not the you need to click on standard dial up terminal .

[Me] Thanks for your comments. I'll keep muddling through the questionnaire. Have a great day!

[Natasha] Your welcome, same to you.

(long time passes)

[Me] If you happen to still be there, I've gotten to the end of the process and it's told me I "need" a network scan, costing $60 a year. I believe this conclusion to be false.

[Natasha] If you are connected to the internet then yes you will need to run a scan of the yearly cost of $59.

[Me] If I understand it correctly, phoneSWIPE represented that since the cardholder data is encrypted on the swiper and only passes through the computing device encrypted, and is only able to be decrypted on the phoneSWIPE servers which do pass PCI compliance, that there is no way that cardholder data could be compromoised on the computing device (Android phone in this case).
[Me] Further, any IP address the phone is assigned by Verizon changes without notice.

[Natasha] I understand that but as you are connected to your wireless or wifi in the business we need to scan your router.

[Me] Hmmm, but again here I'm not convinced myPCI's questionnaire anticipates our environment. The wifi is OFF ALL OF THE TIME. We turn it on when our device needs internet access _and doesn't have Verizon coverage_. The thing is, we only do credit card swiping in locations we have Verizon coverage. So the wifi is NEVER on when processing credit cards.
[Me] Also, suppose we wanted this "service", what IP address are we supposed to put in the Panoptic sign-up form, given that the we have a dynamic IP address?

[Natasha] Which is why you need to run a scan, I understand it is only turned on when you need to process a payments but you still turn it on and use it in your business for when you process a payments.  We can the firewall built within your router to make sure the firewall has no vulnerabilities in it.  So we need to make sure no one can gain access to the card holder data from the net and no information can be leaked out.

[Me] You misread - it is NEVER turned on when we need to process a payment.
[Me] We only process payments in locations we have Verizon coverage, and in such cases we do not need wifi and our wifi is OFF.

[Natasha] Every internet has a public IP address.  If you Google whatsmyip.org it will provide you with that information you require.
[Natasha] So you only use you phone internet not the business one?

[Me] For credit card processing, we NEVER use the wifi/broadband. We ALWAYS use the Verizon 3g.
[Me] (When we are selling goods & services we are out & about and in Verizon coverage areas.)

[Natasha] In the pre saq you need to click on standard dial up terminal and you will be assigned the correct questionnaire and no scan will be required form you.

[Me] So I just wasted half an hour after you told me "As you use the Verizon you need to complete the questionnaire that has been assigned to you today." I told you the questionnaire seemed inapplicable, and I told you that I use Verizon, and you told me that I had the right questionnaire. Now you tell me otherwise.
[Me] I'd also like to know how any phoneSWIPE user is supposed to figure out that their high-tech card reader plug-in for their Android cell phone is actually a "dial-up terminal". You tell me they're updating the front menu to make that more obvious. I hope they get that updated finished real soon, 'coz otherwise they're wasting a lot of time for a lot of people like me, who end up wasting a lot of time from people like you.

[Natasha] I am sorry you confused me by talking about your wifi in your business.

(Editors' note : I only mentioned wifi because the questionnaire was asking about it.  I knew it was irrelevant!!!)

[Natasha] As we are not based in America I am not familiar with the networks

[Me] Ah - that makes sense.
[Me] ok, thanks for the pointer to SAQ B and hopefully it'll be smooth sailing from here!

[Natasha] I do apologies. It is a less complex questionnaire and you should have no problem with completing the process form here.

[Me] Done - thanks again & have a great day. Over & out.

Friday, May 31, 2013

7+ Taskbar Tweaker is AWESOME

The skinny :

7+ Taskbar Tweaker makes Windows 7 even better.

The two things I can now do that I couldn't previously :
  • Re-arrange the order of items in a stacked taskbar group.
  • See seconds on clock in the system tray!
It does much more besides, but these are the key things for me.

The fat :

I love Windows 7.

7+ Taskbar Tweaker makes it even better.

I'm one of those common-enough-but-not-so-common guys who tends to have ZILLIONS of things open at the same time.

Especially web browsers.

Dragging & dropping tabs around within browser windows is very useful.

And the ability to drag & drop Windows 7 taskbar entries around is very useful.

But I HAVE to use "grouping" or "stacking" on the taskbar, or else I end up with three or four rows of icons.

Some might argue I should use Windows differently than I do.  I say it works very well for me.

But what didn't work so well was that the spatial aspects of the Windows desktop were compromised by the order of items in the stacked / grouped windows.

e.g. open Notepad, enter "Text 1", open another Notepad, enter "Text 2", open another Notepad, and enter "Text 3".  Now suppose you want to refer frequently to "Text 3".  It's third up from the bottom.  Easy enough.

But suppose you're a programmer, and Windows 7 is still not the most reliable beast in the world, and maybe once or twice a month you have Windows Explorer crash on you and restart.  The crash & restart isn't very painful - at least they've smoothed over that process - but now the order of items within the stacked / grouped lists has changed!  Whatever Notepad you happened to have used most recently prior to the Windows Explorer crash & restart, is now at the top of the list.  The order of items in the list is changed to match the somewhat arbitrary z-order of windows at the time the Windows Explorer crash occurred!  Not so useful.

And if like me you have lots of browser windows open (not just lots of tabs within windows - which I also do), then you spend more time than you care to hunting through the list of open windows in any group, trying to find GMail or that project management tool or whatever it is you like.

7+ Taskbar Tweaker resolves this problem, and does more besides.  It downloads quickly, and installs easily, and gives you a very impressive range of customisation options for the Taskbar.

But most importantly for me, it works with Windows 7 64-bit and allows me to relatively-easily change the order of items in any grouped / stacked set of windows, to whatever I want.

Since my taskbar is at the bottom of my screen, I figure it's most efficient to have my most-frequently-accessed browser windows at the bottom of the stack.  Can do.  GMail first, then other very-frequently-accessed management tools.

Voila!  Much less time hunting for things, much more time getting things done.  Swapping between tools or quickly referring to a document is now easier.

And of course this works with my in-house Autosave Notepad, and with PDFs open in Adobe Acrobat, and with Word documents and Excel spreadsheets, and with any other Windows app where you might from time to time end up with a bunch of open documents for reference as you work.

I love it!  Great work whoever you are who wrote 7+ Taskbar Tweaker!

Tuesday, June 26, 2012

GeeMail damaged my data

The skinny :

I don't recommend trying GeeMail.

The fat :

For various reasons, I wanted a standlone GMail app on my Windows 7 laptop.

Specifically, it had to run in its own process - i.e. not simply as another tab in a browser, nor as a browser window that's still part of a larger FireFox or whatever process.  I needed to be able to kill my browser without affecting my GMail.

I found one.  It's called GeeMail.  There appear to be no other options.

I installed it.  When I ran it, it consumed 100% of one core for many minutes.  When it finally loaded, it showed about one screenful of emails all with no subject line.  That's right - no sender, no subject line to see in the list.  Basically a useless list.

It appears there's also no built-in search, which is rather limiting.

But the thing that shocked me most, and made me immediately close it down and stop using it (and therefore I don't know what other features it does or doesn't have) :

Since GeeMail was basically useless when just showing a list of emails with no identifying information in each list entry, I jumped back into my browser to check email.

Guess what?

Roughly a few dozen emails that had been marked Unread, were now all marked Read.

For a moment I thought maybe GeeMail had done that for a great slab of emails.

It appears now it had only done it for roughly a screenful.

But that's a screenful too many.

I'm one of those who use an email's Unread status to flag when action is required.

"The fault is with you - you should learn how to use email properly."  Since when were you the expert who knows how a new technology like email should be used?  Since when was the world so advanced that there was no longer room for variation in how we try to tame the email beast?

Nay, the fault lies squarely with GeeMail.

I don't know how many important emails disappeared from my Inbox, but I fished back at least one.

Fished it back, that is, using the browser-based version of GMail.

And sadly, it is with that browser-based version of GMail that I must remain, at least for now.

Experiments for another day :

* Run GMail on a tablet with a keyboard.  (iPad or Android tablet.)

One downside of this approach is that I still want to separate general browsing from email, so I want any links I click in an email to open in a separate browser.  iPad or Android will do that, but then I'm stuck using mobile versions of browsers, which unfortunately are not suitable for the information processing tasks I perform.

* Try to run two concurrent copies of FireFox - one just for email, one for browsing.

One downside of this approach is that I need to go to a lot more effort to open a link from an email.  Open link, copy URL, paste into other FireFox, close tab that opened in GMail FireFox.  But it would sorta work.

* Run one browser (e.g. Google Chrome) just for GMail, and a different one (e.g. FireFox) just for general browsing.

Again, a lot more effort to open a link from an email, but it would sorta work.

* Write a decent standalone desktop GMail app.  C'mon, iOS and Android have ones, so it must be possible!  Why aren't there others already?  Are there really that few of us who want that feature?

Downside : major time cost.

* Use a standalone email client and download GMail messages via POP.

But the very reason I want to stick with GMail is because I like the way it "thinks".  Its concept of conversations, its concept of tagging, its "Priority Inbox", and the built-in search.  Yes, it can definitely be improved on in various ways.  But switching e.g. to Outlook downloading from GMail would be a retrograde step in these key areas.

In short, there are options, but no good options.

If I built a standalone desktop Windows GMail client that preserves access to the things that make GMail great - and if it worked well - would you use it?

Maybe this would be a good open-source project.

Sunday, June 3, 2012

SD cards unreadable on Windows 7 - Acronis True Image at root of problem

This was a very weird one, and the solution was to disable the Acronis Nonstop Backup Service.

Symptoms : Sony Vaio Z laptop, Windows 7 Ultimate, built-in SD card reader completely stopped recognising SD cards. Made no sense why, but I got around it by using the SD card reader in another machine.

Eventually got frustrated enough with the problem that I spent more time Google-ing, and lo-and-behold, Acronis True Image was the problem. I didn't have to uninstall it - just going in to Local Services and stopping and disabling the Acronis Nonstop Backup Service did the trick. The next SD card I inserted worked perfectly.

Note - in the post I linked to above, people talk about needing to reboot after disabling the Acronis Nonstop Backup Service. This indicates that they changed the startup type to "disabled" without stopping the currently-running copy of the service. i.e. make sure you STOP the service AND disable it from starting again in future. Or if you just disable it without stopping it, then you will need to reboot for the change to take effect.

Many thanks to the folks in the above-linked forum page for providing such a simple yet inobvious solution to such an annoying problem!

Wednesday, January 18, 2012

Magnetic Laundry Balls - glad I didn't buy

It sounded awesome - never use laundry powder (detergent) again - just place these reusable magnetic balls in the washing machine instead.

Claimed to alter the surface tension of the water, making it wash more effectively.

Hmmmm - y'know, sounds cool. I considered buying.

But I Googled for more info, 'coz it did seem, well, pretty extraordinary.

First big clue that something's sus : page after page of search results are almost entirely official websites or resellers.

Y'know, if I'd found such an awesome product and it worked for me, I'd've blogged about it, right? So where are the rave testimonials, not from random unknowns who might be company agents, but on blogs that have loads and laods of reviews - some positive, some negative - demonstrating their impartiality?

In contrast, there are numerous reports that cast these "magnetic laundry balls" in very bad light. You can find them yourself if you dig & dig through pages of Google search results. I'll just link to a few here to help improve their Google rank.

Magnetic laundry ball scam

Magnetic laundry aids and surface tension reduction - a critique

Magnetic laundry scams - not as detailed, but relevant

Buyer beware!

Wednesday, January 11, 2012

Google Apps GMail bug with multiple sign-in and POP3 access

The skinny : Trouble with POP3 or forwarding from one GMail or Google Apps account to another? Make sure you're signed out of all multiple-sign-ins in all browsers for the affected accounts, and don't multiple-sign-in again with the account your trying to get emails from.

The fat : read on...

GMail is a very refined product, but unfortunately, its rare bugs tend to be extremely poorly handled, causing wasted time chasing rabbits hither and thither.

Take my recent challenge of combining a Google Apps email account into my personal GMail account. Should be easy, right? And it did seem so.

I configured my personal GMail account to be able to send as my Google Apps email address - all worked fine.

And I configured the Google Apps email account to auto-forward to my personal email account and delete - and that was working fine too.

Then I discovered a cool new feature in GMail (and the wider world of Google) called "multiple sign-in", making it possible to be concurrently signed in to multiple accounts! Whoohoo! I tried it, but it wasn't as seamless an experience as I'd hoped for, so I decided to just stick with having everything pouring into my personal GMail account.

And the world got pretty quiet.

But hey - it was new year, so I figured everyone was away.

But I did get a report of an email sent to me, that definitely never arrived.

And then another report from a different sender.

Hmmm..........

I logged into my Google Apps email account, and there were 15 emails that had never been forwarded to my personal GMail account!!! How did that happen!!!??!!?!!

I looked at the Google Apps email account's settings, and it had reverted back to not automatically forwarding emails. I corrected that, telling it once again to forward all emails to my personal GMail account.

That's not the end of the story - it's just getting started - but on this matter my educated guess is that GMail automatically disabled the auto-forwarding when that Google Apps email account became enabled for concurrent multiple sign-in. (Whether they would do that generally, or whether they did it because the forward-to email address was associated with the other of the concurrently-signed-in accounts, I don't know. It would be easy enough to test - you could let us know in the comments if you determine either way.)

So now my problem was 15 emails sitting in the one account when I wanted them in the other. I could manually forward each one - not optimal. Or I could try to use POP3 import that I use successfully in GMail for other accounts.

Only, every time I try POP3 import from the Google Apps email account to my personal email account, GMail tells me that the username + password combination is not accepted. Very strange.

I dig around and manage to confirm that pop.gmail.com is the correct POP3 server name even for Google Apps email accounts. So no problem there.

I've definitely set the POP3 port to 995 and set to use encryption. No problem there.

I try some other combinations of settings anyway just in case, but the error messages made it clear they weren't the right answer.

I found the POP3 bulk downloader tool in my personal GMail account, and tried to use that to download the emails from the Google Apps email account. But it just sat there saying "Connecting" for many minutes, until I closed the window. tried again with equal non-success and gave up on that approach.

I found a note about using Captcha Unlock for your GMail account, so I tried to use it for the Google Apps account, just in case that would help, but crazily, it kept telling me that the password I'd enterted was incorrect, even though it was correct. Just in case, I even went ahead and changed the password, which involved entering the current password for verification, and the change password proceeded fine, but even the new password was rejected as incorrect by the Google Captcha Unlock page.

Bizarre! Some Google pages knew my password, but others rejected it. Go figure.

I even tried multiple browsers - same result.

So it was no thanks to useless error messages and processes that totally failed me that I finally found what seems to be the solution.

I document it here for the few travellers encountering the same problem.

The solution? I signed out of all Google accounts in all browsers, and then studiously avoided using the multiple-sign-in feature. That was all it took. When signed in only to my personal GMail account, I was able to easily add a POP3 download from my Google Apps email account, and it worked flawlessly.

No thanks Google for the time wastage, but hey, big thanks still for an in-nearly-all-other-respects AWESOME product. GMail fanboy is me.

Tuesday, December 13, 2011

Google Apps CNAME activation - here be more dragons

It used to be you could create a CNAME record to verify your ownership of a domain name, when setting up a Google Apps account.

To this day, current Google Apps documentation still says you can do it :

Troubleshooting CNAME Records :
There are two reasons to create a CNAME record for Google Apps: verifying domain ownership and customizing a URL.
Dig as you might through the user interface, you'll be offered a way to verify using TXT records, but nada for CNAME records.

Some enterprising folk around 18 months ago figured a workaround.  But even that no longer works.

It seems that Google has quietly - nay silently - axed support for CNAMEs for domain verification.

Whilst still mentioning in current documentation that you can.

So the nontrivial effort I've just gone through getting a CNAME record created by an extraordinarily-slow-to-respond IT department, was a waste.

But not just any kind of waste.  A waste for which Google itself is responsible.

It's one thing to remove a feature.  Sure - I have no problem with that.

After all, it's a free service anyway, so no complaints there.

But at least tell us.

The current documentation which says you can use a CNAME for domain verification, combined with the preponderence of articles throughout the web explaining how to do it, combined with the complete absence of acknowledgement from Google that they've removed the option, combined with (in the first few pages of search results) complete absence of any bloggers like me (that I managed to find) pointing out the omission, was a perfect recipe for getting me - and doubtless many others - to waste time arranging things that Google no longer supports.

Just tell us.

Y'know, a Google blog post or something with all the right keywords : "by the way, kids, we're axing the CNAME option for Google Apps domain name verification".

By not telling us, and especially by failing to properly update your documentation, you've wasted my time, and doubtless that of others.

Not happy.

Not impressed.

What is wrong with a little footnote in your other help pages (the ones that do now mention TXT records), that CNAME records used to be supported but no longer are?

I mean, if I'd come across one official page (as I did - linked above) on the Google site saying "CNAMEs are supported" and another one saying "CNAMEs used to be supported but no longer are", I'd figure the second supersedes the first.  But what's with this insistence on not even mentioning the removal of the CNAME option?

It makes no sense to me, and it is an exercise in providing a bad customer experience.  I'm generally a raving Google fan, but this is certainly one of those big speed bumps you really don't want to be giving even your fans.

Sure, it wouldn't hurt anywhere near so much if there wasn't an unresponsive IT department in the picture, making all DNS changes take hours of wasted time and days of elapsed time.  But at least if Google's information had been more open and accurate about the change of features, I could have ensured we weren't now in for a second round of delay.

The lesson?  When writing documentation, never assume you've correctly updated every place that needs updating.  (Hopefully you have updated everything, but don't assume it.)  Include a note as to the change, so that a) people used to the old system can be less confused; and b) if any bits of doco slipped through the cracks, people will be able to figure out (with the aid of the change note) what information is current vs outdated.

Thus saith the blogger.