Troubleshooting SharePoint

Transcription

1 Troubleshooting SharePoint The Complete Guide to Tools, Best Practices, PowerShell One-Liners, and Scripts Stacy Simpkins

2 Troubleshooting SharePoint Stacy Simpkins Brandon, Florida, USA ISBN-13 (pbk): ISBN-13 (electronic): Library of Congress Control Number: Copyright 2017 by Stacy Simpkins This work is subject to copyright. All rights are reserved by the Publisher, whether the whole or part of the material is concerned, specifically the rights of translation, reprinting, reuse of illustrations, recitation, broadcasting, reproduction on microfilms or in any other physical way, and transmission or information storage and retrieval, electronic adaptation, computer software, or by similar or dissimilar methodology now known or hereafter developed. Trademarked names, logos, and images may appear in this book. Rather than use a trademark symbol with every occurrence of a trademarked name, logo, or image we use the names, logos, and images only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. The use in this publication of trade names, trademarks, service marks, and similar terms, even if they are not identified as such, is not to be taken as an expression of opinion as to whether or not they are subject to proprietary rights. While the advice and information in this book are believed to be true and accurate at the date of publication, neither the authors nor the editors nor the publisher can accept any legal responsibility for any errors or omissions that may be made. The publisher makes no warranty, express or implied, with respect to the material contained herein. Cover image designed by Freepik Managing Director: Welmoed Spahr Editorial Director: Todd Green Acquisitions Editor: Joan Murray Development Editor: Laura Berendson Technical Reviewer: Samarjeet Singh Tomar Coordinating Editor: Jill Balzano Copy Editor: Kim Burton-Weisman Compositor: SPi Global Indexer: SPi Global Artist: SPi Global Distributed to the book trade worldwide by Springer Science+Business Media New York, 233 Spring Street, 6th Floor, New York, NY Phone SPRINGER, fax (201) , orders-ny@springer-sbm.com, or visit Apress Media, LLC is a California LLC and the sole member (owner) is Springer Science + Business Media Finance Inc (SSBM Finance Inc). SSBM Finance Inc is a Delaware corporation. For information on translations, please rights@apress.com, or visit rights-permissions. Apress titles may be purchased in bulk for academic, corporate, or promotional use. ebook versions and licenses are also available for most titles. For more information, reference our Print and ebook Bulk Sales web page at Any source code or other supplementary material referenced by the author in this book is available to readers on GitHub via the book s product page, located at For more detailed information, please visit Printed on acid-free paper

3 This book is dedicated to Saanvi, Owen, Willow, Oaklyn, and Weston.

4 Contents About the Author... ix About the Technical Reviewer... xi Acknowledgments... xiii Introduction...xv Chapter 1: Least-Privileged SharePoint Builds... 1 Why Least Privilege... 1 An Ounce of Prevention Is Worth a Pound of Cure... 1 Local Group Membership... 5 Ask the Domain Controllers... 6 Database Permissions for Farm Account Vs Install Account... 7 File System Permissions for Members of the WSS_Admin_WPG Local Group... 7 Logging File Paths Registry Permissions Application Pool Accounts WSS_WPG Registry Access Application Pool Accounts in IIS PowerShell to Reset Local Permissions and Files Inspecting for Least Privilege Next Steps Chapter 2: Key Settings of a Good Build PowerShell Aliases Verb-Noun All PowerShell cmdlets Are Objects v

5 Contents Running Administratively and the SharePoint Management Console Variable Instantiation Objects as a Form of Troubleshooting Avoiding Scrolling Truncation Enumerating Sites Step Step PowerShell Script to Create Central Administration PowerShell Script to Create Service Applications Building a Farm with AutoSPInstaller MSDTC and DCOM Settings Network Service Permissions Local Security for the Farm Account Next Steps Chapter 3: More Key Settings to a Good Build COM+ Security for User Profile Sync App Fabric and Distributed Cache User Profile Synchronization Patching Publishing Infrastructure vs. Minimal Download Strategy Account Management Logging Locations and Levels Path-based vs. Host-named Site collections HNSC or HHSC Next Steps vi

