User’s Help
Preface
Audience
Using This Book
Typographical Conventions
Contacting Technical Support
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
Generate an HTTP Password
Create a Clone From a GitCentric Repository
Configure the Clone for Code Review (Optional)
Configure the Clone for Direct Push
Troubleshoot Git Clone Issues
View Commit History
Information Displayed on the Commits Page
Review a Commit’s Files
Starting from the Commits Page
Starting from the Source Tree Page
Information Displayed on the Source Tree Page
Compare Branches
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
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
Avoid Git Reserved Name for AccuRev Elements
Specifying the AccuRev Server Connection
What to Do Next
Mapping the Branch to the Stream
Test Your Mapping Status
Create a Clone and Test It
Troubleshooting
Unmap a Git Branch from an AccuRev Stream
Enable and Use Change Packages
Specifying the Commit Message Format
About GitCentric Regular Expressions
Troubleshooting Change Package Errors
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
Troubleshoot Import/Export Operations
AccuRev to Git
Git to AccuRev
Set Up Gerrit Garbage Collection
Gerrit gc Syntax
cron job Examples
3. My Account
Opening the My Account Page
Menu Options
Profile
Preferences
Watched Repositories (Projects)
Contact Information
Public Keys
AccuRev Servers
HTTP Password
Avoiding Password Entry
People
4. Code Review
Opening the Code Review Page
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
Opening the Administration Page
Repositories
To Create a New Repository
To Configure an Existing Repository
General
Branches
Access
AccuRev Connector
Status 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
Commands for Backup and Restore
Best Practices
Backing Up GitCentric
What Gets Backed Up?
What are the GitCentric Databases?
How to Back Up GitCentric
Restoring GitCentric
Caution: Restore Overwrites Existing GitCentric Installations
Prerequisites
What Gets Restored?
How to Restore GitCentric
Next Steps
If You Restored to a New Location
If You Restored to a New Machine
If You Restored to the Same Location
Restore Scenarios
Overflow
Rollback
Missing Branch in the Repository Copy
C. Command-Line Reference
Basic Syntax
Basic Syntax
Spaces and Quoting
config-branch
config-repo
delete-repo
ls-repo
CLI Example
D. GitCentric Glossary
Index
GitCentric™
Index
overview_group_acls
howto_setprefs
howto_config_group_acls
gc_cli_ref_intro
config_branch
config_repo
delete_repo
ls_repo
glossary