This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Install/Update

This section will show you how to install or update your Controller.

In this section you will go trough the installation process of a new Motorcortex image onto your Controller. To start off you will download the latest Motorcortex Image, after this you will follow the installation process for your designated Controller.

GCC Industrial PC Raspberry PI Virtual Machine
Download Image Download Image Download Image Download Image
Install Image On USB Install Image On USB Install Image On SD Card Install Image On Virtual Machine

1 - Download MCX-OS

This section will show you how to download a Motorcortex-OS image from Motorcortex.io.

Download an MCX-OS image

The MCX-OS Image is a complete Realtime System image that can be flashed onto your controller’s harddrive. Users of Motorcortex.io can download the correct image for their controller architecture by clicking the button below. If you don’t have a account yet make sure to request a trail.

The latest Motorcortex OS Image can always be found in the motorcortex.io Store. After the download is completed a .zip file should appear in your Download folder. Extract the .zip file to get access to your. .img.xz file.

The next step is to install the MCX-OS Image on your controller. Install an Image

2 - Install Image On Virtual Machine For Linux

This Section will show you how to a Image on your Virtual Machine for Linux.

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card VirtualMachine

Getting a Virtual machine working is different for every Operating system. Please choose the Operating system you are working from below:

Linux Windows MacOS

A vitrual machine can be used to try out Motorcortex on your PC. Using a virtual machine you will need a .img file or a .vdi file. and VirtualBox installed on your machine. this chapter will show how to install VirtualBox and get your virtual machine up and going.

Installing VirtualBox For Linux

To get VirtualBox you wil have to download it from the https://www.virtualbox.org/wiki/Downloads website. choose the operating system you are using. and download the .deb file.

  1. Double click the .deb file.

  2. Click install in the pop-up. VirtualBox will now be installed.

Converting image

to use virtual box you will need a .vdi file. If you have a .img or compressed .img.xz you will need to convert these files using the following commands.

to uncompress a .img.xz file run the following command in the folder the file is located.

    unxz -k -v yourfile.xz

the compressed image will now be uncompressed. after this you can convert the .img file to a .vdi file. make sure you are in the correct folder where the file is located.

    VBoxManage convertfromraw yourfile.img yourfile.vdi		

Setting up the virtal machine

Setting up the virtual machine has to be done using the folowing steps:

  1. Open VirtualBox and click on New.

  1. In the Create Virtual Machine pop-up the following settings have to be selected.
  • Name: desired name
  • Machine Folder: desired folder
  • Type: Linux
  • Version: Linux 2.6/3.x/4.x(64-bit)

  1. Click Next.

  2. Set the memory size to 8000 MB and click Next.

  1. select the Use an existing virtual hard disk file and click on the folder icon.

  1. Click the Add icon and browse to the desired .vdi file.

  1. Click Choose.

  1. Click Create.

A virtual machine is created. Now the Network has to be configured.

  1. Click File and go to Host Network Manager.

  1. In the Host Network Manager fill in the settings as following:
  • Disable the DHCP Server by unchecking the box
  • IPv4 Address: 192.168.2.1
  • Network Mask: 255.255.255.0

  1. Close the Host Network Manager.

The network manager is now configured. Now the system settings have to be checked.

  1. click on settings.

  1. In System under the Motherboard tab make sure the Enable EFI box is checked.

  1. In System under the Motherboard tab make sure that Processor(s) is set to 4 CPU’s.

  1. In Network under the Adapter1 tab set Attached to to Host-only Adapter.

  1. Click OK

The virtual machine has now been set up.

Using virtual machine

Starting your virtual machine has to be done using the folowing steps:

  1. In virtual box select the desired virtual machine and press Start.

  1. The virtual machine will boot now this can take up to 5 seconds or longer.

  1. Log in to the controller.
  • Login: Admin
  • Password: vectioneer

the command line should change like this.

    mcx-intel:~$

If no hardware is connected to the virtual machine make sure the simulation mode is activated. how to activate simulation mode is described in Sumulation Mode

3 - Install an Image for MacOS

This Section will show you how to install a Image using a USB Drive

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card Virtual Machine

To install a MCX-OS a MCX-Imager stick has to be made, for this you will need a USB Drive. Creating a MCX-Imager Stick is different for every OS. Please select the OS that you are using.

Linux Windows MacOS

