Sun Storage 7000 Unified Storage System: NDMP and ZFS allow datasets to be created containing spaces that then break the appliance CLI.

Asset ID:	1-72-1526639.1
Update Date:	2016-02-08
Keywords:

Solution Type Problem Resolution Sure

Solution 1526639.1 : Sun Storage 7000 Unified Storage System: NDMP and ZFS allow datasets to be created containing spaces that then break the appliance CLI.

Applies to:

Sun ZFS Storage 7420 - Version All Versions and later
Sun ZFS Storage 7320 - Version All Versions and later
Sun ZFS Storage 7120 - Version All Versions and later
Sun Storage 7310 Unified Storage System - Version All Versions and later
Sun Storage 7210 Unified Storage System - Version All Versions and later
7000 Appliance OS (Fishworks)

Symptoms

To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start a discussion in the My Oracle Support Community - Disk Storage ZFS Storage Appliance

When carrying out a restore - using a Data Management Application via NDMP to the appliance - it is possible to specify that the restore dataset name includes spaces in it.

In the following example, Netbackup was used to restore a backup of a share to a new dataset with the name 'testrestore'. Unfortunately, using cut-and-paste introduced a space at the end of the name - "testrestore ". This space was accepted by the DMA (Netbackup), passed along and accepted by NDMP and then passed on to zfs to create the dataset. However share names with trailing spaces break the CLI - although the BUI seems able to cope with them.

See below for error message details.

nas7000:> shares select testrestore
error: internal error: invalid entity name 'nfs1 ': entity names cannot contain
  spaces

error: the above error was unexpected and likely indicates faulty software;
  please give your service provider the following details regarding the
  origin of the error when seeking any further assistance:

  Error()@:0
  @../common/akError.js:473

Changes

Restores carried out direct to the appliance using NDMP. The restore specifies a dataset name that includes spaces.

Cause

As stated by the ZFS administration Guide link, datasets should not be allowed to be created with the spaces in it.

However NDMP accepts names with spaces, and ZFS does allow datasets to be created with spaces included in their name.

For more details see <Bug 15806293> for NDMP and <Bug 15941019> for ZFS.

The spaces then break the appliance stipulation that spaces CANNOT be included in dataset names and so the CLI breaks with an error, although the BUI seems able to handle this case.

See https://stbeehive.oracle.com/teamcollab/wiki/AmberRoadSupport:NDMP+allows+Data+Management+Applications+to+specify+restores+to+datasets+with+spaces+in+their+names

This is a page on the internal Amber Road Support wiki detailing how to recreate the problem and fix it using OS shell commands.

If you do not have access to the Amber Road Support wiki please contact a member of the NAS support team.

Solution

Use the BUI Shares screen to highlight the problem dataset and click the trashcan icon to destroy it.

Then restore again using a dataset name with no spaces.

References

<BUG:15941019> - TRIM THE TRAILING SPACE OF DATASET/CLONE/SNAPSHOT NAMES AS WINDOWS DOES
<BUG:15806293> - SUNBT7187066 APPLIANCE: NDMP BACKUP/RESTORE INTRODUCES SHARES WITH SPACE; CHAOS
http://docs.oracle.com/cd/E23824_01/html/821-1448/gbcpt.html

Attachments

This solution has no attachment