Skip to content
This repository has been archived by the owner on Mar 30, 2024. It is now read-only.

Latest commit

 

History

History
39 lines (27 loc) · 2.47 KB

windows.md

File metadata and controls

39 lines (27 loc) · 2.47 KB
Raw

Windows Support

Documentation for getting aws-okta working with Windows.

Environments where aws-okta works under Windows basically fall into 2 categories: Native Windows and Windows Subsystem for Linux (WSL). Note that your home directory in WSL and your home directory in Native Windows are not the same! Changes you make in WSL will not be reflected outside of WSL and vice versa.

Native Windows

Native Windows includes Windows shells/environments that execute Windows binaries and use the standard Windows filesystems available in Explorer. aws-okta generally works fine here but aws-okta add must be run in cmd.exe or PowerShell (not ISE) and network drives are known to cause problems with Go. Environments where aws-okta login and aws-okta exec are known to work include:

  • cmd.exe
  • PowerShell
  • PowerShell ISE
  • Git BASH

Installation

  1. Install go for windows >= 1.10
  2. If you're using network drives on your system make sure that %GOPATH% and %GOROOT% point to a LOCAL disk. You may also need to download the zip distribution of golang and manually install on a local drive.
  3. Install gcc. MinGW-w64 package is known to have issues while Win-builds 1.5.0 has been confirmed working.
  4. From your favorite shell go get github.com/segmentio/aws-okta
  5. Add %USERPROFILE%\go\bin to your PATH
  6. From a cmd.exe shell run aws-okta add - some shells lack the required functionality for this command to work but cmd.exe is consistent
  7. Follow the general instructions for configuring and using aws-okta
  8. To update go get -u github.com/segmentio/aws-okta

Windows Subsystem for Linux

aws-okta generally works fine in WSL as long as you're on Windows build >= 15093. Windows builds earlier than this lack the console features required. To find out what build of Windows you're on run the winver command.

The easiest way to install under WSL is to download the latest release Linux binary and put it somewhere in your path.

Installation From Source

  1. Install golang >= 1.10 - follow the instructions here if your WSL distribution does not natively include an appropriate version
  2. go get github.com/segmentio/aws-okta
  3. Add ~/go/bin to your $PATH
  4. Follow the general instructions for configuring and using aws-okta
  5. To update go get -u github.com/segmentio/aws-okta