Installation Guide for RTX 2011 with Service Pack 1

Transcription

1 Installation Guide for RTX 2011 with Service Pack 1

2 Copyright by IntervalZero, Inc. All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means, graphic, electronic, or mechanical, including photocopying, and recording or by any information storage or retrieval system without the prior written permission of IntervalZero, Inc. unless such copying is expressly permitted by federal copyright law. While every effort has been made to ensure the accuracy and completeness of all information in this document, IntervalZero, Inc. assumes no liability to any party for any loss or damage caused by errors or omissions or by statements of any kind in this document, its updates, supplements, or special editions, whether such errors, omissions, or statements result from negligence, accident, or any other cause. IntervalZero, Inc. further assumes no liability arising out of the application or use of any product or system described herein; nor any liability for incidental or consequential damages arising from the use of this document. IntervalZero, Inc. disclaims all warranties regarding the information contained herein, whether expressed, implied or statutory, including implied warranties of merchantability or fitness for a particular purpose. IntervalZero, Inc. reserves the right to make changes to this document or to the products described herein without further notice. RTX, RT-TCP/IP, RtxTcpIpStack, Platform Evaluator, and TimeView are all trademarks of IntervalZero, Inc. Microsoft, MS, and Win32 are registered trademarks and Windows 7, Windows Vista, Windows XP, and Windows Server 2003 are trademarks of Microsoft Corporation. All other companies and product names may be trademarks or registered trademarks of their respective holders. Installation Guide for RTX 2011 with Service Pack 1 Document Number: IZ-DOC-X June 2011

3 Contents Introduction 4 Editions 4 Hardware Requirements 5 HAL Type 5 Supported Network Adapters 5 Hardware Considerations 5 Software Requirements 7 Operating System Requirements 7 Retired Operating System Support 8 Microsoft Visual Studio Requirements (SDK Only) 8 Administrator Privileges 8 Installation Warnings 9 Installing RTX 2011 with Service Pack 1 10 Additional Installation Options 10 Before You Begin 10 Performing the Install 11 Modifications to the Boot Configuration 13 Viewing the Release Notes after Installation 14 Verifying the Installation of RTX 2011 with Service Pack 1 15 Uninstalling RTX 2011 with Service Pack 1 16 Uninstall Considerations 16 Performing the Uninstall 16 Getting Support 18 Third-Party Support 18 Before Calling Technical Support 18 Your Support ID 18 The Version Number of Your RTX Software 18 IntervalZero Web Site 18 Contacting Technical Support by Phone 18 Appendix A: Licensing 20 Key Retrieval 20 Automatic License Key Generation 20 Manual License Key Generation 21 Product Relocation 21 Appendix B: System Modifications During Installation 22 RTX-Recommended Power State on Machines 22 RTX-Recommended Basic Settings 22 RTX-Recommended Advanced Settings 22 Appendix C: Installing on MP Systems with One Processor 24

4 IZ-DOC-X Introduction Introduction This guide describes system requirements and installation instructions for RTX 2011 with Service Pack 1. Editions IntervalZero provides six different Runtime editions of the RTX 2011 with Service Pack 1 product, listed in the table below. The edition... Solo Entry Basic Professional Premium Ultimate Includes support for real-time operations on... One shared or dedicated RTSS processor in a uniprocessor or multicore/multiprocessor environment. One shared or up to two dedicated RTSS processors in a multicore/multiprocessor environment. One shared or up to three dedicated RTSS processors in a multicore/multiprocessor environment. One shared or up to seven dedicated RTSS processors in a multicore/multiprocessor environment. One shared or up to 15 dedicated RTSS processors in a multicore/multiprocessor environment. One shared or up to 31 dedicated RTSS processors in a multicore/multiprocessor environment. 4

