JDK-8175871 : Deployment.properties file example is incorrect
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 8,9
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2017-02-26
  • Updated: 2019-01-14
  • Resolved: 2018-08-14
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8u191Fixed
Sub Tasks
JDK-8186788 :  
Description
Java Platform, Standard Edition Deployment Guide; section 21 at 
http://docs.oracle.com/javase/8/docs/technotes/guides/deploy/properties.html#CHDDDEHJ

The customer's description of the problem:

++++++

At issue is the following statement from paragraph 21.1.2:

"The deployment.system.config property is the URL to the system (enterprise-wide) deployment.properties file. This property can be used by system administrators to centrally administer or "lock-down" user-specific configuration settings. For local files, use the file protocol in the URL, for example, file:///C:/Windows/Sun/Java/Deployment/deployment.properties."

More specifically, the "example" in the above narrative.

The notation 'deployment.system.config=file:///C:/Windows/Sun/Java/Deployment/deployment.properties', does not work.

Instead, the following syntax (seemingly) MUST be used, else the contents of the deployment.config (and consequently, the deployment.properties file) are essentially IGNORED.  The two files (config and properties) may as well not exist, otherwise:

Use this notation, instead  "deployment.system.config=file\:\\C\:\\Windows\\Sun\\Java\\Deployment\\deployment.properties"

Note the change from forward slashes to backslashes, as well as the necessary 'escaping' done by the 'double-backslash'.  

Apparently, this is important.

I have proven this, as I've tried both syntaxes.  The Oracle documentation fails, while the escaped backslashed notation succeeds. 
Comments
Dmitry Markov has closed the RN subtask as not an issue. Changing the label on the parent to reflect the update and removing the CPU 18_01 label.
16-11-2017

Moved out of 17_04 while we decide if this is even necessary.
05-09-2017