Page Content

This section describes the installation of RT-LAB target components on an OPAL-RT simulator running with the OPAL-RTLinux (x64-based) real-time operating systems.
It is primordial that the RT-LAB version currently in use on the Windows host PC is also installed on each target system intended to be used for simulation. To deploy the RT-LAB version on the target system, the following scenarios are possible:

1. An RT-LAB version is already installed on target systems, which is usually the case. For this situation, the installation process is simplified since it can be performed from the RT-LAB GUI.

2. No RT-LAB version is already installed on target systems, which typically is the case after the OS has been freshly installed. In this situation, a terminal access or SSH connection to the target system will be required.

Typically, OPAL-RT simulators already have an RT-LAB installed version, which simplifies the installation. This section only applies to users that want to install a new version of RT-LAB.

Installing RT-LAB

Installing from the RT-LAB GUI

When an installation on the target is needed, RT-LAB will often prompt you to install the new version of the software on the target.
Simply accept to upgrade the target node automatically.

Open

Otherwise, it is also possible to perform the target installation on demand:

• Open RT-LAB.

• Right-click on the target you want to install RT-LAB.

• Select Install/RT-LAB from the popup menu.

Open

Installing from the Network on an OPAL-RTLinux (x64-based) Target Node

To install without going through the RT-LAB GUI, which is required when a target does not already have a version of RT-LAB installed, perform the following

1. Open a Windows Explorer and go to the directory:
   C:\OPAL-RT\RT-LAB\vX.X.X.X\target\rt_linux64

2. Type cmdin the path field and press Enter to open a Windows command line interface in the current directory
   
   

3. Transfer the RPM file to the target using the following command, where [version_name] and [target_ip_address] are respectively substituted for the RT-LAB version and target IP address:
   scp -r rtlab-rt_linux64-[version_name].rpm root@[target_ip_address]:/home/root
   Enter the root password when prompted

4. Now establish an SSH connection to the target computer with the following command, where [target_ip_address] is substituted for the target IP address:
   ssh root@[target_ip_address]
   If prompted for authenticity acceptation, answer yes. Also enter the root password when prompted.

5. On the SSH prompt, type the following command to install RT-LAB, where [version_name] is substituted for the RT-LAB version:
   rpm -ivh --force /home/root/rtlab-rt_linux64-[version_name].rpm

6. Close the SSH connection with:
   exit

Uninstalling RT-LAB

Uninstalling from the RT-LAB GUI

To uninstall from the RT-LAB GUI:

• Open RT-LAB.

• Double-click the target to open the Target Editor.

• Open the Software Page.

• Select the version to uninstall.

• Click Uninstall.

Uninstalling from the Network on an OPAL-RTLinux (x64-based) Target Node

To manually uninstall:

1. Open a Windows command line (i.e., Start>Run> cmd)

2. Now establish an SSH connection to the target computer with the following command, where [target_ip_address] is substituted for the target IP address:
   ssh root@[target_ip_address]
   If prompted for authenticity acceptation, answer yes. Also enter the root password when prompted.

3. On the SSH prompt, type the following command to uninstall RT-LAB, where [version_name] is substituted for the RT-LAB version:
   rpm -e rtlab-rt_linux64-[version_name]