Cvapi.c a sample API application | Quantum 3.5 specs

Appendix C StorNext Files

Commonly Used SNFS Files

•/usr/cvfs/lib/

cvextapi.a — A SNFS API library.

•libcvfsdmapi.a — A SNFS DMAPI library.

•/usr/cvfs/src/

cvapi.c — A sample API application.

StorNext 3.5 Installation Guide

141

Image 158

Quantum 3.5 manual Cvapi.c a sample API application

Contents

StorNext Copyright Statement Contents StorNext GUI Accessing the StorNext GUI Displaying the Configuration Wizard 111 106110 112 Viewing a Fibre Channel Device 124 125 Figures Figures 103 101102 104 Tables 105 146 Preface Audience Purpose Document Organization Notational Conventions Convention Example Related Documents Document No Document Title Document Description Online Service Support World Wide WebContacting Quantum North America 1Installing StorNext File System and Storage Manager Hardware Requirements Operating System Kernel Platform Storage Manager System RequirementsOperating System Requirements Partitioning Local Hard Disks File SystemsDisk Space LAN Requirements Planning for LUNs Larger Getting Ready to InstallConfiguring Storage Devices Than 1 TB Operating Label for System LUNs 1 TB LUNs 1-2 TB LUNs 2 TB Vtoc Support Directory Description Pre-Installation ScriptBefore You Begin Running snPreInstall Pre-installation script runs figure Interpreting snPreInstall Output Type Description StorNext Installation Script Remove the existing rpms Installation script runs figure For Red Hat users only, before proceeding you must Changing Installation Configuration Options Menu Option Description Configuration Menu Changing Application Directory Locations Changing the Default Media Type Performing an Installation Operation 2Installing StorNext File System File System Requirements Windows Server Etc/hosts file Planning for LUNs Larger than 1 TB MacOS X Panthera Apple Xsan SVTOC Launching the Snfs Installation Script Installing StorNext File System on Linux or UnixInstalling the Linux Kernel Source Code Ls -l Application directories see Changing Change installation options for the locationExit the Snfs installation script Performing an Installation Operation Installing StorNext File System on Windows Disabling Automatic IP Address Configuration StorNext Installation window appears figure Removing a Previous Version of StorNext Running the Setup Wizard StorNext Installation Window Install StorNext Snfs Setup End User License Agreement Click an installation option Snfs Setup Choose Setup Type Restoring a Previous Client Configuration Snfs Setup Finish StorNext Installation Window Configure StorNext Click an option for handling current configuration settings Import/Export Client Configuration Window 3Installing the StorNext Client Client System Requirements Operating System Release or Kernel Platform Hardware Requirements StorNext File System Client Buffer Cache Downloading the StorNext Client Software Platform Type =2GB Memory For a MDC running Snfs only On the home page, click Select Platform window appears figure Download Client Software Window Installing the StorNext Client on Linux or Unix Installing the StorNext Client on Linux Mkdir -pmount point chmod 777 mount point Installing the StorNext Client on Sun Solaris File system mount point cvfs 0 auto rw Installing the StorNext Client on HP-UX Installing the StorNext Client on IBM AIX Mkdir -pmount point chmod 777 mount point Installing the StorNext Client on Windows StorNext Installation Window Remove StorNext Click Next to continue License Agreement window appears figure Snfs Setup Choose Setup Type Restoring a Previous Client Configuration StorNext Installation Window Configure StorNext Click an option for handling current configuration settings Configuring StorNext Accessing the StorNext StorNext GUI StorNext Home File System and Storage Manager Configuration Wizard StorNext Configuration Wizard File System Only Enter License Add File System Add Media Add LibraryAdd Tape Drive Mail Notification Add Storage DisksAdd Storage Policy Configuring a Distributed LAN Client Server Distributed LAN server configuration utility appears figure Sndpscfg Configuration Utility Field / Button Description Command Description Creating an Override ConfigurationUsing Distributed LAN Client and Server Commands Windows Configuration Utilities Client Configuration Mount Point Select the desired drive letter Select Map to Drive Letter to map the drive toSpecific drive letter Instead of selecting Map to Drive Letter, select Distributed LAN As a distributed LAN client or distributed Select this option to disable the StorNext clientSelect to configure the StorNext client as a LANserver Advanced Mount Options Default is off Soft Mount. Quantum Default isWhen this box is checked, the driver attempts Specify the number of times the driver will re Disks being accessible in the file system stripe When this box is checked, the file system canBe mounted and accessed without all Accessed Penalty value, where n is expressed When you choose Allow I/O Timouts, thisRequest in error, otherwise reset PathInError will be bypassed in favor Advanced Cache Options If Buffer Cache is disabled, the remaining When this box is not checked, the file systemDirectly into the applications memory using Will not buffer any data. All files will be read Default value is 16 buffers with a File system block size. The value default isDefault value is 1MB Maximum of 100. Using a value of 0 disables Circumstances where files are frequently Default values are 30 seconds for nonSetting these parameters lower will greatly Shared on the SAN, setting the Attribute Flush Disk Device Labeler On the Disk Labeler window, do one of the following Labeling Disks Close the Disk Labeler dialog box License Identifier Simple File System ConfigurationDo not write a label to the disk and proceed to Click to deselect all devices in the list Name used by clients when establishing aSwitching to the next disk in the stripe group Click to select all devices in the list Saved in the StorNext configuration directory Click to save the configuration usingCurrent settings. The configuration file is Configuration utility Configuring StorNext Windows Configuration Utilities Configurations is highest priority and 9 is Click to add a file system to the FSM servicesFSM services list Click to save changes to the FSM services list Click to quit the File System Startup List Utility without saving changes Server Administration File System Properties Stripe Group Properties Quota Properties Displays the percentage of the quota that has Type the name of the user or group to set aQuota for Been used Clients Information Quality of Service InformationServer Configuration Disk Types on Disk Definitions on Stripe Groups on Global Settings Allocate when a file is created Optional Select to send a warning when aUser attempts to access a file that is locked or When reading and storing files Disk Types Server Configuration Disk Types Disk Definitions Configured file system for I/O Select to enable the selected disk definitionWhen enabled, the defined disk is available to Click to create a new disk definition. Type a Click to delete the selected device name Stripe Groups Accesses the disk Select to enable the selected stripe groupWhen enabled, the stripe group is available to Using the Quality of Service QOS API Installing Promise RAID Controller Software Windows Boot Manager Screen Windows Boot Manager Screen StorNext 3.5 Installation Guide 109 Uninstalling StorNext Uninstalling StorNext on Unix and Linux Uninstalling Snsm Snfs Uninstalling the StorNext Client Software StorNext Remove Main Menu Uninstalling StorNext on Windows HP-UX StorNext Administration Tasks Sharing a Library Between Applications Vi mediafilelibraryname Manually Modifying Storage Manager Configuration Fssysparmoverride Configuration File StorNext 3.5 Installation Guide 117 Connecting to a StorNext Network Using Xsan Mounting Snfs on the OSx Computer StorNext 3.5 Installation Guide 119 Creating the automount.plist File Mounting Snfs on the Mac OS X Computer Plist StorNext 3.5 Installation Guide 123 Viewing a Fibre Channel Device Log Rolling Options StorNext Log Rolling AdministrationChanging Log Rolling Times Modified find command looks like this Avoiding Poor System Performance StorNext Files Example.cfg File Appendix C StorNext Files Page Page Page Page Page Cluster-Wide Central Control Cluster-Wide Control File Example Page # Snfsall Commonly Used Snfs Files Cvlog debug and runtime messages Usr/cvfs/docs Cvapi.c a sample API application Quality of Service Guide Overview Active vs. Passive Supported Platforms Unit of I/O ConfigurationNon-Realtime Operation Converting MB/sec to I/O/ sec Name Description Default Rtio Upper Bound Reserve Token Timeouts Real-time I/O SetRtio Oversubscription Handles Ungated files All internal calculations are done in terms of I/O/sec Non-Realtime I/O ConfigurationCalculating Available Configuration File Examples Host bw-type sg=yy,sg=yy Callbacks Issued and return to the previous state Above diagram, a process on client a requests some amountStripe group back to non-real-time mode Client in Step Situation arises it can be detected Stripe group is back in non-real-time mode, Client a requests some amount of Rtio as in Figure Be back in its original state StorNext 3.5 Installation Guide 157 Client C with the new token in Step , assume the stripe group is already in real-time mode as aTime I/O token in . The FSM calls back to Clients B and D Failure Semantics FSM Failures Client Failures Client Token Releases MonitoringReal-time I/O available Send out callbacks to other clients Sharing Disk Resources