HP X9320 Guida Utente

HP StorageWorksX9000 File Serving Software CLI ReferenceGuideThis document describes commands provided with X9000 File Serving Software. It is intende

1 General CLI informationExecuting X9000 Software commandsThe commands in “X9000 File Serving Software commands” (page 11) must be executed on themana

Set up network interface monitoring:ibrix_nic -m -h MONHOST -A DESTHOST/IFNAMEThe command assigns server MONHOST to monitor server DESTHOST over netwo

DescriptionOptionForces NIC migration.–FIdentifies pairs of file serving nodes and interfaces in standby or monitoringrelationships.-H HOSTNAME/IFNAME

ibrix_online_quotacheckChecks and repairs quota files.DescriptionYou will need to use the ibrix_online_quotacheck command in the following cases:• You

DescriptionOptionForces a quotacheck ID override.—fChecks for the group quota type.—gScans the device, but does not write the limits to the file syste

ibrix_powersrcAdds or deletes power sources and modifies power source attributes in the configuration database.DescriptionProgrammable power sources a

Modify the IP address for IPMI or iLO power sources:ibrix_powersrc -m [-I IPADDR] [-u USERNAME] [-p PASSWORD] [-s] -hPOWERSRCLISTTo modify the securit

ibrix_profileManages kernel profiles.DescriptionThe ibrix_profile command is used to start, disable, or reset kernel profiles, or to displaykernel pro

ibrix_pvDiscovers, lists, and deletes physical volumes.DescriptionThis command discovers physical volumes that have been added to file serving nodes s

