si migrate
is used for backing up projects, members and their associated archives to the backup schema, and restoring them from that schema
Synopsis
si migrate [--publish] [--resume] [--rollback] [--dumpToBackup=projectList] [--restoreFromBackup=projectNames] [--[no]confirm] [--verbose=projectLocation]
Description
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.
|
Options
This command takes the universal options available to all
si commands, as well as some general options. See the
options reference page for descriptions.
• ----[no]confirm
displays a confirmation message before performing the command. The --confirm option is enabled by default.
• --dumpToBackup=projectlist
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.
• --publish
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.
• --resume
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.
• --rollback
deletes all projects and archives in the database repository that have not been published, as well as objects that refer to them.
• --restoreFromBackup=projectNames
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.
• --verbose=projectlocation
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.
|
• projectlocation...
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.
Diagnostics
See the
diagnostics reference page for possible exit status values.
Preferences
Using
si setprefs or
si viewprefs, you are able to set or view the preference keys for this command.
See Also