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 ...
      • Tutorial: Adding a New Drawer Slide in the Foundation Library

        Adding a New Drawer Slide This article will demonstrate how to add a new drawer slide to the Foundation Library. Adding a new slide to your library will allow you to customize the drilling for the slide holes, the name of the hardware that appears on ...
      • 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 ...
      • Recent Articles

      • Toolbox Release Notes | Build 24.1.0416.641

        The following release notes apply to Toolbox build 24.1.0416.641. Maestro Toolfile Fix There was an issue with Maestro SCM Toolfiles reportedly experienced by some users, wherein the labels output by autolabeling would be in incorrect positions, an ...
      • Toolbox Release Notes | Build 24.1.0409.641

        The following release notes apply to Toolbox build 24.1.0409.641 Saw Delimited Processing Station Figure 1: The Saw Delimited option in a custom processing station. New options have been added to saw processing stations to allow for control over data ...
      • Toolbox Release Notes | Build 24.1.0328.641

        The following release notes apply to Toolbox Build 24.1.0328.641 Fillet Token Fixes Issues were discovered in the use of fillet tokens on products that also had the IRIB setting enabled: Some users processed work orders with rounded parts, which ...
      • Microvellum Foundation Library Release Notes | Build 24.0322

        Additions Added the Master Angled Ends Cabinet. Added a Global prompt, "Hinge Plate Offset From Front" for easier control. Added “Double Division” option to Horizontal Designer Cabinets, 3 Door Cabinets, and other similar products. Added a new ...
      • Common Floating License Connectivity Issues

        This document lists common issues reported by users regarding the topic of Microvellum’s Floating License Activation (FLA) and the connectivity required for FLA to function. Firewall Blocking Activation of Floating License Some users have had an ...