-
Notifications
You must be signed in to change notification settings - Fork 229
Windows Testing
This guide is designed for:
- Testing Mapbox Studio on Windows
- From an OS X machine
- by using the Mapbox Sandbox account.
- 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.
- 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 likem3.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
andStep 4: Add Storage
- For
Step 5: Tag Instance
give the instance a name likeyourname/windows-studio-testing
- Then click
Review and Launch
, thenLaunch
- Get public DNS of the machine
Grab the public DNS via the instance listing:
- Login to machine
- Create a new "RDP Desktop" configuration
- User is
Administrator
andPassword
isPlato1234
(this is pre-configured by https://github.com/mapbox/cfn-ci/blob/windows/ami/cfn-ami-win2012-vs2014.template#L46) - Put the public DNS address into the
PC Name
field - Save the configuration
- Click it to start the 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:
- 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/
- 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 chooseOpen command window here
- Then type
cd c:\
to get to the root of the drive
- Open the
- 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.
- 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
- 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 notterminate
it).
TODO:
- document automated methods refs https://github.com/mapbox/mapbox-studio/issues/1218#issuecomment-76878571