Debug-SdHost
Troubleshoots your system setup.
Syntax
Debug-SdHost [-Session] <String> [-Host] <String> [-RuleCategory] <Category> [-Session] <String> [-Host] <String>
Detailed Description
Troubleshoots your system setup. You can use this cmdlet to identify problems with the following rules:a) Validate storage connection settings.b) Export-policy rule.c) SMB share "continuously-available" property.d) SMB share ACL setup.When you are troubleshooting a clustered Data ONTAP environment, run Debug-SdHost on each node of the Windows cluster.
Parameters
Name | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|
Session |
false |
true (ByPropertyName) |
||
Host |
Specifies the name or IP address of the host on which you execute the operation. The default is your local machine. |
false |
true (ByPropertyName) |
|
RuleCategory |
Indicates that you want to troubleshoot the specified category only. |
false |
true (ByPropertyName) |
Examples
Example 1: Debugging your host
PS C:\> Debug-SdHost
In this example syntax, you have checked your host for the various system setup problems and found errors with the export-policy rule, the SMB share ACL setup rule, and the SMB share "continuously-available" property rule.
Rule: Storage connections. Description : The storage connection rule verifies that the storage connection settings on your host system are valid and active. Category: General Source : NEXTGEN-BOX59 Severity: Info Problem : N/A Impact : N/A Resolution : N/A Message : Success. All your storage connection settings are valid and active. Rule: Export-Policy Rule Description : The export-policy rule verifies that the client trying to access the data objects is doing so using the SMB protocol. Category: SMB Source : NEXTGEN-BOX59 Severity: Info Problem : N/A Impact : N/A Resolution : N/A Message : Success. The SMB protocol is set in the export-policy rule of all the virtual storage servers. Rule: SMB share ACL setup. Description : This rule verifies that the share ACL has host permissions, and if your host is a part of a cluster it verifies that the share has cluster permissions. Category: Hyper_V Source : NEXTGEN-BOX59 Severity: Error Problem : Your shares do not have access control set for the host or the cluster. Impact : You cannot access these shares from your host. Resolution : Add the host or the cluster to your share's ACL. Message : Error. The following shares do not have host or clusters set in the ACLs: \\CIFS_SERV\admin$,\\CIFS_SERV\ipc$. Rule: SMB share "continuously-available" property. Description : This rule verifies that your SMB share contains the continuously-available property. The continuously-available property is mandatory for installating a VM. Category: Hyper_V Source : NEXTGEN-BOX59 Severity: Error Problem : Some of the shares do not contain the continuously-available property. Impact : You cannot install a VM on the share. Resolution : Set the share property to continuously-available. Message : Error. The following shares do not have continuously-available property set: \\CIFS_SERV\admin$,\\CIFS_SERV\sales_dbshare,\\CIFS_SERV\ACL,\\CIFS_SERV\qtree,\\CIFS_SERV\ipc$.