CONTENTS Title Page Copyright Page Preface 1 OpenVMS Galaxy Version 7.2 Release Notes 1.1 Informational Message During Booting 1.2 Permanent Restriction on KFMSB and CIXCD Adapters in OpenVMS Galaxy Configurations 1.3 Compatibility of Galaxy Computing Environment and Non-Galaxy Cluster Members 1.4 Possible Problem Upgrading Firmware on AlphaServer 4100 Systems for V7.2-EFT3 Part I Introduction to the Galaxy Software Architecture on OpenVMS 2 OpenVMS Galaxy Overview 2.1 A New Computing Model and a New Software Architecture 2.2 The Galaxy Software Architecture on OpenVMS 2.3 OpenVMS Galaxy Components and Concepts 2.3.1 APMP Concepts 2.3.2 Another Possible Picture 2.4 OpenVMS Galaxy Features 2.5 OpenVMS Galaxy Benefits 2.6 OpenVMS Galaxy Version 1.0 Features 3 OpenVMS Galaxy Configurations 3.1 Is an OpenVMS Galaxy for You? 3.1.1 Why a Galaxy is a Good Business Choice 3.1.2 Things to Consider If You Want to Create a Galaxy 3.2 Possible OpenVMS Galaxy Configurations 3.2.1 Shared-Nothing Computing Model 3.2.2 Shared-Partial Computing Model 3.2.3 Shared-Everything Computing Model 3.3 Important Cluster Information 3.4 SCSI Cluster Considerations 3.5 Security Considerations in an OpenVMS Galaxy Computing Environment 3.6 Important Info That Needs to be Located in the Appropriate Chapters 3.6.1 New SYSGEN parameter 3.6.2 System Auto-Action 3.6.3 Changing console environment variables 3.6.4 CONFIGURE GALAXY 4 OpenVMS Galaxy Licensing Information 4.1 OpenVMS Galaxy Licensing Requirements 4.1.1 OpenVMS Operating System License 4.1.2 OpenVMS Galaxy License 4.1.3 OpenVMS Layered Products License 4.2 Clustering OpenVMS Galaxy Instances 4.2.1 Clustering in a Galaxy System 4.2.2 Clustering Outside a Galaxy System 4.3 License Databases 4.4 OpenVMS Galaxy License PAKs and LMF 4.5 For More Information About OpenVMS Licensing Part II Creating an OpenVMS Galaxy Environment 5 Creating an OpenVMS Galaxy on an AlphaServer 8400 5.1 Step 1: Choose a Configuration and Determine Hardware Requirements 5.1.1 Using the OpenVMS Configuration Utility 5.1.2 OpenVMS Galculator Display Example 5.2 Step 2: Set Up Galaxy Hardware 5.2.1 Installing the KFE72-DA Console Subsystem Hardware 5.2.2 Using a Terminal Server 5.2.3 Recommendations for Configuring Console Subsystems 5.2.4 Installing EISA Devices 5.3 Step 3: Create A System Disk 5.4 Step 4: Install OpenVMS Alpha Version 7.2 5.4.1 OpenVMS Galaxy Licensing Information 5.5 Step 5: Upgrade the Firmware 5.6 Step 6: Set Environment Variables 5.6.1 Galaxy Environment Variables Example 5.6.2 Table of Useful Integers 5.7 Step 7: Start the Secondary Console Devices 5.7.1 Console Hints 5.8 Step 8: Boot the OpenVMS Galaxy 6 Creating an OpenVMS Galaxy on an AlphaServer 8200 6.1 Step 1: Choose a Configuration and Determine Hardware Requirements 6.1.1 Using the OpenVMS Galculator 6.1.2 OpenVMS Galculator Display Example 6.2 Step 2: Set Up Galaxy Hardware 6.2.1 Installing the KFE72-DA Console Subsystem Hardware 6.2.2 Using a Terminal Server 6.2.3 Recommendations for Configuring Console Subsystems 6.2.4 Installing EISA Devices 6.3 Step 3: Create A System Disk 6.4 Step 4: Install OpenVMS Alpha Version 7.2 6.4.1 OpenVMS Galaxy Licensing Information 6.5 Step 5: Upgrade the Firmware 6.6 Step 6: Set Environment Variables 6.6.1 Galaxy Environment Variables Example 6.6.2 Useful Integers 6.7 Step 7: Start the Secondary Console Devices 6.7.1 Console Hints 6.8 Step 8: Boot the OpenVMS Galaxy 7 Creating an OpenVMS Galaxy on an AlphaServer 4100 System 7.1 Before You Start 7.2 Procedures 8 Using a Single-Instance Galaxy on Any Alpha System Part III Managing An OpenVMS Galaxy 9 OpenVMS Galaxy Configuration Utility 9.1 GCU Tour 9.1.1 Creating Galaxy Configuration Models 9.1.2 Observation 9.1.2.1 Layout Management 9.1.2.2 OpenVMS Galaxy Charts 9.1.3 Interaction 9.2 Managing an OpenVMS Galaxy with the GCU 9.2.1 Independent Instances 9.2.2 Required PROXY Access 9.3 Galaxy Configuration Models 9.3.1 Active Model 9.3.2 Offline Models 9.3.2.1 Example: Creating an Offline Model 9.4 Using the GCU Charts 9.4.1 Component Identification and Display Properties 9.4.2 Physical Structure Chart 9.4.2.1 Hardware Root 9.4.2.2 Ownership Overlay 9.4.3 Logical Structure Chart 9.4.3.1 Software Root 9.4.3.2 Unassigned Resources 9.4.3.3 Community Resources 9.4.3.4 Instance Resources 9.4.4 Memory Assignment Chart 9.4.4.1 Console Fragments 9.4.4.2 Private Fragments 9.4.4.3 Shared Memory Fragments 9.4.5 CPU Assignment Chart 9.4.5.1 Primary CPU 9.4.5.2 Secondary CPUs 9.4.5.3 Fast Path and Affinitized CPUs 9.4.5.4 Lost CPUs 9.4.6 IOP Assignment Chart 9.4.7 Failover Target Chart 9.5 Viewing Component Parameters 9.6 Executing Component Commands 9.7 CPU Reassignment 9.7.1 DCL Reassignment 9.7.2 GCU Drag-and-Drop Reassignment 9.7.3 Intermodal Reassignment 9.7.4 Software Reassignment Using Galaxy Services 9.7.5 Reassignment Faults 9.8 Monitoring an OpenVMS Galaxy with DECamds 9.9 Creating an Instance 9.10 Dissolving an Instance 9.11 Shutdown and Reboot Cycles 9.12 Online versus Offline Models 9.13 What's New For The GCU in EFT3 9.13.1 New DCL commands 9.14 GCU System Messages 10 DCL Commands 10.1 CPU Commands 10.1.1 STOP/CPU/MIGRATE 10.1.2 SHOW CPU 10.2 SHOW MEMORY 10.3 Lexical Function Example 10.4 DUMP 10.5 ANALYZE 10.6 INSTALL 11 Shared Memory Cluster Interconnect (SMCI) 11.1 SYS$PBDRIVER Port Devices 11.1.1 Multiple Clusters in a Single Galaxy 11.2 SYSGEN Parameters for SYS$PBDRIVER 11.2.1 SMCI_PORTS 11.2.2 SMCI_FLAGS 11.3 LAN Shared Memory Device Driver 12 OpenVMS Galaxy Tips and Techniques Part IV Developing Programs For An OpenVMS Galaxy 13 Locking Programming Interfaces 13.1 SYS$CREATE_GALAXY_LOCK_TABLE 13.2 SYS$DELETE_GALAXY_LOCK_TABLE 13.3 SYS$RESET_GALAXY_LOCK 13.4 SYS$CREATE_GALAXY_LOCK 13.5 SYS$DELETE_GALAXY_LOCK 13.6 SYS$GET_GALAXY_LOCK_INFO 13.7 SYS$GET_GALAXY_LOCK_SIZE 13.8 SYS$ACQUIRE_GALAXY_LOCK 13.9 SYS$RELEASE_GALAXY_LOCK 13.10 Locking Error Messages 14 System Events Programming Interfaces 14.1 $SET_SYSTEM_EVENT 14.2 $CLEAR_SYSTEM_EVENT 15 Shared Memory Programming Interfaces 15.1 Using Shared Memory 15.2 System Services 15.2.1 Enhanced Services 15.2.2 New Section Flag SEC$M_READ_ONLY_SHPT 15.3 Galaxywide Global Sections 16 CPU Management Programming Interfaces 16.1 SYS$CPU_TRANSITION 16.2 $CPU_TRANSITIONW 17 Configuration Management Programming Interfaces 17.1 SYS$GETSYI 18 System Dump Analyzer (SDA) 18.1 SDA Command Interface Changes or Additions 19 OpenVMS Galaxy Device Drivers 19.1 Direct DMA Window Changes 19.2 How PCI Direct DMA Works Prior to OpenVMS V7.2 19.3 How PCI Direct DMA Works in OpenVMS Version 7.2 19.4 IOC$NODE_DATA Changes to Support Non-zero Direct DMA Windows