Skip to content
This repository has been archived by the owner on Dec 3, 2018. It is now read-only.

Windows Testing

Matthew Irwin edited this page Mar 10, 2015 · 7 revisions

How to test Mapbox Studio on Windows

This guide is designed for:

  • Testing Mapbox Studio on Windows
  • From an OS X machine
  • by using the Mapbox Sandbox account.
  1. Install Microsoft Remote Desktop

Download from the app store: https://itunes.apple.com/us/app/microsoft-remote-desktop/id715768417?mt=12

This is like VNC but for windows.

  1. Launch AMI

Signin to Amazon and go to https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-8ce26ce4 to launch this ami-8ce26ce4 machine.

Note: this ami was generated by @yhahn for cfn-ci (https://github.com/mapbox/cfn-ci/blob/e547a0728d7b8eb9b4f4ab50d3b7b294f51ec418/cfn-win.template#L108)

To configure the AMI:

  • Any instance type should be fine, but ideally use an instance type with High network performance like m3.xlarge because you'll be using remote desktop to connect to the instance.
  • Choose Next: Configure Instance Details
  • Accept defaults for Step 3: Configure Instance Details and Step 4: Add Storage
  • For Step 5: Tag Instance give the instance a name like yourname/windows-studio-testing
  • Then click Review and Launch, then Launch
  1. Get public DNS of the machine

Grab the public DNS via the instance listing:

  1. Login to machine

Note: every time you restart this instance you'll need to edit this config with the new ip address but the credentials will stay the same.

Note, for windows ami's not created by cfn-ci the password will be different, but you can fetch it from the AWS console:

  1. Disable enhanced security

Once logged into the machine, disable enhanced security http://blog.blksthl.com/2012/11/28/how-to-disable-ie-enhanced-security-in-windows-server-2012/

  1. Learn your way around
  • By default the Remote Desktop will open in full screen view. It's usually better to disable full screen and instead use scaled mode. Do this by:
  • Choosing Window > Full Screen to disable full screen mode
  • Choosing Window > Scaling to enable scaling mode
  • Hitting the command (or ⌘) toggles between the desktop view and the "start" screen
  • Ctrl or command click may not work to emulate a mouse right-click so use a two-finger tap to bring up contextual menus on windows.
  • There are two ways to open a terminal, one is:
    • Open the File Explorer by clicking on the folder icon pinned to the taskbar
    • Then, within a given directory, press shift + two-finger tap and then choose Open command window here
    • Then type cd c:\ to get to the root of the drive
  • The other way is to use powershell:
    • Click the powershell icon icon pinned to the taskbar
    • Within the powershell terminal type cmd
  • Copy and paste between OSX and the remote desktop should work. If not try rebooting the instance just by shutting it down and restarting it in the AWS console.
  1. Install software and test

You'll likely want to install chrome, download studio, then test.

For more involved testing you can install sublime text for windows. See the gochas below for more tips

Gochas

  • You will see a certificate warning when first connecting via RDP - this is normal
  • Only one person can log into a machine at once using RDP. So, if you get logged out all of a sudden, try logging back in and you'll kick off the person that previously bumped you.
  • Even after modifying the IE security settings I found it impossible to download Google Chrome via IE. The Chrome download pages uses some javascript:void(0) trick that may be the breakage - or politics. Either way my workaround was to 1) download the windows version via my local OS X machine (https://www.google.com/chrome/browser/?platform=win), 2) grab the URL manually from the chrome downloads page (chrome://downloads/), and then copy n paste that into IE.
  • You may need to install software that requires a reboot. No problem: it is safe to restart the instance and the data will be persisted (as long as you just stop the instance and do not terminate it).

TODO:

Clone this wiki locally