CLI Reference > Server Administration Commands > si migrate
si migrate
is used for backing up projects, members and their associated archives to the backup schema, and restoring them from that schema
si migrate [--publish] [--resume] [--rollback] [--dumpToBackup=projectList] [--restoreFromBackup=projectNames] [--[no]confirm] [--verbose=projectLocation]
si migrate is used for backing up projects, members and their associated archives to the backup schema, and restoring them from that schema.
Multiple migration-specific options may not be used together. For example, --resume and --rollback may not be used together.
If there is a temporary error, such as “file in use” or “project in use”, the migrator performs an automatic resume operation.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
displays a confirmation message before performing the command. The --confirm option is enabled by default.
copies projects to a backup database schema. The value for projectList specifies a selection of projects. For detailed procedures on copying projects to a backup database, see the Windchill RV&S Help Center.
commits newly restored projects and archives to the database repository and ends the migration session. The --publish option also generates output on the progress of the migration. Running a publish operation causes a resume operation to run first, allowing the migrator to capture any changes that were made when the repository was fully accessible.
continues an restore that was previously interrupted. The --resume option also re-migrates projects and archives that have changed since the migration began or since the last interruption occurred. This option can only be used after a previous restore was started and has stopped, before a rollback, or before a publish operation.
deletes all projects and archives in the database repository that have not been published, as well as objects that refer to them.
restores previously deleted projects. The value for projectNames specifies the names of projects to restore from the backup tables in the database. For detailed procedures on restoring deleted projects, see the Windchill RV&S Help Center.
more detailed information on the progress of the migration operation. Using the --verbose option increases the size of the migration.log file.
Using the --verbose option can degrade performance during a migration. Use this option only when required.
specifies the location of projects on the Windchill RV&S Server. By default, the migrator only migrates projects that are visible in the project registry. If your project registry contains invisible projects, you must locate the project within the file system, and use the si addproject command to add it to project registry.
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si createproject, si dropproject, si projectinfo, si viewproject, si viewprojecthistory
Miscellaneous: ACL, diagnostics, options, preferences