The Databases Window
The Databases window shows a tree with all databases you have added in the COMSOL Desktop. You typically use the tree to browse and administer the content of databases, including, for example, edit Database Configurations, add Repositories, create Branches, record Snapshots, and, for server databases, manage Users and Groups.
Click the Step In button () to show a subtree of the tree in the window. You can continue stepping into nodes until only leaf nodes are visible. Click Step Back () to return one step, or Step Home () to show the whole tree. You can toggle the visibility and appearance of various nodes in the Show menu () and the Item Tree Node Text menu ().
Toggling the Databases Window
Click the Databases button () in the Database toolbar to toggle the visibility of the Databases window.
The Databases Window Toolbar
The toolbar in the Databases window contains the following toolbar buttons:
•
Click the Step Home button () to show all nodes in the Databases window’s tree; that is, to return to the default tree view after stepping into nodes.
•
Click the Step Back button () to show the nodes previously shown before stepping into a node.
•
Click the Step In button () to only show the child nodes, and their descendants, of a selected node in the Databases window’s tree.
•
Click the Refresh button () to refresh the child nodes of the selected node.
•
Click the Show menu () to set visibility options for nodes.
•
Click the Item Tree Node Text menu () to set text options for nodes corresponding to models and files.
The Databases Tree
The top nodes in the Databases window’s tree are the Database Configurations of all databases that have been added to the COMSOL Desktop: local databases and server databases accessed via a Model Manager server.
The child nodes to the databases configurations consist of all Repositories you are authorized to see, as well as a Security node () containing child nodes related to user management. The Security node is hidden for a local database.
Each repository node contains a Branches node () and a Snapshots node (). The Branches node and the Snapshots node contain all Branches and Snapshots, respectively, you are authorized to see.
Each of the branch and snapshot nodes contain the latest versions of Items — that is, Models, Files, and Tags — with respect to the point in time of the corresponding commit. For a branch node, these are the latest versions at the present time, while for a snapshot, these are the versions that were the most recent ones at the time of the snapshot’s referenced commit.
See Locations and Commits for a discussion on how a branch and snapshot are associated with a specific commit, and how that commit in turn identify a subset of latest versions in the database.
The items are further organized into a subtree based on their assigned tags with respect to the corresponding commit — see also The Tag Tree. You may think of the branch node or snapshot node as representing a root tag in this subtree.
Select Items in the Show menu button () to see items under branch and snapshot nodes.
The items under a tag node are sorted on title, with a maximum of 100 models and files initially shown. When more items are available under a tag node, a Show More tree node () can be expanded to reveal the next 100 items. You can set another value for this default page size in the Result Page Size field on the Model Manager page in the Preferences dialog box.
The Security node contains a Users node (), a Groups node (), and a Permission Templates node (). Each one contains, respectively, all Users, Groups, and custom Permission Templates in the database.
Right-click a node and select Refresh () to refresh all child nodes of that node. You may find this useful, for example, to see changes made in a server database from another COMSOL Multiphysics program session, perhaps run by your coworker.
Deleting and Restoring Unversioned Database Objects
You can delete Repositories, Branches, Snapshots, Users, Groups, and Permission Templates by right-clicking their corresponding tree nodes and selecting Delete (). This deletion is not permanent but rather marks these database objects as hidden in the COMSOL Desktop by default.
Clicking Show () enables you to show deleted (hidden) nodes in the tree. You can right-click such nodes and select Restore () to remove their hide-marker, making them visible again everywhere in the COMSOL Desktop. The options set via the Show toolbar button also determines the visibility of deleted repositories, branches, and snapshots in The Select Location Dialog Box.
Permission templates can also be permanently deleted. Right-click and select Delete Permanently (). This requires that the permission template is not assigned to any items.