1. Setting Up AccuRev®

1. Setting Up AccuRev®
This chapter describes how to perform initial data setup using either AccuRev’s Quick Setup Wizard or equivalent manual procedures. It assumes you are familiar with basic AccuRev concepts such as depots and workspaces as described in the AccuRev Concepts Manual.
Before You Begin
Identify a directory that contains files that you want to place under version control and note its pathname (c:\myfiles\src\, for example). The directory you choose can have subdirectories. The data in these directories is not modified during initial data setup -- AccuRev makes a copy of it.
Note that while you can place files under AccuRev control at any time, you might find it more convenient to do so during the initial data setup.
In addition, consider preparing a list of users for whom you want to create AccuRev accounts.
Using the Quick Setup Wizard
This section describes how to use the AccuRev Quick Setup Wizard to quickly get files under AccuRev control.
1.
Alternative: In a Command Prompt window, enter acgui.
If this is the first time you are starting AccuRev, the AccuRev Quick Setup Wizard appears.
If the Quick Setup Wizard does not appear, choose Help > Quick Setup from the AccuRev menu.
2.
Review the quick setup process, then click the Next button to start the wizard.
Note: Names for all AccuRev entities (usernames, depot names, workspace names, and so on) are case-sensitive. Usernames john and JOHN are considered to be different, for example.
3.
4.
5.
Select Yes when asked "Do you have files that you would like to import into AccuRev?"
Select Yes when asked "Do you want to create a workspace in a new location …?"
6.
Manual Set-Up Procedures
Use the procedures in this section to perform you initial data set-up manually.
Create an AccuRev Username and Password
1.
Select Admin > Security from the AccuRev main menu.
2.
On the Users tab, click the Add User button () to create a new user.
3.
4.
5.
Select Tools > Login from the AccuRev main menu.
6.
7.
Create a New Storage Depot
1.
Select File > New > Depot from the AccuRev main menu.
2.
3.
Click Ok (and continue to the next operation).
Create a Workspace to Store Your Work
1.
Click Yes (“Do you want to create a workspace for the depot?”).
2.
Click Next to select your newly created depot, and the stream that has the same name as the depot.
3.
Choose a physical location for the workspace (example: C:\ws\widget) and click Next to accept the default name for the workspace.
4.
Click Next to accept defaults for the new workspace.
5.
Click Finish.
Import Files into Your Workspace
Use operating system commands to copy the directory and files you identified in Before You Begin on page 1 into the workspace directory on your file system. For example:
xcopy /E /Y c:\myfiles\src\* c:\ws\widget)
Add the Files in Your Workspace to the Depot
If your newly created workspace is not already open in the AccuRev GUI, open it by clicking the Open Workspace button on the toolbar (Alternative: Select File > Open Workspace from the AccuRev main menu).
1.
All the files listed in the Details pane should have a status of (external).
2.
3.
Click the Promote button () in the toolbar.
Alternative: Right-click and choose Promote from the context menu.
Tip: Promote automatically performs a Keep operation on any files that require it.
4.
(optional) In the Promote dialog box, enter a comment string.
Tip: Comments that you enter during Promote and other operations become part of the history of those files.
5.
Click the Promote button.
The files you just added to your workspace are now available to other users with workspaces that share the same parent stream. They are no longer visible in Outgoing Changes mode because their status has changed from (external) to (backed). Click the Workspace Explorer button to change modes; the files you just promoted are displayed here.
Update Your Workspace
Click the Update button () to update your workspace with changes promoted by other users with workspaces that share the same parent stream.
Keeping your workspace up-to-date with frequent Update operations greatly improves workspace-search performance.
Next Steps
After completing the initial setup, your users can start using AccuRev as described in Getting Started with AccuRev.

Borland