Install Amazon ParallelCluster on Windows - Amazon ParallelCluster
Install Amazon ParallelCluster using Python and pip on WindowsAdd the Amazon ParallelCluster executable to your command line path
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Install Amazon ParallelCluster on Windows

You can install Amazon ParallelCluster on Windows by using pip, which is a package manager for Python. If you already have pip, follow the instructions in the main installation topic.

Install Amazon ParallelCluster using Python and pip on Windows

The Python Software Foundation provides installers for Windows that include pip.

To install Python and pip (Windows)

  1. Download the Python Windows x86-64 installer from the downloads page of Python.org.

  2. Run the installer.

  3. Choose Add Python 3 to PATH.

  4. Choose Install Now.

The installer installs Python in your user folder and adds its program folders to your user path.

To install Amazon ParallelCluster with pip3 (Windows)

If you use Python version 3+, we recommend that you use the pip3 command.

  1. Open the Command Prompt from the Start menu.

  2. Use the following commands to verify that Python and pip are both installed correctly.

    C:\>py --version
Python 3.8.11
C:\>pip3 --version
pip 21.3.1 from c:\python38\lib\site-packages\pip (python 3.8)

  3. Install Amazon ParallelCluster using pip.

    C:\>pip3 install "aws-parallelcluster<3.0"

  4. Verify that Amazon ParallelCluster is installed correctly.

    C:\>pcluster version
2.11.9

To upgrade to the latest version, run the installation command again.

C:\>pip3 install --user --upgrade "aws-parallelcluster<3.0"

Add the Amazon ParallelCluster executable to your command line path

After installing Amazon ParallelCluster with pip, add the pcluster program to your operating system's PATH environment variable.

You can find where the pcluster program is installed by running the following command.

C:\>where pcluster
C:\Python38\Scripts\pcluster.exe

If that command does not return any results, then you must add the path manually. Use the command line or Windows Explorer to discover where it is installed on your computer. Typical paths include:

  • Python 3 and pip3 – C:\Python38\Scripts\

  • Python 3 and pip3 --user option – %APPDATA%\Python\Python38\Scripts

Note

Folder names that include version numbers can vary. The preceding examples show Python38. Replace as needed with the version number that you are using.

To modify your PATH variable (Windows)

  1. Press the Windows key and enter environment variables.

  2. Choose Edit environment variables for your account.

  3. Choose PATH, and then choose Edit.

  4. Add the path to the Variable value field. For example: C:\new\path

  5. Choose OK twice to apply the new settings.

  6. Close any running command prompts and reopen the command prompt window.