Library Update Utility

Library Update Utility

This article provides details on the process of updating the Foundation Library through the Library Update Utility feature. 


To be able to use the Library Update Utility feature, your current library must be version 22.0729 or newer, and you must have Toolbox version 22.1.1017 or newer to have the Library Update Utility button show up in your utilities interface. It is recommended to be updated to Toolbox version 22.1.1123 to avoid a possible update at the project level instead of in the template. Please talk to your account manager for more details if your library version is too old.
Note that Reports are not updated with this utility. Please visit the reports download section for the latest report updates.

Run Library Update Utility

1. Locate the appropriate Update Package zip file from the Foundation Library Download (All Regions) knowledge base article and download it. Once the download is complete, it is recommended to place the zip file on your desktop for easier access. 

2. Open Microvellum Toolbox and select "Options" from the Toolbox Setup drop-down menu.

3. Select the "Utilities" menu on the far right of the dialog box and then select the "Library Update Utility" button.


4.  A reminder will appear to back up your current library as data will be overwritten. (It is recommended to select all specification group components to update). 


5. Select the browse button and navigate to the zip file you downloaded. Select okay. Note: The zip file does not need to be extracted manually.

6. Depending on the update file size, after a few minutes a Resolving Duplicates interface will appear. If there are certain products you do not want overwritten, this interface will allow you to skip the update for this particular product, or keep it along with the updated version.



7.  Restart Toolbox.

In the case of missing custom specification groups or errors in the update, a back up folder containing the old data will be saved in a subfolder among your software data. To restore this information simply click the Library Restore Utility button and select the backup folder to reverse the update.


    Library Update Utility Best Practices

    ‚ÄčIt is best to wrap up and complete any ongoing projects before running a library update. Occasionally, new variables are added to specification group files such as globals, wizards, and/or material pointers. When this happens, the utility will only update the template spec group files and not your project spec group files. So, when adding additional products to the existing projects, these new products will be lacking dependent variables, causing errors. This can be quickly remedied by using the revert feature in your project spec group interface. However doing this will cause any project specific settings to also revert, requiring you to set them up again. If there are too many settings to change, it may be easier to manually update the original project global/wizard with whatever new variables that have been added. 
    1. All stock products and subassemblies will be overwritten. However, there is an opportunity to "skip" certain products and subassemblies. But, doing so will result in those becoming an older version, which can lead to errors. The best practice is to leave the vanilla stock products and subassemblies alone and save any modified custom products in a different folder with a different name. This will ensure they are protected from being overwritten.
    1. Do NOT rename product or subassembly categories in the database. The update will assume that this category is missing and create it again in the database causing duplicates of each product.
    1. No materials are deleted or removed, but new materials may be added periodically, including hardware. These new materials will be appended to your existing materials and will appear uncategorized in the user interface. You will need to categorize (move) the new materials to a folder of your choosing.
    1. No spec group (global or wizard) workbook files will be overwritten. The utility can append new variables as needed and can also insert new rows into existing look-up tables. Occasionally, if necessary to correct an issue, the utility may change a variable's value, but this is uncommon and should only happen to formulas that need to be updated. Hard values, such as default distances or setbacks, should never need to be updated as they are user settings. Changing them could cause problems.
    1. The Factory workbook may also be appended. A common update would be the addition of a new drawer system, in which case the new subassembly would be added, and the Factory (F) workbook would have the LookUpTableListOptions updated to include the new drawer option.
    1. If you ever have any questions about what the utility is going to do, you can unzip the update and examine the contents. Whatever is in there is what the utility is going to do. However, this is only recommended for advanced MV users and editing the contents is not recommended as it could have undesired repercussions in the future. It is a great way to see what each update is going to do.



      • Related Articles

      • Tutorial: Foundation Library Dowel & Screw Patterns

        The most recent releases of the Microvellum Foundation Library (library version 23.0609 onward) have made a few noteworthy changes to the available settings of dowels and screw patterns. This article and video were created to document those changes, ...
      • Foundation Library Subassembly Inserts

        Foundation Library Subassembly Inserts This article will provide you with an overview of the Subassembly Inserts included within Microvellum's Foundation Library. Each subassembly has its own set of configurable options and can be inserted into a ...
      • Foundation Library Options

        This article provides a list and detailing of the options available for products in the Microvellum Foundation Library. Construction Methods See below for a collection of screenshots showing the various construction methods available. These can be ...
      • Overview: Foundation Library Handles and Pull Tabs

        The video below covers working with Handles and Pull Tabs within the Microvellum Foundation Library. How to View Handles/Pulls To view the available handles and pulls in your Library: Open Toolbox. Go to the Toolbox Setup menu and choose Library ...
      • Foundation Hardware Highlight: Blum

        Microvellum’s Foundation Library is built on the premise of providing our users with the best quality hardware for their construction projects, be they commercial, residential, or anything otherwise. As such, Toolbox has hardware from multiple brands ...
      • Recent Articles

      • Toolbox Release Notes | Build 23.1.0921.641

        The following release notes apply to Toolbox build 23.1.0921.641 Cumulative Library Updates Fix Figure 1: Cumulative Update issue. There was a bug noted by users while attempting to download the Foundation Library’s phase 1 cumulative update and ...
      • Microvellum Foundation Library Release Notes | Build 23.0919

        Additions Added new product Master Double Sided Cabinet. Added “Horizontal Handles Centered” global option to all doors. This is available for all tab pulls, handles, and knobs. Added a new DRAWRECTANGLE 2D plan token to the door subassemblies. This ...
      • My Cases: Case Details

        Once you've logged into the Client Portal and navigated to the My Cases area, simply click on the case title to access the case details page. Here, you can thoroughly review the case description, append additional comments, upload attachments, and ...
      • My Cases: Overview

        Once you've logged into the Client Portal, accessing your support cases is a breeze. You can simply click on the "My Cases" icon in the flyout menu or choose the "View Cases" button conveniently placed on the Welcome page. Inside this section, you'll ...
      • Uploading Attachments to Support Cases

        Support case attachments are files or documents attached to a support case or ticket, serving the purpose of providing additional information, context, or evidence relevant to the reported issue. These attachments can encompass a wide range of file ...