2. Virtual Machine - Docker

2.1. Linux Docker Image Deployment

2.1.1. Operating Environment

Virtual machine operating system: Ubuntu 18.04.6;

Virtual machine operating environment: RAM 4G, ROM 50G, 6-core CPU;

Operation permissions: Use super administrator root privileges. Setting method see Appendix 3;

Docker installation file: fr_docker.tar.gz;

FAIRINO SimMachine image: FAIRINOSimMachine.tar;

2.1.2. Install Docker

If the user has already installed and deployed Docker, skip this section and proceed to section 1.3 Image Deployment.

1. Download fr_docker.tar.gz and place it in the Ubuntu file path /opt/.

2. Extract fr_docker.tar.gz. Using /opt/ directory as an example:

cd /opt/ && tar -zxvf fr_docker.tar.gz

3. Execute the Docker installation script:

sh install.sh docker-27.0.3.tgz

After the script finishes executing, if the version number appears, it indicates successful installation.

2.1.3. Image Configuration

2.1.3.1. Import Docker Image

1. Download the virtual machine image FAIRINOSimMachine.tar and extract it.

2. Check the Docker version to confirm installation.

docker -v

3. Import the image

docker load -i ./FAIRINOSimMachine.tar

The appearance of fairno_simmachine:latest indicates the import is complete.

4. Execute docker images to check if the import was successful.

2.1.3.2. Create Custom Bridge Network

1. Execute the following command to create a bridge network named fairino-net with subnet 192.168.58.0/24.

docker network create --driver bridge --subnet 192.168.58.0/24 --gateway 192.168.58.1 fairino-net

2. View the network

docker network ls

The presence of the fairino-net network indicates successful creation.

2.1.3.3. First-time Docker Container Startup

1. Create and start the container

Start the container using the fairino-net network and the fairino_simmachine image.

docker run -d -P --name fairino-container --privileged -u root --net fairino-net fairino_simmachine

docker ps

Check if the container started successfully. The appearance of fairino-container indicates successful startup.

2.2. Web Operation of Virtual Robot

2.2.1. Container Normal Startup

This section applies to non-first-time container startups, such as when the container is not running in the background due to computer restart or Docker shutdown.

1. Start Docker:

systemctl start docker

2. Check Docker status:

systemctl status docker

Green active(running) indicates successful startup.

3. Execute docker ps -a to view the container ID.

4. Execute docker start [Container ID].

5. After successful execution, execute docker ps again to confirm the container is running.

2.2.2. Operating the Virtual Robot

1. Confirm the Docker container is running.

docker ps

The appearance of fairino-container indicates it is running.

2. Open a browser, enter the default IP: 192.168.58.2, to access the web interface and operate the virtual robot.

3. Log in with the admin account, password: 123.

2.2.3. User IP Address Modification

1. Open a browser, enter the default IP: 192.168.58.2, to open the web page;

2. Log in with the admin account, password: 123;

3. Navigate to “System Settings” → “General Settings” → “Network Settings”, modify the IP to the target IP address, subnet mask, and gateway. Click “Set Network”;

4. Open the terminal, stop the container;

View the container ID:

docker ps -a

Stop the container:

docker stop [Container ID]

5. Reconfigure the container network;

Delete the original network:

docker network rm fairino-net

Create a new network:

docker network create --driver bridge --subnet [Target IP/Subnet Mask] --gateway [Gateway IP] fairino-net

Using 192.168.56.0/24 as an example: docker network create –driver bridge –subnet 192.168.56.0/24 –gateway 192.168.56.1 fairino-net

6. Reconnect the container to the newly created network;

docker network connect fairino-net [Container ID]

7. Restart the container;

docker start [Container ID]

8. Now open the browser, enter the modified IP address, to access the web interface and operate the virtual robot.

2.3. Virtual Machine Version Upgrade/Downgrade

2.3.1. Overview

This manual details the standard procedure for performing software upgrades and downgrades when using the FAIRINO SimMachine Docker virtual machine, and systematically outlines key considerations during the version change process.

2.3.2. Upgrade/Downgrade Preparation and Considerations

2.3.2.1. Operation Preparation

1. A deployed and normally functioning FAIRINO SimMachine Docker virtual machine. Deployment tutorial see “User Manual - Linux Docker Image Deployment”;

2. Software upgrade package for the Docker virtual machine version. Download location see “Data Download - FAIRINO SimMachine Docker”. After extraction, contents include the latest version docker image FAIRINOSimMachine.tar and the software upgrade package software.tar.gz.

2.3.2.2. Considerations

1. Data Backup: It is recommended to perform a backup before upgrading, method see “Data Backup” chapter, to avoid data loss due to upgrade anomalies.

2. Version Restrictions:

Table 2.3-1 Upgrade/Downgrade Version Restrictions

Operation Type	Condition/Restriction	Step Description
Version Upgrade	Current Version >= 3.7.8	Can upgrade directly
Version Upgrade	Current Version < 3.7.8	Must first upgrade to version 3.7.5 or use the compatibility solution
Version Downgrade	Current AND Target Version >= 3.7.8	Can downgrade directly
Version Downgrade	Current OR Target Version < 3.7.8	Use the compatibility solution
Compatibility Solution	Applicable for both upgrade/downgrade anomalies	See “Compatibility Solution” chapter for detailed steps