DescriptionOptionPhysical volumes. Enter either a comma-delimited list of physical volumes (forexample, d1,d2,d3) or a range list (for example, d[1-3]

ibrix_rebalanceRedistributes files among segments to balance segment utilization and server workload, or evacuatesall files from specific segments.Des

2 X9000 File Serving Software commandsThis chapter lists commands used to configure and manage X9000 File Serving Software. Thecommands must be run on

lists, all segments are rebalanced. If you enter source and destination segments, specified by eithersegment name or logical volume name, rebalancing

DescriptionOptionVerbose kernel logging.-vShows the usage for this command.-?ibrix_rebalance 111

ibrix_serverPerforms management and control procedures for file serving nodes.DescriptionUse ibrix_server to:• Identify or delete a standby for a file

The command assigns network interface IFNAME for traffic from source server SRCSERVER todestination host DESTHOST.The network interface preference is

DescriptionOptionFails over to or fails back from a file serving node.-fOne or more file serving nodes.-h SERVERNAME orSERVERLISTProvides detailed inf

ibrix_shManages shell tasks.DescriptionThe ibrix_sh command can be used to run the Linux shell commands cp and find on file servingnodes and save the

ibrix_snapCreates or deletes file-system snapshots and cleans up after an unsuccessful snapshot session.Descriptionibrix_snap creates a file-system sn

OptionsDescriptionOptionRuns the automated snapshot procedure.-AAutomatically mounts a snapshot.-MCreates a file-system snapshot.-cDeletes a file-syst

ibrix_snap_strategyCreates an automated snapshot strategy.DescriptionIf you will be taking a snapshot of a file system on a regular basis, you can cre

When a snapshot is created with one of these templates, the variables will be replaced with thevalues shown above.{fsname}_snap_{fulldate}snap_{shortd

DescriptionOptionConfigures static user mapping.-SSets the “Unknown” Windows user, who takes ownership of files when a mappingcannot be resolved.-W WI

ibrix_snmpagentUpdates the configuration properties for the SNMP agent.DescriptionThe SNMP agent is created automatically. It is configured initially

OptionsDescriptionOptionIndicates whether community names or passwords are encrypted in the configuration file.Default: no encryption. When this optio

ibrix_snmpgroupManages SNMP groups.DescriptionA group defines the access control policy on managed objects for one or more users. All usersmust belong

DescriptionOptionIdentifies the v3 context name, defining the objects this group can access. Default: noname in use.-x CONTEXT_NAMEShows the usage for

ibrix_snmptrapCreates, updates, or deletes trapsinks for any SNMP version.DescriptionA trapsink is the host destination where agents send traps, which

Display information about trapsinks:ibrix_snmptrap -l [-h HOSTLIST]For all v1 or v2 trapsinks, or for all hosts in HOSTLIST, the command displays the

ibrix_snmpuserCreates, updates, or deletes SNMPv3 users.DescriptionNames the user whose keys were used to authenticate and encrypt packets.SynopsisCre

See alsoibrix_snmpgroup, ibrix_snmpviewibrix_snmpuser 127

ibrix_snmpviewAdds entries to or deletes entries from the SNMP MIB view.DescriptionA MIB view consists of a collection of view subtrees that can be in

ibrix_statsLists statistics for file serving nodes.DescriptionApproximately every 20 seconds, the file serving nodes report a range of operational sta

ibrix_atSchedules X9000 Software commands.DescriptionThe ibrix_at command is used to create a schedule that is applied to another X9000 Softwarecomman

ibrix_supportticketManages support tickets, which include system and X9000 software information useful for analyzingperformance issues and node termin

ibrix_tapeLists or rescans tape devicesDescriptionThe ibrix_tape command can be used to list tape and media changer devices available forNDMP backups.

ibrix_taskManages tasks running in the cluster.DescriptionThe ibrix_task command can be used to view information about the tasks running in the cluste

ibrix_tierManages data tiers.DescriptionA tier is a group of one or more segments. Tiering enables automatic migration of files from onetier to anothe

ibrix_umountUnmounts a file system.Descriptionibrix_umount unmounts a file system from file serving nodes, X9000 clients, and hostgroups.You can also

ibrix_versionReports software version numbers for file serving nodes and X9000 clients.DescriptionThis command reports the following information for e

ibrix_vgCreates, extends, reduces, or deletes volume groups.DescriptionUse ibrix_vg to perform these tasks:• Create volume groups from discovered phys

OptionsDescriptionOptionBacks up the vgconfig maps on the management console.-bCreates a volume group.-cDeletes a volume group.-dExtends a volume grou

ibrix_vsIdentifies storage resources, discovers them, and maps them to physical volumes.Descriptionibrix_vs identifies vendor storage resources, disco

3 Commands for Linux X9000 clients and file serving nodesThe commands in this chapter are run directly on Linux X9000 clients and/or file serving node

ibrix_authConfigures authentication for CIFS, FTP, and HTTPDescriptionFile serving nodes that will be hosting CIFS, FTP, or HTTP shares must be config

ibrix_lwhostTunes Linux X9000 clients. This command can be run on X9000 clients only.DescriptionUse ibrix_lwhost to set Linux X9000 client parameters:

DescriptionOptionSpecifies a tuning parameter value or, in the case of threads, the number of server threadsto set.-v valueLists parameter settings th

ibrix_lwmountMounts a file system on a Linux X9000 client. This command can be run on X9000 clients only.DescriptionA file system must be mounted on t

ibrix_lwumountDetaches a file system from a Linux X9000 client. This command can be run on X9000 clientsonly.SynopsisDetach a file system from a clien

ibrix_topCollects and presents live views of file system, host, and segment activity. The command can berun on either file serving nodes or X9000 clie

OptionsDescriptionOptionSpecifies the directory where data captures are written. HP recommends that you namethis directory with an absolute path.-d DI

4 Support and other resourcesContacting HPFor worldwide technical support information, see the HP support website:http://www.hp.com/supportBefore cont

GlossaryACE access control entry.ACL access control list.ADS Active Directory Service.ALB Advanced load balancing.BMC Baseboard Management Configurati

SELinux Security-Enhanced Linux.SFU Microsoft Services for UNIX.SID Secondary controller identifier number.SNMP Simple Network Management Protocol.TCP

IndexAActive Directory authentication, 14Active Directory, configure on Windows X9000 clients,11agile management console, 43Autoconnect table, NFS cli

DescriptionOptionSpecifies configuration parameters for Active Directory.-S SETTINGLISTA list of file serving nodes.-h HOSTLISTSpecifies the domain na

Llicense file, display, 83Linux X9000 client, register, 26Local User authenticationconfigure, 14local groups, 84local users, 85logical volumes, manage

ibrix_autoconnectManages entries in the Autoconnect table.DescriptionAn X9000 Software autoconnection enables NFS clients to mount file systems automa

ibrix_certificateManages SSL certificates.DescriptionServers accepting FTPS and HTTPS connections typically provide an SSL certificate that verifies t

DescriptionOptionShows information about a certificate.-iSpecifies the location of the certificate file.-p CERTPATHNOTE: The -m and -S SETTINGLIST opt

ibrix_cfrjobStarts and stops the replication process and monitors the state of remote replication activity.DescriptionNOTE: Remote replication must be

© Copyright 2009, 2011 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or

The -S option specifies the directory under the source file system to synchronize with the targetdirectory. The -P option specifies the target directo

DescriptionOptionIdentifies this job as a run-once action that synchronizes a particular directory.-oPauses the specified remote replication task.-pRe

ibrix_cifsManages CIFS shares.NOTE: Be sure to use the ibrix_cifs command located in <installdirectory>/bin.The ibrix_cifs command located in /u

DescriptionOptionDeletes a CIFS share.-dA file system.–f FSNAMEOne or more file serving nodes.-h HOSTLISTDisplays information about CIFS shares.-iModi

ibrix_cifsconfigConfigures global settings for CIFS.DescriptionThe ibrix_cifsconfig command configures global settings for CIFS operations. The settin

See alsoibrix_cifsibrix_cifsconfig 25

ibrix_clientPerforms management and control procedures for X9000 clients.Descriptionibrix_client enables the following X9000 client procedures:• Regis

When the command has completed, the default cluster interface will be used to communicate fromthe client to the DESTSERVER.OptionsDescriptionOptionAss

ibrix_clusterRegisters source and target clusters for remote replication.DescriptionA cluster must be registered before other remote replication comma

ibrix_clusterconfigSets or displays cluster configuration parameters.DescriptionConfigures cluster configuration settings such as the default gateway

Contents1 General CLI information...10Executing X9000 Software commands...

ibrix_clusterconfig -d -L DEV -I ADDRESSShow OS parameters and tunings:ibrix_clusterconfig -i -OCreate or update an OS parameter:ibrix_clusterconfig -

ibrix_dbckEnsures that information maps on hosts are consistent with the configuration database.NOTE: ibrix_dbck should be used only under the directi

ibrix_edquotaSets and manages file system quotas for users, groups, and directory trees.DescriptionThe ibrix_edquota command sets, lists, and deletes

Export the existing quotas information to a file:ibrix_edquota -e -p PATH [-f FSNAME]Delete a user quota:ibrix_edquota -D -u UID [-f FSNAME]To delete

DescriptionOptionLists quota limits.-lSets the hard limit for megabyte allocation. The default value is 0.-m HARD_MEGABYTESSets quota limits.-sImports

ibrix_eventSets up email and SNMP notifications of cluster events, displays event messages, and removesevent messages from the events table.Descriptio

Before sending a test message to the email address, notifications must be turned on. If the addressis valid, the command signals success and sends an

DescriptionOptionSpecifies an email subject string that is prefixed to the automatically generatedemail Subject line.-t SUBJECTSends a test email.-uAn

ibrix_exportcfrConfigures a target (a file system or directory) for remote replication.DescriptionThis command exports the target file system. Before

ibrix_exportcfrpreferenceIdentifies the preferred hosts for replication storage and a preferred NIC for replication traffic.DescriptionIf you are repl

ibrix_clusterconfig...29Description...

DescriptionOptionIdentifies a preference.-aThe exported file system.—f FSNAMEHost preferences (list of hosts used by the file system).-h HOSTLISTLists

ibrix_exportfsMaintains the list of NFS-exported file systems and specifies file-system access for X9000 clients.Descriptionibrix_exportfs makes local

OptionsDescriptionOptionUnexports the named file system.-UExcludes the file serving node standby from the export.-bSpecifies file-system access for an

ibrix_fmControls an agile management console configuration.DescriptionTypically, one active management console and one or more passive management cons

OptionsDescriptionOptionBacks up the management console configuration.-BSpecifies an IP address.-I <IP address>Registers a management console.-R

ibrix_fm_tuneSets or resets configuration tuning parameters on the management console.DescriptionCAUTION: This command sets or resets the configuratio

Table 1 ibrix_fm_tune configuration options (continued)DescriptionOption nameSets whether the management console will implement a policy otherthan the

DescriptionOptionResets configuration tuning options.-USelects the logging component.-cLists configuration tuning options.-lSpecifies a list of comma-

ibrix_fsCreates, extends, and manages file systems.Descriptionibrix_fs is used to:• Create a file system from physical or logical volumes.• List infor

Create a file system from the specified physical volumes in one step:ibrix_fs -c -f FSNAME -p PVLIST [-a] [-q] [-oOPTION1=VALUE1,OPTION2=VALUE2,...] [

Options...51See also...

For example, to add logical volume ilv1 (owned by s1.mycompany.com) to file system ifs1:ibrix_fs -e -f ifs1 -S ilv1:s1.mycompany.comTo extend the file

Enabling Export Control does not affect file-system access by file serving nodes or any NFS/CIFSclients attached to the nodes. File serving nodes alwa

DescriptionOptionCreates a new file system.-cDeletes the named file system or systems.-dExtends the named file system.-eA file system or a list of fil

ibrix_fs_opsManages directory tree quota entries.DescriptionDirectory tree quotas apply to a file system located at a specific directory tree. Use the

ibrix_fs_tuneOverrides the default file allocation behavior on file serving nodes and clients.DescriptionX9000 Software allocates new files and direct

ibrix_client on the X9000 clients, reboot the X9000 clients, or execute ibrix_lwhost--a on the X9000 clients.Table 2 File allocation policiesThe X9000

To prefer a pool of segments for NFS/CIFS clients, specify only NFS/CIFS servers in the HOSTLIST.To prefer a pool of segments for X9000 clients, lists

DescriptionOptionSpecifies the number of KB that X9000 Software will pre-fetch. The default value is128 KB.-r readaheadA list of one or more logical v

ibrix_fsckAnalyzes inconsistencies in a file system.DescriptionIf a file system shows evidence of inconsistencies, contact HP technical support. You m

Run phase 2:ibrix_fsck -p 2 -f FSNAME [-s LVNAME] [-c] [-o "options"]The command can be run on the specified file system or optionally only

Synopsis...76Options...

ibrix_ftpconfigManages configuration profiles for the FTP service.DescriptionA configuration profile specifies a set of global FTP parameters that are

DescriptionOptionDisplays current information for the specified configuration profile, or displays current profileinformation for specified file servi

ibrix_ftpshareManages FTP shares.DescriptionAn FTP share provides access to data on X9000 Software file systems. FTP clients access the sharesusing st

OptionsDescriptionOptionSpecifies the IP addresses/ports assigned to this share.-I IPaddrs:PortLists valid FTP share settings.-LSpecifies the settings

ibrix_haconfigReports whether X9000 Software high availability features are configured for file serving nodes.Descriptionibrix_haconfig tests whether

OptionsDescriptionOptionIncludes standby servers in the configuration check.-bReports only on failed file serving nodes.-fA list of file serving nodes

ibrix_hbaDiscovers HBAs, identifies standby pairings of HBA ports, monitors HBA ports for failure, deletesHBAs from the configuration database, and li

DescriptionOptionAdds an HBA port definition.-aIdentifies two ports as a standby pair.-bDeletes an HBA port definition.-dOne or more file serving node

ibrix_healthChecks the functional health of file serving nodes and X9000 clients.Descriptionibrix_health runs a set of health checks on all hosts or t

-f: Reports only hosts that failed a test.-b: Includes standbys for file serving nodes.-s: Includes details about the file system and segments.-v: Inc

Synopsis...97Options...

ibrix_healthconfigManages health check sets.DescriptionUse this command to create or update sets of health checks. You can also delete health check se

ibrix_host_tuneSets and lists tuning parameters for file serving nodes and X9000 clients.DescriptionCAUTION: The default values for the host tuning pa

List default values and the range of values for host-tuning parameters:ibrix_host_tune -LSet host configuration options for the specified hosts:ibrix_

DescriptionOptionSets a communications protocol (UDP or TCP).-p tcp|udpQueries configuration tuning parameter values.-qSets the number of server threa

ibrix_hostgroupCreates and manages hostgroups.DescriptionA hostgroup is a named set of X9000 clients. Hostgroups provide a convenient way to centrally

Add a domain rule to a hostgroup:ibrix_hostgroup -a -g GROUPNAME -D DOMAINDelete one or more hostgroups from a hostgroup tree:ibrix_hostgroup -d -g GR

ibrix_hostpowerSets up a file serving node power source for failover and lists information about the power sources.DescriptionUse ibrix_hostpower to:•

ibrix_httpconfigManages configuration profiles for the HTTP service.DescriptionA configuration profile specifies a set of global HTTP parameters in ef

DescriptionOptionDeletes a configuration profile.-dSpecifies one or more file serving nodes.-h HOSTLISTDisplays current information for the specified

ibrix_httpshareManages HTTP shares.DescriptionAn HTTP share provides access to data on X9000 Software file systems. HTTP clients access theshares usin

ibrix_snmpgroup...122Description...

OptionsDescriptionOptionLists valid HTTP share settings.-LSpecifies the URL that clients will use to access the share.-P urlpathSpecifies the settings

ibrix_httpvhostManages HTTP virtual hosts.DescriptionAn HTTP virtual host is associated with an HTTP configuration profile. The virtual host specifies

DescriptionOptionLists HTTP virtual hosts.-lModifies the specified HTTP virtual host.-m VHOSTNAMEDisplays detailed information. Enter 1 as the level.-

ibrix_licenseDisplays the contents of the X9000 File Serving Software license.Descriptionibrix_license lists the contents of the license file, which c

ibrix_localgroupsManages local group accounts for CIFS or HTTP access.DescriptionIf Local User authentication is configured for CIFS or HTTP shares, u

ibrix_localusersManages local user accounts for CIFS or HTTP access.DescriptionIf Local User authentication is configured for CIFS or HTTP shares, use

DescriptionOptionSpecifies that the password is in NT hashed format.-nSpecifies the local user's password.-p PASSWORDSpecifies the local user&apo

ibrix_lvManages logical volumes.Descriptionibrix_lv creates logical volumes (file-system segments) from a volume group. You can specifylogical volume

DescriptionObjectSpecifies the number of logical volumes to create. The value is an integer that specifies boththe number of logical volumes to create

ibrix_migratorDefines migration rules and controls migrator operations.DescriptionTiering enables automatic migration of files from one tier to anothe

Description...138Synopsis...

OptionsDescriptionOptionAdds a data migration rule to a file system.-ASpecifies the destination tier in a migration rule.-D DESTINATION_TIERForces mig

The following example uses a relative date:ibrix_migrator -A -f ifs2 -r "atime older than 2 days " -S TIER1 -DTIER2Rule keywordsRules consis

# ibrix_migrator -A -f ifs2 -r 'mtime older than 1 month and ( name = "*.jpg" or name = "*.gif" )' -S T1 -D T2Example 3:

ibrix_mountMounts a file system on file serving nodes and X9000 clients.DescriptionWhen mounting a file system on specific file serving nodes, the fir

Export Control ExamplesThe following command mounts file system ifs1 on all file serving nodes and X9000 clients atmountpoint /ifs1 and gives the clie

ibrix_mountpointCreates and deletes mountpoints.DescriptionMountpoints are immediately created or deleted on file serving nodes. For X9000 clients the

OptionsDescriptionOptionCreates a mountpoint.-cDeletes a mountpoint.-dSpecifies a list of hostgroups.-g GROUPLISTSpecifies a list of file serving node

ibrix_ndmpconfigConfigures NDMP parameters on the cluster.DescriptionThe ibrix_ndmpconfig command sets NDMP parameters on the cluster. These parameter

ibrix_ndmpsessionManages NDMP sessions and reports session history.DescriptionThe ibrix_ndmpsession command lists the currently running NDMP sessions

ibrix_nicConfigures network interfaces.Descriptionibrix_nic is used to:• Set up automated failover for a user interface.• Identify or delete network i