To assist with File Import operations from VNX1/VNX2 systems to Unity, there is a Service Script called "svc_param" that can be used to view and modify certain File-related parameters on the Unity SPs.
File-related parameters are compared between VNX and Unity during Import Session creation, and are important in order to maintain data transparency (non-disruptive access) to Hosts when performing File-based migrations from VNX to Unity NAS Servers.
The Service script is accessible via the Command Line Interface (CLI) when logged into the Service Processor as the Service user, through SSH.
Users who are familiar with VNX systems will recognize the syntax used to view or modify Server Parameters on the Unity system.
Since Service Processors are used to host NAS Servers, a Unity parameter change is applied to both SPs, and in some cases, the parameter change will not go into effect until the SPs are rebooted (staggered reboot).
The primary Use Case for performing parameter changes would be to support NFS Host transparency (non-disruptive access) when migrating File Servers from VNX1/VNX2 systems to Unity.
When creating an Import Session, the Unity system compares parameters between VNX and Unity. If parameter values differ more than allowed limits, NFS Host transparency cannot be guaranteed during Import Cutover to the Unity system. If NFS Host transparency is important, you can change parameters on either the VNX Data Mover or the Unity system. The svc_param script provides the customer the flexibility to view and/or modify parameters on the Unity side.
The Unisphere GUI and UEMCLI also provide the option to skip the parameter checks.
svc_param Script usage as follows:
svc_param -h
Service script for managing param
Usage : svc_param -h | --help | <command>
Commands:
svc_param ALL -facility <facilityname> -info <paramname>
Show current state of a param
svc_param ALL -facility <facilityname> -modify <paramname> -value <newvalue>
Modify a param
svc_param ALL -facility { <facilityname> | -all } -list
Display the list of authorized param for a facility or for all facilities
svc_nas Script usage as follows:
Usage: svc_nas {<NAS_server_name> | ALL}
Description: This script allows NAS server advanced management, including NAS server parameters
setting and databases maintenance.
Options:
| -help | --help | -h
Print this message and exit.
| -param
{-info
Display all NAS param facilities
|-facility {<facility> | -all} -list
Display all NAS param values of the given facility of the given NAS server.
|-facility {<facility> | -all} -info { <param_name> [-verbose] | -all}
Display the details of the specified NAS param of the given facility of the given NAS server.
|-facility <facility> -modify <param_name> -value <new_value>}
Modify the value of the specified NAS param of the given facility of the given NAS server.
Parameter's values naming conventions:
default: Default factory value, can't be changed.
current: Value currently used by the system.
configured: Value applied upon SP reboot for global parameters only.
There are two types of parameters:
global: Parameters' value applied to all NAS servers.
Modifiable only with the ALL target.
NAS server: Parameters' value applied per NAS server instance.
Initial value inherited from current global parameter's value
upon new NAS server creation.
Caution: Please note that Unity parameters apply to both Service Processors (SPs), and that some parameter changes require that the SPs reboot before going into effect
Note: svc_param is deprecated in Unity 4.2.0 and has been replaced by svc_nas -param.
Example of Changing and Viewing a Unity Parameter (Unity OE before 4.2.0):
spb:# svc_param ALL -facility nfs -modify transChecksum -value 1
spb:# svc_param ALL -facility nfs -info transChecksum
Server parameter value, transChecksum="1"
Example of Changing and Viewing a Unity Parameter (Unity OE after 4.2.0):
spb:# svc_nas ALL -param -facility nfs -modify nthreads -value 512
Note: The parameter nthreads for the facility nfs is global to the array. Please use ALL instead of NAS server name.
spb:# svc_nas ALL -param -facility nfs -info nthreads
ALL NAS Servers :
name = nthreads
facility_name = nfs
default_value = 512
current_value = 512
configured_value =
param_type = global
user_action = reboot SP
change_effective = reboot SP
range = (32,2048)
description = Number of threads dedicated to serve nfs requests, and memory dependent.
Parameters available for Change with svc_param:
Facitity Param name Comment
cfs showChildFsRoot Enable snapshot entry point at the root of primary FileSystem
cifs acl.restrictedTakeOwnership In Unix security onlyuser with UID 0 are able to take ownership.
cifs admin.shareC_NotCreated Do not expose C$ share
cifs admin.shareC_RO Enforce access to C$, to be readOnly
cifs allowSnapSureVss Disallow access to snapshot from 'Previous Version' tab in explorer
cifs cifsclient.timeout Modify the time-out on SMB request when Nas server is client and access another NAS server
cifs LanmanServer.disableNameChecking Disables checking of the server's principal name of the client's kerberos ticket.
cifs LanmanServer.IdleUserAutoLogoff Set AutoLogOff on SMB Idle connection
cifs LanmanServer.MaxMpxCount Set Max Pending command for a client in a connection (SMB1 Only behavior)
cifs maxVCThreads Increase the number of threads exclusively reserved to VirusChecker
cifs nullSession Manage NullSession accessibility on Nas server
cifs ReadOnly.Comp Sync ReadOnly Bit Dos Attrinute and Unix mode bits
cifs ReadOnly.Delete When ReadOnlySync is set, manage dehavior on delete readOnly file from Unix
cifs set_eas_ok As Unity does not support EAS, this param manage error status when client look at it.
cifs smbsigning Disable signing for SMB1 clients
cifs srvmgr.diskdrive Show shares named by a drive letter follow by $, as real drives.
cifs srvpwd.updtMinutes Change Server Password update interval
cifs windowsTimeUpdate Change when last modification Time is updated for SMB operations
cvfs virtualDirName Can change directory name to access SnapShot from Primary FS directory
dns updateMode Secure DNS update mode change
dns updatePTRrecord Enable PTR record in DDNS
filesystem rstchown Change Posix sementic for change owner
ldap cacheMaxGroups Size Group caching
ldap cacheMaxHosts Size Host caching
ldap SecurityLayer Change Ldap security
lockd gpDuration Change grace periode for NFS locking after a failover
mount forceFullShowmount Restrict showmount from host to he export accessible by the hosts
mount tcpResponseLimit Size max export returned in showmount request
nfs nthreads Tunne number of NFS threads in the SP
nfs transChecksum Enable checksum in addition of XID value checking for Oracle DirectNFS support
nfs v3xfersize Tunne max transfer size for NFS V3 and V4.
nfsv4 leaseDuration Tunne max lease duration (before renew)
quota useQuotasInFsStat Enable userQuota check on "df" command, user will see only his quota space
security maxNISCacheGroupsCount Size NIS group caching
security maxNISCacheUsersCount Size user NIS caching
shadow followabsolutpath Follow absolute symbolic link path for SMB access by the server (SMB1 only)
shadow followdotdot Follow .. In symbolic link for SMB access by the server (SMB1 only)
viruschk Traces enable more tracing in VirusChecker
Parameters available for Change with svc_nas:
param_name facility default current configured
IPv6 NDMP 1 1
concurrentDataStreams NDMP 20 20
snapsure NDMP 0 1 1
showChildFsRoot cfs 0 1
LanmanServer.IdleUserAutoLogoff cifs 4294967295 4294967295
LanmanServer.MaxMpxCount cifs 127 127
LanmanServer.disableNameChecking cifs 0 0
LanmanServer.maxLocalUsers cifs 128 128
ReadOnly.Comp cifs 0 0
ReadOnly.Delete cifs 0 0
acl.extacl cifs 0 0
acl.restrictedTakeOwnership cifs 0 0
admin.shareC_NotCreated cifs 0 0
admin.shareC_RO cifs 0 0
allowSnapSureVss cifs 1 1
cifsclient.timeout cifs 20000 20000
maxVCThreads cifs 3 3
nullSession cifs 0 0
set_eas_ok cifs 0 0
smb2.maxDialect cifs SMB3.1.1 SMB3.0.2 SMB3.0.2
smbsigning cifs 1 1
srvmgr.diskdrive cifs 0 0
srvpwd.updtMinutes cifs 0 0
windowsTimeUpdate cifs 0 0
virtualDirName cvfs ckpt ckpt
updateMode dns 2 2
updatePTRrecord dns 0 0
updateTTL dns 1200 1200
rstchown filesystem 1 1
SecurityLayer ldap 2 2
cacheMaxGroups ldap 10000 10000
cacheMaxHosts ldap 10000 10000
gpDuration lockd 45 45
forceFullShowmount mount 1 1
tcpResponseLimit mount 262144 262144
nthreads nfs 512 512
transChecksum nfs 0 0
v3xfersize nfs 131072 131072
leaseDuration nfsv4 18 18
useQuotasInFsStat quota 0 0
maxNISCacheGroupsCount security 10000 10000
maxNISCacheUsersCount security 10000 10000
followabsolutpath shadow 0 0
followdotdot shadow 0 0
Traces viruschk 0x00000000 0x00000000