installation troubleshooting

Installing a complex scientific computing environment or a diverse set of laptops is very challenging. Even though our instructions work for most students, there are many ways in which something can not quite work the way as expected.

This page collects notes and recipes on trouble shooting (or "debugging" as we say) the installation process.

For additional help see also SoftwareCarpentry's Configuration Problems and Solutions.

Windows 10

pip or python are not found in git-bash

description

You opened git-bash and try to run the command

pip install vpython

or

python --version

but you get an error such as bash: pip: command not found.

solution

We are adding additional information to your bash shell startup file so that Anaconda will be found.

This solution assumes that you installed Anaconda3 in the default location — if you changed the location in the installation process then you will have to change the content of the MYCONDA variable below to use your custom location.

1. open git-bash

2. type

   cd
   echo $HOME

   (always hit RETURN after typing a command)

   You should see output such as /c/Users/YOUR-USERNAME (where "YOUR-USERNAME" stands for your user name, e.g., "alice", "bob", or "dvader")

3. type exactly

   cat >> $HOME/.bash_profile << 'EOF'
   # PHY494 bash startup for local Anaconda
   # see https://github.com/ASU-CompMethodsPhysics-PHY494/PHY494-resources/wiki/installation-troubleshooting
   MYCONDA="$HOME/Anaconda3"
   export PATH="$MYCONDA:$MYCONDA/Scripts:$MYCONDA/Library/bin:$PATH"
   unset MYCONDA
   EOF

4. close git-bash

5. open a new git-bash (this is important so that the changes take effect)

6. type

   which conda

   Should print something like /c/Users/YOUR-USERNAME/Anaconda3/conda.

Then try out again to run pip or python.

explanation

Newer versions of Anaconda do not add themselves to the Windows PATH anymore. The installer for Anaconda3 now recommends users by default to NOT add anaconda path to Windows PATH environment variable and thus our installation instructions for windows lead to an installation with Anaconda3 not immediately accessible from the command line.

macOS

Linux