Add note to application.default.yml and installation documentation that

uuid_prefix must be exactly 5 characters.

diff --git a/doc/install/install-api-server.html.textile.liquid b/doc/install/install-api-server.html.textile.liquid
index c3d5200b16871fa87bfe04ad4026d99de9f6f4a1..3aa123e26f1fbcae402dfa56a6b40d9c53a11e91 100644 (file)
--- a/doc/install/install-api-server.html.textile.liquid
+++ b/doc/install/install-api-server.html.textile.liquid
@@ -59,7 +59,7 @@ Consult @config/application.default.yml@ for a full list of configuration option
 
 h3(#uuid_prefix). uuid_prefix
 
-It is recommended to explicitly define your @uuid_prefix@ in @config/application.yml@, by setting the 'uuid_prefix' field in the section for your environment.
+Define your @uuid_prefix@ in @config/application.yml@ by setting the @uuid_prefix@ field in the section for your environment.  This prefix is used for all database identifiers to identify the record as originating from this site.  It must be exactly 5 alphanumeric characters (lowercase ASCII letters and digits).
 
 h3(#git_repositories_dir). git_repositories_dir
 

diff --git a/services/api/config/application.default.yml b/services/api/config/application.default.yml
index 5547704fc388fd46719095e5b67f5bf339835ff0..8ecef119a708c044e10c1f3689d1756eddd0a06d 100644 (file)
--- a/services/api/config/application.default.yml
+++ b/services/api/config/application.default.yml
@@ -47,6 +47,9 @@ test:
   workbench_address: https://localhost:3001/
 
 common:
+  # The prefix used for all database identifiers to identify the record as
+  # originating from this site.  Must be exactly 5 alphanumeric characters
+  # (lowercase ASCII letters and digits).
   uuid_prefix: <%= Digest::MD5.hexdigest(`hostname`).to_i(16).to_s(36)[0..4] %>
 
   # If not false, this is the hostname that will be used for root_url and