The Maintenance Window
The Maintenance window in the Model Manager workspace shows all versions in all repositories and branches that an item has been saved to and that you are authorized to see. You can use the window to get an overview of the total footprint that a model makes in a database.
The set of versions shown in the window follows the current item selection in The Databases Window or The Model Manager Window (depending on which window is focused). Click Link with Selection () to disable this automatic linking. You can still update the Maintenance window with a new item by right-clicking and selecting Maintenance ().
The versions are shown in a table sorted in chronological order. At most 100 versions are initially shown. Click the Show More button () to include older versions in the table. If the viewed model is opened in the COMSOL Desktop, the corresponding model version row is highlighted in bold in the table. The table columns are:
•
The type column — the type of the item represented by an icon.
•
The Title column — the title set for the item in that version.
•
The Saved column — the time when the version was saved.
•
The Saved By column — the name of the user that saved the version.
•
The Repository column — the repository that the version was saved in.
•
The Branch column — the target branch of the commit in which the version was saved.
•
The Comments column — the optional comment provided when the version was saved.
When viewing the Maintenance window for a model, all versions of all drafts of the model are also included.
Viewing the table in the Maintenance window as “the version history” of a model can sometimes be misleading. Since versions of a model’s drafts are included in the table, and these drafts may have been worked on in parallel by multiple users, going from one version to the next in the table may not represent how the model has evolved over time. A similar observation holds when a model has been saved on multiple branches. The true version history of a model is best viewed in The Versions Window.
The Maintenance Window Toolbar
The toolbar in the Maintenance window contains the following toolbar buttons:
•
Click the Refresh button () to refresh the table in case any new versions have been saved. The table will automatically refresh if you save a new version to the database from the COMSOL Desktop.
•
Click the Show More button () to include older versions in the table.
•
Click the Link with Selection button () to enable or disable whether to automatically update the Maintenance window based on the current selection in the Databases window or the Model Manager window (which ever had focus last).
•
Click the Version Details button () to open The Version Details Dialog Box containing more information on the version.
•
Click the Estimated Disk Space Usage button () to open the Estimated Disk Space Usage dialog box — see Estimated Disk Space Usage.
•
Click the Open button () to open a selected model version in the COMSOL Desktop.
•
Click the Run button () to launch and run a selected version in the COMSOL Desktop. Only enabled if the selected version is an application.
•
Click the Preview File button () to open a selected file version using the default application for its file type.
•
Click the Compare button () to compare a selected model version with the model opened in the COMSOL Desktop. Select two model versions to compare them with each other.
•
Click the References button () to show version references for the selected version.
•
Click the Export to New Local Database button () to export the version to a new local database — see Export to New Local Database.
•
Click the Show Drafts button () to include the versions of all drafts of a model in the table.
•
Click the Permanently Delete All Drafts button () to permanently delete all drafts created from a model.
•
Click the Permanently Delete Selected Version button () to permanently delete a selected version in the table.
•
Click the Permanently Delete All Versions button () to permanently delete all versions of a model or file. For a model, all versions of all drafts created from the model will also be permanently deleted.
If you right-click a version in the table, you can also
•
Select Export () to export the version to the file system — see Exporting Items.
•
Select Branch () to create a new branch from the commit that the version was saved in.
•
Select Snapshot () to record a snapshot of the commit that the version was saved in.
•
Select Copy Location () to copy a text string with a URI that uniquely identifies a model or file version in the database to the clipboard.
•
Select Restore Version () to save the selected version as a new latest version of the model. See Restore Version.
•
Select Settings () to update the Settings window with the version.
Export to New Local Database
You can export a single model version to a new local database by clicking the Export to New Local Database button () in the Maintenance window’s toolbar. Select a name for the database directory in the New Local Database dialog box and click Save. You can then open the created database in the COMSOL Desktop — see Opening a Local Database.
Estimated Disk Space Usage
The Estimated Disk Space Usage dialog box contains an estimate on the total disk space used by all versions of a model, including all versions of drafts created from the model.
The upper part shows statistics on the model when including all its drafts. The bottom part shows statistics for only the drafts. The Versions field shows the total number of versions on all branches. The Data field is the estimated disk space usage for all versions, and the Computed Data field is the estimated disk space usage for Built, Computed, and Plotted Data.
Summing the estimated disk space usage of several models may result in an overestimate as identical files used by different models are never duplicated in the database, but will still be included in the usage estimate for each model.
•
Click the Permanently Delete All Versions button to permanently delete all versions of the model, including all versions of all drafts created from the model.
•
Click the Permanently Delete Drafts button to permanently delete all drafts created from the model.
•
Click one of the Delete Computed Data buttons to permanently delete all Built, Computed, and Plotted Data of either all versions of the model, including all versions of all drafts created from the model, or only from all drafts created from the model.