Creating a Virtual Machine with OPAL-RT Linux Version PDF Free Download

Creating a Virtual Machine with OPAL-RT Linux Version 1.5 www.opal-rt.com

Contents REVISION HISTORY... 4 INTRODUCTION... 5 REQUIRED MATERIAL... 6 CREATION OF THE VIRTUAL MACHINE... 7 INSTALLATION OF RT-LAB TARGET COMPONENTS... 20 OPTION A: USING FTP AND COMMAND LINE INSTRUCTIONS... 20 OPTION B: USING THE RT-LAB USER INTERFACE ON THE WINDOWS HOST COMPUTER... 21 LICENSE... 24 COMPILER... 24 APPENDIX 1: USING THE VIRTUAL MACHINE ON A STAND-ALONE COMPUTER... 25 APPENDIX 2: CHANGING THE KEYBOARD LAYOUT... 30

REVISION HISTORY Version Date Responsible Comment 1.0 2017-03-23 Daniel O Brien Initial version 1.1 2017-03-27 Vithuran Vilvarajah Add on the GCC compiler 1.2 2017-07-12 Daniel O Brien Minor typos 1.3 2017-08-02 Yahia Bouzid 1.4 2017-09-06 Daniel O Brien 1.5 2017-09-20 Daniel O Brien Added configuration for Host-Only adapter (stand alone mode) APPENDIX 1 Added APPENDIX 2 for changing keyboard layout. Added requirement for 20 GB of free disk space. Updated RPM to v11.1.4.59. Made the RT-LAB target components, the License and the Compiler sections clearer for non-rt-lab users (i.e. users who only wish to compile an S- Function for a third-party integrator). Minimum of 10 GB of free disk space is required. - 4 -

INTRODUCTION This document presents a procedure to create a virtual machine containing OPAL-RT Linux. This allows the user to emulate on a Windows PC the operating system normally installed on an OPAL-RT simulator. With a virtual machine, the user will be able to do the following: - Build a model for RT-LAB (OPAL-RT license required) - Load a model without any I/Os with RT-LAB (OPAL-RT license required) - Compile the source code of a S-Function in order to hide intellectual property - 5 -

REQUIRED MATERIAL Windows host PC o 20 GB of free disk space is recommended (minimum of 10 GB of free disk space is required) Oracle VM VirtualBox software o Download and install from: https://www.virtualbox.org/ Latest ISO image of OPAL-RT Linux operating system o Available here: ftp://client:opal102@ftp.opal-rt.com/redhat o Example: rhel_custom_16.4.3.iso Latest RPM file for installing RT-LAB target components o Available here: ftp://client:opal102@ftp.opal-rt.com/redhat o Example: rtlab-redhawk-v11.1.4.59.rpm - 6 -

CREATION OF THE VIRTUAL MACHINE 1. Open Oracle VM VirtualBox and click on New. 2. Enter a name for your virtual machine, select Linux as the type and select Red Hat (32- bit) as the version. Click Next. - 7 -

3. Enter the amount of memory (RAM) that you want to dedicate to your virtual machine. It is recommended to reserve 2048 MB. Click Next. 4. Select Create a virtual hard disk now. Click Create. - 8 -

5. Select VDI (VirtualBox Disk Image). Click Next. 6. Select Fixed size. Click Next. - 9 -

7. Select the folder where to store the virtual hard disk file. Also, enter the size of the hard disk that you want to dedicate to your virtual machine. It is recommended to reserve 20 GB. Minimally, 10 GB of free disk space is required. Click Create. 8. Once the creation of the virtual hard disk is finished, the virtual machine will be available in the VirtualBox manager. 9. Right-click on the virtual machine, and click Settings. - 10 -

10. In the Storage category, attach the ISO image of OPAL-RT Linux under Controller: IDE. 11. In the System category, move the Optical device to the top of the Boot Order. - 11 -

12. In the Network category, make sure Enable Network Adapter is checked, and select Bridged Adapter. Note: this setting is recommended if you plan to use the virtual machine while your computer is connected to a local network, and its IP address is automatically set by a DHCP server. If you need to use the Virtual machine while the computer is not connected to the local network, please refer to APPENDIX 1. 13. Click OK. 14. Start the virtual machine. - 12 -

15. Click Yes when the following warning appears. 16. Follow the instructions in order to install the operating system. The default options are correct. - 13 -

17. Power off the virtual machine, once the installation process is finished. Note: By default, VirtualBox is configured to capture the mouse inside the virtual machine once you click inside. Press the right Ctrl key in order to uncapture the mouse from the virtual machine. 18. Again, right-click on the virtual machine, and click Settings. - 14 -

19. In the System category, move the Hard Disk device to the top of the Boot Order. 20. Click OK. 21. Start the virtual machine - 15 -

22. Log in with the following credentials: Username: root Password: redhat Note: By default, the keyboard has a QWERTY layout. For an AZERTY keyboard layout, you must therefore type redhqt for the password. If you want to change the keyboard layout permanently, please refer to APPENDIX 2. - 16 -

23. (Optional) If you want to change the IP configuration of the virtual machine, go to the menu System/Administration/Network. Then, select the device you which to configure, and click Edit. It is recommended to keep the option Automatically obtain IP address setting with: dhcp. However, it is possible to configure a static IP address. Please consult your IT department if you are uncertain of the desired IP configuration. Click OK (bottom right button) when the configuration is finished. You will have to deactivate and activate the device for the change to take effect. Note: if you plan to use the computer in stand-alone mode (no connection to the local network), please refer to APPENDIX 1. - 17 -