The MCX-Imager Stick is a bootable USB drive that can be used to create backups and restore images of Motorcortex Systems.

4 - Install an Image for Windows

This Section will show you how to install a Image using a USB Drive

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card Virtual Machine

To install a MCX-OS a MCX-Imager stick has to be made, for this you will need a USB Drive. Creating a MCX-Imager Stick is different for every OS. Please select the OS that you are using.

Linux Windows MacOS

The MCX-Imager Stick is a bootable USB drive that can be used to create backups and restore images of Motorcortex Systems.

Creating a Motorcortex-Imager USB Drive (For Windows)

Before we start you will need an USB Drive of at least 6Gb and at least 7Gb of free space on your PC.

  1. Motorcortex.io Users can download the latest MCX-Imager from the Shop by pressing the button below:

  2. Extract the .zip file, After extracting you should have a 6Gb .img file.

  3. Insert your USB Drive into your PC.

  4. Write the image to your USB Drive, When done, your USB Drive will be named ImageData, here you can put imager that you want to install onto a controller.

  5. Copy the MCX-OS Image .img.xz file into the ImageData folder.

Congratulations you have made your own MCX-Imager Stick. lets continue to install a image onto your controller.

Booting from the MCX-Imager Stick

  1. Make sure the controller is turned off.

  2. Insert the MCX-Imager Stick into your controller.

  3. Turn the controller on.

  4. Your machine should automatically boot from the Motorcortex-Imager USB Drive.

    There are 2 ways to Interact with the Imager stick:

    • By attaching a Keyboard and a Display to your controller. The screen should inmediatly show you a similar screen like below.

    • Or trough SSH connection on your laptop.

      1. Open a terminal.

      2. Connect to your Controller by typing:

        ssh tc@192.168.2.100
        
      3. log in with password vectioneer.

      4. The terminal should inmediatly show you a similar screen like below.

Congradulations you have booted from the MCX-Imager Stick. We can now Restore a MCX-OS image onto your Controller.

Restoring an image (Cold Start)

  1. To start the restore procedure type
