Virtual Alpha User Guide - Migration Specialties: …

1 Migration Specialties International, Inc. 217 West 2nd Street, Florence, CO 81226-1403 +1 719-784-9196 E-mail: Continuity in Computing Copyright 2018, Migration Specialties. International, Inc. All trademarks and registered names used in this document are the property of their respective owners. Virtual Alpha user Guide for Avanti, AvantiFlex, & FreeAXP 05-JAN-2018 Version : This manual covers all releases of Avanti , AvantiFlex and FreeAXP . This manual describes how to install and use Avanti, AvantiFlex, and FreeAXP, Migration Specialties' AlphaServer 400 hardware emulators. AvantiFlex and Avanti are commercial products that require purchase of a product license. AvantiFlex and Avanti include 30 days of manufacturer support after purchase and the option to buy an extended support contract. FreeAXP can be used for personal and commercial purposes. FreeAXP is unsupported without purchase of a support contract.

2 If you have questions or problems with FreeAXP and have not purchased a support contract, visit the FreeAXP forum at the OpenVMS Hobbyist web site. Avanti & Avanti Flex Links Product Info: user Guide : Release Notes: License: SPD: Pricing Guide : FreeAXP Links Product Info: user Guide : Release Notes: License: SPD: user Forum: Download: Migration Specialties International, Inc. Copyright 2018 Migration Specialties International, Inc. 217 W 2nd Street Florence, Colorado 81226-1403 +1 719-784-9196 Email: Web-Site: First Printing: February 2011 The software described in this manual is furnished under a license and may only be used or copied in accordance with the terms of that license. No responsibility is assumed by Migration Specialties or its affiliated companies for use or reliability of this software or for errors in this manual or in the software. Restricted Rights Legend Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subdivision (b) (3) (ii) of the Rights in Technical Data and Computer Software clause in , or other applicable Federal Acquisition Regulations.

3 This manual is subject to change without notice and does not constitute a commitment by Migration Specialties. The following are trademarks of Migration Specialties: Avanti FreeAXP Avanti Flex Digital Emulator Collection The following are trademarks of Microsoft Corporation: Windows Windows XP Windows Vista Windows 7 Windows 8 Windows 10 Windows Server 2003 Windows Server 2008 Windows Server 2012 The following are trademarks of Hewlett Packard Corporation: VAX DEC Alpha OpenVMS Tru64 UNIX Integrity OSF ULTRIX-32 ULTRIX All other trademarks and registered names used in this document are the property of their respective owners. Migration Specialties International, Inc. 1 Contents 1. DOCUMENT CONVENTIONS 10 Virtual Alpha Product References 10 Size Designations: K, M, G 10 Migration Specialties Virtualization Products 10 Retired O/S 10 2. QUICK START 11 Porting Services 11 3. AVANTI LICENSING 12 Transitioning from FreeAXP to Avanti 12 USB License Key Installation Confirmation 12 License Key Grace Period 13 Avanti Version and License Key Information 13 Temporary License Example 13 Permanent License Example 14 Moving a Temporary Avanti License Key 14 USB License Key Troubleshooting 15 USB Port 15 Native to the Board Ports 15 4.

4 INSTALLATION 16 Windows Installation 16 Prerequisites 16 Operating Systems 16 Hardware 16 Sizing Host Memory 16 Rights 17 Installation Restrictions 17 Windows Installation Steps 18 Windows Installation Details 20 Installation Folder 20 Firewall Exception 20 Installation Log 20 Migration Specialties International, Inc. 2 5. DE-INSTALLING AVANTI 21 Windows Uninstall 21 6. Virtual Alpha CONFIGURATIONS 22 7. AVANTI CONFIGURATION UTILITY 23 Avanti Configuration Files 23 Manually Modified Configuration Files 23 Updating Avanti Path Names 23 Specifying Sizes 23 Configuration Utility Layout 24 Running the Configuration Utility 24 Configuration Drop-down Menus 25 File 25 Help 26 Virtual Alpha Components 26 Advanced Features 26 <base> 26 VLC 27 Logfile 27 keep 27 Virtual Alpha Base Settings 27 Main Memory 28 JIT 28 Serial Ports: OPA0/tty00 TTA0/tty01 29 Telnet server 29 Port 29 Start session automatically 29 Physical Port 29 Log file 30 keep 30 PCI Slots 30 SCSI Controllers: KZPAA and KZPCA 31 Type 31 Migration Specialties International, Inc.

