Note: this command does not physically move the slice. See the
chslice command in the
AccuRev CLI User’s Guide for more information.
When site is specified, the command verifies the existence of the AccuRev database as well.
When diag is specified, the command performs a series of diagnostics (server initialization, database connection, query execution, and database creation) and displays timing information for each one.
Note: Stop the AccuRev Server before running this command.
The dbupgrade wizard will prompt you through the options and values that you need to provide, including database admin name and password. If you are upgrading from AccuRev 4.x, the wizard gives you the option to perform a “dry run” upgrade -- one that does not write to the database -- to allow you to verify the UTF-8 changes that are required for the current AccuRev database before actually committing them. If you already have a UTF-8 database (AccuRev 5.2 and later) you will not be given the option for a dry-run because no UTF-8 conversion is required.
During the upgrade, dbupgrade checks and corrects (if necessary) the integrity of information in AccuRev depots. These integrity checks focus primarily on the
trans (transactions),
trans_entry (transaction-entries),
ver (version),
vvr (virtual-version), and
anc (ancestry) tables.
The --auto_commit option. If you have a large number of depots (several hundred or more), consider using the
--auto_commit option. The
--auto_commit option instructs
dbupgrade to commit each depot immediately after it is checked, rather than waiting until every depot has been inspected before committing all changes. This requires fewer database resources and can help speed the
dbupgrade process.
The discard command permanently deletes a snapshot or stream, provided it is unreferenced. This means it cannot have cross-links, children or references. An attempt to discard such will fail. Once deleted, the stream or snapshot may not be restored.
|
•
|
-s <stream>: Specify stream to be discarded.
|
|
•
|
-l <stream list>: Specify a file containing a list of streams to be discarded.
|
|
•
|
-v: display additional information.
|
|
•
|
-i: display only what is being discarded without actually deleting anything.
|
Note: Use of either
-s or
-l is required.
Makes a database user using the DB_USER and
DB_PASS values from the
acserver.cnf file in the AccuRev
bin directory. The AccuRev Server uses this username to communicate with the database.
The <backup-file-spec> can be either a file name (if the backup was saved to
$BACKUP_LOC) or the full path and name of the backup file.
Writes the <parameter> and
<value> specified to the
acserver.cnf file in the AccuRev
bin directory in the form
PARAMETER=value. If the
<parameter> is
DB_PASS, this command encrypts the plain-text password given as well.
When the update option is specified, the values that do not match are written from the
acserver.cnf file into the database.
For each AccuRev depot, displays the slice number (Slice#) and the full pathname to the directory within the repository that stores the data for that depot (
Location). Use the
all parameter to include deactivated (removed) slices in the listing. Use the
chslice command to change the location of a slice.
|
•
|
-q: computes the checksum of the .sto file and replaces the CRC value in the version record with the newly computed value.
|
|
•
|
-c: changes the .sto file by removing all its CR characters -- that is, all bytes with the value 0x0D -- and then performs the changes associated with -q.
|
|
•
|
-fx: Display the results in XML format.
|
Note:The size is the sum of all unarchived versions of the element kept and does not represent the size of the individual file. In addition, elements on Windows machines have the CR (Carriage Return) stripped from LR(Line Return)/CR and may actually be smaller than the actual file.