Command Line Server Console

You can run the server console as a command line utility to back up, restore, and migrate vaults and Content Center libraries.

NoteAutoCAD Civil 3D does not use Content Center libraries.

You can run the server console as a command line utility to back up and restore vaults.

Run the server console from the command line:

Click Windows Start Run, and then enter cmd in the Run dialog box.
Change directories to the install directory for the server console. By default, this path is C:\Program Files\Autodesk\ADMS <application><year>\ADMS Console, where application is the Autodesk Vault edition, and year is the release year (such as Professional 2013).
At the command line, enter: Connectivity.ADMSConsole.exe followed by the command line options, and then press Enter.

Back Up the Vault

The backup switch requires a vault administrator account.

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

NoteIf using Autodesk Vault Collaboration or Autodesk Vault Professional the Hot Backup feature allows the backup to run while users are connected to the Vault.

-Obackup	The operation being performed (required).
-Bfolder	The back up directory (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required unless password is blank).
-VAL	Validates the backup. Errors are recorded in the specified log file. See Optional Switches for more information on specifying a log file.
-INCR	Performs an incremental backup.
-DBSC	Excludes the standard content libraries from the back up process. The standard content libraries are detached before backing up the vault, the vault is backed up, and then the standard content libraries are reattached.
-DBUsaUser	The SQL sa account user name (required unless default configuration).
-DBPsapassword	The SQL sa account password (required unless default configuration).
-INRF	Ignore non-replicated files. If this switch is not present in the command line, files will get replicated prior to the backup starting.

Example

Connectivity.ADMSConsole.exe -Obackup -BC:\Backup -VUadministrator -VPadmin -VAL -LC:\Backup\BackupLog.txt

NotePaths containing spaces must be inside of double quotes (for example, "C:\Vault Backup").

Using Tape Backup Software with a SQL Server Plug In

If you use backup software that supports Microsoft SQL server, such as Veritas Backup Exec, then you can select the vault server during your standard backup.

NoteWe recommend using the supplied utility. Using it backs up the SQL data and the file store giving you more predictable results.

Restore the Vault

The restore switch requires a vault administrator account and a database administrator account, unless the default database account is still valid. The restore command does not automatically migrate data. If restoring the vault data to an upgraded vault server, migrate the data immediately after restore.

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Orestore	The operation being performed (required).
-Bfolder	The back up directory (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required unless password is blank).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).
-Tfolder	The target database location (optional). If used with the -TL switch, this will be the target location for the MDF database file.
-TLfolder	The target database log file (LDF) location (optional).
-Ufolder	The target file store location (optional).
-INCR	Performs an incremental restore.

NoteBy default, the restore command restores both components to their original locations. If the -T is not used, then the database is restored to the default location defined in the MSDE SQL installation. If the -U is not used, then the file store is restored to its original location.

Example

Connectivity.ADMSConsole.exe -Orestore -BC:\Backup -VUadministrator -VPadmin -DBUdbadmin -DBPdbpword -LC:\Vault.txt

NoteYou specify the name and location of the backup from which you want to restore. Paths containing spaces must be inside of double quotes (for example, "C:\Vault Backup").

Migrate Vault Data

Migrating vault data applies whatever changes are necessary to the database schema following an upgrade of the vault server. Always migrate data following an upgrade of the vault server. The migrate switch requires a vault administrator account and a database administrator account, unless the default database account is still valid.

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Omigrate	The operation being performed (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).

Example

Connectivity.ADMSConsole.exe -Omigrate -VUadministrator -VPadmin -DBUdbadmin -DBPdbpword

Purge File Versions

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Opurge	The operation being performed (required). If this operation is executed without any other switches, the task will run based on revision and lifecycle rules without affecting uncontrolled files.
-Nvault name	The name of the vault to be purged (required).
-Stop	Halts the purge task while it is running.
-Normal	Sets the purge task to a normal system priority.
-KEEPVERSnumberX	Keep the latest X number of versions (optional). The value can range between 1 and 99. The default value is 1.
-MINAGEnumberX	Purge versions older than X number of days (optional). The value can range between 0 and 180. The default value is 0.
-EXCLCMTcomment	Purge versions that do not contain the specified comment (optional). The default value is an empty string, "".
-UNCONTROLLED	Purges versions based on default settings and the revision and lifecycle rules. If used in conjunction with -KEEPVERS, -MINAGE, or -EXCLMT, then the system purges uncontrolled files as well as files based on revision and lifecycle rules.
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).

Example

Connectivity.ADMSConsole.exe -Opurge -NVault -KEEPVERS3 -MINAGE30 -EXCLCMT"Do not purge" -VUadministrator -VPadmin