5 3 31 image file 32 Creating a Disk Image File 32 Assigning an Existing Image File 32 raw device 32 tape image 32 Creating a Tape Image File 33 Assigning an Existing Tape Image File 33 CD-ROM 33 NIC 33 Type 34 Interface 34 Set MAC address 34 Single Avanti Instance and MAC Addressing 35 Multiple Avanti Instances and MAC Addressing 35 show units 35 Advanced Configuration Features 36 VLC [+] 37 extra_threads 37 fixed_threads 37 win32_limit_cache_yn 38 win32_limit_cache_size 38 forbidden_cpus 38 startup_delay 38 Logfile [+] 38 wmi 38 JIT [+] 39 image 39 jit_memory 39 PCI bus [+] 39 data 39 shadow_on_disk 39 Serial Ports (OPA0/tty00, TTA0/tty01) [+] 39 Migration Specialties International, Inc. 4 log 39 buffersize 40 chunksize 40 chunktime 40 Telnet Port [+] 40 action 40 Device (Physical serial port) [+] 40 linesettings 40 readbuflen 41 debug 41 debugv 41 dumpbuffer 41 Log file [+] 41 wmi 41 SCSI Disk [+] 41 vendor 41 model_num 41 rev_num 41 serial_num 41 autocreate_size (image file only) 42 sparse (image file only) 42 write_share 42 tcq 42 disconnect 42 sync_io 42 round_up 42 heads 43 cylinders 43 sectors 43 read_delay 43 write_delay 43 write_through 43 SCSI Tape [+] 44 Migration Specialties International, Inc.

6 5 vendor 44 model_num 44 rev_num 44 serial_num 44 advanced_behavior 44 disconnect 44 8. RUNNING AVANTI 45 Key Requirements 45 Host Network Configuration 45 Avoiding Avanti Crashes 45 Avanti Warning on Windows Shutdown 45 Launching Avanti 45 Avanti Control Icon 46 Control Menu Layout 46 Launching Avanti from a Shortcut 47 Launching Avanti Manually 47 Launching Avanti from a Batch File 47 Running Avanti From a Non-Administrator Account 48 First Launch Messages 48 Console Operations 49 Console Help 49 Launching Avanti Without the Console 49 OpenVMS Auto Boot 49 Tru64 Auto Boot 49 Ambiguous Boot Device 50 Exiting Avanti 50 Multiple Avanti Instances on a Single Host 50 Overloading a Host System with Multiple Avanti Instances 51 Avanti and FreeAXP on a Single Host 51 FreeAXP / Avanti Selection Box 51 Installing Avanti as a Service 51 Service Creation 52 Migration Specialties International, Inc.

7 6 Service Removal 52 Service Errors 53 9. Virtual HOST ENVIRONMENTS 54 USB Key Support 54 VMware USB Key Support 54 Migrating Virtual USB Support 54 NIC Configuration 54 VMware Virtual NICs 54 Allocating CPU Resources 54 General VM Resource Management 55 10. NETWORKING AVANTI 56 Adding a Host NIC 56 Dedicating a NIC 56 NICs and Multiple Instances of Avanti 56 Networking Avanti on a System with a Single NIC 57 Microsoft Loopback Connector 57 Manually Modifying the Avanti MAC Address 57 DE435 for Older O/S 58 Networking with Wireless Ethernet 58 Wireless Ethernet and Avanti 58 Installing a New NIC 59 VMware NICs 59 Hyper-V Virtual NICs 60 11. AVANTI DEFAULT SERIAL PORTS 61 Serial Port Telnet Port Numbers 61 Serial Port Logging 61 Console Port 61 Physical Serial Devices 61 12. 5-PORT SERIAL CARD SUPPORT (OPENVMS) 62 Defining the Serial Card to the Firmware 63 Defining the Serial Card to OpenVMS 65 Serial Card Configuration Prior to OpenVMS 65 Migration Specialties International, Inc.

