With so much focus on open source software in my co-op job, sometimes I forget that there are people out there who don't use Linux or Mac (UNIX). There are people using Windows who might encounter our tutorial and want to give it a go. So I've redesigned a portion of the AWS (Amazon Web Services) tutorial to split into two different sections, one for Windows users and one for UNIX users.

recognizing_windows_users_1

The section in question is one where the user has to set up an SSH session to connect to their running AWS instance. Windows users get the short stick with this part. UNIX users can just type a command in and bam, they're connected. For some reason, Microsoft doesn't include an SSH program in Windows, so they have to set up a program called PuTTY which emulates this. Luckily, once PuTTY is set up, it functions very similarly to how most Windows programs function, providing users with a nice GUI instead of making them use commands. But the program has some tricky parts to set up.

I have broken down the process of using PuTTY to connect to an AWS instance as much as possible and provided a screenshot for every step. Amusingly, my tutorial is even more up to date than AWS's official PuTTY setup tutorial.

recognizing_windows_users_2

Hopefully, with documentation like this, users will feel welcome in trying out our framework. :)

Note: This was originally posted on the blog I used for my co-op term while at Seneca College (mswelke.wordpress.com) before being imported here.