Server Configuration > File Vaulting for Configuration Management > Configuring the File Vault
Configuring the File Vault
To configure the Configuration Management file vault on a Windchill RV&S server:
1. Stop the Windchill RV&S server.
2. Enable vault support by modifying the following property in the file under WindchillRVSServerinstalldir/config/properties:
When set to true, this property enables support for file vaulting on the Windchill RV&S server. When set to false, file vaulting is disabled.
3. Specify the vault location for this Windchill RV&S server instance. Modify the following property in the file under WindchillRVSServerinstalldir/config/properties:
si.vault.location=root directory of the Configuration Management file vault
For example:
The file vault location specified must be a directory other than the Windchill RV&S server installation directory.
The Windchill RV&S server requires read/write access to the file vault directory. Ensure that the account that is used to run the Windchill RV&S server has read/write access.
The path format used depends on which operating system the Windchill RV&S server is running on. If the server is running on Linux, the vault path must be a Unix-style path. On a machine running Windows, the vault path must be a Windows-style path, a direct UNC path, or a mapped drive for a network path. Forward slashes “\” are supported but they must be escaped with a second forward slash “\\”.
4. Ensure that the vault location directory exists on the file system before starting the Windchill RV&S server. If the vault location does not exist, the Windchill RV&S server will not start.
5. Start the Windchill RV&S server. At startup, Windchill RV&S performs a check of vault content to ensure that it is synchronized with the database. The sanity check validates that the latest vaulted revision content exists in the specified vault location. If the server startup check fails and the Windchill RV&S server fails to start, an administrator can bypass the server startup check to start the server. Modify the following property in the file under WindchillRVSServerinstalldir/config/properties: si.vault.bypassVaultSanityChecksUponStartup=true
When set to true, the server startup check is bypassed on startup. By default, this property is set to false.
When the server startup check fails, the server failing to start can be an indication of a more serious issue, such as file vault corruption. PTC strongly recommends that you restore the contents of the file vault from a viable backup before attempting to bypass the failure and start the server. For more information, see Backing Up and Restoring File Vaults.
6. In the Windchill RV&S administration client, enable the Use File Vault for Store by Reference Member Revisions configuration management policy. Revision data is not moved to the file vault until this policy is set globally or is set on specific configuration management projects. For more information on setting configuration management policies, see the topic “To set general policies”. For more information on this policy, see the topic “General Policy Options”.
Once the Windchill RV&S server is started, all newly created, eligible revisions are added to the file vault location for all or specific configuration management projects.
Existing revision data is not automatically added to the Configuration Management file vault. For more information on migrating existing data, see Migrating Existing Revisions to the File Vault.