Register for the iXsystems Community to get an ad-free experience and exclusive discounts in our eBay Store.

Update VM disk image instructions

Kris Moore

VP of Engineering
Administrator
Moderator
iXsystems
Joined
Nov 12, 2015
Messages
265
VM Installation Instructions for TrueCommand

While TrueCommand is built and updated as a Docker image, it can also be deployed and operated as a VM (Virtual Machine). To simplify the process, iXsystems has provided pre-built VMDK and VHDX images that can be easily deployed. Once TrueCommand is deployed as a VM, the standard tools are used to update TrueCommand within the VM.

Deployment Instructions:
  1. Go to https://www.ixsystems.com/truecommand/
  2. Submit the registration form at the bottom of the page
  3. After submitting the form, download options will appear. Download the correct VM disk image for your environment:
    1. VMDK - VMware / VirtualBox / Others
    2. VHDX - Microsoft Hyper-V
  4. Extract the ZIP file
  5. Create a Virtual Machine using settings similar to these
    1. OS Type - Linux x64 (Debian 10)
    2. CPU - 2 Cores
    3. Memory - 2GB or greater
    4. Network - Interface with routes to your TrueNAS or FreeNAS storage devices
  6. When prompted to create a disk, most virtual machine software will give you an option to “Create New” or “Select Existing Disk”. Choose “Select Existing Disk” and pick your VMDK or VHDX disk image that was extracted in step #2
  7. Power On your Virtual Machine
After your VM has finished booting, your console should show a page similar to this:




In your web-browser, open the displayed IP address, in this case http://172.26.100.124. Enter the default “admin / admin” credentials for the WebUI:



You will first be prompted to create a new Administrator Account:


After entering your new credentials, you will be prompted to use them to login, and at this point your TrueCommand setup is complete!

Update process:

Once the TrueCommand VM is operating, updates can be performed by rebooting the VM at any time. At bootup, the VM will check for updates to TrueCommand and apply them as necessary. To manually perform a reboot, login to the console with username: truecommand, password: truecommand and then run “sudo reboot” and enter the password “truecommand” when prompted.
 
Last edited by a moderator:

danb35

Wizened Sage
Joined
Aug 16, 2011
Messages
11,318
That's a big improvement over where the VM disk image was when it was first released, when it didn't even automatically start TrueCommand. But why not incorporate an automatic update, as described here?
 

aervin

iXsystems
iXsystems
Joined
Jun 13, 2018
Messages
34
Thanks for the feedback @danb35 -- the latest VM image should update TC automatically on every reboot, assuming the VM has internet access. Alternatively, you can restart the TC service manually while the VM is running.
 

kenmoore

TrueCommand Project Lead
iXsystems
Joined
May 1, 2019
Messages
40
As the update process section in Kris's post mentions, there is already an automatic update method included in the VM image.
You can trigger the update by rebooting the system, or once you login to the VM there is a quick "reference list" of commands, and restarting the TrueCommand service in the VM will also trigger the auto-update (it basically tries the auto-update every time the service starts up).
 

danb35

Wizened Sage
Joined
Aug 16, 2011
Messages
11,318
Yes, you've both confirmed there's a better mechanism to manually update the docker image, by restarting the VM. And it's definitely improved over where it used to be. But you're both missing my point--it's trivial, as Basil has demonstrated, to set the machine up to check for updates to the TC image, and automatically update it when updates are available. Why not configure the VM image to do the same? It's not because of hesitation to do auto-updates, or you wouldn't try them whenever the service starts.
 
Top