AccuRev® Administrator’s Guide Version 7.1 Revised 15-September-2017 Copyright and Trademarks Copyright © Micro Focus 2017. All rights reserved. This product incorporates technology that may be covered by one or more of the following patents: U.S. Patent Numbers: 7,437,722; 7,614,038; 8,341,590; 8,473,893; 8,548,967. AccuRev, AgileCycle, and TimeSafe are registered trademarks of Micro Focus. AccuBridge, AccuReplica, AccuSync, AccuWork, Kando, and StreamBrowser are trademarks of Micro Focus. All other trade names, trademarks, and service marks used in this document are the property of their respective owners. Table of Contents Preface......................................................................................................................... ix Audience .....................................................................................................................................................................ix Before You Begin........................................................................................................................................................ix Using This Book .........................................................................................................................................................ix Typographical Conventions .........................................................................................................................................x Contacting Technical Support......................................................................................................................................x 1. Setting Up AccuRev®.............................................................................................. 1 Before You Begin.........................................................................................................................................................1 Using the Quick Setup Wizard.....................................................................................................................................1 Manual Set-Up Procedures ..........................................................................................................................................3 Create an AccuRev Username and Password .......................................................................................................3 Create a New Storage Depot.................................................................................................................................3 Create a Workspace to Store Your Work...............................................................................................................3 Import Files into Your Workspace ........................................................................................................................3 Add the Files in Your Workspace to the Depot.....................................................................................................4 Update Your Workspace........................................................................................................................................4 Next Steps ....................................................................................................................................................................4 2. The AccuRev Repository ........................................................................................ 5 Repository Access Permissions....................................................................................................................................5 READ ME NOW: Assuring the Integrity of the AccuRev Repository........................................................................5 Backing Up the Reposito ry..........................................................................................................................................6 Restoring the Repository..............................................................................................................................................8 Archiving Portions of the Repository ..........................................................................................................................9 Moving a Workspace or Reference Tree....................................................................................................................10 Moving a Depot .........................................................................................................................................................10 Removing a Depot .....................................................................................................................................................10 Moving the db or site_slice Directories .....................................................................................................................10 A Word of Caution on Windows Zip Utilities............................................................................................................11 Storage Layout ...........................................................................................................................................................12 3. The AccuRev Server.............................................................................................. 13 Operating-System User Identity of the Server Processes ..........................................................................................13 UNIX/Linux Identity ..........................................................................................................................................13 Windows Identity................................................................................................................................................13 AccuRev User Identity of the Server Process............................................................................................................14 Starting the AccuRev Server......................................................................................................................................15 Running the Server Automatically at Operating System Startup .......................................................................15 Starting the Server Manually ..............................................................................................................................15 Server Configuration File...........................................................................................................................................15 AccuRev® Administrator’s Guide iii UNIX/Linux: Controlling the Server’s Operating-System User Identity...........................................................16 Controlling Login Session Longevity.................................................................................................................17 Controlling Multithreading of the AccuRev Server............................................................................................17 Configuring Access to the Database ...................................................................................................................17 Server Logging...........................................................................................................................................................18 Time zone offset..................................................................................................................................................18 Logging Levels ...................................................................................................................................................18 UNIX/Linux: Log File Rotation .........................................................................................................................18 Controlling Server Log Verbosity.......................................................................................................................18 Verbose Server Logging......................................................................................................................................19 Server Watchdog ........................................................................................................................................................20 Watchdog Logging..............................................................................................................................................20 Controlling Server Operation.....................................................................................................................................20 UNIX/Linux: ‘acserverctl’ Utility.......................................................................................................................21 Windows: ‘Services’ Control Panel ....................................................................................................................22 Server-Control Files............................................................................................................................................22 Open Filehandle Limits and the AccuRev Server......................................................................................................23 Checking the Number of File Descriptors ..........................................................................................................23 Changing the Per-Process Open File Descriptor Limit.......................................................................................24 AccuRev Server Performance....................................................................................................................................25