6 Contents Chapter 4: Files, Virtual Mappings, and IIS Settings Got Weird Stuff? SharePoint IIS Site Directories Virtually Mapped Folders SharePoint Web Services What About Registry? Chapter 5: SQL PowerShell Configuring SharePoint-Integrated Reporting with SQL Server 2012/ Scenario Scenario Chapter 6: SQL Backup and Restore and Useful CLI Commands Event ID Chapter 7: Search Configuration and Troubleshooting Chapter 8: Service Application Troubleshooting Chapter 9: ULS Viewer Chapter 10: Tools: Network Packet Tools and Page Performance Wireshark Fiddler NetMon and Message Analyzer Developer Dashboard Webalizer Indihiang SPS Farm Report utility Process Monitor (ProcMon) vii

7 Contents Chapter 11: Tools: SharePoint Health Analyzer Demystified SharePoint Health Analyzer Tool Performance Analysis of Logs (PAL) Tool for SharePoint SharePoint Feature Administration and Cleanup Tool The SharePoint Manager Tool Wrap Up Index viii

8 About the Author Stacy Simpkins is a SharePoint engineer with Rackspace, the numberone managed cloud company. He is passionate about SharePoint and loves helping customers understand and get the most out of SharePoint. Prior to Rackspace, Stacy worked with the federal government as an IT specialist and across multiple industries (food, legal, manufacturing, health insurance, and professional services) architecting and developing small, medium, and large SharePoint environments as a consultant. As a consultant, he served as a solutions architect for Magenium Solutions and as a senior consultant for Sogeti LLC. Stacy holds numerous Microsoft Certifications. During his limited free time, he enjoys blogging about SharePoint and other Microsoft products, speaking at user group meetings, and leading the Tampa Bay SharePoint user group. ix

9 About the Technical Reviewer Samarjeet Singh Tomar is a SharePoint Engineer for the Blue Cross Blue Shield Association (BCBSA), a national federation of 36 independent, community-based and locally operated Blue Cross and Blue Shield companies. He is passionate about SharePoint and.net Core, Tableau, Angular, D3, Power-BI and helping customers and business in automate and visualization. Prior to BCBSA, Samar worked with various industry domains and service area. He is passionate about learning and implementing different technology and build scalable solution using proven practices. During his limited free time, he enjoys blogging about SharePoint and other technologies, he loves travelling and playing computer games. xi

10 Acknowledgments I d like to thank my fellow Rackspace SharePoint engineers for their contributions: Scott Fawley, J. T. Shoupe, Stephen Swinney, Danny Pugh, Mike Ross, Mike Clarke, Jarod Oliver, Daocheng Li (Richard), Mark Watts, Ryan Holderread, Brad Slagle, and Tray Harrison. Originally, I had planned to provide a short bio of everyone on this list; however, we weren t able to pull them all together before printing. To everyone on this list, I sincerely thank you for your fanatical support and the awesome SharePoint knowledge, and the wisdom you ve shared with me over the last year. xiii

11 Introduction This introduction covers, at a high level, the topics that this book discusses. The book assumes that you already have a development SharePoint environment that you can use to perform the exercises. If you don t have a development farm and are not sure about the steps needed to create one, you should get a copy of my book Building a SharePoint 2016 Home Lab: A How-To Reference on Simulating a Realistic SharePoint Testing Environment (Apress, 2016). Although it is possible to read each chapter independently, there are parts of chapters that build off previous chapters and/or assume some requisite SharePoint knowledge. The following is the 40,000-foot view. Chapter 1. Least-Privileged SharePoint Builds This chapter thoroughly discusses building a SharePoint farm using least privileging. It starts to peel away the troubleshooting onion, layer by layer, and explains why a least-privileged build is important for troubleshooting. Chapter 2. Key Settings of a Good Build This chapter is the first of two parts that cover the key settings of a good build. You ll learn about SQL aliases, MSDTC, to IIS WAMREG and DCOM, Network Service, and the local security needs of a farm account. Chapter 3. More Key Settings of a Good Build This chapter finishes the discussion on key settings in the file system as they relate to App Fabric and Distributed Cache, User Profile Synchronization, publishing infrastructure, account management, logging locations and levels, and path-based vs. host headers, also known as host named site collections. Chapter 4. Files, Virtual Mappings, and IIS Settings This chapter explores the changes that SharePoint makes to a Windows server file system and discusses how this relates to IIS. It looks at IIS logging and opens the discussion that surrounds the connection between IIS logs, SharePoint logs, and Windows logs. Chapter 5. Database and Security Operations This chapter opens SQL Server Management Studio and looks at the SQL Server settings, database settings, server roles, database mappings, SQL logging, and various PowerShell and/or command-line operations as they relate to SharePoint database security operations from within SSMS and/or SQL Server configuration. xv