- 18 -

24. To determine the IP address of the virtual machine, right-click on the desktop, and click Open Terminal. Then, type the command ifconfig. The IP address will be shown next to inet addr. 25. Your virtual machine is ready. - 19 -

INSTALLATION OF RT-LAB TARGET COMPONENTS In order to install the RT-LAB target components on the virtual machine, there are 2 options. A. Using FTP and command line instructions B. Using the RT-LAB user interface on the Windows host computer These 2 options are equivalent. You may choose the one that is the most convenient. For example, if you are compiling the source code of a S-Function in order to hide intellectual property, option A is preferable. OPTION A: USING FTP AND COMMAND LINE INSTRUCTIONS 1. Open a My Computer window. Enter ftp://ntuser@xxx.xxx.xxx.xxx/ in the address bar. Note that xxx.xxx.xxx.xxx is the virtual machine s IP address 2. Enter ntuser in the password field. 3. You are now connected by FTP to the virtual machine. 4. Copy the RT-LAB RPM file rtlab-redhawk-[version_number].rpm. Note that [version_number] is the RT-LAB version number (ex: rtlab-redhawkv11.1.4.59.rpm). 5. In the virtual machine, right-click on the desktop, and click Open Terminal. 6. Type the following commands to install RT-LAB: cd /home/ntuser - 20 -

rpm ivh --force rtlab-redhawk-[version_number].rpm OPTION B: USING THE RT-LAB USER INTERFACE ON THE WINDOWS HOST COMPUTER 1. Launch RT-LAB on the Windows host computer. Click on Go to the workbench, if you are in the Welcome page. - 21 -

2. In the Project Explorer, right-click on Targets. Then, click New / New Target. 3. Enter a name and the IP address of the Virtual Machine. Click Finish. - 22 -

4. Right-click on the newly added target, and click Install / RT-LAB. - 23 -

LICENSE This section is only necessary if you plan to use RT-LAB to compile or load a model on your virtual machine. Please consult the following knowledge base article for instructions on how to request a license. http://www.opal-rt.com/kmp/index.php?/article/aa-01022/8/howto/how-to-request-and- Install-a-License-for-RT-LAB-11.x.html COMPILER This section is only necessary if you plan to use RT-LAB to compile a model on your virtual machine. RT-LAB is compatible with both Intel and GCC compilers on its OPAL-RT Linux (x86-based) platform. For the Intel compiler, please follow the instructions on this knowledge base article on how to request and install it: http://www.opal-rt.com/kmp/index.php?/article/aa-01092/8/howto/how-to-request-and- Install-an-Intel-Compiler-License-on-your-target.html The GCC compiler is installed as a standard on the OPAL-RT Linux distribution. In order to use it, you need to set the RTLAB_INTEL_COMPILER environment variable in RT-LAB, under the Variables tab of your model, to 0. - 24 -

APPENDIX 1: USING THE VIRTUAL MACHINE ON A STAND-ALONE COMPUTER In case you need to use the host PC in standalone mode (no connection to a real network, typically with a laptop during a travel), you will need to configure the virtual machine in Host- Only mode. 1. First, check if a virtual network adapter called VirtualBox Host-Only Network has been created in the Network Connections section of the Control Panel. 2. If it does not exist, you can create it from VirtualBox. In the menu File/Preferences, select Network and go to tab Host-only Networks. Then click on the topmost button to the right (with a green plus symbol). A new host-only network will be created and added to the list, as depicted in the previous step. - 25 -

3. When you double-click on the adapter (e.g. VirtualBox Host-Only Ethernet Adapter #2 in the picture above), you ll have access to the IP settings. VirtualBox assigns an IP address by default. Please check that this address in not in conflict with any other address in your local network. 4. Once the Host-Only Ethernet Adapter has been set, click on the virtual machine and then click Settings. In the Network category, in the field Attached to, select Host-only Adapter. The Name shall be the same as the VirtualBox Ethernet Adapter configured above (e.g. VirtualBox Host-only Ethernet Adapter #2 in this example). - 26 -

5. The last steps will configure the IP Address in the virtual target. Start the virtual machine. 6. Log in with the following credentials: Username: root Password: redhat Note: By default, the keyboard has a QWERTY layout. For an AZERTY keyboard layout, you must therefore type redhqt for the password. If you want to change the keyboard layout permanently, please refer to APPENDIX 2. - 27 -

7. Go to the menu System/Administration/Network 8. Click on the Edit button 9. Set a static IP address according to address chose in step 3. For example Address: 192.168.169.100 Subnet mask: 255.255.255.0-28 -

Note: This address must be different from the one specified on the VirtualBox Host-Only Ethernet Adapter, but located in the same subnet. 10. Click Deactivate, then Activate in order to reload the newly configured network configuration. - 29 -

APPENDIX 2: CHANGING THE KEYBOARD LAYOUT 1. Go to the menu System/Preferences/Keyboard. 2. In the Layouts tab, click Add. - 30 -

3. Choose the desired layout and click on the checkbox to make it your default keyboard layout. - 31 -

Technical Services www.opal-rt.com/support CONTACT Opal-RT Corporate Headquarters 1751 Richardson, Suite 2525 Montréal, Québec, Canada H3K 1G6 Tel.: 514-935-2323 Toll free: 1-877-935-2323 Note: While every effort has been made to ensure accuracy in this publication, no responsibility can be accepted for errors or omissions. Data may change, as well as legislation, and you are strongly advised to obtain copies of the most recently issued regulations, standards, and guidelines. This publication is not intended to form the basis of a contract.