5 Hardware Requirements IZ-DOC-X Hardware Requirements This section lists hardware requirements for the RTX 2011 with Service Pack 1 release. HAL Type To use the RTX Subsystem, your system must support one of the following HAL types: Windows Device Manager Standard PC Registry Resource Map PC Compatible EISA/ISA HAL Advanced Configuration and Power Interface (ACPI) PC ACPI Compatible EISA/ISA HAL ACPI Uniprocessor PC ACPI Multiprocessor PC ACPI x86-based PC Supported Network Adapters ACPI APIC Platform UP ACPI APIC Platform MP ACPI x86 Platform The RTX 2011 with Service Pack 1 release provides support for a number of network adapters. For the most up-to-date list, click the link titled Download the RTX Supported Network Interface Cards PDF file on this web site: Hardware Considerations Some hardware configurations are not supported by RTX installations. When RTX can detect these unsupported configurations they are indicated with a popup error message. Although RTX runs on most x86 platforms, unique attributes of some processors require special consideration before selecting them as a target system. For a comprehensive list of approved and supported hardware, see the Microsoft Windows Logo Program web page: Problems with Microsoft WinDbg on AMD Opteron Dual-core AMD64 hardware When using Windows versions prior to Windows Vista on AMD Opteron Dual-core AMD64 hardware, the system may exhibit unstable behavior. This behavior can be seen when trying to use Windows WinDbg to break into and step through Windows drivers due to incorrect context registers. IntervalZero recommends using Windows 7 or Windows Vista as your base OS when using one of these AMD systems. On Dell Latitude D420 with Core Duo U2500 CPU systems, the RTSS subsystem will suffer a large decrease in performance if the following conditions exist: 5

6 IZ-DOC-X Hardware Requirements Intel SpeedStep is enabled. Prevent Windows idle state is unchecked on the Hardware tab in the RTX Properties control panel. Latency causing devices are not disabled. PCI express video controllers can cause jitter (large latencies) within an RTX application (3228). Workarounds for this problem are to: Select /BASEVIDEO in the boot.ini to use standard VGA display driver, or Disable all DirectDraw and Direct3D acceleration in Display Control Panel. Click the Settings tab, then Advanced, then Troubleshoot. The NVIDIA GeForce 7300 LE video driver causes long latencies on Vista systems and should be disabled (5837). The properties are: Driver file: nvlddmkm.sys Driver version: Date: This problem is also seen on Windows 7 systems which use both the NVIDIA GeForce 7300 LE card and the NVIDIA Quadro FX1700 card with properties (1220): Driver file: nvlddmkm.sys Driver version: Date: Note: If you disable this video driver using the RTX control panel, your display turns black and you must reboot. If you remove the driver using the Windows control panel, no reboot is required. On certain Dell dual-processor systems with the Intel Xeon chip sets (for example, Dell 650, Dell 670), the maximum timer delivery latency for a periodic RTX timer in Dedicated Mode is doubled under intensive video activities. Investigation results show that the high latency is inherited from the hardware. 6

7 Software Requirements IZ-DOC-X Software Requirements This section lists software requirements for the RTX 2011 with Service Pack 1 release. Operating System Requirements The RTX 2011 with Service Pack 1 Runtime and SDK are supported on the 32-bit configurations listed in the table below. The RTX 2011 with Service Pack 1 SDK can be installed on a 64-bit Windows system, and that system can be used for development and to host the debugging of a target machine. However, you cannot install the Runtime Subsystem, as it is not supported on a 64-bit operating system. Windows XP Professional with SP3 Uniprocessor PIC Uniprocessor APIC Multi-processor Yes Yes Yes Windows XP Embedded Yes 3 Yes 3 Yes 3 Windows Server 2003 with no SP Windows Server 2003 with SP1 Yes Yes Yes Yes Yes Yes Windows Server 2003 R2 Yes Yes Yes Windows Server 2003 with SP2 No 1,2 No 1,2 Yes 1 Vista with no SP No Yes Yes Vista with SP1 No Yes Yes Vista with SP2 No Yes Yes Windows Embedded Standard 2009 No Yes 3 Yes 3 Windows 7 with no SP No Yes Yes Windows 7 with SP1 No Yes Yes Windows Embedded Standard 7 No Yes 4 Yes 4 1 Windows Server 2003 SP2 supports only dedicated environments. It does not support shared environments. 2 RTX cannot be installed on uniprocessor machines running Windows Server 2003 SP2. 3 Embedded system must support MSI installation to allow RTX to be installed. Otherwise, the RTX Embedded Runtime must be used. 7

