PVCS Version Manager Administrator’S Guide Copyright © 2018 Serena Software, Inc., a Micro Focus Company
Total Page:16
File Type:pdf, Size:1020Kb
PVCS Version Manager Administrator’s Guide Copyright © 2018 Serena Software, Inc., a Micro Focus company. All Rights Reserved. This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Serena. Any reproduction of such software product user documentation, regardless of whether the documentation is reproduced in whole or in part, must be accompanied by this copyright statement in its entirety, without modification. This document contains proprietary and confidential information, and no reproduction or dissemination of any information contained herein is allowed without the express permission of Serena Software. The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Serena. Serena assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. Third party programs included with the Dimensions product are subject to a restricted use license and can only be used in conjunction with Dimensions. Trademarks Serena, TeamTrack, StarTool, PVCS, Comparex, Dimensions, Prototype Composer, Mariner, and ChangeMan are registered trademarks of Serena Software, Inc. The Serena logo and Version Manager are trademarks of Serena Software, Inc. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. U.S. Government Rights Any Software product acquired by Licensee under this Agreement for or on behalf of the U.S. Government, its agencies and instrumentalities is "commercial software" as defined by the FAR. Use, duplication, and disclosure by the U.S. Government is subject to the restrictions set forth in the license under which the Software was acquired. The manufacturer is Serena Software, Inc., 2345 NW Amberbrook Drive, Suite 200, Hillsboro, OR 97006. Product version: 8.6.1 Publication date: August 2018 Table of Contents Part 1 Initial Setup. 11 Introduction . 12 Chapter 1 About Version Manager Project Databases . 13 About Project Databases. 14 About Version Manager Projects . 15 Planning a Project Database . 16 Workfiles . 17 Archive Locations . 17 Workfile Locations . 18 Shared Archives . 19 Upgrading 5.3/6.0 Projects. 20 Converting SourceSafe Databases . 21 Cross-Platform Environment . 21 Chapter 2 Creating Project Databases Using the Desktop Client. 23 Overview . 24 Creating a Project Database . 24 Creating a Project . 27 Adding Workfiles . 28 Sharing Archives . 32 Copying 5.3/6.0 Projects into Project Databases . 33 Chapter 3 Creating Project Databases Using the Command-Line Interfaces . 41 Overview . 42 Creating a Project Database . 42 Creating a Project . 44 Adding Workfiles . 45 Chapter 4 Setting Up Your File System . 47 Protecting Program Files and Project Data . 48 Protecting Program Files and Project Data on UNIX . 49 Protecting Program Files and Project Data on Windows . 50 Setting Up a Cross-Platform Environment . 50 Turning Off Setuid . 53 Editing the nfsmap File . 53 Setting PVCS_BINDIR . 54 Assigning Privileges . 54 Configuring Version Manager from the Desktop Client . 55 Configuring Version Manager from the Command Line . 61 Administrator's Guide 1 Table of Contents Making the Case of File and Directory Names Consistent . 63 Part 2 Configuring Servers . 65 Introduction . 66 Chapter 5 Configuring the Version Manager Application Server . 67 About the Version Manager Application Server . 68 About the Application Server’s Tomcat Installation. 68 Using the Application Server with a Third-Party Web Server . 68 Starting and Stopping the Application Server . 69 Starting and Stopping the Application Server on Windows . 69 Running the Application Server as a Windows Service . 70 Starting and Stopping the Application Server on UNIX . 71 About Web Server and WebDAV Servlets . 71 Chapter 6 Configuring and Using the Version Manager File Server . 73 About the Version Manager File Server . 74 Why Use the Version Manager File Server?. 74 How Compatible is the Version Manager File Server? . 75 How Does the Version Manager File Server Work?. 75 Installing the Version Manager File Server . 78 About Administrating the Version Manager File Server . 78 Starting and Stopping the File Server. 78 Launching the Version Manager File Server Administration Utility . 78 Managing Administrative Users . 79 Managing Project Database and Revision Library Paths. 80 Adding or Editing a Path Map . 81 Configuring Path Map Security Options . 83 Deleting a Path Map . 84 Assigning Work to Multiple File Servers . 84 Resolving Conflicting Path Maps . 85 Configuring the File Server . 86 Setting WorkDir & ArchiveWork Directives . 90 Viewing Server Status . 90 Viewing Server Status from the Version Manager File Server Administration Utility. 91 Viewing Server Status from the Desktop Client . 92 Viewing the Server Log. 92 Adding Project Databases to a Version Manager File Server . 93 Adding Existing Project Databases to a File Server Without Moving Them . 93 Using the Desktop Client to Copy Project Databases to a File Server . 99 Using PCLI to Copy Project Databases to a File Server . 100 Creating New Project Databases on a File Server . 103 Creating Revision Libraries . 103 Prerequisites. 104 Enabling the RFSSplitOnCreate Directive . 104 2 PVCS Version Manager Table of Contents Splitting Existing Archives . 105 Exporting, Importing, Moving, Renaming, and Fixing Archives. 108 Syntax . 108 Options . 108 Examples . 110 Using the File Server in a Cross-Platform Environment . 111 Security Considerations . 111 Creating a Default Access Control Database for Path Maps . 112 Enabling Secure Socket Layer on the File Server . 113 Configuring Clients for Use with File Servers . 113 Configuring File Server Access when the Desktop Client Is Installed . 113 Configuring File Server Access when Only the IDE Client Is Installed . 115 Specifying the Location of the Servers.ini File when the Desktop Client Is Not Installed . 116 How to Access File Servers from Version Manager Clients . 117 Securely Accessing a Version Manager File Server. 118 Chapter 7 Configuring the Version Manager Web Server . 119 About the Version Manager Web Server . 120 Version Manager Web Server Components . 120 How Version Manager Components Are Integrated . 122 About Configuring Servlets . 123 Servlet Name . 123 Description . 123 Servlet URL . 123 Project Database or Root (Windows) or rootPath (UNIX) . 123 Server (Windows) or serverName (UNIX) . 124 Web Server Application URL or trackerName and trackServerType . 124 Default Password (Windows).