8 7 OpenVMS and Higher Serial Card Configuration 66 Sample Configuration File With Serial Card 67 13. Virtual TAPES 69 Changing Tapes 69 Virtual Tape File Space Allocation 70 Make Tape Utility 70 14. AVANTI PERFORMANCE 71 CPU Instruction Sets 71 Memory 71 Disk I/O 71 Using CDs and DVDs 72 Virtual Tape Performance 72 TCQ and Performance 72 15. OPENVMS SPECIFIC NOTES 73 Porting an OpenVMS System 73 OpenVMS Auto Boot 73 Reconfiguring the Network 73 Bypassing a NIC 74 Maximum Physical Disk Size Under OpenVMS 74 OpenVMS Clustering 74 Quorum Disk and TCQ 74 Clusters and Disk Sharing 74 OpenVMS 75 OpenVMS 75 VMS Login After Installation 75 VMS Conversational Boot 75 OpenVMS 76 VMS Installation 76 VMS Image Backups 76 VMS Network Support 76 OpenVMS SCSI Support Limitations 77 Serial Devices 77 Migration Specialties International, Inc. 8 OpenVMS PuTTY Settings 78 Transferring PuTTY Settings 78 UNXSIGNAL Bug Check 79 16.

9 TRU64 UNIX SPECIFIC NOTES 80 Porting a Tru64 System 80 Tru64 Auto Boot 80 Tru64 Version Support 80 Network Notes 81 NIC Support in Releases 81 NIC Console Variables 81 Sharing NICs with Windows 81 LAT and Dual NICs 81 Switching NICs 81 SCSI Support Limitations 82 V5 and Large Disks 82 Maximum Physical Volume Size Under Tru64 UNIX 82 TRU64 Unix Virtual Tape Support 82 Tru64 UNIX PuTTY Settings 83 Transferring PuTTY Settings 84 17. MISCELLANEOUS NOTES 85 Boot Console Variables 85 Floating Point Values 85 Container File Compatibility 85 PersonalAlpha & Charon Container File 85 FreeAXP 32-bit PuTTY String 86 Lantronix Serial to Ethernet Device Support 86 Graphics Support 86 Shared CD-ROMs 86 18. TROUBLESHOOTING 87 Log Files 87 Avanti Log File 87 Terminal Log Files 87 Migration Specialties International, Inc. 9 PuTTY Log Files 87 Avanti Crash Dump File 87 Halting a Hung System 88 Problem Submission 88 APPENDIX A: GLOSSARY 89 APPENDIX B: AVANTI EMULATOR FILES 90 APPENDIX C: UPDATING A WINDOWS LICENSE KEY 91 LICENSE UPDATE FILE 91 LICENSE UPDATE PHRASE 91 RUNNING THE LICENSE UPDATE UTILITY 92 STEPS TO APPLY A LICENSE UPDATE 92 APPENDIX D: AVANTI COMMAND LINE OPTIONS 94 Migration Specialties International, Inc.

10 10 1. DOCUMENT CONVENTIONS This document uses the following conventions. Virtual Alpha PRODUCT REFERENCES Throughout this manual, Avanti will be used to represent the Migration Specialties Virtual Alpha products Avanti, AvantiFlex, and FreeAXP. Most installation, configuration, and runtime tasks are the same for all three products. Where distinctions are necessary, the products are referenced by name. SIZE DESIGNATIONS: K, M, G Some parameters used by the configuration utility designate file or buffer sizes. The suffixes K, M, and G are used to designate Kilo, Mega, and Giga. For example, to set the autocreate size of a disk to 4 gigabytes, the user would enter 4G in the autocreate_size box. Migration SPECIALTIES VIRTUALIZATION PRODUCTS Product Description Avanti/AvantiFlex Commercial Alpha emulator FreeAXP Free Alpha emulator SimH VAX Free open source VAX emulator RETIRED O/S The following host O/S are no longer supported.