12 Introduction Chapter 6. SQL Backup and Restore, and Useful CLI This chapter covers a few more SQL-related topics, such SQL database backup and restore options, unattached restores, SQL file restores, and PowerShell site collection backup and restore. We look at some Windows OS commands that yield helpful troubleshooting information, including systeminfo, ncpa.cpl, msinfo32, SC, and others as I talk about finding answers to troubleshooting questions. Chapter 7. Search Configuration and Troubleshooting This chapter peels back a deeper layer of the troubleshooting onion as it relates to issues with search, search configuration with PowerShell, and the search service application. We look at some cool scripts and take a fairly good dive into search. Chapter 8. Troubleshooting Services This chapter looks at troubleshooting User Profile Synchronization Connections, Excel Services, Office Web app connections, and patching Office Web apps. We look at managed metadata term stores and discuss the connection to the User Profile Service. I ll discuss web.config modifications and using PowerShell to determine if the web.config is modified. Along with looking at web.config, PowerShell interrogates timer jobs, log levels, and databases. Finally, PowerShell is used to unprovision and provision services. Chapter 9. Tools: ULS, merge-splogfile, and Other PowerShell cmdlets This chapter s primary focus centers on ULS logs, ULS viewer, merge-splogfile, and other PowerShell cmdlets that pertain to Windows logs. It discusses the numerous settings of ULS viewer and some various scenarios and methods. The chapter explains the connection between SharePoint and Windows event logs and helps the reader understand how to decipher what the logs are saying and how to use the logging system and configure it. Chapter 10. Tools: Network Packet Tools and Page Performance This chapter discusses the use of ProcMon, WireShark, Fiddler, NetMon, developer dashboard, and more! It also covers a few more tools used to look at network packets, IIS logs, and page load performance. Chapter 11. Tools: SharePoint Health Analyzer Demystified This chapter discusses the SharePoint Health Analyzer report, the Performance Analysis of Logs (PAL) tool for SharePoint, the SharePoint Manager tool, the SharePoint feature admin tool, and finally, a summation of the three chapters on troubleshooting tools. xvi

13 Commonly Used Shortcuts Introduction In this book, we use keyboard shortcuts, the run bar, and commands quite a bit. Table-A lists some of the commands with a brief description. Table-A. Keyboard Shortcuts and Commands Used in This Book Command\Keyboard Shortcut Windows key + R Cmd Comexp Compmgmt.msc ipconfig nslookup Ncpa.cpl Regedit Control netconnections Msinfo32 Sysdm.cpl Services.msc Dsa.msc Dnsmgmt.msc Gpmc.msc Control Panel Lusrmgr.msc Notepad Adsiedit.msc Description of Run Command Opens the run bar Opens the Command window Opens the Component Services manager Opens the Computer Management console Opens the ipconfig information Opens a command-line interface to DNS Opens the network connections Opens the registry editor Opens the network connections Opens the system information Opens the system properties Opens the Services console Opens the Active Directory users and computers Opens the Domain Name System manager Opens the Group Policy Manager Open the control panel Open the Local Users and Groups administration console Opens Notepad Opens the Active Directory Service Interface editor Summary The goal of this book is to provide you with a much broader troubleshooting arsenal for SharePoint and perhaps a deeper understanding of how the file system relates to the databases. We do not delve into unsupported activities, such as table modifications, as that would not be in best practice; however, there are a couple points in the book where we come close, as we look into certain tables inside the SharePoint SQL Server database tables. No animals were hurt during the making of this book and all of the tools you see used in this book are available free of charge and are downloadable on the Internet. xvii