Fix #4988. Handle Maven Surefire locale and timezone

conf/docker-aio/1prep.sh

@@ -1,7 +1,5 @@
 #!/bin/sh
 
-export LANG="en_US.UTF-8"
-
 # move things necessary for integration tests into build context.
 # this was based off the phoenix deployment; and is likely uglier and bulkier than necessary in a perfect world
 

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

@@ -57,6 +57,11 @@ Launch Netbeans and click "File" and then "Open Project". Navigate to where you
 
 If you installed Maven instead of Netbeans, run ``mvn package``.
 
+NOTE: Do you use a locale different than ``en_US.UTF-8`` on your development machine? Are you in a different timezone
+than Harvard (Eastern Time)? You might experience issues while running tests that were written with these settings
+in mind. The Maven  ``pom.xml`` tries to handle this for you by setting the locale to ``en_US.UTF-8`` and timezone
+``UTC``, but more, not yet discovered building or testing problems might lurk in the shadows.
+
 Install jq
 ~~~~~~~~~~
 

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

@@ -52,6 +52,9 @@ We are aware that there are newer testing tools such as TestNG, but we use `JUni
 
 If writing tests is new to you, poke around existing unit tests which all end in ``Test.java`` and live under ``src/test``. Each test is annotated with ``@Test`` and should have at least one assertion which specifies the expected result. In Netbeans, you can run all the tests in it by clicking "Run" -> "Test File". From the test file, you should be able to navigate to the code that's being tested by right-clicking on the file and clicking "Navigate" -> "Go to Test/Tested class". Likewise, from the code, you should be able to use the same "Navigate" menu to go to the tests.
 
+NOTE: Please remember when writing tests checking possibly localized outputs to check against ``en_US.UTF-8`` and ``UTC``
+l10n strings!
+
 Refactoring Code to Make It Unit-Testable
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

pom.xml

@@ -14,6 +14,9 @@
 	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 	<additionalparam>-Xdoclint:none</additionalparam>
         <aws.version>1.11.172</aws.version>
+        <project.timezone>UTC</project.timezone>
+        <project.language>en</project.language>
+        <project.region>US</project.region>
     </properties>
 
     <repositories>
@@ -635,6 +638,7 @@
                 <configuration>
                    <!-- testsToExclude come from the profile-->
                    <excludedGroups>${testsToExclude}</excludedGroups>
+                    <argLine>-Duser.timezone=${project.timezone} -Dfile.encoding=${project.build.sourceEncoding} -Duser.language=${project.language} -Duser.region=${project.region}</argLine>
                 </configuration>
             </plugin>
         </plugins>