Library version history
The Spotfire library provides the ability to keep old versions of files in the library, so that you can easily revert to an older version of a file, if something goes wrong.
When your library contains large analysis files, for example, files with embedded data, or files that are updated often, you might want to manage the number of versions of an analysis that are saved.
There are plenty of opportunities to fine-tune your settings to make sure the size of your Spotfire library is kept on a reasonable level. See Deleting old versions of files in the library and Deleting library item versions using the command line for more information.
It is recommended to define a policy about how many versions to save, or over what time frame old versions should be kept. You can configure a scheduled job on the Spotfire Server to run that will remove library versions based on the specified policy. A scheduled job can be configured using an operating system scheduling program like Windows Task Scheduler or Linux cron.
- Reverting to a previous version of a file
If an analysis or other type of file has become corrupted when it was modified, you can use the versioning functionality in the library to revert to a previous version of the file. You can also look at previous versions to review the library version history of a file. - Deleting old versions of files in the library
If your library grows too much, you can delete all, or some, old versions of a file using the commanddelete-library-versions
. Single old versions can also be deleted directly from the Library user interface. - Adding a name or description to a version
When library version history is enabled, you can name a specific version, or add a comment to it, to easily determine the content or status of that particular version of a file. - Switching off library versioning
A new version of all files is by default kept each time a file is updated in the library. As an administrator, you have the option to switch off version history for your Spotfire environment. Use the command line configuration tool and setlibrary.versioning.enabled
tofalse
to disable library versioning completely. You can also choose to exclude certain item types only. - Spotfire item types
There are a number of different types of items available in the Spotfire library. They can be referred to in certain configurations, and they can also be used as arguments in different commands.
- Reverting to a previous version of a file
If an analysis or other type of file has become corrupted when it was modified, you can use the versioning functionality in the library to revert to a previous version of the file. You can also look at previous versions to review the library version history of a file. - Deleting old versions of files in the library
If your library grows too much, you can delete all, or some, old versions of a file using the commanddelete-library-versions
. Single old versions can also be deleted directly from the Library user interface. - Adding a name or description to a version
When library version history is enabled, you can name a specific version, or add a comment to it, to easily determine the content or status of that particular version of a file. - Switching off library versioning
A new version of all files is by default kept each time a file is updated in the library. As an administrator, you have the option to switch off version history for your Spotfire environment. Use the command line configuration tool and setlibrary.versioning.enabled
tofalse
to disable library versioning completely. You can also choose to exclude certain item types only. - Spotfire item types
There are a number of different types of items available in the Spotfire library. They can be referred to in certain configurations, and they can also be used as arguments in different commands.