Bug 976799 - Slash escaping in add vault command on Windows
Summary: Slash escaping in add vault command on Windows
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise Application Platform 6
Classification: JBoss
Component: Documentation
Version: 6.1.0
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ER7
: EAP 6.3.0
Assignee: David Michael
QA Contact: Russell Dickenson
David Michael
URL:
Whiteboard:
Depends On: 1001688
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-06-21 13:39 UTC by kamitsunami
Modified: 2014-08-14 15:17 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Instance Name: Not Defined Build: CSProcessor Builder Version 1.8 Build Name: 11865, Administration and Configuration Guide-6.1-3 Build Date: 23-05-2013 10:40:22
Last Closed: 2014-06-28 15:24:28 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description kamitsunami 2013-06-21 13:39:05 UTC
Title: Configure the JBoss Enterprise Application Platform to Use the Password Vault

Describe the issue:
In the documentation it supplies an example of the command to add a password vault in Linux.  I am using windows, so the file separator is "\" instead of "/".  This causes issues with some of the jboss-cli commands as the "\" need to be escaped.
In the case of the add vault command you must double escape the slashes, so "\" becomes "\\\\" (4 in total). 

Suggestions for improvement:
The escaping is fine, but can the documentation be updated to let users know this is a requirement when using Windows, it took me a while to figure out it was the escaping that was giving me problems with the command.

Additional information:

Comment 2 Misty Stanley-Jones 2013-08-20 07:37:05 UTC
I added the following in a note:

				<para>
					If you use Microsoft Windows, replace each <literal>/</literal> character in a filename or directory path with four <literal>\</literal> characters. This is because it should be two <literal>\</literal> characters, each escaped. This does not need to be done for other <literal>/</literal> characters.
				</para>

Let me know if this works for you.

Comment 3 Russell Dickenson 2013-08-26 02:58:27 UTC
The text has been corrected and it now available for QE at [1]. When validating this change, first confirm that you're viewing revision 1.0-58 or later.

[1] http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_JBoss_Enterprise_Application_Platform/6.1.1/html-single/Administration_and_Configuration_Guide/index.html#Configure_the_Enterprise_Application_Platform_to_Use_the_Password_Vault1

Comment 7 Josef Cacek 2014-06-05 13:34:57 UTC
Verification failed. The point 2 from comment #4 is still not fixed. (/ -> \)

Replace the current text with something like:

If you use Microsoft Windows Server, in the CLI command, escape each \ character in a directory path with an additional \ character (e.g. "C:\\data\\vault\\vault.keystore"). This is because single \ character is used for character escaping.

Comment 11 Ondrej Lukas 2014-06-11 11:06:30 UTC
Note from comment 7 was added. Verified on stage in Administration and Configuration Guide in Revision 6.3.0-24 and in Development Guide in Revision 6.3.0-20.


Note You need to log in before you can comment on or make changes to this bug.