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) page 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 OK. 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. After the first screen in which one resolves duplicates, a progress bar indicating the stages and status of various processes will appear. After these processes have been completed, one will have the Database Management window pop up to request a transfer between the existing database and the update package's contents. Click the "Transfer" button. Another duplicate resolution screen may or may not pop up, depending on the size of the update.
8. After the update has been completed, a pop-up will appear informing you that the process has been completed.
When updating, one will be faced with a progress bar that is not indicative of the update processing, but rather, an indication that the system is prepared for the transfer. When this pop-up is on the screen, it means the Database Management window is open and ready for transfer.
9. Restart Toolbox.
In
the case of missing custom specification groups or errors in the update, a backup 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. - 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Video Tutorials
The following videos explain the process of updating one's Foundation Library, addressing questions users may have when attempting to update their Foundation Library.
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 Catalog: Countertops
This document lists all products in the Countertop category of Microvellum's Foundation Library. Countertop products are products designed to be placed atop counters or placed along wall components to act as surfaces, coming in a variety of shapes to ...Foundation Library Catalog: Appliances
This document lists the full range of appliance products within the Microvellum Foundation Library. Appliances are non-cabinet products such as refrigerators, dryers, microwaves, intended to be placed into Microvellum project rooms for visualization ...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 ...
Recent Articles
Toolbox Release Notes | Build 24.1.1105.641
The following release notes apply to Toolbox build 24.1.1105.641 Nesting Fix Fig. 1: The fatal error that would occur during processing. There was reportedly an issue that occurred when clients attempted to process a work order using the nesting ...Microvellum Foundation Library Release Notes | Build 24.1025
The following release notes apply to Microvellum Foundation Library build 24.1025. Additions Added new global variable “Remove Stop Dado On Bottom Edge” for wood drawer boxes. Check this option to run the dado through at the bottom of the sub front ...Toolbox Release Notes | Build 24.1.1030.641
The following release notes apply to Toolbox build 24.1.1030.641 Routing and Profile Fixes Several issues were found with routing and polyline paths: Fig. 1: Horizontal routes off of a part disappearing (left) and appearing correctly (right). When ...Toolbox Release Notes | Build 24.1.1010.641
The following release notes apply to Toolbox build 24.1.1010.641 Biesse Winstore Fix Several issues with the Biesse Winstore plugin have been resolved: There was an issue that would sometimes occur wherein materials that were intended to stack wound ...Toolbox Release Notes | Build 24.1.1001.641
The following release notes apply to Toolbox build 24.1.1001.641 HBore Toolfile Fix Fig. 1: The location in the Toolfile UI where the error would occur. There was an issue reported with the functionality of the Horizontal Boring Machine setting in ...