Updates¶
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.
Update Video¶
We have created a video called “NIM Updates” that walks through the update process:
NIM Updates from NIM Labs on Vimeo.
Additional NIM videos can be found here: https://nim-labs.com/videos
Updating NIM¶
The first step to updating NIM is to download the latest update from the NIM Client Portal.
This file will be named the NIM_Update_vX-X-X-XXXX.tar
where vX-X-X-XXXX
is the version of the update.
The 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 NIM_Update_vX_X_X_XXXXXX.tar
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:
NIM_X_X_X_XXXXXX_update
nim-update-local
Navigate into the NIM_X_X_X_XXXXXX
folder and execute the nim-update-local
script by typing:
sudo ./nim-update-local
IMPORTANT: This command needs to be run with sudo
.
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.
VM Updates¶
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.
Important
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:
sudo unattended-upgrade
This can take a minute to run and may require a reboot after completion.