Software Installation

The software installation process will require access to an internet connection, but the general operation of the Move Live software does not require any internet connection.

Installation

Install Ubuntu 22.04.5
1. Download the ISO file from here
2. Back up any existing data and note down any custom settings you have configured, as the installation process will require you to erase your disk.
3. Follow the installation process
Install Nvidia drivers
1. Go to Apps and search for ‘Additional Drivers’
2. Within the section relating to your installed GPU
3. Tick the 'NVIDIA driver metapackage from Nvidia driver 535.'
  1. NOT the 'NVIDIA Server driver metapackage from Nvidia driver 535 server'
4. Click Apply Changes
5. Reboot the server
Install Move Live
1. Run the command below in a new terminal.
```
wget -qO- https://aptrepo.move.ai/install_u22.sh | sudo bash
```
2. Reboot the server
3. Run the command below in a new terminal.
```
sudo apt install mocap-rt=2.2.3767-3767
```
4. Run the command below in a new terminal.
```
sudo apt install mocap-desktop=1.4.15
```
5. Reboot the server
Install Spinnaker SDK and drivers
1. Check if the SpinView application is already installed, if not follow the below steps
  1. Download Spinnaker 4.0.0.116-amd64-pkg-22.04 from https://flir.netx.net/file/asset/59513/original/attachment
  2. Extract the folder
  3. Open terminal (in same location as file) and run the below command
```
sudo ./install_spinnaker.sh
```
  4. Say YES to everything
Install WIBU Licensing dongle drivers
1. Check if the CodeMeter application is already installed, if not follow the below steps
  1. Download CodeMeter User Runtime for Linux Version 8.10b | 2024-08-06 | multilanguage from https://www.wibu.com/uk/support/user/downloads-user-software.html
  2. Open a terminal in the same location as the downloaded deb file and enter the following command
```
sudo apt install ./codemeter_8.10.6221.500_amd64.deb
```
2. Make sure the provided dongle is plugged in.
3. Request a licence
  1. Once installed, open CodeMeter Control Centre and this will show you the physical dongle you have installed.
  2. Make sure the Dongle is enabled when selected.
  3. Select License Update and then Next before selecting Create License Request.
    1. Note: If WIBU systems need to update the licence software/firmware, then you would be required to select Import License Update, but this option does NOT update the Move AI mocap software.
  4. Then select Add License of a New Vendor
    1. Note: To extend a license, select 'Extend Existing Licence'
  5. Enter the Move Ai Firm Code, this is 6002284.
    1. Note: This is the Move AI code indefinitely and does not change.
  6. Select the file name and path where you want to save the file. This will then create the request file and save it to the location path you selected.
    - Example request file - 3-0000000.WibuCmRaC
  7. Attach this to an email and share with the Move team.
4. Activate your licence
  1. Once the update file has been received from the Move team.
    1. Example update file - 3-0000000.WibuCmRau
  2. Drag and drop the update file into the window and the updates will be applied.
  3. Open the Web Admin page (bottom right).
  4. Scroll down to the Move.ai section and check the expiration date is as expected.

Network Configuration

Open Settings > Network > Select the port connected to the camera switch
In the Identity tab, set the MTU to 9000 (jumbo packets)
In the IPVv4 tab:
1. Set the IP to your desired IP address (ideally on a dedicated range)
2. Set the subnet mask to 255.255.255.0
3. No gateway is required
4. Set DNS to automatic
Disable reverse path filtering using the below process:
1. Open the network security config file using the below command
  1. ```
  sudo gedit /etc/sysctl.d/10-network-security.conf 
```
2. Enter the password of the server when requested
3. Comment out the following lines in the 10-network-security.conf file, accessed using the following command:
  1. ```
  ## net.ipv4.conf.default.rp_filter=1
  ## net.ipv4.conf.all.rp_filter=1
```
4. Save and close
Increase the receive buffer size using the below process:
1. Open the sysctl config file using the below command:
  1. ```
  sudo gedit /etc/sysctl.conf 
```
2. Enter the password of the server when requested
3. Add the 2 lines below
  1. ```
  net.core.rmem_max=10485760
  net.core.rmem_default=10485760
```
4. Save and close

SpinView

SpinView is the software provided by the camera manufacturer that allows you to manage the camera settings and check the connection on the network.

Check you have a connection to all cameras in SpinView. If you are not able to see any cameras in SpinView, refer to Support & Troubleshooting.

Setting the IP addresses of your cameras

Once you've configured the network you'll use for your camera switch, you can set the persistent IP address of your cameras, so that they don't revert to their default if they're power cycled.

In order to change the settings of your cameras, you need to ensure they are on an accessible IP range. If there is a red error icon next to the serial number, the IP is not on the same range - right click and select ‘Force IP to resolve’ to correct this.

To set a persistent IP address for your cameras, open the settings by doubling clicking on one. Then, locate the below rows in the features panel underneath and make the following changes (on each camera).

Current IP Configuration Persistent
- Tick this box
Persistent IP Address
- Enter the desired IP address, which is on the same range as the network card it's plugged into (identified in the blue bar above).
- The IP must be entered in integer format. Use this site to convert it.
Persistent Subnet Mask
- Enter the respective subnet.
- The subnet must be entered in integer format. Use this site to convert it.
Repeat for all other cameras.
Power cycle your switch (in turn, power cycling the cameras)
Once powered up, check your cameras have remained on the expected IP addresses.

Refer to this document for more info - https://www.flir.co.uk/support-center/iis/machine-vision/knowledge-base/persistent-ip-in-spinnakerqt/

Framing up the cameras

Using the below image as a guide, orientate the cameras to give the best possible view of capture volume, with the least unused space in the frame of each camera. To achieve the best MoCap, ensure you can see your actors fully head-to-toe in as many locations as possible. Allow a little extra space around the edges of the frame, as the system will crop the images slightly when undistorting the lenses.

SpinView can be used to adjust camera settings, such as White Balance and Exposure. However, once changed, it is essential to check the cameras are still able to capture at your desired framerate.