8 IZ-DOC-X Software Requirements 4 Windows Embedded Standard 7 system must support MSI installation to allow RTX to be installed. For the most up-to-date list, click the link titled Download the RTX Operating System Compatibility Matrix PDF file on the web site Note: RTX Windows XP Embedded and Windows Embedded Standard 2009 support, through Microsoft Windows Embedded Studio, is provided in a separate installer. Retired Operating System Support Starting with RTX 2009, IntervalZero discontinued RTX support for Windows Microsoft Visual Studio Requirements (SDK Only) The RTX 2011 SDK requires that you have Microsoft Visual Studio 2010, Visual Studio 2008 or Visual Studio 2005 installed if you wish to build or debug RTX programs with the Visual Studio IDE. Beginning with RTX 2011, IntervalZero has discontinued support for Visual Studio.NET Administrator Privileges Administrator privileges are required for installing, uninstalling, and using the RTX 2011 with Service Pack 1 product. If you are installing on a Windows 7 or Vista system with User Account Control activated, your application will not be run with your full permissions unless you choose to run them as an administrator. RTX avoids this problem by providing a User Account Control Override service. If you do not want to override this Windows functionality you can disable it by doing following: During the RTX installation you will have the option to deselect the RTX User Account Control Override Service. If you do not install, or if you disable the RTX User Account Control Override service, non-administrative users will not be allowed to run RTSS applications. 8

9 Installation Warnings IZ-DOC-X Installation Warnings Depending upon your system configuration, you may encounter installation warnings. They can be ignored, as explained below, and the installation should still proceed successfully. "Setup was unable to interface with the power management service. Please note that an RTX-Compatible power configuration will not be created. See the RTX Installation Guide for detail on the RTX Recommended Power State." If the power management feature is not a part of your Windows 7-Based Windows Embedded Standard 7 target image, then the installer will not be able to implement the RTX Recommended Power State. This should not affect functionality as the preferred power state for RTX is to have all power management features disabled. "Could not register type library for C:\Program Files\IntervalZero\RTX\ tools\platformevaluator\cfx4032.ocx. Contact your support personnel." On some Windows Embedded Standard systems, a warning could appear during installation noting that the ActiveX control used for Platform Evaluator could not be registered. This warning can be avoided by de-selecting the Platform Evaluator feature from the Custom Setup selections or it can be ignored. 9

10 IZ-DOC-X Installing RTX 2011 with Service Pack 1 Installing RTX 2011 with Service Pack 1 This release is provided as a downloadable file from the IntervalZero Web site. The installation program walks you through the installation process. Additional Installation Options In addition to the installation described in this document, the RTX 2011 with Service Pack 1 Runtime is also available in the following installation types: Silent RTX Runtime RTX 2011 with Service Pack 1 can be installed silently. The silent installation can be invoked from the command line or used within your own product installation so as not to require user interaction during the installation process. The RTX Silent Installer can also be added as a Distribution Share component using the Windows Embedded Standard 7 Image Configuration Editor (ICE). For more information, see the Silent Installation Guide for RTX Embedded RTX Runtime The RTX 2011 with Service Pack 1 Runtime is provided as a Source Level Definition (SLD) that supports Windows XP Embedded and Windows Embedded Standard This support is provided in a separate installer and is also available as an evaluation version. Merge Modules for RTX Runtime Features The RTX 2011 with Service Pack 1 Runtime components are available as merge modules that can be included in the installation of an OEM product. A separate installation places merge modules on the system for your use. The merge modules are also available as an Evaluation version. Before You Begin Before beginning the installation, do the following: Verify that your configuration meets the system requirements described earlier in this document. You must have administrator privileges on your system. Log on with administrator privileges or start using Run as Administrator. If you are upgrading from a version prior to RTX 2009, you must uninstall any previous versions before installing the new version. Make sure that you have an RTX 2011 Purchase Authentication Code (PAC) number for license key entry; it is available from IntervalZero Sales. For information regarding PAC numbers, see "Appendix A: Licensing" on page 20. IntervalZero recommends that you de-select the Windows Automatically reboot option for Startup and Recovery from the Advanced tab of the System Properties 10

