Creating a Virtual Machine with OPAL-RT Linux Version 1.5

Transcription

1 Creating a Virtual Machine with OPAL-RT Linux Version 1.5

2 1751 Richardson, suite 2525 Montréal (Québec) Canada H3K 1G All rights reserved Printed in Canada

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

4 REVISION HISTORY Version Date Responsible Comment Daniel O Brien Initial version Vithuran Vilvarajah Add on the GCC compiler Daniel O Brien Minor typos Yahia Bouzid Daniel O Brien 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 v 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

5 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 -

6 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: Latest ISO image of OPAL-RT Linux operating system o Available here: ftp://client:opal102@ftp.opal-rt.com/redhat o Example: rhel_custom_ 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-v rpm - 6 -

7 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

8 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

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

10 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

11 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

12 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 Click OK. 14. Start the virtual machine

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

14 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

15 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

16 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

17 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

18 - 18 -

19 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

20 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-redhawkv 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

21 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

22 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

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

24 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. 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: 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

25 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

26 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)

27 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

28 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: Subnet mask:

29 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

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

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

32 Technical Services CONTACT Opal-RT Corporate Headquarters 1751 Richardson, Suite 2525 Montréal, Québec, Canada H3K 1G6 Tel.: Toll free: 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.