start Glassfish on Mac from Netbeans, faster Glassfish startup on Mac

doc/sphinx-guides/source/developers/dev-environment.rst

@@ -86,6 +86,19 @@ To install Glassfish, run the following commands:
 
 ``sudo chown -R $USER /usr/local/glassfish4``
 
+Test Glassfish Startup Time on Mac
+++++++++++++++++++++++++++++++++++
+
+``cd /usr/local/glassfish4/glassfish/bin``
+
+``./asadmin start-domain``
+
+``grep "startup time" /usr/local/glassfish4/glassfish/domains/domain1/logs/server.log``
+
+If you are seeing startup times in the 30 second range (31,584ms for "Felix" for example) please be aware that startup time can be greatly reduced (to less than 1.5 seconds in our testing) if you make a small edit to your ``/etc/hosts`` file as described at https://stackoverflow.com/questions/39636792/jvm-takes-a-long-time-to-resolve-ip-address-for-localhost/39698914#39698914 and https://thoeni.io/post/macos-sierra-java/
+
+Look for a line that says ``127.0.0.1 localhost`` and add a space followed by the output of ``hostname`` which should be something like ``foobar.local`` depending on the name of your Mac. For example, the line would say ``127.0.0.1 localhost foobar.local`` if your Mac's name is "foobar".
+
 Install PostgreSQL
 ~~~~~~~~~~~~~~~~~~
 

doc/sphinx-guides/source/developers/tips.rst

@@ -36,6 +36,8 @@ Dataverse only works with a specific version of Glassfish (see https://github.co
 
 Launch Netbeans and click "Tools" and then "Servers". Click "Add Server" and select "Glassfish Server" and set the installation location to ``/usr/local/glassfish4``. The default are fine so you can click "Next" and "Finish". To avoid confusing, click "Remove Server" on the newer version of Glassfish that came bundled with Glassfish.
 
+Please note that if you are on a Mac, Netbeans may be unable to start Glassfish due to proxy settings in Netbeans. Go to the "General" tab in Netbeans preferences and click "Test connection" to see if you are affected. If you get a green checkmark, you're all set. If you get a red exclamation mark, change "Proxy Settings" to "No Proxy" and retest. A more complicated answer having to do with changing network settings is available at https://discussions.apple.com/thread/7680039?answerId=30715103022#30715103022 and the bug is also described at https://netbeans.org/bugzilla/show_bug.cgi?id=268076
+
 At this point you can manage Glassfish using Netbeans. Click "Window" and then "Services". Expand "Servers" and right-click Glassfish to stop and then start it so that it appears in the Output window. Note that you can expand "Glassfish" and "Applications" to see if any applications are deployed.
 
 Ensure that Dataverse Will Be Deployed to Glassfish 4.1