1ce8560eeSMatt Barden# 2ce8560eeSMatt Barden# This file and its contents are supplied under the terms of the 3ce8560eeSMatt Barden# Common Development and Distribution License ("CDDL"), version 1.0. 4ce8560eeSMatt Barden# You may only use this file in accordance with the terms of version 5ce8560eeSMatt Barden# 1.0 of the CDDL. 6ce8560eeSMatt Barden# 7ce8560eeSMatt Barden# A full copy of the text of the CDDL should have accompanied this 8ce8560eeSMatt Barden# source. A copy of the CDDL is also available via the Internet at 9ce8560eeSMatt Barden# http://www.illumos.org/license/CDDL. 10ce8560eeSMatt Barden# 11ce8560eeSMatt Barden 12ce8560eeSMatt Barden# 13ce8560eeSMatt Barden# Copyright (c) 2012 by Delphix. All rights reserved. 14ce8560eeSMatt Barden# Copyright 2020 Tintri by DDN, Inc. All rights reserved. 15ce8560eeSMatt Barden# 16ce8560eeSMatt Barden 17ce8560eeSMatt Bardenlibmlrpc Unit Test Suite README 18ce8560eeSMatt Barden 19ce8560eeSMatt Barden1. Building and installing this Unit Test Suite 20ce8560eeSMatt Barden2. Running this Unit Test Suite 21ce8560eeSMatt Barden3. Test results 22ce8560eeSMatt Barden 23ce8560eeSMatt Barden-------------------------------------------------------------------------------- 24ce8560eeSMatt Barden 25ce8560eeSMatt Barden1. Building and installing this Unit Test Suite 26ce8560eeSMatt Barden 27ce8560eeSMatt BardenThis Test Suite runs under the testrunner framework (which can be installed 28ce8560eeSMatt Bardenas pkg:/system/test/testrunner). To build both this Unit Test Suite and the 29ce8560eeSMatt Bardentestrunner without running a full nightly: 30ce8560eeSMatt Barden 31ce8560eeSMatt Barden build_machine$ bldenv [-d] <your_env_file> 32ce8560eeSMatt Barden build_machine$ cd $SRC/test 33ce8560eeSMatt Barden build_machine$ dmake install 34ce8560eeSMatt Barden build_machine$ cd $SRC/pkg 35ce8560eeSMatt Barden build_machine$ dmake install 36ce8560eeSMatt Barden 37ce8560eeSMatt BardenThen set the publisher on the test machine to point to your repository and 38ce8560eeSMatt Bardeninstall the Utils Unit Test Suite. 39ce8560eeSMatt Barden 40ce8560eeSMatt Barden test_machine# pkg install pkg:/system/test/libmlrpctest 41ce8560eeSMatt Barden 42ce8560eeSMatt BardenNote, the framework will be installed automatically, as this test suite 43ce8560eeSMatt Bardendepends on it. 44ce8560eeSMatt Barden 45ce8560eeSMatt Barden2. Running this Unit Test Suite 46ce8560eeSMatt Barden 47ce8560eeSMatt BardenThe pre-requisites for running the this Unit Test Suite are: 48*bbf21555SRichard Lowe - A non-root user with the ability to sudo(8) to root without a 49ce8560eeSMatt Barden password or the root user must run the test. 50ce8560eeSMatt Barden (The samlogon test requires a user with 'solaris.smf.read.smb' 51ce8560eeSMatt Barden authorization, such as root.) 52ce8560eeSMatt Barden - The libmlrpc library must be installed. 53ce8560eeSMatt Barden - The system must be joined to the domain. 54ce8560eeSMatt Barden - Certain information must be collected from a packet capture performing 55ce8560eeSMatt Barden NTLM authentication against the system using a domain user, all from 56ce8560eeSMatt Barden the NetrSamLogon(Ex) request: 57ce8560eeSMatt Barden - IDENTITY_INFO/Domain 58ce8560eeSMatt Barden - IDENTITY_INFO/Acct Name 59ce8560eeSMatt Barden - IDENTITY_INFO/Wkst Name 60ce8560eeSMatt Barden - three binary files, exported from Wireshark: 61ce8560eeSMatt Barden 1. NETWORK_INFO/Challenge (8 bytes) 62ce8560eeSMatt Barden 2. First NETWORK_INFO/'LM Chal resp'/Bytes array/'LM Chal resp' 63ce8560eeSMatt Barden (variable - the first is NT) 64ce8560eeSMatt Barden 3. Second NETWORK_INFO/'LM Chal resp'/Bytes array/'LM Chal resp' 65ce8560eeSMatt Barden (variable - the second is LM) 66ce8560eeSMatt Barden - Enter configuration data in /opt/libmlrpc-tests/cfg/samlogon.config. 67ce8560eeSMatt Barden 68ce8560eeSMatt BardenOnce the pre-requisites are satisfied, simply run the script: 69ce8560eeSMatt Barden 70ce8560eeSMatt Barden test_machine$ /opt/libmlrpc-tests/bin/libmlrpctest 71ce8560eeSMatt Barden 72ce8560eeSMatt Barden3. Test results 73ce8560eeSMatt Barden 74ce8560eeSMatt BardenWhile the Unit Test Suite is running, one informational line is printed at 75ce8560eeSMatt Bardenthe end of each test, and a results summary is printed at the end of the run. 76ce8560eeSMatt BardenThe results summary includes the location of the complete logs, which is of the 77ce8560eeSMatt Bardenform /var/tmp/test_results/<ISO 8601 date>.