Re-index File Properties

Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Oreindexfileproperties	The operation being performed (required).
-Ndatabasename	The name of the database to be re-indexed (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-ALL	Re-indexes all versions of files (optional). If included, all version are indexed. If not included, only the latest versions of the released versions are indexed. NoteSee Understanding Revisions in the main client help for more information.
-EXTextensions	File extensions filter (optional). Enter values separated by ',' or ';' without spaces. With or without '*' or '.'
PROVIDERcontentsourceproviders	Content source providers filter (optional). Enter values separated by ',' or ';' without spaces. Use the following system name for each provider: AutoCAD–AutoCAD_PropertyProvider AutoCAD Electrical–AutoCADElectrical_PropertyProvider Inventor DWG– InventorDwg_PropertyProvider Inventor– Inventor_PropertyProvider Revit– Revit_PropertyProvider Office 97-2003 Documents– Office_PropertyProvider Office Documents– OfficeOpenXml_PropertyProvider All Files– IFilter_PropertyProvider AutoCAD C3D– AutoCADC3D_PropertyProvider Sheet Set Data–SSM_PropertyProvider
-FROMstartdate	Start date filter (optional) Use mm/dd/yyyy format
-TOenddate	End date filter (optional) Use mm/dd/yyyy format
-FORCE	Force all files or latest files to be cracked open and re-indexed (optional)
-STOP	Terminates the re-indexing operation (optional). Once stopped, re-indexing cannot be started from the point at which it left off.
-NORMAL	Bumps the process priority from "Below Normal" to "Normal" (optional). The priority cannot be changed once the re-indexing operation is initiated. If the -NORMAL switch is used, re-indexing will complete sooner; however, server performance will degrade due to the higher priority of the operation.

Examples

Connectivity.ADMSConsole.exe -Oreindexfileproperties -NVault -VUadministrator -VPadmin

Connectivity.ADMSConsole.exe -Oreindexfileproperties -NVault -VUadministrator -VPadmin -STOP

Connectivity.ADMSConsole.exe -Oreindexfileproperties -Nvault -VUadministrator -VPadmin -TIP -FORCE -EXTipt,iam -PROVIDERAutoCADElectrical,OfficeOpenXml -FROM5/10/2011 -TO5/20/2011

Rebuild Search Index Data

Defragment a Vault Database

Import a Library

The server console command line can be used to import libraries.

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Oimportlibrary	The operation being performed (required).
-NLibraryName	The database name of the library to import (required).
-DFdataFilePath	The path to the data file being imported, including the name of the file (required).
-DLlogFilePath	The path to the log file being imported, including the name of the file (required).
-ZIP	A switch that indicates the data file is a Zip file containing both the .mdf and .ldf files (required regardless if the file specified in the -DF switch ends with a .zip extension).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).

Example

Connectivity.ADMSConsole.exe -Oimportlibrary -N"Inventor Standard Content" -DF"c:\My Library Repository\Inventor Standard Content.mdf" -VUadministrator -VPadmin -DBUsername -DBPassword

Export a Library

Attach a Library

The server console command line can be used to attach libraries.

Make sure no users are connected to the vault.
Run Connectivity.ADMSConsole.exe from a command line with the following switches:

-Oattachlibrary	The operation being performed (required).
-NLibraryName	The database name of the library to attach.
-DFdataFilePath	The path to the data file being attached, including the name of the file (required).
-DLlogFilePath	The path to the log file being imported, including the name of the file (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).

Example

Connectivity.ADMSConsole.exe -Oattachlibrary -N"Inventor Standard Content" -DF"c:\My Library Repository\Inventor Standard Content.mdf" -VUadministrator -VPadmin -DBUsername -DBPassword

Detach a Library

Defragment a Library Database

Rename a Server

Validate File Store

Optional Switches

The following switches are optional and can be used with the command line operations.

-WA	Use Windows Authenticaion for a command that requires a vault user name and password. Use in place of -VUusername and -VPpassword.
-S	Run the utility in silent mode without any message boxes.
-L	Specify the name and location for a log file. If the log file already exists, the output is appended to the file specified.

-OSiteRename	The operation being performed (required).
-SNOpreviousname	The current name of the computer to rename (required).
-SNNnewname	The new name for the computer being renamed (required).
-DBUsaUser	The SQL sa account user name (required).
-DBPsapassword	The SQL sa account password (required).

-ORebuildsearchindexes	The operation being performed (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).

-Odefragmentvault	The operation being performed (required).
-Ndatabasename	The name of the vault database to be defragmented (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).

-Oexportlibrary	The operation being performed (required).
-NLibraryName	The database name of the library to export (required).
-TtargetDirectory	The path to store the exported library (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).

-Odetachlibrary	The operation being performed (required).
-NLibraryName	The database name of the library to detach.
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).
-DBUusername	Database account user name (required unless default configuration).
-DBPpassword	Database account password (required unless default configuration).

-Odefragmentlibrary	The operation being performed (required).
-NdatabaseName	The name of the library database to defragment (required).
-VUusername	Vault administrator account user name (required).
-VPpassword	Vault administrator account password (required).

Command Line Server Console

See Also