11 Installing RTX 2011 with Service Pack 1 IZ-DOC-X page of the Windows Control Panel. De-selecting this parameter allows you to view blue screen information. Exit all Windows programs. Note: When you upgrade your operating system (for example, from Windows Vista to Windows 7), you must uninstall and then reinstall RTX 2011 with Service Pack 1 after the OS upgrade. Performing the Install To install RTX 2011 with Service Pack 1: 1. Download the self-extracting executable, RTX2011Setup_with_SP1.exe, from the IntervalZero web site: Note: The download directory also includes: The RTX 2011 Silent Installer file: IntervalZero RTX 2011_with_SP1.msi The RTX 2011 Merge Module installer: Rtx2011MergeModulesSetup_with_SP1.exe For access to evaluation kits, go to the URL: In the form that appears, select RTX 2011 from the drop-down list, fill out the contact information, and click Submit. 2. Double-click the RTX2011Setup_with_SP1.exe. 3. On Windows 7 or Vista machines, if necessary, click Continue in the User Account Control dialog box. 4. Click Next in the IntervalZero RTX 2011with Service Pack 1 installation Welcome window. 5. Read the End User License Agreement, select I accept the terms in the license agreement and then click Next. 6. Enter your user name, organization, address and PAC number, and then click Next. Note: If you do not have a PAC Number, contact your software provider. 11

12 IZ-DOC-X Installing RTX 2011 with Service Pack 1 7. If you are using a retail copy, you will be prompted to click Yes if you have access to the Internet so that a product license key can be generated. If you do not have access to the Internet from this system, instructions will be displayed showing you how to generate a license from an Internet-enabled location If Internet access is available, the installer opens up Internet Explorer to a page on the IntervalZero Web site. Note: The browser window may be hidden by the installer program windows, so you may have to switch to the browser using ALT-TAB. 8. The license generating routine will enter the gathered information into the Product Licensing page. To obtain a license, you must first click the Terms & Conditions link to read license information and then check the agreement box before clicking the Get License button. 9. Return to the installer program to enter the license you received in the previous step and then click Next. 10. Optionally, change to a destination other than the default: C:\Program Files\IntervalZero\RTX. Click Next in the Destination Folder screen. 11. Click Next in the Custom Setup screen. Note: If you have selected the Win32 Enabled Managed Code Support feature during installation and the.net Framework is installed, the Managed Code DLL will be registered by default. 12. In the Boot Configuration screen, configure the number of RTX and Windows processors and choose a Configuration Mode, or accept the defaults. Then click Next. Shared mode is supported on systems that: o o Have eight or fewer processors Do not have processor clustering automatically set by the hardware. Dedicated mode is supported on systems that have up to 32 processors. o If your system has more than eight processors, or if clustering is required by the hardware in a system with eight or fewer processors, RTX will automatically configure the system to run in Dedicated (Cluster) mode. Number of Windows processors: o In Dedicated (Cluster) mode, a maximum of four processors can be dedicated to Windows. Number of RTSS processors: 12

13 Installing RTX 2011 with Service Pack 1 IZ-DOC-X o The RTX product supports up to 32-processors. This line will also show the maximum number of licensed processors. Edition options allow up to 31 processors to be licensed to be dedicated to RTSS. See Modifications to the Boot Configuration for more information. 13. In the Ready to Install the Program screen, select whether you want Desktop Icons and/or Start Menu Icons and then click Install. 14. If prompted, install the drivers: a. Click Install to install the RTX Plug and Play driver. (Windows 7 or Vista) b. Click Install to install the RTX Virtual Network Adapter. 15. Click Finish in the installation Completed screen. 16. When you are prompted, click Yes to reboot your computer. If you have a multiprocessor machine, choose the boot configuration at system startup: [Operating System] - RTX Dedicated Note: The RTX Properties control panel will not provide completely accurate information until you reboot your system. Modifications to the Boot Configuration On multiprocessor (MP) systems, the RTX 2011 with Service Pack 1 installation process modifies the boot configuration to contain an additional RTX Dedicated option. It does this by first checking to see how many processors are known to the operating system. If it detects more than one processor, it creates a new boot configuration for RTX Dedicated, based on the current configuration. If the installation determines that processor clustering is enabled (either because there are more than eight processors, or because a system with eight or fewer processors has hardware enforced clustering) then an initial dedicated configuration will assign four processors (the maximum allowable) to Windows and the rest to RTX. If the installation determines that more than one processor is present in the system, but clustering is not enabled, then an initial dedicated configuration will assign one processor to RTX and the remaining processors to Windows. On boot up, you must select the Microsoft [Windows Version] - RTX Dedicated configuration. For example, Microsoft Windows XP Professional - RTX Dedicated. If you boot into another configuration and attempt to use RTX, you will encounter a popup warning that RTX is not configured for the current configuration. The boot configuration modifications that occur depend upon the type of operating system that you are running (Windows 7, Vista or XP) and the state of the current boot configuration. On a uniprocessor system, the only valid configuration is Shared, with 1 RTSS Processor and 1 RTX processor. 13

