Runtime Issues

This section describes runtime issues that relate to the Sun QFS and Sun Storage Archive Manager 5.3 release.

sammkfs Command Does Not Support the -A Option if the SUNWqfs Package Is Installed

The sammkfs -A option is not supported if the SUNWqfs packages is installed and will result in an error.

For example:

# sammkfs -A -S sqfs1
sammkfs: illegal option -- A
sammkfs: Unrecognized argument -A.
Usage: sammkfs [-i ninodes] [-a allocation] [-P] [-S] [-V] fs_name
sammkfs: sammkfs: Unrecognized argument.
sammkfs: Argument error.

Workaround: Use the following workaround:

1. Build a Sun QFS file system by using the sammkfs command without the -A option.

2. Run the samfsck -AF command to convert POSIX style ACL to NFSv4 style ACL.

samst and sgen Drivers in SAM-QFS

In the Oracle Solaris 11 and Oracle Solaris 10 09/10 releases, the media changer driver alias scsicalss,08, is assigned to the sgen driver. The SAM-QFS driver uses the same driver for media changers. SAM-QFS resolves the conflict by removing the scsicalss,08 driver alias from the sgen driver and adding it to the SAM-QFS samst driver during package post-install.

If you want to use magneto-optical drives with SAM-QFS, add the scsiclass,07 driver alias to the samst driver by using the update_drv command.

For example:

# update_drv -a -m "* 0666 root sys" -i \"scsiclass,07\" samst

After uninstalling SAM-QFS, if you want to use media changers with the sgen driver, update the sgen driver with the driver alias.

For example:

# update_drv -a -m "* 0666 root sys" -i \"scsiclass,08\" sgen

Solaris I/O Multipathing and Direct-Attached StorageTek Libraries

When Solaris I/O multipathing (MPxIO) is enabled, some StorageTek libraries do not work correctly with the multipathing software and will require additional configuration.

Workaround: In order to make the library usable by Oracle Solaris, disable the library from being included in MPxIO by modifying the /kernel/drv/scsi_vhci.conf file and issuing the stmsboot -u command.

To modify the /kernel/drv/scsi_vhci.conf file in the Oracle Solaris 10 releases:

device-type-scsi-options-list =  
"STK     SL500", "DISABLE", 
"Sun     SL500", "DISABLE";   
DISABLE = 0x7000000; 

To modify the /kernel/drv/scsi_vhci.conf file in the Oracle Solaris 11 releases:

device-type-scsi-options-list =
"STK     SL500", "NONE",
"SUN     SL500", "NONE";

For more information about configuring devices, see the “Configuring Third-Party Storage Devices” section in Oracle Solaris Administration: SAN Configuration and Multipathing.

Online Shrink Issues

Normal file system activity may leave the file system with a few data blocks missing from the free space list. This is not a problem for normal operation. However, it will leave the file system in a state where an online shrink made via the samadm eq-remove command will not succeed. If this happens, the following message will appear in the /var/adm/messages directory:

cannot OFF ord=4 space 0xba0ce80 KB is not equal to capacity 0xba0cec0 KB

where ord is the affected device, and space and capacity numbers are arbitrary.

Workaround: Unmount the file system first, perform a samfsck -F on it, remount the file system, and then do the remove.

Restoring Files With ACLs

In addition to the older POSIX style ACLs, SAM–QFS 5.3 now supports NFSv4 style ACLs too. If a samfsdump file that contains ACLs of one type is restored to a file system that is made with the other type of ACLs, a warning message will be printed. Also, ACLs conversion will not happen and files will be restored with empty ACLs.

Workaround: Recreate the file system with the correct ACL type and redo the restore.