Setup Linux Target Computer

Target Computer

What can be used as a target computer:

Any Linux machine that supports MATLAB^® installation.
Windows machine with Windows Subsystem for Linux (WSL2 version) installed.
- WSL version 2 is required.
- WSL Linux distros with minimum versions: Ubuntu 18.04/Debian 11/Oracle Linux_7_9 should be setup.
- WSL target should be on the same windows host machine.

For more information, see https://in.mathworks.com/support/requirements/matlab-linux.html

Target Computer Requirements

To deploy Service Oriented Architecture applications on a target computer using the support package, following requirements have to be met.

Docker software version 20.10 or later needs to be installed.
Zip and Unzip commands needs to be installed.
SSH server needs to be in running state.
Target computer username needs to have privileges to run docker commands. For more information, see https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user.

Note

For fastDDS communication mode, port numbers 5555 and 5556 on target are used to communicate with the host by default. To modify the port numbers, update them in the <Support-Package-root>/toolbox/coder/linux/host/ContainerConfig.json file. You can get the support package root using the command:

matlabshared.supportpkg.getSupportPackageRoot

Port number 22255 is reserved for use on target and hence the port is not configurable.

For SSH communication mode, port number 22 is used by default. To modify the port number, use setSSHPort function.

Steps to Use Non Default SSH Port

In case of SSH, port number 22 is used by default to communicate with the target. To use a different port, follow these steps.

Open the file /etc/ssh/sshd_config from your machine in a text editor.
Add a line below the line Port 22. For example, to use port 22345 add the line.
```
Port 22345
```
Note
Do not modify the line or delete the line Port 22. Add a new line below it.
Save the changes and close the file.
Restart SSH daemon using the command.
```
systemctl restart sshd
```

After successful restart, the SSH daemon will listen on port 22 or port 22345 for communication.

Steps to setup target

Use the Linux Runtime Manager application to connect, disconnect, add, remove, and update Linux target computers.

To connect to a target computer that is running the Linux operating system:

Open the Linux Runtime Manager.
```
linuxRuntimeManager
```
In the Targets Tree pane, select Target Computers and click plus button in the to add a target computer. In Target Configuration section, enter details for the target computer.
programmatically:
```
tgs = linux.Targets();
tg = tgs.addTarget(<targetName>, <ipAddress>, <userName>, <password>);
```
For a newly added target computer, enter the full path of the location at which you want to deploy the application using this command:
```
tg.setDeploymentLocation(<Deployment location>);
```
For WSL targets, specify WSL linux file system storage as a Deployment location.
To deploy DDS applications configured with RTI Connext vendor, set the value of environment variable NDDSHOME_LINUX on host to the RTI Connext software folder path on Linux target machine.
```
setenv('NDDSHOME_LINUX', '<Path for the software>')
```
For example:
```
setenv('NDDSHOME_LINUX', '/home/user/RTIDDS/glnxa64/rti_connext_dds-6.0.1_gcc7.3.0')
```
Select a target and click the Linux Target > Connect To Target > Connect button.
Programmatically:
```
tg.connect();
```
Note
This step prompts you to provide a deployment location for the target computer if one is already not set.
To update software on the target computer, select the target computer and click Linux Target > Connect To Target > Update Target.
Programmatically:
```
tg.updateTarget();
```
To disconnect the target computer, select the target computer and click Linux Target > Connect To Target > Disconnect.
Programmatically:
```
tg.disconnect();
```
To completely remove the target computer files and its storage, use this command:
```
tgs.uninstallTarget(<Target Name>);
```
To remove a target computer, select the target computer and click the delete button. This action removes the target computer from the Targets Tree, but the applications deployed to the target computer and its docker image still exist in storage.
Programmatically:
```
tgs.removeTarget(<Target Name>);
```

Using this application, you can connect to multiple target computers at the same time.