Add troubleshooting topic to documentation

Author: steveburnett

presto-docs/src/main/sphinx/index.rst

@@ -23,6 +23,7 @@ Presto Documentation
     router
     develop
     presto-cpp
+    troubleshoot
     release
 
 .. Note: If "release" is not the last item, the CSS must be updated.

presto-docs/src/main/sphinx/troubleshoot.rst

@@ -0,0 +1,14 @@
+***************
+Troubleshooting
+***************
+
+.. toctree::
+    :maxdepth: 1
+
+    troubleshoot/deploy
+
+This section of the Presto documentation collects known problems when working 
+with Presto, and their identified solutions or workarounds. 
+
+To contribute to this section, or to any other part of the Presto documentation, use the 
+*Create docs issue* in the right margin of this page.

presto-docs/src/main/sphinx/troubleshoot/deploy.rst

@@ -0,0 +1,72 @@
+================
+Deploying Presto
+================
+
+.. contents::
+    :local:
+    :backlinks: none
+    :depth: 1
+
+``Permission denied: ‘/private/var/presto/data/var/run/launcher.pid``
+---------------------------------------------------------------------
+
+Problem
+^^^^^^^
+
+``bin/launcher run`` or ``bin/launcher start`` returns the following error: 
+
+``Permission denied: ‘/private/var/presto/data/var/run/launcher.pid``
+
+Solution
+^^^^^^^^
+
+Run the command as root or using ``sudo``. 
+
+.. code-block:: none
+
+    sudo bin/launcher run
+    sudo bin/launcher start
+
+
+``xcode select failed to locate python``
+----------------------------------------
+
+Problem
+^^^^^^^
+
+On an OS X system, ``bin/launcher run`` or ``bin/launcher start`` returns the following error: 
+
+``xcode select failed to locate python requesting installation of command``
+
+Solution
+^^^^^^^^
+
+Create a symlink where XCode looks for python that links to python3. An example of such a command: 
+
+.. code-block:: none
+
+    ln -s /Library/Developer/CommandLineTools/usr/bin/python3 /Library/Developer/CommandLineTools/usr/bin/python
+
+
+
+
+``Error: VM option ‘UseG1GC’ is experimental``
+----------------------------------------------
+
+Problem
+^^^^^^^
+``bin/launcher run`` or ``bin/launcher start`` returns the following error: 
+
+.. code-block:: none
+
+    Error: VM option ‘UseG1GC’ is experimental and must be enabled via -XX:+UnlockExperimentalVM Options.
+
+    Error: Could not create the Java Virtual Machine.
+
+    Error: A fatal exception has occurred. Program will exit.
+
+Solution
+^^^^^^^^
+
+This error occurs with some versions of Java. Uninstall Java, then install a different version of Java. 
+