GitCentric™ User’s Help
Copyright and Trademarks
Preface
Audience
Using This Book
Typographical Conventions
Contacting Technical Support
License Issues
Other Support Issues
Other Resources
1. Concepts and Overview
What is AccuRev GitCentric?
Where to go for More Information
A Note About Terminology
Basic Architecture
GitCentric Users
GitCentric Administrators and Mapping Branches to Streams
Basic Rules
Mapped Behavior
Best Practices When Planning Your Installation
Keeping Git Merges and AccuRev Promotes in Sync
Best Practice for Keeping Merges and Promotes in Sync
Scenarios for Mapping Multiple Repositories to a Single Stream
Project-based
Security-based
Multiple Repos and Multiple Servers
AccuRev Replica Server Restriction
Configuring for Security
GitCentric Group-Based ACLs
Configuring Multiple Git Repos with AccuRev and EACLs
Getting Started
2. How to...
Procedures for All Users
Procedures for All Users
Get Started
Create an SSH key
Log In to GitCentric
Register with GitCentric
Set Preferences
Define and Display a Site Header or Footer for Gerrit Code Review
Create a Clone From a GitCentric Repository
Configure the Clone for Code Review (Optional)
Configure the Clone for Direct Push
Troubleshoot Git Clone Issues
Switch Between Gerrit Code Review and GitCentric
Procedures for Administrators Only
Configure AccuRev
Configure GitCentric
Create a Repository for GitCentric
Remove a Branch or a Repository
Remove a Branch
Remove a Repository
Import an Existing Git Repo
A Note About AccuRev Depots
Import a Snapshot of the Latest Heads into AccuRev
Import Complete Git History into AccuRev [BETA only]
I. Create Bare Repo and Check Admin Group Membership
II. Set ACLs on refs/*
III. Make a Clone of the Repo to be Imported
IV. Push the First Commit
V. Map the Repo to AccuRev
VI. Push the HEAD
Set General Attributes for a Repo
Create Branches for a Repo
Configure Access Rights (ACLs) for a Repo
General Procedure for Setting ACLs
Configuring ACLs for Code Review
Additional Considerations for ACLs
Label Verified
Configuring "Verify" for Continuous Integration
Disabling "Verify"
Configuring GitCentric ACLs for Direct Push
Map a Git Branch to an AccuRev Stream
Specify the Server and Service Account
About GitCentric Regular Expressions
Map the Branch to the Stream
Test Your Mapping Status
Create a Clone and Test It
Troubleshooting
Unmap a Git Branch from an AccuRev Stream
Add an AccuRev Server
Registering an AccuRev Server
Configuring the AccuRev Server
Configure Multiple AccuRev Servers
Manage GitCentric Groups
To View and Access Groups
Add a Group
Add a Member to a Group
AccuRev Groups
Configure AccuRev Element ACLs (EACLs)
Enable/Disable Code Review
Allowing Self-Reviews
Disabling Code Review
Enable Gerrit Code Review Replication
Overview
Registering the GitCentric Bridge SSH Key with Gerrit
Modifying the replication.config File
Enable and Use Change Packages
Troubleshoot Import/Export Operations
AccuRev to Git
Git to AccuRev
3. My Account
Menu Options
Profile
Preferences
Watched Repositories (Projects)
Contact Information
Public Keys
AccuRev Servers
HTTP Password
People
4. Code Review
Overview of Gerrit Code Review
Differences from Standalone Gerrit Code Review
Code Review for Users of Differing Backgrounds
Gerrit Code Review and AccuRev Mappings
Troubleshooting
5. Administration
Repositories
To Create a New Repository
To Configure an Existing Repository
General
Branches
Access
AccuRev Connector
Task Monitor
Support for Hooks
Migrating Existing Git Hooks
People
AccuRev Servers
A Note about the CLI Path Setting
A. The kandoMaintain Utility
Using kandoMaintain
Backup and Restore
kandoMaintain Command Reference
Commands
Options
Connection Options
Other Options
GitCentric Bridge Configuration Settings
Examples
B. Backup and Restore
The Backup Process
What are the GitCentric Databases?
Best Practices
Backing Up GitCentric
What Gets Backed Up?
Where the Backup File Gets Created
Before You Begin
How to Back Up GitCentric
Restoring GitCentric
Restore Scenarios
Overflow
Rollback
Missing Branch in the Repository Copy
Before You Begin
How to Restore GitCentric
C. Command-Line Reference
Basic Syntax
Basic Syntax
Spaces and Quoting
config-branch
config-repo
ls-repo
CLI Example
D. GitCentric Glossary
AccuRev®
GitCentric Glossary
overview_group_acls
howto_setprefs
howto_config_group_acls
gc_cli_ref_intro
config_branch
config_repo
ls_repo
glossary