14 IZ-DOC-X Installing RTX 2011 with Service Pack 1 On a multiprocessor system without clustering, Shared or Dedicated may be specified. If using a shared configuration, there can only be 1 RTSS processor. The number of Windows processors can be anywhere between 1 and the number of cores on the system. In Dedicated mode, the number of Windows processors and RTSS processors must not exceed the number of cores on the system. RTSS processors must not exceed the number licensed. On a multiprocessor machine with clustering, only Dedicated mode is supported. The number of Windows processors must be between 1 and 4. Since Windows and RTSS can t share a cluster, the number of RTSS processors cannot exceed the total number of processors minus 4. RTSS processors must not exceed the number licensed. Notes: RTX configuration is setup via the RTX Control Panel or RTX Properties API and must not be modified or removed. When upgrading from RTX 2009, an extra boot configuration line may be created. Viewing the Release Notes after Installation Each component has release notes installed as part of its product and can be accessed by selecting IntervalZero > RTX 2011 > RTX Documentation and then Release Notes from the Start menu. 14

15 Verifying the Installation of RTX 2011 with Service Pack 1 IZ-DOC-X Verifying the Installation of RTX 2011 with Service Pack 1 After RTX 2011 with Service Pack 1 has been installed and the system has been rebooted, you can run the System Response Time Measurement (SRTM) utility to verify that the installation was successful. To run SRTM: 1. Open Windows Explorer and navigate to the <RTXDIR>\bin directory. Note: If you accepted the installation defaults, this location is: C:\Program Files\IntervalZero\RTX\bin 2. Run SRTM by double-clicking the srtm.rtss executable. You should hear a steady 1 KHz tone for 15 seconds and a histogram of the system s response time measurements should appear on the screen. Sample Output from srtm.rtss SRTM v2.0 timer delivery latencies for a periodic RTX timer: Timer Period = 100 us, Clock Resolution = 0.1 us. Sample Period = 15 s, Total Ticks = Summary: Minimum = 0 us, Average = 0 us, Maximum = 3 us Histogram: 0-1 us: us: us: us: us: 0 *** 15

16 IZ-DOC-X Uninstalling RTX 2011 with Service Pack 1 Uninstalling RTX 2011 with Service Pack 1 Uninstall Considerations Keep the following in mind when removing RTX 2011 with Service Pack 1 from your system. If you install the RTX Runtime on a Windows Server 2003 system and then subsequently uninstall the RTX software, you must reboot the system before you can reinstall RTX. When RTX is uninstalled from a system, any devices given to RTX must be returned to Windows by using the Windows Device Manager The RTX Properties control panel must be closed before uninstalling RTX. An error message appears if you do not allow the RTX subsystem to be stopped automatically during an uninstall. Performing the Uninstall If you need to uninstall any of the RTX 2011 with Service Pack 1 components, perform the appropriate procedure, as described below, for your version of Windows. To uninstall RTX 2011 with Service Pack 1 on Windows 7 or Vista machines: 1. From the Start menu, choose Control Panel. 2. Under Programs, click Uninstall a Program. 3. Select the RTX 2011 with Service Pack 1 program and click Uninstall. 4. Click Yes to confirm. 5. If necessary, click Allow. 6. You are warned if any RTX applications need to be stopped prior to uninstalling. Verify that Automatically close applications and attempt to restart them after setup is complete is selected and click OK. 7. Click Yes to restart your machine. To uninstall RTX 2011 with Service Pack 1 from Windows XP machines: 1. From the Start menu, choose Control Panel. 2. Open Add or Remove Programs. 3. Select the IntervalZero RTX 2011 with Service Pack 1 program and click Change. (for Windows 7, click Uninstall) 4. In the IntervalZero installation window that appears, click Remove. 16

