HP StoreOnce: Avoid special characters in NAS share description
While I was playing with my shiny, new HP StoreOnce VSA in my lab, I noticed a curious behavior. I created a NAS share for some tests with Veeam Backup & Replication. Creating a new share is nothing fancy. You can create a share in two ways:
- using the GUI, or
- using the CLI
So I created a new share:
Patrick Terlisten/ vcloudnine.de/ Creative Commons CC0
Nothing special, as you can see. I opened up a Explorer, typed in the IP address of my StoreOnce VSA and… saw no share.
Patrick Terlisten/ vcloudnine.de/ Creative Commons CC0
I repeated this process a couple of times, always with the same result. Then I went to the CLI and checked the newly created share:
# nas show share share0
ID 0
Protocol CIFS
Name veeam
Network Name veeam
Description Share for Veeam B&R
Created On 11:35 2015/05/27
Modified On 11:35 2015/05/27
Status Online
Health OK
Replication Role Non Replicating
Replication Status Non Replicating
Replication Health Information
User Bytes 0
Disk Bytes 380
Dedupe Ratio 0.0
Files 0
Directories 1
Read-only No
Encryption Enabled No
Deduplication Enabled Yes
Share Version 2
Authentication None
Physical Data Size Quota (No Quota)
Logical Data Size Quota (No Quota)
Command Successful
So far, so good. I removed the share and tried to create the share using the CLI:
# nas create share set1 share0 proto cifs name "veeam" desc "B&R"
Command Failed -
The command failed, no share was created. I verified the syntax, but the syntax of the command was correct. I started to simplify the command and removed the description.
# nas create share set1 share0 proto cifs name "veeam"
Command Successful
# nas show share share0
ID 0
Protocol CIFS
Name veeam
Network Name veeam
Description HP StoreOnce Share 1
Created On 11:43 2015/05/27
Modified On 11:43 2015/05/27
Status Starting
Health Information
Replication Role Non Replicating
Replication Status Non Replicating
Replication Health Information
User Bytes 0
Disk Bytes 380
Dedupe Ratio 0.0
Files 0
Directories 1
Read-only No
Encryption Enabled No
Deduplication Enabled Yes
Share Version 2
Authentication None
Physical Data Size Quota (No Quota)
Logical Data Size Quota (No Quota)
Command Successful
The share was added with the default description. I removed the share and tried it again with my description. The command failed again. After removing the ampersand (&) from the description, the share could be added. I tried the same from the GUI. Using the GUI, a share with a ampersand (&) in the description field could be added, but it wasn’t accessible. Even if I removed the ampersand (&) from the share description. I had to remove and re-create the share with a valid description. Unfortunately the GUI allows you to create the share, even if the CLI command fails with the same settings. The GUI also doesn’t allow you to create the share with an empty description.
At this point, I can’t say if this is a bug or a known behaviour. I’m in contact with HP to clarify this. But you should avoid the usage of special characters in the NAS share description.
Edit: Today, I got an e-mail from the HP StoreOnce Engineering. They informed me, that it’s not only the ampersand (&) you should avoid. You should avoid a set of special characters
- `
- *
- &
- %
- +
- multiple space in a row
These characters can cause minor issues with Windows tools, like the Explorer. As a result, these special characters were banned in the latest 3.12.x CIFS server code. However this ban was not messaged in the GUI. As a fix, this ban will be lifted from 3.12.2 software to allow the use of the above mentioned special characters.