4 minute read
There are a couple of different ways to install a MCX-OS image onto your Controller.
- For a GCC or Industrial PC you will need to create a MCX-Imager USB-Stick, copy your new MCX-OS Image onto the Stick, boot your Controller from the stick and restore the image to the Controller’s harddrive.
- For a Rasberry Pi you will need to transfer the appropriate MCX-OS Image to the Pi’s SD Card.
- To use a Virtual Machine as your Controller, you need to convert the MCX-OS Image to a Virtual Box Image.
Please choose what kind of method you will use to install your Controller:
|MCX-Imager USB-Stick||SD Card||Virtual Machine|
To install a MCX-OS Image on your controller you will need to create an MCX-Imager USB-Stick. The MCX-Imager USB-Stick is a bootable USB drive that can be used to create backups and restore images of Motorcortex Systems.
You will need an empty USB Drive of at least 8 Gb. Creating a MCX-Imager USB-Stick is different for every OS. Please select the OS that you are using.
Creating a MCX-Imager USB-Stick (For Linux)
Before we start you will need an
USB Stick of at least 8Gb and at least 7Gb of free space on your PC.
Motorcortex.io Users can download the latest
MCX-Imager USB-Stick Imagefrom the
Shopby pressing the button below:
.zipfile, After extracting you should have a 6Gb
Insert your empty USB Drive into your PC. Beware that we will erase everything that is already on your USB Stick.
Right-click on the
.imgfile and select
Disk Image Writer.
In the following window select the drive you want to write the MCX-Imager image file to and hit the
Make Startup Diskbutton.
When restoring of the image is complete, the system should automatically mount the ImageData partition of the USB-Stick.
Copying the MCX-OS Image to your MCX-Imager USB-Stick
- Copy the MCX-OS Image
.img.xzfile into the
ImageDatafolder of you USB-Stick.
Booting your Controller from the MCX-Imager USB-Stick
Make sure your Controller is turned off.
Insert the MCX-Imager USB-Stick into your Controller.
Turn the Controller on.
Your Controller should automatically boot from the Motorcortex-Imager USB Drive. If it does not boot automatically from USB check your Controller’s BIOS settings to enable booting from USB.
Log in to the MCX-Imager terminal
There are 2 ways to access the terminal of the MCX-Imager:
By attaching a
Displayto your Controller. The screen should immediatly show you a similar screen like below.
SSHconnection on your laptop.
Connect your controller with your pc using the Ethernet port (In the virtual machine this is already set-up).
Make sure the ip address of your network adapter that is connected to the Controller is in the 192.168.2.xxx range (do not use 192.168.2.100)
Connect to your Controller by typing:
log in with password
The terminal should inmediatly show you a similar screen like below.
Installing an MCX-OS image onto your Controller
- To start the restore procedure type
sudo mcx-restore -f
TipThe -f option will expand the image to use the full disk size, this is useful if you are restoring a truncated image and you wish to use all available disk space on the target system.
- Now the prompt will ask you what image you would like to restore. Choose the image that you would like to restore.
- Second the prompt will ask you to choose the drive where you want to restore your image to.
- Restoring the image will take some time. When the process is done, check for any errors in the console
WarningMake sure that the image will fit on your disk. Otherwise your system may not function properly!
- You will get the message
Donewhen the process is finished.
Remove the MCX-Imager Stick.
Now you can reboot or poweroff.
- Wait for a couple seconds for the system to restart.
- Congratulations you have installed MCX-OS onto your Controller!
The next step is to set-up the connection between your controller and your laptop. Connect Your PC