17 Uninstalling RTX 2011 with Service Pack 1 IZ-DOC-X Note: If the RTX subsystem is currently running, the uninstall process tells you that the subsystem must be stopped in order to uninstall RTX 2011 with Service Pack 1. If the process asks if you want to stop the subsystem and then continue, click Yes. 5. After the uninstall process has been completed, click Finish. 6. When you are prompted to restart the machine, click Yes. 17

18 IZ-DOC-X Getting Support Getting Support IntervalZero offers a number of support options for RTX users, including technical support and the IntervalZero Web site. Third-Party Support If you are a customer who purchased an IntervalZero product through a third-party reseller, contact the reseller for support. Before Calling Technical Support Please have the following information ready before calling IntervalZero Technical Support: Your Support ID Customers who purchase direct support receive an address and password for use when accessing the IntervalZero support web site. The Version Number of Your RTX Software Before calling technical support, determine the version of RTX installed on your system. To obtain the RTX version number: 1. Click Start > All Programs > IntervalZero > RTX 2011 > RTX Properties. 2. Record the RTX version that is shown in the RTX Properties window. IntervalZero Web Site The IntervalZero Customer Support Web page is located at: The IntervalZero support web pages provide electronic access to the latest product releases, documentation, and release notes. With a valid address and password, you can access the online problem report database to submit new issues or to obtain the status of previously reported issues. Contacting Technical Support by Phone For technical support related to installing and using RTX, you can call technical support at these numbers: From inside the United States, call At the prompt, press 3 for Support. From outside the United States, call At the prompt, press 3 for Support. 18

19 Getting Support IZ-DOC-X Hours are Monday - Friday, 8:30 a.m. 5:30 p.m. US Eastern time (GMT-500), excluding holidays. 19

20 IZ-DOC-X Appendix A: Licensing Appendix A: Licensing When a purchase order is processed, a Purchase Authentication Code (PAC) is assigned to each product license purchase. The list of PACs is then sent in an that describes how to generate your per-machine license key from the IntervalZero Web site. During the installation of a per-machine RTX license, you must have a connection to our Web site to generate a license key specific to the product Purchase Authentication Code (PAC) and machine. Site/OEM licensing is to be used by companies that distribute IntervalZero software bundled with their own software, or those who purchase a site license for their organization. Installation via site/oem licensing does not require an Internet connection to the IntervalZero website. The following section discusses this product licensing methodology. Key Retrieval Installing RTX 2011 with Service Pack 1 with a per-machine license requires three pieces of information: Purchase Authentication Code (PAC) - Provided by IntervalZero after an order is processed. The PAC indicates that a product license has been purchased. It serves as a token associated with each product license purchase. Machine Information - Generated at the time of installation by the product installation, based on system information. License Key - Machine-specific license key derived from the Purchase Authentication Code and the system specific machine information. The license key is generated for you by IntervalZero. The RTX per-machine license key can be obtained from IntervalZero in two ways: Automatic License Key Generation or Manual License Generation Automatic License Key Generation If the target system is connected to the Internet, then automatic key generation is possible. The product installation extracts machine information and automatically accesses the IntervalZero Web site to get the License Key. 20

21 Appendix A: Licensing IZ-DOC-X You are prompted for your contact information and the Purchase Authentication Code at the IntervalZero Web site. The license key is derived from the Purchase Authentication Code. This per-machine license key is then used to complete the installation of the RTX 2011 with Service Pack 1 product. You will also receive a copy of the License Key transaction in an containing your contact information, Purchase Authentication Code, the machine information, and the License Key. Save this information as it may be needed if the product is reinstalled or relocated. Manual License Key Generation If the system is not connected to the Internet, automatic key generation is not possible and key generation must be done manually. The product installation extracts machine information and displays the information that will be required to generate a license key. You must go to the following IntervalZero web site: For a purchased edition, license key generation can be done at: For an evaluation edition, license key generation can be done at: When prompted, enter the requested Purchase Authentication Code, Machine ID and Address. You will receive the License Key in a browser window; you are also sent an listing your contact information, Purchase Authentication Code, machine information and the License Key. The License Key can then be entered manually during the product installation. Product Relocation If you must move the product installation to another system for any reason (for example, replacing a development system, a machine is unavailable because it needs repair, and so on), you may relocate your software by generating a replacement License Key. To request a "Replacement License" you must contact IntervalZero Sales. 21