summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorToomas Soome <tsoome@me.com>2022-12-07 12:05:38 +0200
committerToomas Soome <tsoome@me.com>2022-12-08 23:33:54 +0200
commit66cff9fd00b4800a75aeda1985ab1a26f4dfd540 (patch)
treeb23cfc1c4106bc1b3e34275fcee6e661958c356c
parent3f3c90a958c5abf8ec0ed5d1fad2e40bd9905a50 (diff)
downloadillumos-gate-66cff9fd00b4800a75aeda1985ab1a26f4dfd540.tar.gz
15237 smbsrv-tests: document smb server share setup
Reviewed by: Gordon Ross <gordon.w.ross@gmail.com> Approved by: Dan McDonald <danmcd@mnx.io>
-rw-r--r--usr/src/test/smbsrv-tests/doc/README48
1 files changed, 46 insertions, 2 deletions
diff --git a/usr/src/test/smbsrv-tests/doc/README b/usr/src/test/smbsrv-tests/doc/README
index e83affbb9b..2a6b667c5f 100644
--- a/usr/src/test/smbsrv-tests/doc/README
+++ b/usr/src/test/smbsrv-tests/doc/README
@@ -38,7 +38,51 @@ To install the full suite, run:
--------------------------------------------------------------------------------
-2. Running the SMB Server Test Suite
+2. Preparing the SMB Server Share
+
+When workgroup mode is used, make sure the pam_smb_passwd module is
+configured in /etc/pam.conf or in /etc/pam.d:
+
+other password required pam_smb_passwd.so.1 nowarn
+
+Add test user:
+# useradd test
+# smbadm enable-user test
+# passwd test
+
+If needed, add admin user as shown above, and add it to smb group:
+# smbadm add-member -m admin@<hostname> administrators
+
+Set smb default settings:
+
+# sharectl set -p signing_required=false smb
+# sharectl set -p signing_enabled=true smb
+# svcadm restart network/smb/server
+
+Create dataset(s):
+
+Some smbtorture tests do rely on recordsize 4k.
+
+# zfs create -o recordsize=4k -o casesensitivity=mixed -o nbmand=on \
+ <pool>/test
+
+Set permissions:
+
+# chmod A=everyone@:full_set:fd:allow /<path to mounpoint>/test
+
+Create required snapshots (WPTS needs exactly 3 snapshots):
+
+# zfs snapshot <pool>/test@a
+# zfs snapshot <pool>/test@b
+# zfs snapshot <pool>/test@c
+
+Activate smb share:
+
+# zfs set sharesmb=name=test <pool>/test
+
+--------------------------------------------------------------------------------
+
+3. Running the SMB Server Test Suite
The default configuration:
/opt/smbsrv-tests/include/default.cfg
@@ -68,7 +112,7 @@ as additional arguments to the individual test, eg
--------------------------------------------------------------------------------
-3. Test Results
+4. Test Results
While the SMB Server Test Suite is running, one informational line is
printed for each test, ending with one of: