Dolphin D Express Installation and Reference Guide

- MySQL - Oracle RAC

Dolphin Interconnect Solutions ASA

This document describes the installation and usage of the Dolphin Express software stack version 3.4.0. In combination with Dolphin D hardware.

Published under Gnu Public License v2

August 21st, 2008


Table of Contents

Abstract
1. Introduction & Overview
1. Who needs Dolphin Express and SuperSockets?
2. How do Dolphin Express and SuperSockets work?
3. What's Special about Dolphin Express and SuperSockets?
4. Contents of this Document
5. Terminology
6. Contact & Feedback: Dolphin Support
2. Quick Installation Guide
3. Requirements and Planning
1. Supported Platforms
1.1. Hardware
1.1.1. Supported Platforms
1.1.2. Recommended Node Hardware
1.1.3. Recommended Frontend Hardware
1.2. Software Support
1.2.1. Others
2. Interconnect Planning
2.1. Nodes to Equip with Dolphin Express Interconnect
2.1.1. MySQL Server and MySQL Cluster
2.1.2. Oracle RAC
2.2. Dolphin D Interconnect Topology
2.3. Physical Node Placement
4. Initial Installation
1. Installation Requirements
1.1. Live Installation
1.2. Non-GUI Installation
1.2.1. No X / GUI on Frontend
1.2.2. No X / GUI Anywhere
2. Dolphin D Adapter Card Installation
3. Software and Cable Installation
3.1. Overview
3.2. Starting the Software Installation
3.3. Working with the dishostseditor
3.3.1. Cluster Edit
3.3.2. Node Arrangement
3.3.3. Cabling Instructions
3.4. Cluster Cabling
3.4.1. Connecting the Dolphin D cables
3.4.2. Verifying the Cabling
3.5. Finalising the Software Installation
3.5.1. Static Connectivity Test
3.5.2. SuperSockets Configuration Test
3.5.3. SuperSockets Performance Test
3.6. Handling Installation Problems
3.7. Interconnect Validation using the management GUI
3.7.1. Installing sciadmin
3.7.2. Starting sciadmin
3.7.3. Cluster Overview
3.7.4. Cabling Correctness Test
3.7.5. Fabric Quality Test
3.8. Making Cluster Application use Dolphin Express
3.8.1. Generic Socket Applications
3.8.2. Kernel Socket Services
5. Update Installation
1. Complete Update
2. Rolling Update
6. Manual Installation
1. Installation under Load
2. Installation of a Heterogeneous Cluster
3. Manual RPM Installation
3.1. RPM Package Structure
3.2. RPM Build and Installation
4. Unpackaged Installation
7. Interconnect Maintenance
1. Verifying Functionality and Performance
1.1. Low-level Functionality and Performance
1.1.1. Availability of Drivers and Services
1.1.2. Cable Connection Test
1.1.3. Static Interconnect Test
1.1.4. Interconnect Load Test
1.1.5. Interconnect Performance Test
1.2. SuperSockets Functionality and Performance
1.2.1. SuperSockets Status
1.2.2. SuperSockets Functionality
1.3. SuperSockets Utilization
2. Replacing Interconnect Cables
3. Replacing an Adapter
4. Physically Moving Nodes
5. Replacing a Node
6. Adding Nodes
7. Removing Nodes
8. Locating and Fixing Connection Problems
8.1. Recognizing Connection Problems
8.1.1. Causes for Connection Problems
8.2. Locating Problematic Connections
8.2.1. Software Tools for Connection Testing
8.2.2. Manually Locating Problematic Connections
8. MySQL Operation
1. MySQL Cluster
1.1. SuperSockets Poll Optimization
1.2. NDBD Deadlock Timeout
1.3. SCI Transporter
2. MySQL Replication
9. Oracle RAC Operation
1. Oracle RAC
2. Installation
2.1. Oracle
2.2. Dolphin SuperSockets
2.3. Enabling Oracle Booster
3. Known issues
10. Advanced Topics
1. Notification on Interconnect Status Changes
1.1. Interconnect Status
1.2. Notification Interface
1.3. Setting Up and Controlling Notification
1.3.1. Configure Notification via the dishostseditor
1.3.2. Configure Notification Manually
1.3.3. Verifying Notification
1.3.4. Disabling and Enabling Notification Temporarily
2. High-Availability Features
3. Managing IRM Resources
3.1. Updates with Modified IRM Configuration
4. Using scidiag
11. FAQ
1. Dolphin D Hardware
2. Software
A. Self-Installing Archive (SIA) Reference
1. SIA Operating Modes
1.1. Full Cluster Installation
1.2. Node Installation
1.3. Frontend Installation
1.4. Installation of Configuration File Editor
1.5. Building RPM Packages Only
1.6. Extraction of Source Archive
2. SIA Options
2.1. Node Specification
2.2. Installation Path Specification
2.3. Installing from Binary RPMs
2.4. Preallocation of Memory - Communication Buffers
2.5. Enforce Installation
2.6. Configuration File Specification
2.7. Batch Mode
2.8. Non-GUI Build Mode
2.9. Software Removal
B. sciadmin Reference
1. Startup
2. Interconnect Status View
2.1. Icons
2.2. Operation
2.2.1. Cluster Status
2.2.2. Node Status
3. Node and Interconnect Control
3.1. Admin Menu
3.2. Cluster Menu
3.3. Node Menu
3.4. Cluster Settings
3.5. Adapter Settings
4. Interconnect Testing & Diagnosis
4.1. Cable Test
4.2. Fabric Test
5. Troubleshooting Best Practice
C. Configuration Files
1. SuperSockets Configuration
1.1. supersockets_profiles.conf
1.2. supersockets_ports.conf
2. Driver Configuration
2.1. dis_irm.conf
2.1.1. Resource Limitations
2.1.2. Real time behavior
2.1.3. Memory Preallocation
2.1.4. Logging and Messages
2.2. dis_ssocks.conf
D. Platform Issues and Software Limitations
1. Platforms with Known Problems vs Dolphin D
2. SuperSockets

List of Figures

4.1. Cluster Edit dialog of dishostseditor
4.2. Main dialog of dishostseditor
4.3. Node dialog of dishostseditor
4.4. Location of link 0 and link 1 on D352 adapter
4.5. Location of channel A and channel B on D350 adapter
B.1. Fabric is UP
B.2. Fabric is DEGRADED
B.3. Fabric has FAILED due to loss of connectivity
B.4. Fabric has FAILED due to dead nodes
B.5. Options in the Admin menu
B.6. Options in the Cluster menu
B.7. Options in the Node menu
B.8. Cluster configuration in sciadmin
B.9. Advanced settings for a node
B.10. Link disabled by istrator (Disabling the links on the machine with hostname tiger-5 takes down the corresponding links on the other machines that share the same ringlet.).
B.11. Result of running cable test on a good cluster
B.12. Result of cable test on a problematic cluster
B.13. Result of fabric test without installing all the necessary rpms
B.14. Result of fabric test on a proper fabric

List of Tables

B.1. Node or Adapter State
B.2. Link State