[CLIMATE-660] Wiki OCW installation guide suggestions - ASF JIRA

XML

Word

Printable

JSON

A few suggestions for the installation guide available on the wiki:

The "Make Everything Easier" section's code snippet is missing an end quote:
i.e. change the first line to be the second
- export PYTHONPATH="$HOME/climate/:$HOME/climate/ocw/:$PYTHONPATH
- export PYTHONPATH="$HOME/climate/:$HOME/climate/ocw/":$PYTHONPATH
The "Install Additional Dependencies" section should have a WARNING to inform the user they should "deactivate" their virtual environment, complete the section "Make Everything Easier" and then re-activate their virtual environment if they chose the "Option 1: Install Anaconda and various other dependencies" option under the section "Install Conda Dependencies". There are virtualenv / conda configuration conflicts if the above is not completed.
The "Test Your Installation section" should have a TIP to suggest the user upgrade libpng library to libpng16. I'm running a fresh Ubuntu Server 15.04 with kernel 3.19, and I had to manually upgrade libpng12 to libpng16 for the demo to work. (see: http://geeksww.com/tutorials/libraries/libpng/installation/installing_libpng_on_ubuntu_linux.php, and http://sourceforge.net/projects/libpng/files/libpng16/)

C python libraries (e.g. Python.h) are required, but a fresh Ubuntu doesn't include these libraries. I had to run sudo apt-get install python-dev as a pre-requisite. This step should be included.