sudo mcx-restore -f
  1. Now the prompt will ask you what image you would like to restore. Choose the image that you would like to restore.
  2. Second the prompt will ask you to choose the drive where you want to restore your image to.
  3. Restoring the image will take some time. When the process is done, check for any errors in the console
  1. You will get the message Done when the process is finished.

  1. Now you can reboot or poweroff.

     sudo poweroff`
    
  2. Wait for a couple seconds for the system to power off.

  3. Remove the USB Drive.

  4. Turn on your machine again.

  5. Congratulations you have installed MCX-OS onto your Machine. Next up we can start connecting to your controller.

5 - Install Image On a SD Card

This Section will show you how to omstall a Image on your SD Card.

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card VirtualMachine

6 - Install Image On Virtual Machine For MacOS

This Section will show you how to a Image on your Virtual Machine for MacOS.

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card VirtualMachine

Getting a Virtual machine working is different for every Operating system. Please choose the Operating system you are working from below:

Linux Windows MacOS

7 - Install Image On Virtual Machine For Windows

This Section will show you how to a Image on your Virtual Machine for Windows.

There are a couple of different ways to install a image onto your Controller.

  • For a GCC or Industrial PC you will need to create a MCX Imager USB Stick.
  • For a Rasberry Pi you will need to create a MCX SD Card.
  • With a Virtual Machine you can Simulate a Motorcortex Controller.

Please choose what kind of Controller you will be using:

USB SD Card VirtualMachine

Getting a Virtual machine working is different for every Operating system. Please choose the Operating system you are working from below:

Linux Windows MacOS

A vitrual machine can be used to try out Motorcortex on your PC. Using a virtual machine you will need a .img file or a .vdi file. and VirtualBox installed on your machine. this chapter will show how to install VirtualBox and get your virtual machine up and going.

Installing VirtualBox (For Windows)

To get VirtualBox you wil have to download it from the https://www.virtualbox.org/wiki/Downloads website. choose the operating system you are using. and download the .exe file.

  1. Double click the .exe file.

  2. The setup wizard will pop-up click next.

  1. Click Next unless you want to change the location for the VirtualBox.

  1. Click ‘Next’ unless you want to change some of the install options.

  1. A warning will tell you that network connections will be disconected temporarily. Click Yes.

  1. Click Install.

  1. The instalation will start. During the instalation a security warning will pop-up click Install.

  1. click Finish to complete the instalation.

Converting image

to use virtual box a .vdi file is needed. .img files or compressed .img.xz files have to be converted.

to uncompress a .img.xz file run the following command in the folder the file is located.

    unxz -k -v yourfile.xz

the compressed image will now be uncompressed. after this you can convert the .img file to a .vdi file. make sure you are in the correct folder where the file is located.

    VBoxManage convertfromraw yourfile.img yourfile.vdi		

Setting up virtal machine

Setting up the virtual machine has to be done using the folowing steps:

  1. Open VirtualBox and click on New.

  1. In the Create Virtual Machine pop-up the following settings have to be selected.
  • Name: desired name
  • Machine Folder: desired folder
  • Type: Linux
  • Version: Linux 2.6/3.x/4.x(64-bit)

  1. Click Next.

  2. Set the memory size to 8000 MB and click Next.

  1. select the Use an existing virtual hard disk file and click on the folder icon.

  1. Click the Add icon and browse to the desired .vdi file.

  1. Click Choose.

  1. Click Create.

A virtual machine is created. Now the Network has to be configured.

  1. Click File and go to Host Network Manager.

  1. In the Host Network Manager fill in the settings as following:
  • Disable the DHCP Server by unchecking the box
  • IPv4 Address: 192.168.2.1
  • Network Mask: 255.255.255.0

  1. Close the Host Network Manager.

The network manager is now configured. Now the system settings have to be checked.

  1. click on settings.

  1. In System under the Motherboard tab make sure the Enable EFI box is checked.

  1. In System under the Motherboard tab make sure that Processor(s) is set to 4 CPU’s.

  1. In Network under the Adapter1 tab set Attached to to Host-only Adapter.

  1. Click OK

The virtual machine has now been set up.

Using virtual machine

Starting your virtual machine has to be done using the folowing steps:

  1. In virtual box select the desired virtual machine and press Start.

  1. The virtual machine will boot now this can take up to 5 seconds or longer.

  1. Log in to the controller.
  • Login: Admin
  • Password: vectioneer

the command line should change like this.

    mcx-intel:~$

If no hardware is connected to the virtual machine make sure the simulation mode is activated. how to activate simulation mode is described in Sumulation Mode

8 - Install MCX-OS

This Section will show you how to install the MCX-OS Image using the MCX-Imager USB-Stick

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.

Linux Windows MacOS

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.

  1. Motorcortex.io Users can download the latest MCX-Imager USB-Stick Image from the Shop by pressing the button below:

  2. Extract the .zip file, After extracting you should have a 6Gb .img file.

  3. Insert your empty USB Drive into your PC. Beware that we will erase everything that is already on your USB Stick.

  4. Right-click on the .img file and select Disk Image Writer.

  5. In the following window select the drive you want to write the MCX-Imager image file to and hit the Make Startup Disk button.

    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

  1. Copy the MCX-OS Image .img.xz file into the ImageData folder of you USB-Stick.

Booting your Controller from the MCX-Imager USB-Stick

  1. Make sure your Controller is turned off.

  2. Insert the MCX-Imager USB-Stick into your Controller.

  3. Turn the Controller on.

  4. 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.

  5. Log in to the MCX-Imager terminal

    There are 2 ways to access the terminal of the MCX-Imager:

    • By attaching a Keyboard and a Display to your Controller. The screen should immediatly show you a similar screen like below.

    • Or trough SSH connection on your laptop.

      1. Connect your controller with your pc using the Ethernet port (In the virtual machine this is already set-up).

      2. 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)

      3. Open a terminal.

      4. Connect to your Controller by typing:

        ssh tc@192.168.2.100
        
      5. log in with password vectioneer.

      6. The terminal should inmediatly show you a similar screen like below.

Installing an MCX-OS image onto your Controller

  1. To start the restore procedure type
sudo mcx-restore -f
  1. Now the prompt will ask you what image you would like to restore. Choose the image that you would like to restore.
  2. Second the prompt will ask you to choose the drive where you want to restore your image to.
  3. Restoring the image will take some time. When the process is done, check for any errors in the console
  1. You will get the message Done when the process is finished.

  1. Remove the MCX-Imager Stick.

  2. Now you can reboot or poweroff.

    sudo reboot
  1. Wait for a couple seconds for the system to restart.
  2. 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