Cvapi.c a sample API application | Quantum 6-00360-15 instruction

Appendix C StorNext Files

Commonly Used SNFS Files

cvlabels.example

cvpaths.example

example.cfg

fsmlist.example

fsnameservers.example

fsports.example

fsroutes.example

•/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.1.3 Installation Guide

134

Image 151

Quantum 6-00360-15 manual Cvapi.c a sample API application

Contents

StorNext Copyright Statement Contents Hardware Requirements LAN Requirements StorNext GUI Accessing the StorNext GUIOperating System Requirements Hardware Requirements 111 108109 110 Example.cfg File 125 Commonly Used Snfs Files 132 Log Rolling Options 123 Avoiding Poor System Performance 124 Figures Figures File System Startup List Tables Tables Preface Purpose Audience Document Organization Convention Example Notational Conventions Related Documents North America Online Service Support World Wide WebContacting Quantum Document No Document Title Document Description 1Installing StorNext File System and Storage Manager Operating System Requirements Storage Manager System RequirementsHardware Requirements Operating System Kernel Platform Disk Space File Systems LAN Requirements Partitioning Local Hard Disks Than 1 TB Getting Ready to InstallConfiguring Storage Devices Planning for LUNs Larger Operating Label for System LUNs 1 TB LUNs 1-2 TB LUNs 2 TB Vtoc Before You Begin Pre-Installation ScriptSupport Directory Description Pre-installation script runs figure Running snPreInstall Interpreting snPreInstall Output Type Description Launching the StorNext Installation Script StorNext Installation ScriptInstallation script runs figure Page Menu Option Description Changing Installation Configuration Options Changing Application Directory Locations Configuration Menu Changing the Default Media Type Performing an Installation Operation 2Installing StorNext File System Windows 2008 Server File System RequirementsOperating System Release or Kernel Platform Windows 2003 Server Hardware Requirements Installing StorNext File System Getting Ready to Install Operating Label for Planning for LUNs Larger than 1 TBSystem LUNs 1 TB LUNs 1-2 TB LUNs 2 TB SVTOC Installing the Linux Kernel Source CodeIBM AIX d MacOS X Panther a Apple Xsan Launching the Snfs Installation Script Installing StorNext File System on Linux or Unix Exit the Snfs installation script Change installation options for the locationApplication directories see Changing Performing an Installation Operation StorNext Installation Status Installing StorNext File System on Windows Removing a Previous Version of StorNext Running the Setup Wizard Snfs Setup Welcome Snfs Setup Customer Information Click an installation option Snfs Setup Ready to Install Click Finish to close the setup wizard Restoring a Previous Client Configuration StorNext Configuration Window Import/Export Client Configuration Window Click an option for handling current configuration settings 3Installing the StorNext Client Windows XP Client System RequirementsWindows Vista 11i Itanium 64-bit Bit PowerDistributed LAN server memory tuning guidelines Sun Solaris Generic Sparc 64-bit Opteron Intel x86 64-bit For a MDC running Snfs only On the home page, click Downloading the StorNext Client SoftwareSelect Platform window appears figure Download Client Software window appears figure Download Client Software Window Installing the StorNext Client on Linux Installing the StorNext Client on Linux or Unix 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 SGI Irix File system mount point cvfs verbose=yes 0 Installing the StorNext Client on Windows StorNext Installation Window Remove StorNext StorNext Installation Window Install StorNext Snfs Setup End User License Agreement Snfs Setup Choose Setup Type Snfs Setup Finish StorNext Installation Window Configure StorNext Click an option for handling current configuration settings Configuring StorNext StorNext GUI Accessing the StorNext StorNext Home File System and Storage Manager Configuration Wizard StorNext Configuration Wizard File System Only Add File System Enter License Add Tape Drive Add LibraryAdd Media Add Storage Policy Add Storage DisksMail Notification Configuring a Distributed LAN Client Server Distributed LAN server configuration utility appears figure Sndpscfg Configuration Utility Field / Button Description Using Distributed LAN Client and Server Commands Creating an Override ConfigurationCommand Description Windows Configuration Utilities Drive Mappings Client Configuration Associate with the selected local drive letter Select a local drive letter to associate with aFile system Type or select the name of the file system to FS Name Servers Authentication Group on the SAN Select the Windows user to map to a user ID Mount Options Syslog Level Client Configuration Mount Options Cache Parameters Client Configuration Syslog Level Distributed LAN Client Configuration Cache Parameters Servers Select to configure the StorNext client as aDistributed LAN client. The StorNext client Will connect to all available distributed LAN Disk Device Labeler Disk Device Labeler Labeler window appears Labeling Disks License Identifier Simple File System Configuration Current settings. The configuration file is Name used by clients when establishing aSwitching to the next disk in the stripe group Click to save the configuration using Configuring StorNext Windows Configuration Utilities Check Read-Only a File System File System Startup List Click to save changes to the FSM services list Click to add a file system to the FSM servicesFSM services list Configurations is highest priority and 9 is Configuring StorNext Windows Configuration Utilities Server Administration File System Properties Stripe Group Properties Quota Properties Been used Type the name of the user or group to set aQuota for Displays the percentage of the quota that has Server Configuration Quality of Service InformationClients Information Disk Definitions on Stripe Groups on Disk Types on Global Settings When reading and storing files Optional Select to send a warning when aUser attempts to access a file that is locked or Allocate when a file is created Disk Types Server Configuration Disk Types Disk Definitions Click to create a new disk definition. Type a Select to enable the selected disk definitionWhen enabled, the defined disk is available to Configured file system for I/O Stripe Groups Click to delete the selected device name Using the Quality of Service QOS API Select to enable the selected stripe groupWhen enabled, the stripe group is available to Accesses the disk To respond to a token callback To real-time applications using the QualityService QOS API Type the number of seconds to wait for clients Uninstalling StorNext on Unix and Linux Uninstalling StorNext Snfs Uninstalling Snsm HP-UX Uninstalling the StorNext Client Software Uninstalling StorNext on Windows Sharing a Library Between Applications StorNext Administration Tasks Vi mediafilelibraryname Fssysparmoverride Configuration File Manually Modifying Storage Manager Configuration StorNext 3.1.3 Installation Guide 115 Mounting Snfs on the OSx Computer Connecting to a StorNext Network Using Xsan StorNext 3.1.3 Installation Guide 117 Creating the automount.plist File Mounting Snfs on the Mac OS X Computer Plist StorNext 3.1.3 Installation Guide 121 Viewing a Fibre Channel Device Changing Log Rolling Times StorNext Log Rolling AdministrationLog Rolling Options Avoiding Poor System Performance Modified find command looks like this Example.cfg File StorNext Files Appendix C StorNext Files Page Page Page Page Page Commonly Used Snfs Files Fsmlist a list of Snfs file systems that have been serviced Cvlog debug and runtime messages Cvapi.c a sample API application Quality of Service Guide Active vs. Passive Supported Platforms Overview Unit of I/O ConfigurationConverting MB/sec to I/O/ sec Name Description Default Rtio Upper Bound Reserve Token Timeouts Real-time I/O SetRtio Oversubscription Handles Non-gated files Ungated files Calculating Available CallbacksAll internal calculations are done in terms of I/O/sec Callback Flow for Initial Rtio Request Callback Failures Tokens Failure Semantics , assume the stripe group is already in real-time mode as aNew token amount in Steps 2-3. The clients respond in Steps With the new token in Step FSM Failures Client Failures Send out callbacks to other clients MonitoringReal-time I/O available Client Token Releases Sharing Disk Resources