NIM updates are delivered as
.tar files that can be downloaded from the NIM Client Portal.
NIM updates include all previous updates so you only need the latest update file to be current.
We have created a video called “NIM Updates” that walks through the update process:
Additional NIM videos can be found here: https://nim-labs.com/videos
The first step to updating NIM is to download the latest update from the NIM Client Portal.
This file will be named the
vX-X-X-XXXX is the version of the update.
NIM_Update_vX-X-X-XXXX.tar file needs to be accessible from the NIM VM.
To do this you can upload the update file to the NIM VM using SFTP or a shared folder location.
If using SFTP, login to the NIM VM with the VM IP address, username, and password.
Copy the update file to the NIM VM and exit your SFTP program.
Login to the NIM VM console.
Navigate to the folder containing
Type the following command to unpack the update (replacing the file name with the actual name of the update):
tar -xvf NIM_Update_vX-X-X-XXXX.tar
This will create a folder named
NIM_X-X-X-XXXX containing a directory and a script file:
Navigate into the
NIM_X_X_X_XXXXXX folder and execute the
nim-update-local script by typing:
IMPORTANT: This command needs to be run with
The script will check the amount of available space on your VM before performing the update. If there isn’t enough space to perform the update, it will tell you how much space you need to free up.
Next, the script will tell you how much space your apache log files are taking up and give you the option to clear them out.
Finally, before the update runs, you will have the option to back up your NIM database. If you choose to do so, the backup will overwrite any previous backups performed by this update script. Any exising backups can be found at: /home/nim/database-backups
After the backup step, the script will provide output as it performs various updates. When complete, you will see NIM successfully updated to version X.X.X.XXXXXX!.
Log into NIM and go to the Main Menu / Help / Licensing section.
The version information located in will be updated to reflect the current version.
The NIM VM is distributed as an Ubuntu VM and in most cases can be administered directly as needed. However you should not manually update packages on the VM as this can conflict with NIM’s operation.
Do not manually update packages on the NIM VM. All required packages will be updated with subsequent NIM Updates. Manually updating the VM packages can potentially break NIM.
VM Security Updates¶
The NIM updates typically handle all core applications updates required to keep NIM up to date. However OS security updates are continually made available by the Ubuntu community. If your NIM VM is online you can run the security updates with the following command at the VM command line:
This can take a minute to run and may require a reboot after completion.