HP IBRIX X9000 Network Storage System CLI Reference Guide This document describes commands provided with X9000 File Serving Software. It is intended for system administrators managing X9300 Network Storage Gateway systems, X9320 Network Storage Systems, X9720 Network Storage Systems, and X9730 Network Storage Systems. For the latest X9000 guides, browse to http://www.hp.com/support/manuals.
© Copyright 2009, 2012 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 General CLI information..............................................................................5 Executing X9000 Software commands........................................................................................5 Command syntax......................................................................................................................5 Command messages.................................................................................................................
ibrix_localusers......................................................................................................................96 ibrix_lv..................................................................................................................................98 ibrix_migrator......................................................................................................................100 ibrix_mount ......................................................................................
1 General CLI information Executing X9000 Software commands The commands in “X9000 File Serving Software commands” (page 6) must be executed on the Fusion Manager host. Root privileges are required to run these commands. The commands in “Commands for Linux X9000 clients and file serving nodes” (page 156) can be executed on file serving nodes and/or Linux X9000 clients. Any user can run these commands. All commands are run from the working directory /usr/local/ibrix/bin. Command syntax Names.
2 X9000 File Serving Software commands This chapter lists commands used to configure and manage X9000 File Serving Software. The commands must be run on the Fusion Manager host. ibrix_activedirectory Configures and lists Active Directory settings. Description Active Directory settings must be configured on the Fusion Manager to allow Windows X9000 clients to query the Active Directory server when reading or writing on a file serving node.
Option Description -S Configures static user mapping. -W WIN_USER_NAME Sets the “Unknown” Windows user, who takes ownership of files when a mapping cannot be resolved. -d DOMAIN_NAME Identifies a fully qualified Active Directory domain name. -i DOMAIN_CONTROLLER_IP The domain controller IP address. -l Displays Active Directory settings on this Fusion Manager. -p PROXY_PASSWORD Sets the Active Directory proxy password.
ibrix_auth Configures Active Directory or Local Users and Groups authentication for CIFS, FTP, and HTTP shares. Description The ibrix_auth command configures Active Directory or Local Users and Groups as the authentication method for users accessing CIFS, FTP, or HTTP shares.
Option Description -h HOSTLIST A list of file serving nodes. -n DOMAIN_NAME Specifies the domain name for Active Directory authentication. -i Displays current information about authentication. -t Modifies the authentication settings. -? Shows the usage for this command.
ibrix_av Manages miscellaneous Antivirus operations. Description The ibrix_av command is used to start a cluster-wide update of Antivirus definitions and to display or delete Antivirus statistics. You can schedule periodic updates of the virus definitions. The cluster connects with external virus scan engines, which have the current definitions, and the definitions are updated on the cluster nodes as needed.
ibrix_avconfig Configures Antivirus operations on an X9000 cluster. Description The ibrix_avconfig command can be used to enable or disable Antivirus operations on file systems, to add the virus scan engines running the Antivirus software, to configure exclusions on directories, and to configure other policies. To configure the Antivirus feature on a cluster, complete these steps: 1. Add the external virus scan engines to be used for virus scanning. These systems run the Antivirus software.
The -G option specifies the policy that determines which file operations trigger AV scans. There are three policies: • O — Scan on open. • C — Scan on close. • B — Scan on open and close. The -k option specifies the file sharing protocol affected by the scan policy. Currently, only the CIFS protocol is supported. Add exclusions on the specified directory: ibrix_avconfig -a -E -f FSNAME -P DIR_PATH {-N | [-x FILE_EXTENSION] [-s FILE_SIZE]} Exclusions specify files to be skipped during Antivirus scans.
Option Description -g Updates the Antivirus unavailable policy. -k PROTOCOL Specifies a file sharing protocol for scan policies. -l Lists the Antivirus configuration. -p PORTNUMBER Specifies the port number of an external scan engine. -r Removes an existing item from the Antivirus configuration. -s FILE_SIZE Specifies the file size limit (in MB) for exclusions. -u Updates an item in the Antivirus configuration.
ibrix_caseinsensitive Manages case insensitivity on a file system or directory. Description By default, X9000 file systems and directories follow POSIX semantics and file names are case-sensitive for Linux/NFS users. (File names are always case-insensitive for Windows clients.) If you prefer to use Windows semantics for Linux/NFS users, you can make a file system or subdirectory case-insensitive. Doing this prevents a Linux/NFS user from creating two files that differ only in case (such as foo and FOO).
ibrix_certificate Manages SSL certificates. Description Servers accepting FTPS and HTTPS connections typically provide an SSL certificate that verifies the identity and owner of the web site being accessed. You can add your existing certificates to the cluster, enabling file serving nodes to present the appropriate certificate to FTPS and HTTPS clients. X9000 Software supports PEM certificates. When you add an SSL certificate file to the cluster, the file must contain both the certificate contents (the .
Option Description -e Exports a certificate. -i Shows information about a certificate. -m Modifies a certificate. -p CERTPATH Specifies the location of the certificate file. -? Shows the usage for this command. NOTE: The -m and -S SETTINGLIST options shown in the command usage message are not currently supported.
ibrix_chassis Display information about the chassis in an X9720/X9730 system, or unregister a chassis. Description The chassis in an X9720/X9730 system is registered automatically for hardware monitoring. The ibrix_chassis command displays information about registered chassis or about servers registered in a chassis. You can also use the command to unregister a chassis.
ibrix_cifs Manages CIFS shares. NOTE: Be sure to use the ibrix_cifs command located in /bin. The ibrix_cifs command located in /usr/local/bin/init is used internally by X9000 Software and should not be run directly. Description CIFS is the file-sharing protocol used in Windows-based networks. Use the ibrix_cifs command to configure CIFS shares. You can configure the following options when creating a share: • Default modes for creating files and directories in the share.
Options Option Description -A ALLOWCLIENTIPSLIST Lists client IP addresses that are allowed access to the share. Use commas to separate the IP addresses, and enclose the list in quotes (for example, ibrix_cifs -A “192.186.0.1,102.186.0.2/16”). The default is "", which allows all IP addresses. -D SHAREDESCRIPTION Describes the share. -E DENYCLIENTIPSLIST Lists client IP addresses that are denied access to the share.
ibrix_cifsconfig Configures global settings for CIFS. Description The ibrix_cifsconfig command configures global settings for CIFS operations. The settings apply to all CIFS shares configured in the cluster. Synopsis Configure CIFS settings: ibrix_cifsconfig -t [-S SETTINGLIST] [-h HOSTLIST] For the -S SETTINGLIST option, enclose the list of settings in quotation marks, and use commas to separate the settings.
See also ibrix_cifs ibrix_cifsconfig 21
ibrix_cifsmonitor Monitors CIFS services on file serving nodes. Description The ibrix_cifsmonitor command configures monitoring for the following CIFS services: • lwreg • dcerpc • eventlog • lsass • lwio • netlogin • srvsvc If the monitor finds that a service is not running, it attempts to restart the service. If the service cannot be restarted, that particular service is not monitored.
ibrix_cifsperms Manages user and group permissions for CIFS shares. Description The ibrix_cifsperms command adds a user or group to a CIFS share and assigns share-level permissions. You can also use the command to modify or delete existing share-level permissions, or to display the current share-level permissions. The share level permissions are fullcontrol, read, or change. NOTE: Permissions on a CIFS share managed by the MMC cannot be modified by the X9000 management console GUI or CLI.
ibrix_client Performs management and control procedures for X9000 clients. Description ibrix_client enables the following X9000 client procedures: • Registers a Linux X9000 client with a Fusion Manager. Clients that are to communicate with multiple management consoles must be registered on each console. (To register a Windows X9000 client, use the Windows X9000 client GUI.) • Sets a preferred user interface for an X9000 client. (To prefer a user interface for a hostgroup, use ibrix_hostgroup.
Options Option Description -A Assigns a preferred NIC. -D DESTSERVER Deletes the network interface preference established between the source client and the destination server. -a Adds an X9000 client. -d Deletes a client from the configuration database. -e IPADDRESS Specifies the IP address for a client. -h CLIENTLIST One or more clients (specify as CLIENT1,CLIENT2,CLIENT3,...). -i Provides detailed information for one or more clients. -l Lists clients.
ibrix_cluster Registers a remote cluster for remote replication. Description The source and target clusters of a remote replication configuration must be registered with each other before remote replication tasks can be created. Use ibrix_cluster -r on the target cluster to register the source cluster before creating a remote replication export with ibrix_crr_export. Use ibrix_cluster -r on the source cluster to register the target cluster before starting a remote replication task with ibrix_crr.
ibrix_clusterconfig Sets or displays cluster configuration parameters. Description Configures cluster configuration settings such as the default gateway and time zone. The settings are used during cluster setup and can also be used to update the configuration of existing systems. Synopsis Show cluster-wide configuration parameters: ibrix_clusterconfig -i -P Set cluster configuration parameters: ibrix_clusterconfig -c -P PARAM1=VALUE1[,...
ibrix_clusterconfig -d -L DEV -I ADDRESS Show OS parameters and tunings: ibrix_clusterconfig -i -O Create or update an OS parameter: ibrix_clusterconfig -c -O KEY=VALUE,[...KEY=VALUE] Delete/reset an OS parameter: ibrix_clusterconfig -d -O KEY List OS parameters and defaults: ibrix_clusterconfig -Q Synchronize parameters on file serving nodes: ibrix_clusterconfig -s [-P] [-O] [-o keyword] [-h HOSTLIST] Use -P to synchronize cluster parameters such as DNS and NTP. Use -O to synchronize OS tunings.
ibrix_collect Collects information from X9000 cluster nodes for diagnosis by HP Support. Description This command collects relevant information from X9000 systems for diagnosis. You can invoke the collection manually using ibrix_collect or the GUI, or it can be invoked automatically by a system crash. When you invoke the collection manually, you can specify a name for the collection. A collected data set includes logs and output from specific operating system and X9000 commands.
Delete all data collection sets: ibrix_collect -F Show details for the specified data collection: ibrix_collect -v -n NAME The details include the description, state, initiator, and time of invocation. List the details of all data collections: ibrix_collect -l For each collection, the output reports the collection name, description, state, time of invocation, and initiator. List the ibrix_collect configuration: ibrix_collect -i Options 30 Option Description -C options Configures ibrix_collect.
ibrix_crr Starts and stops the replication process and monitors the state of replication activity. Description The Continuous Remote Replication service (CRR) provides a transparent method to replicate changes in a source file system on one cluster to a target file system on either the same cluster or a second cluster. The remote replication service has two modes: continuous and run-once. For detailed information about these modes, see the HP IBRIX X9000 Network Storage System File System User Guide.
Omit the -o option to start a continuous replication task. A continuous replication task does an initial full synchronization and then continues to replicate any new changes made on the source. Continuous replication tasks continue to run until manually stopped by the user. Start an intra-cluster remote replication task: ibrix_crr -s -f SRC_FSNAME [-o [-S SRCDIR]] -F TGT_FSNAME [-P TGTDIR] The command starts a continuous or run-once intra-cluster replication task for file system SRC_FSNAME.
Use -h to limit the output to the specified host. When the command is run from a target, the -C option identifies the source cluster and is required. It is optional when the command is run from the source cluster. Options Option Description -C TGT_CLUSTERNAME The remote cluster name. -C SRC_CLUSTERNAME The source cluster name. When a command is run from the target cluster, this argument is required. –F TGT_FSNAME The target file system. -K Forcefully stop a replication task.
ibrix_crr_export Configures a target export for continuous remote replication (CRR). Description This command exports a target file system and directory for remote replication. Before remote replication can take place, you must create a mapping between the source cluster and the target file system that receives the replicated data. This mapping ensures that only the specified source cluster can write to the target export (exported file system and directory).
ibrix_crr_nic Identifies server assignments for the servers and corresponding NICs that handle replication requests. Description If you are replicating a file system to a remote cluster, you can use ibrix_crr_nic on the target cluster to select or modify the servers that handle replication requests and the corresponding NICs that carry replication traffic in the cluster. The default server assignments are: • Use all servers that have the file system mounted. • Use the cluster NIC on each host.
Options Option Description -D Restores the default server assignments (automatically use all servers and the cluster network interface on each server). -P ASSIGNMENT_ID1 [,...,ASSIGNMENT_IDn] Server assignment ID. -a Creates a server assignment. A previous server assignment for the same export must not exist, or must be removed before a new server assignment is created. —f FSNAME An exported file system. -h HOSTLIST The servers to use for remote replication.
ibrix_datavalidation Performs a data validation scan of a file system or subdirectory configured for data retention Description To ensure that WORM and retained files remain unchanged, it is important to run a data validation scan periodically.
ibrix_dbck Ensures that information maps on hosts are consistent with the configuration database. NOTE: ibrix_dbck should be used only under the direction of HP Support. Description Hosts (file serving nodes and X9000 clients) maintain information about a file system based on information that they obtain from the configuration database. If a host’s information about a file system becomes outdated, the host cannot access the file system or communicate with other hosts about the file system.
ibrix_edquota Sets and manages file system quotas for users, groups, and directory trees. Description The ibrix_edquota command sets, lists, and deletes storage quotas for users or groups on a specific file system. It also sets directory tree quotas, which limit the amount of storage and the number of files that can be created on a file system located at a specific directory tree. By default, quotas are not set. The recommended order for handling quotas is as follows: 1.
If you are creating multiple directory tree quotas, you can import the quotas from a file. The system then uses batch processing to create the quotas. If you add the quotas individually, you will need to wait for ibrix_onlinequotacheck to finish after entering each ibrix_edquota command.
Options Option Description -C Sets the grace period for a file system. The default is seven days. -D Deletes user, group, or directory tree limits. -G Specifies all groups with quota settings. -I SOFT_FILES Sets the soft limit on the number of files. -K INODES_GRACE_TIME Specifies the number of Hours/Days/Weeks/Months to set as the grace period for the inode limit (for example, 10H/1D/2W/2M). -M SOFT_MEGABYTES Sets the soft limit on the megabyte allocation. –T All directory trees.
ibrix_evacuate Evacuates all files from the specified segments to other segments in the same file system. Description Before retiring storage, move, or evacuate, all files from the segments on that storage to other segments in the same file system. If segments with adequate space are not available, use ibrix_fs to extend the file system. The evacuation operation is transparent to users or applications accessing the file system.
ibrix_event Sets up email and SNMP notifications of cluster events, displays event messages, and removes event messages from the events table. Description Use ibrix_event to set up two types of event notifications: • Email notification, which sends to one or more addresses an email containing the event, the originating server, the severity level, a timestamp, an autogenerated number, and the Fusion Manager name. • SNMP notification, which sends an SNMP trap to one or more trapsinks.
Before sending a test message to the email address, notifications must be turned on. If the address is valid, the command signals success and sends an email containing the settings to the recipient. If the address is not valid, the command returns an address failed exception. Remove events from the events table: ibrix_event -p [-o DAYS_COUNT] Events are removed starting with the oldest events. The default is to remove the oldest seven days of messages.
TIMESTAMP : Feb 14 15:08:14 LEVEL : ALERT TEXT : category:CHASSIS, name: x9730_ch1, overallStatus:DEGRADED, component:OAmodule, uuid:09USE038187WOAModule2, status:MISSING, Message: The Onboard Administrator module is missing or has failed., Diagnostic message: Reseat the Onboard Administrator module. If reseating the module does not resolve the issue, replace the Onboard Administrator module., eventId:000D0004, location:OAmodule in chassis S/N:USE123456W, level:ALERT FILESYSTEM : HOST : ix24–03.ad.hp.
See also ibrix_snmptrap “Setting up email notification of cluster events” and “Setting up SNMP notifications” in the administrator guide for your system.
ibrix_exportfs Maintains the list of NFS-exported file systems and specifies file-system access for X9000 clients. Description ibrix_exportfs makes local directories available for NFS clients to mount. The Fusion Manager manages the table of exported file systems and distributes the information to local /etc/exports files. All entries are automatically re-exported to NFS clients and, optionally, to the file serving node standbys. A file system must be mounted before it can be exported.
ibrix_exportfs -U -f FSNAME -p CLIENT1:PATHNAME1,CLIENT2:PATHNAME2,.. Options Option Description -U Unexports the named file system. -b Excludes the file serving node standby from the export. -c Specifies file-system access for an X9000 client. -f FSNAME A file system. -h HOSTNAME or HOSTLIST A file serving node or a list of file serving nodes exporting a file system. -l Lists all NFS export entries, or lists entries on a named host. -o “OPTIONS ” Linux exportfs options.
ibrix_fm Controls an agile Fusion Manager configuration. Description Typically, the Fusion Manager is installed on all file serving nodes when the cluster is installed. The Fusion Manager is active on one node and passive on the other nodes. This is called an agile Fusion Manager configuration. An agile Fusion Manager can be in one of the following modes: • active. In this mode, the Fusion Manager controls console operations.
ibrix_fm -l Options Option Description -A With the exception of the local node running the active Fusion Manager, moves all instances of the Fusion Manager to the specified mode. -B Backs up the Fusion Manager configuration. -I Specifies an IP address. -R Registers a Fusion Manager. -a Specifies the IP address of the cluster virtual interface. -c Adds information about a virtual interface to the Fusion Manager configuration.
ibrix_fm_tune Sets or resets configuration tuning parameters on the Fusion Manager. Description CAUTION: Manager. This command sets or resets the configuration tuning parameters on the Fusion The default values for the Fusion Manager tuning parameters are suitable for most cluster environments. Changing parameter values can alter file-system performance. HP recommends that you exercise caution before implementing any changes, or do so only under the guidance of HP technical support.
Table 1 ibrix_fm_tune configuration options 52 Option name Description bufferOverflowMonitorInterval The interval for the buffer overflow monitor, specified in seconds. Value is an integer. Default: 60 sec. clusterName The name of the cluster. cpuThresholdSensitivityInterval Interval in seconds between samples when the CPU utilization exceeds the cpuUsageEventThreshold. File serving nodes only. Range: 0-65535. Default: 300 sec. cpuUsageEventThreshold File serving node CPU utilization threshold.
Table 1 ibrix_fm_tune configuration options (continued) Option name Description snapUsageMonitorInterval Interval in seconds between Snap usage checks. Value is an integer. Default: 300 sec. usageStatisticsSaveInterval Interval in seconds between writes of usage statistics. Value is an integer. Default: 3600 sec. Options Option Description -L Lists default configuration tuning options. -S Sets configuration tuning options. -U Resets configuration tuning options.
ibrix_fs Creates, extends, and manages file systems. Description ibrix_fs is used to: • Create a file system from physical or logical volumes. • List information about file systems (including snapshot file systems). • Extend a file system by adding new segments. • Delete a file system. • Migrate segments to another file serving node. • Enable or disable export control on a file system. • Disable 32-bit mode on a file system. • Assign or unassign a standby server.
Create a file system from the specified physical volumes in one step: ibrix_fs -c -f FSNAME -p PVLIST [-a] [-q] [-o OPTION1=VALUE1,OPTION2=VALUE2,...] [-t TIERNAME] The file system is created from the physical volumes in PVLIST. One volume group is created per physical volume. Segments are then created from the volume groups and assigned to file serving nodes in a round-robin manner.
-o compat=no Enable 64-bit mode on the file system. -o compat=yes,maxsegs=n Create a 32-bit file system and specify the maximum number of segments to allow in the file system. The valid values for maxsegs are 15, 31, 63, 127, and 255. If none of these options are specified, the new file system is created with quotas disabled, with no mountpoint, and with 32-bit mode compatibility enabled.
Migrate segment ownership Use the following commands to migrate ownership of segments to another file serving node. Migration does not move segments from one physical location to another. Instead, the ownership is recorded on the physical segment itself. Migrate ownership of segments to a new host and update the source host: ibrix_fs -m -f FSNAME -s LVLIST -h HOSTNAME [-M] [-F] [-N] The segments in LVLIST on file system FSNAME are migrated to the new host. To force the migration, include -M.
ibrix_fs -w -f FSNAME Assign or delete a standby server for the specified segments Identify a file serving node as the standby for the specified segments: ibrix_fs -b -f FSNAME -s LVLIST -h HOSTNAME The command assigns HOSTNAME as the standby for the segments in LVLIST on file system FSNAME. To identify a standby server for all segments on a file serving node, use the following command, where HOSTNAME2 is the standby for HOSTNAME1.
Option Description compat=yes|no. Declares whether this file system is 32-bit compatible. maxsegs=n. Defines the number of segments per file system in 32-bit file systems. n can be set to 15, 31, 63, 127, or 255. Data retention options are also set with -o. -p PVLIST A list of one or more physical volume names, expressed as a comma-separated list (for example, d1,d2,d3) or a range (for example, d[1-3]). -q Enables quotas on a file system.
ibrix_fs_ops Manages directory tree quota entries. IMPORTANT: The ibrix_fs_ops command is deprecated in the X9000 File Serving Software 6.0 release. Use the ibrix_edquota command to create, delete, or view directory tree quotas. Description Directory tree quotas apply to a file system located at a specific directory tree. Use the ibrix_fs_ops command to create, delete, or view directory tree quotas.
ibrix_fs_tune Overrides the default file allocation behavior on file serving nodes and clients. Description File allocation policies are set per file system on each file serving node and on X9000 clients. The policies define the following: • Preferred segments. The segments where a file serving node or X9000 client creates all new files and directories. • Allocation policy.
Deprecated segment preferences and allocation policies IMPORTANT: HP recommends that you do not use these options. They are currently supported but will be removed in a future release. Name Description Comment AUTOMATIC Lets the X9000 Software select the allocation policy. Should be used only on the advice of HP support. DIRECTORY Allocates files to the segment where its parent directory is located.
Reset the specified hosts or hostgroups to the default allocation policy for the file system: ibrix_fs_tune -f FSNAME {-h HOSTLIST|-g GROUPLIST} -p -U Prefer a pool of segments for the specified hosts or hostgroups: ibrix_fs_tune -f FSNAME {-h HOSTLIST|-g GROUPLIST} -s LVNAMELIST The segments to be included in the pool are specified by logical volume name (LVNAMELIST). To prefer a pool of segments for NFS/CIFS clients, specify only NFS/CIFS servers in the HOSTLIST.
Options Option Description -N NFS readahead Specifies the number of KB that X9000 Software pre-fetches under NFS. The default value is 128 KB. -O Sets one or more allocation policy tuning options. -P prealloc Sets the number of KB a file system pre-allocates to a file. Default: 256 KB. -R Sets allocation policy for directory segments only. -S SEGMENT_NUMBER Specifies a segment.
ibrix_fsck Analyzes inconsistencies in a file system. Description CAUTION: Do not run ibrix_fsck in corrective mode without the direct guidance of HP Support. If run improperly, the command can cause data loss and file system damage. CAUTION: Do not run e2fsck or any other off-the-shelf fsck program on any part of a file system. Doing so will damage the file system. The ibrix_fsck command command can detect and repair file system inconsistencies.
The command can be run on file system FSNAME or optionally only on segment LVNAME. This phase can be run with a specified block size and an alternate superblock number. For example: ibrix_fsck -p 1 -f ifs1 -B 4096 -b 12250 NOTE: If phase 1 is run in analytic mode on a mounted file system, false errors can be reported. 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 on segment LVNAME.
ibrix_ftpconfig Manages configuration profiles for the FTP service. Description A configuration profile specifies a set of global FTP parameters that are in effect on the file serving nodes listed in the profile. The vsftpd service starts on these nodes when the cluster services are started. Only one configuration profile can be in effect on a particular node. When you create an FTP share, you will need to associate it with a configuration profile.
Option Description -S SETTINGLIST Specifies the settings that are to be applied to a configuration profile. Use a comma to separate the settings, and enclose the settings in quotation marks, such as “passive_enable=true,maxclients=200,...”. To see a list of available settings for the share, use ibrix_ftpconfig -L. -a Adds a configuration profile. -d Deletes a configuration profile. -h HOSTLIST Specifies one or more file serving nodes.
ibrix_ftpshare Manages FTP shares. Description An FTP share provides access to data on X9000 software file systems. FTP clients access the shares using standard FTP and FTPS protocol services. The ibrix_ftpshare command can be used to add a share to an existing file system. You can create multiple shares having the same physical path, but with different sets of properties, and then assign users to the share that is appropriate for their usage. NOTE: The file system must be mounted when you add the share.
Use -v 1 to display detailed information. List the valid settings for a share: ibrix_ftpshare -L Options Option Description -I IPaddrs:Port Specifies the IP addresses/ports assigned to this share. -L Lists valid FTP share settings. -S SETTINGLIST Specifies the settings to apply to an FTP share. Use a comma to separate the settings, and enclose the settings in quotation marks, such as “browseable=true,readonly=true,...”. To see a list of available settings for the share, use ibrix_ftpshare -L.
ibrix_haconfig Reports whether X9000 software high availability features are configured for file serving nodes.
Options 72 Option Description -b Includes standby servers in the configuration check. -f Reports only on failed file serving nodes. -h HOSTLIST A list of file serving nodes. -i Displays a detailed high availability configuration report. -l Displays a summary high availability configuration report. -v Displays details about the configuration checks that received a Passed result. -? Shows the usage for this command.
ibrix_hba Discovers HBAs, identifies standby pairings of HBA ports, monitors HBA ports for failure, deletes HBAs from the configuration database, and lists information about HBAs. Description ibrix_hba sets up HBA monitoring. When a monitored HBA port fails, the Fusion Manager fails the host over to its standby if a standby has been declared and if automated failover is turned on. The -b option identifies two multipath HBAs that have been set to operate as a failover pair.
Option Description -b Identifies two ports as a standby pair. -d Deletes an HBA port definition. -h HOSTNAME or HOSTLIST One or more file serving nodes. -l For each host, displays its WWNN, WWPN, backup WWPN, and whether HBA monitoring is turned on. -m Turns on HBA monitoring. -p PORT Specifies the port number used for HBA monitoring.
ibrix_health Generates health reports for cluster components and X9000 clients. Description The ibrix_health command includes options specific to X9720/X9730 systems and other options for file serving nodes and X9000 clients. For X9720/X9730 systems, ibrix_health generates a detailed or summary health report for storage, chassis, or servers registered to a chassis. For file serving nodes and X9000 clients, ibrix_health runs a set of health checks on all hosts or the specified hosts and reports the results.
-t SCRIPTNAMELIST: Runs the specified scripts and include them in the health report. Display a detailed health report for file serving nodes or X9000 clients: ibrix_health -i -h HOSTLIST [-f] [-b] [-s] [-v] [-t SCRIPTNAMELIST] The options are: –h HOSTLIST: Runs health checks on the specified file serving nodes and X9000 clients. -f: Reports only hosts that failed a test. -b: Includes standbys for file serving nodes. -s: Includes details about the file system and segments.
ibrix_healthconfig Manages health check sets. Description Use this command to create or update sets of health checks. You can also delete health check sets display existing health check sets. Synopsis Create a set of health checks: ibrix_healthconfig -c -n SETNAME -t HEALTH_CHECKLIST SETNAME is the name for the set being created and HEALTH_CHECKLIST lists the checks to be added.
ibrix_host_tune Sets and lists tuning parameters for file serving nodes and X9000 clients. Description CAUTION: The default values for the host tuning parameters are suitable for most cluster environments. Because changing parameter values can alter file-system performance, HP recommends that you exercise caution before implementing any changes, or do so only under the guidance of HP technical support. Host tunings are immediately executed for file serving nodes.
List default values and the range of values for host-tuning parameters: ibrix_host_tune -L Set host configuration options for the specified hosts: ibrix_host_tune -C [-h HOSTLIST] -o OPTIONLIST OPTIONS is a list of configuration options separated by commas. Reset host configuration options to the default values: ibrix_host_tune -R [-h HOSTLIST] -n OPTIONS OPTIONS is a list of configuration options separated by commas.
Option Description -p tcp|udp Sets a communications protocol (UDP or TCP). -q Queries configuration tuning parameter values. -t THREADCOUNT Sets the number of server threads. The default value is 10. -? Shows the usage for this command.
ibrix_hostgroup Creates and manages hostgroups. Description A hostgroup is a named set of X9000 clients. Hostgroups provide a convenient way to centrally manage clients. Group-wide procedures include: • Mounting file systems. • Preferring or unpreferring a network interface for a hostgroup. (You can locally override the preference on individual X9000 clients with ibrix_lwhost.) • Tuning host parameters. • Setting allocation policies.
Add a domain rule to a hostgroup: ibrix_hostgroup -a -g GROUPNAME -D DOMAIN Delete one or more hostgroups from a hostgroup tree: ibrix_hostgroup -d -g GROUPLIST Prefer a network interface for communication from a hostgroup to a destination host: ibrix_hostgroup -n -g HOSTGROUP -A DESTHOST/IFNAME To prefer a network interface for all X9000 clients, use -g clients.
ibrix_hostpower Manages power sources. Description Use ibrix_hostpower to list power sources or disassociate a file serving node from a power source. Synopsis List the power sources assigned to all file serving nodes or the specified nodes: ibrix_hostpower -l [-h HOSTLIST] Dissociate a file serving node from an integrated power source: ibrix_hostpower -d [-s POWERSOURCE ] -h HOSTNAME Options Option Description -d Dissociates a hostname from a power source.
ibrix_httpconfig Manages configuration profiles for the HTTP service. Description A configuration profile specifies a set of global HTTP parameters in effect on the file serving nodes listed in the profile. When you create an HTTP share, you will need to associate it with a configuration profile. One or more HTTP virtual hosts are also associated with the profile and specify the IP addresses/ports that clients will use to access the HTTP shares.
Before using this option, take one of the following steps: • If Active Directory authentication is used, join the restored node to the AD domain manually. • If Local user authentication is used, create a temporary local user on the GUI and apply the settings to all servers. This step resynchronizes the local user database. Options Option Description -L Lists default profile settings. -R Restores the HTTP configuration on a node that has been recovered with the QuickRestore DVD.
ibrix_httpshare Manages HTTP shares. Description An HTTP share provides access to data on X9000 software file systems. HTTP clients access the shares using standard HTTP and HTTPS protocol services. The ibrix_httpshare command can be used to add a share to an existing file system. You can create multiple shares having the same physical path, but with different sets of properties, and then assign users to the share that is appropriate for their usage.
Options Option Description -L Lists valid HTTP share settings. -P urlpath Specifies the URL that clients will use to access the share. -S SETTINGLIST Specifies the settings that are to be applied to an HTTP share. Use a comma to separate the settings, and enclose the settings in quotation marks, such as “browseable=true,readonly=true,...”. If a value is not specified for a setting, the default value will be used. To see a list of available settings for the share, use ibrix_httpshare -L.
ibrix_httpvhost Manages HTTP virtual hosts. Description An HTTP virtual host is associated with an HTTP configuration profile. The virtual host specifies the IP addresses/ports that clients will use to access the HTTP shares associated with the configuration profile. The virtual host also specifies the SSL certificate that will be used for HTTPS connections.
Option Description -l Lists HTTP virtual hosts. -m VHOSTNAME Modifies the specified HTTP virtual host. -v level Displays detailed information. Enter 1 as the level. -? Shows the usage for this command.
ibrix_ldapconfig Configures LDAP as the primary user authentication method for CIFS shares. Description The ibrix_ldapconfig command configures LDAP as the primary authentication method for users accessing CIFS shares on an X9000 file system. IMPORTANT: Before using ibrix_ldapconfig to configure LDAP on the cluster nodes, you must configure the remote LDAP server. For more information, see the HP IBRIX X9000 Network Storage System File System User Guide.
Option Description -h LDAPSERVERHOST The LDAP server host (server name or IP address). -i Displays the LDAP configuration. -m Modifies the LDAP configuration. -n NETBIOS Specifies the NetBIOS name of the X9000 server. This can be any string that identifies the X9000 host, such as X9000. -p LDAPBINDDNPASSWORD The password associated with the LDAP Bind DN. -v The certificate CN value (for example, centralldap.it.entx.net).
ibrix_ldapidmapping Configures LDAP ID mapping as a secondary lookup source for Active Directory. Description When Active Directory is used to authenticate users accessing CIFS shares, you can configure LDAP ID mapping as a secondary lookup source. This method allows the system to read CIFS client UIDs and GIDs from LDAP if the needed ID cannot be located in an AD entry. The name in LDAP must match the name in AD without respect for case or pre-appended domain.
Option Description -m MAXWAITTIME Specifies the local maximum search time-out value in seconds and the operation maximum time limit that is sent to the server within the search request. This value determines how long the client will wait for search results. -p LDAPBINDDNPASSWORD Specifies the LDAP bind password. -n Specifies case sensitivity for name searches (the default is false, or case-insensitive).
ibrix_license Displays the contents of the X9000 File Serving Software license. Description ibrix_license lists the contents of the license file, which controls the operation of an X9000 software cluster. Synopsis Display the license contents: ibrix_license -i In the output, “Segment Server” refers to file serving nodes. Options 94 Option Description -i Lists license contents. -? Shows the usage for this command.
ibrix_localgroups Manages local group accounts for CIFS or HTTP access. Description If Local User authentication is configured for CIFS or HTTP shares, use the ibrix_localgroups command to create and manage local group accounts. When naming local groups, you should be aware of the following: • Group names must be unique. The new name cannot already be used by another user or group. • The following names cannot be used: administrator, guest, root.
ibrix_localusers Manages local user accounts for CIFS or HTTP access. Description If Local User authentication is configured for CIFS or HTTP shares, use the ibrix_localusers command to create and manage local user accounts. When naming local users, you should be aware of the following: • User names must be unique. The new name cannot already be used by another user or group. • The following names cannot be used: administrator, guest, root.
Option Description -n Specifies that the password is in NT hashed format. -p PASSWORD Specifies the local user's password. -s SHELL Specifies the local user's shell program. The default is /bin/false. -u USERNAME Specifies the username for the account. -? Shows the usage for this command.
ibrix_lv Manages logical volumes. Description ibrix_lv creates logical volumes (file-system segments) from a volume group. You can specify logical volume names or allow the names to be assigned automatically. Optionally, you can specify a logical volume size (the minimum size is 1 GB). Additional memory allocation is rounded to the next higher 32 MB. If you do not specify a size, the Fusion Manager evenly divides the whole volume group among the logical volumes.
Object Description -n COUNT Specifies the number of logical volumes to create. The value is an integer that specifies both the number of logical volumes to create and the maximum value of the numeric postfix for each logical volume name. -o "OPTIONS" A string of options for Linux lvcreate, enclosed in double quotation marks. -s LVNAME or LVLIST A logical volume or a list of logical volumes.
ibrix_migrator Defines migration rules and controls migrator operations. Description Tiering enables automatic migration of files from one tier to another within the same file system. User-written rules based on file attributes (such as modification time, access time, file size, or file type) define the migration policy, determining which files are moved and when. Tiers are defined on segments, not individual files. Use ibrix_tier to assign segments to tiers.
Options Option Description -A Adds a data migration rule to a file system. -D DESTINATION_TIER Specifies the destination tier in a migration rule. -F force Forces migration. -S SOURCE_TIER Specifies the source tier in a migration rule. -d Deletes a migration rule for a file system. -f FSNAME Specifies a file system name. -i Lists detailed migration status information for one or more file systems, including the state of any migration tasks. -k Stops a migrator operation on a file system.
ibrix_migrator -A -f ifs2 -r "atime older than 2 days " -S TIER1 -D TIER2 Rule keywords Rules consist of keywords, qualifiers, and operators. Keyword Definition atime Access time, used in a rule as a fixed or relative time. ctime Change time, used in a rule as a fixed or relative time. mtime Modification time, used in a rule as a fixed or relative time. gid An integer corresponding to a group ID. gname A string corresponding to a group name. Enclose the name string in double quotes.
Example 3: This example uses and to impose three conditions on the migration. Note the use of 10M, with no space separating the integer and unit defining the size threshold. # ibrix_migrator -A -f ifs2 -r 'ctime older than 1 month and type = file and size >= 10M' -S T1 -D T2 Example 4: This example uses the path keyword.
ibrix_mount Mounts a file system on file serving nodes and X9000 clients. Description When mounting a file system on specific file serving nodes, the first file serving node listed must own the root segment (segment 1). X9000 software automatically mounts on the root segment first if you mount on all file serving nodes in the cluster. Mounts are immediately executed for file serving nodes. For X9000 clients the mount intention is stored in the Fusion Manager.
ibrix_mount -O noatime,nodiratime -f ifs3 -m /ifs3 Export Control Examples The following command mounts file system ifs1 on all file serving nodes and X9000 clients at mountpoint /ifs1 and gives the clients RW access: /bin/ibrix_mount -f ifs1 -o RW -m /ifs1 The following command mounts file system ifs1 on hostgroup finance at mountpoint /ifs1 and gives the clients RW access: /bin/ibrix_mount -f ifs1 -o RW -g finance -m /ifs1 To run the same command and grant clients in
ibrix_mountpoint Creates and deletes mountpoints. Description The ibrix_mountpoint command immediately creates or deletes the specified mountpoint on file serving nodes and X9000 clients. The command fails if the mountpoint already exists. When creating a mountpoint, use the -o option to specify default mount options that are applied when a file system is mounted at that mountpoint. You can override the default mount options with ibrix_mount -o remount new_options if necessary.
To list all mountpoints on all file serving nodes, X9000 clients, and hostgroups, omit all options. To list mountpoints for certain file serving nodes and X9000 clients, include only the HOSTLIST option. To list mountpoints for certain hostgroups, include only the GROUPLIST option. To list all file serving nodes, X9000 clients, and hostgroups for a specific mountpoint, include only the -m MOUNTPOINTLIST option. Options Option Description -c Creates a mountpoint. -d Deletes a mountpoint.
ibrix_ndmpconfig Configures NDMP parameters on the cluster. Description The ibrix_ndmpconfig command sets NDMP parameters on the cluster. These parameters control communications between the DMA and the NDMP Servers hosted on the file serving nodes. Synopsis Set NDMP parameters: ibrix_ndmpconfig -c [-d IP1,IP2,IP3,...
ibrix_ndmpsession Manages NDMP sessions and reports session history. Description The ibrix_ndmpsession command lists the currently running NDMP sessions or only the completed sessions (successful or not). You can also use the command to cancel a specific NDMP session, to cancel all sessions on a specific file serving node, or to cancel all sessions on all nodes. Canceling a session kills all spawned sessions processes and frees their resources if necessary.
ibrix_nic Configures network interfaces. Description ibrix_nic is used to: • Set up automated failover for a user interface. • Identify or delete network interfaces. User interfaces that are intended for X9000 client traffic must be identified. HP recommends that you also identify user interfaces that are intended for NFS traffic so that you can implement automated failover for them. • Identify or delete standbys for a user interface.
Set up network interface monitoring: ibrix_nic -m -h MONHOST -A DESTHOST/IFNAME The command assigns server MONHOST to monitor server DESTHOST over network interface IFNAME. When configuring NIC monitoring, use the same backup pairs that you used when configuring standby servers.
Options Option Description -A DESTHOST/IFNAME Identifies the file serving node to be monitored and the interface used for monitoring. -B BCASTADDR Specifies an IP address used for network broadcast. -D DESTHOST/IFNAME If used with -r, disables network routing. If used with -m, deletes the monitor from the named host/interface. –F Forces NIC migration. -H HOSTNAME/IFNAME Identifies pairs of file serving nodes and interfaces in standby or monitoring relationships.
ibrix_onlinequotacheck Rescans quota usage. Description The ibrix_onlinequotacheck command is used to rescan quota usage, initialize directory tree quotas, and remove directory tree quotas. The command must be run from a file serving node that has the file system mounted and has three modes: • FILESYSTEM_SCAN mode. Use this mode in the following scenarios: ◦ You turned quotas off for a user, the user continued to store data in a file system, and you now want to turn quotas back on for this user.
Options 114 Option Description -F Forces an online quotacheck task to stop. -S Specifies that FILESYSTEM_SCAN mode be used. —c Specifies that DIRTREE_CREATE mode be used. —d Specifies that DIRTREE_DELETE mode be used. —f FSNAME or FSLIST Specifies a file system or list of file systems. —i Displays detailed status information for online quotacheck tasks. —k Stops online quotacheck tasks. —l Provides a status summary for online quotacheck tasks.
ibrix_phonehome Manages the Phone Home configuration. Description When Phone Home is enabled, you can get remote support for X9000 hardware and software alerts using standard HP Insight Remote Support protocols. Systems are monitored continuously for hardware or software failures, and HP can take the necessary corrective measures. To enable remote support for MSA (X9320 systems), use the ibrix_vs command to register the MSA. The chassis in X9720/X9730 systems are registered automatically.
Synchronize the Phone Home configuration in the cluster: ibrix_phonehome -s The operation enables Phone Home on newly added devices (servers, storage, and chassis) and removes details for devices that are no longer in the cluster. Options Option Description -C Specifies the IP address of the On-Board Administrator for a chassis. -b Customer Entered Serial Number Specifies a customer-entered serial number. -c Configures and enables Phone Home. -d Unconfigures and disables Phone Home.
ibrix_powersrc Adds or deletes power sources and modifies power source attributes in the configuration database. Description Programmable power sources are required for automated failover and forced manual failover. The installed power sources must be identified and added to the configuration database before they can be used. X9000 software works with integrated power sources that are managed by iLO, IPMI, or OpenIPMI.
Option Description -h HOSTNAME or POWERSRCNAME or POWERSRCLIST A file serving node name, the name of a power source, or a list of power source names. -l Lists information about power sources. -m Modifies a power source definition. -p Password used for authentication. -s Skips BMC configuration. -t POWERSRCTYPE Identifies the power source type. -u USERNAME Username for authentication. -? Shows the usage for this command.
ibrix_profile Manages kernel profiles. Description The ibrix_profile command is used to start, disable, or reset kernel profiles, or to display kernel profile statistics. Synopsis Start a kernel profile: ibrix_profile -E [-h HOSTLIST] Use the HOSTLIST option to limit the command to specific nodes. Disable a kernel profile: ibrix_profile -D [-h HOSTLIST] Use the HOSTLIST option to limit the command to specific nodes.
ibrix_pv Discovers, lists, and deletes physical volumes. Description This command discovers physical volumes that have been added to file serving nodes since the last time the command was executed. The command excludes partitions and volumes that belong to volume groups created for use outside of the X9000 software cluster.
Option Description -p PVLIST Physical volumes. Enter either a comma-delimited list of physical volumes (for example, d1,d2,d3) or a range list (for example, d[1-3]). -? Shows the usage for this command.
ibrix_rebalance Redistributes files among segments to balance segment utilization and server workload. Description Rebalancing files The X9000 software Rebalancer redistributes files among segments in a file system to balance segment utilization and server workload. Normally all segments are rebalanced, possibly as a cron job, but a rebalancing can be limited to specific segments. Only segments containing files can be rebalanced.
The job is specified by TASKID. To force the job to stop, include the -F option. To obtain the TASKID, run ibrix_rebalance -i. You can stop a rebalance task at any time. Stopping a task poses no risks for the file system. The Fusion Manager completes any file migrations that are in process when you issue the stop command. Depending on when you stop a job, segments may contain more or fewer files than before the run began.
ibrix_reports Generates reports for data retention, utilization, and validation. Description The ibrix_reports command scans the file system and collects data for reports. There are three types of reports: • Data retention. This report lists ranges of retention periods and specifies the number of files in each range. • Utilization. This report summarizes how storage is utilized between retention states and free space. • Data validation.
ibrix_reten_adm Manages retained and WORM files in a file system or directory enabled for data retention. IMPORTANT: Do not use the ibrix_reten_adm command on a file system that is not enabled for data retention. Description Use the ibrix_reten_adm command to manipulate WORM and retained files. You can perform the following tasks: • Add or remove a legal hold on a WORM or retained file. While the hold is in effect, the file cannot be deleted, even if the expiration period has expired.
Synopsis Deleting files administratively removes them from the file system, regardless of the data retention policy applied to the files. Set a legal hold on retained or WORM files: ibrix_reten_adm -h -f FSNAME -P PATHLIST A legal hold locks the file and the data retention policy in place on the file system will be ignored. For example, the expiration time does not apply to the file.
Option Description -u Upgrades a mounted file system to allow autocommit. -? Shows the usage for this command.
ibrix_server Performs management and control procedures for file serving nodes. Description Use ibrix_server to: • Identify or delete a standby for a file serving node. • Manually fail over a file serving node. • Fail back a file serving node following either automated or manual failover. • Turn automated failover on or off. • Prefer or unprefer a user interface for a file serving node. By default, file serving nodes use the cluster interface. • Power cycle a host.
The command assigns network interface IFNAME for traffic from source server SRCSERVER to destination host DESTHOST. The network interface preference is executed immediately on the file serving nodes. Use the default cluster interface for server traffic: ibrix_server -n -h SRCSERVER -D DESTHOST The cluster interface will be used for network traffic from source server SRCSERVER to destination host DESTHOST.
Option Description -f Fails over to or fails back from a file serving node. -h SERVERNAME or SERVERLIST One or more file serving nodes. -i Provides detailed information about one or more file serving nodes. -l Lists file serving nodes and identifies any configured backups. Also specifies whether the nodes are up or down and whether auto-failover is configured. -m Toggles auto-failover monitoring on a file serving node.
ibrix_sh Manages shell tasks. Description The ibrix_sh command can be used to run the Linux shell commands cp and find on file serving nodes and save the output. You can also list shell tasks in the cluster, display information about the tasks, or delete tasks. Synopsis Execute a command on all file serving nodes: ibrix_sh -c COMMAND -o OUTPUT_DIR The results from the command are saved in the directory OUTPUT_DIR. The supported shell commands are cp and find.
ibrix_snap Manages file system snapshots. Description The X9000 software snapshot feature captures a point-in-time copy of a file system or directory for online backup purposes and simplifies recovery of files from accidental deletion. Software snapshots can be taken of the entire file system or selected directories. Users can access the filesystem or directory as it appeared at the instant of the snapshot.
Option Description —m Enables a file system or directory for snapshots. –n NAMEPATTERN Specifies a pattern for snapshot names. –s Lists snapshots. —? Shows the usage for this command.
ibrix_snapreclamation Reclaims file system space used by deleted snapshots. Description After deleting snapshots, you can use the ibrix_snapreclamation command to reclaim the file system space previously used by the snapshots. The reclamation task runs on an entire file system, not on a specific snap tree within that file system. If a file system includes two snap trees, space is reclaimed for both snap trees.
ibrix_snmpagent Updates the configuration properties for the SNMP agent. NOTE: When Phone Home is enabled, you cannot edit or change the configuration of the X9000 SNMP agent with ibrix_snmpagent. However, you can add trapsink IPs with ibrix_snmtrap and can associate events to the trapsink IP with ibrix_event. Description The SNMP agent is created automatically. It is configured initially as an SNMPv2 agent and is off by default.
Option Description -n SYSNAME Specifies the assigned system name (generally the fully-qualified domain name) of the this agent. -o SYSLOCATION Specifies the physical location of the MIB-II system being managed (this agent). -p PORT Specifies the port on which the agent listens for SNMP requests from the NMS. The default port is 5061. -r READCOMMUNITY In SNMPv1 and v2, identifies the community name (that is, the password) used for an SNMP get request. The default read community name is public.
ibrix_snmptrap Creates, updates, or deletes trapsinks for any SNMP version. Description A trapsink is the host destination where agents send traps, which are asynchronous notifications sent by the agent to the management station. A trapsink is specified by its name or IP address. X9000 software supports multiple trapsinks; you can define any number of trapsinks of any SNMP version, but you can define only one trapsink per host regardless of version.
See also ibrix_event, ibrix_snmpagent 138 X9000 File Serving Software commands
ibrix_stats Lists statistics for file serving nodes. Description Approximately every 20 seconds, the file serving nodes report a range of operational statistics to the Fusion Manager. Synopsis Display statistics for file serving nodes: ibrix_stats -l [-s] [-c] [-m] [-i] [-n] [-f] [-C] [-h HOSTLIST] The output includes all file serving nodes or only the nodes in HOSTLIST. Options Option Description -C Prints CIFS statistics. -c Prints CPU statistics. -f Prints NFS statistics.
ibrix_tape Lists or rescans tape devices Description The ibrix_tape command can be used to list tape and media changer devices available for NDMP backups. The command can also rescan for devices. Synopsis List all tape and media changer devices: ibrix_tape -l Rescan for tape and media changer devices: ibrix_tape -r Options Option Description -l Lists tape devices and media changer devices. -r Rescans for devices ? Shows the usage for this command.
ibrix_task Manages tasks running in the cluster. Description The ibrix_task command can be used to view information about active or inactive tasks in the cluster. You can also pause, resume, or suspend tasks. Active tasks are typically starting, running, or paused. Inactive tasks are typically stopped, either by running to completion or being stopped in some way (for example, manually, by an error, or by failing to start).
Option Description -n TASKID or TASKIDS A task name. -p Pauses the task with the specified task ID. -r Resumes the task with the specified task ID. -s Lists scheduled tasks. ? Shows the usage for this command.
ibrix_tier Manages data tiers. Description A tier is a group of one or more segments. Tiering enables automatic migration of files from one tier to another within the same file system. User-written rules based on file attributes (such as modification time, access time, file size, or file type) define the migration policy, determining which files are to be moved and when. Tiers are defined on segments, not individual files. Use of the tiering structure on any file system is optional.
ibrix_umount Unmounts a file system. Description ibrix_umount unmounts a file system from file serving nodes, X9000 clients, and hostgroups. You can also locally unmount a file system from Linux X9000 clients with ibrix_lwumount. File serving nodes immediately unmount a file system. For X9000 clients the intention to unmount a file system is stored on the Fusion Manager.
ibrix_version Reports software version numbers for file serving nodes and X9000 clients.
ibrix_vg Creates, extends, reduces, or deletes volume groups. Description Use ibrix_vg to perform these tasks: • Create volume groups from discovered physical volumes. This is the second step in the manual method of creating a file system. • Extend or reducing a volume group by adding or removing physical volumes. • Delete unneeded volume groups. Before deleting a volume group, first delete the logical volumes (segments) created from it. • List information about volume groups.
Options Option Description -b Backs up the vgconfig maps on the Fusion Manager. -c Creates a volume group. -d Deletes a volume group. -e Extends a volume group. -g VGNAME or VGLIST A volume group or list of volume groups. Takes either a list of volume groups separated by commas (for example, ivg1,ivg2,ivg3) or a range of volume groups (for example, ivg[1-3]). -h HOSTLIST A list of one or more host names. -i Displays information about volume groups and the file serving nodes accessing them.
ibrix_vs Identifies storage resources, discovers them, and maps them to physical volumes. Description ibrix_vs identifies vendor storage resources, discovers LUNs identified in those resources, and maps them to logical physical volumes in the configuration database. On X9300/X9320 systems, you will need to identify and discover vendor storage resources before they can be used to create block snapshots.
Option Description –s suffix Suffix. -t TYPE Storage system type (eva, lefthand, msa, 3PAR, or eqlogic). -? Shows the usage for this command.
ibrix_vs_snap Creates or deletes file-system snapshots and cleans up after an unsuccessful snapshot session. Description ibrix_vs_snap creates a file-system snapshot for clusters that implement supported storage systems. The snapshot replicates file-system entities and is managed exactly like a standard file system. A snapshot is active from the moment that it is created. The first snapshot task is to define the snapshot allocation policy.
Option Description -c Creates a file-system snapshot. -d Deletes a file-system snapshot. -f ORIGINFSNAME The file system for which a snapshot is being created. -h HOSTLIST A list of one or more hosts. -i Lists snapshot information. -l Lists file-system snapshots. -n SNAPFSNAME or SNAPFSLIST The name of a file-system snapshot or list of snapshots. -p Sets snapshot policy for a snapshot file system. -r Cleans up an invalid snapshot. -? Shows the usage for this command.
ibrix_vs_snap_strategy Creates an automated snapshot strategy for hardware snapshots. Description If you will be taking a snapshot of a file system on a regular basis, you can create a snapshot strategy for that file system. The strategy specifies the number of snapshots to keep and the number of snapshots to mount on the system. You can also create naming templates for the snapshots and the snapshot mountpoints. After creating a snapshot strategy, use the GUI to create a schedule for taking the snapshots.
Options Option Description -M MOUNTSPEC Snapshot mountpoint template. –N NAMESPEC Name of snapshot template. –c Configures a snapshot strategy. –d Deletes a snapshot strategy. –e Edits an existing snapshot strategy. –i Displays detailed information about a snapshot strategy. –k KEEP The number of snapshots to keep per file system. –l Lists snapshot policies. –m MOUNT The number of snapshots to mount per file system. –n NAME Snapshot strategy name. -? Shows the usage for this command.
upgrade60.sh Upgrades pre-6.0 file systems for software snapshots. Description To support software snapshots, the inode format was changed in the X9000 6.0 release. The upgrade60.sh utility upgrades a file system created on a pre-6.0 release, enabling software snapshots to be taken on the file system. The utility can also determine the needed conversions without actually performing the upgrade. When using the utility, you should be aware of the following: • The file system must be unmounted.
Migrating large files The upgrade60.sh utility does not upgrade files larger than 3.8 TB. After the upgrade is complete and the file system is mounted, migrate the file to another segment in the file system using the following command: ibmigrate -f filesystem -m 1 -d destination_segment file The following example migrates file.9 from its current segment to destination segment 2: ibmigrate -f ibfs -m 1 -d 2 /mnt/ibrix/test_dir/dir1/file.9 After the file is migrated, you can snap the file.
3 Commands for Linux X9000 clients and file serving nodes The commands in this chapter are run directly on Linux X9000 clients and/or file serving nodes. The commands can be executed by any user. In a typical installation, the commands are run from the working directory /usr/local/ibrix/bin. ibrix_df Reports disk space utilization information for a file system. This command can be run on file serving nodes or X9000 clients. Description ibrix_df reports disk space utilization for the specified file system.
ibrix_lwhost Tunes Linux X9000 clients. This command can be run on X9000 clients only. Description Use ibrix_lwhost to set Linux X9000 client parameters: • Server settings • Preferred network interface for communication with a file serving node • Communications protocol • Number of server threads Changes take effect immediately and are persistent. This command also initiates a Fusion Manager query that allows the X9000 client to pick up new host tunings.
Option Description --list Lists parameter settings that have been changed from the defaults. -? Shows the usage for this command.
ibrix_lwmount Mounts a file system on a Linux X9000 client. This command can be run on X9000 clients only. Description A file system must be mounted on the file serving node that owns the root segment (that is, segment 1) before it can be mounted on an X9000 client. If the Export Control feature is not enabled, use this command to mount a file system on an X9000 client.
ibrix_lwumount Detaches a file system from a Linux X9000 client. This command can be run on X9000 clients only. Synopsis Detach a file system from a client: ibrix_lwumount -f [fmname:]fsname The file-system name is always required. A Fusion Manager name is required only if this X9000 client is registered with multiple management consoles. Specify the Fusion Manager and file system as a pair separated by a colon: fmname:fsname.
ibrix_top Collects and presents live views of file system, host, and segment activity. The command can be run on either file serving nodes or X9000 clients. Description ibrix_top collects performance metrics for file systems, hosts and segments; and displays the results to the standard output in a form similar to that of the UNIX top(1) command. When the command is first run, some fields are empty or read zero (0). These fields are populated when the command is first refreshed.
Options 162 Option Description -d DIRECTORY Specifies the directory where data captures are written. HP recommends that you name this directory with an absolute path. -r default|host segment|help Specifies the initial view for an ibrix_top session. -s Creates persistent data snapshots. -t SEC Sets the number of seconds in the refresh interval between data collections. The default is 5 seconds. -? Shows the usage for this command.
verify_client_update Determines whether a minor kernel update is compatible with the X9000 client software. Description If you are planning to install a minor kernel update, run the verify_client_update command first to verify that the update is compatible with the X9000 client software. If the minor kernel update is compatible, install the update with the vendor RPM and reboot the system.
4 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
5 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Glossary ACE Access control entry. ACL Access control list. ADS Active Directory Service. ALB Advanced load balancing. BMC Baseboard Management Configuration. CIFS Common Internet File System. The protocol used in Windows environments for shared folders. CLI Command-line interface. An interface comprised of various commands which are used to control operating system responses. CSR Customer self repair. DAS Direct attach storage.
SELinux Security-Enhanced Linux. SFU Microsoft Services for UNIX. SID Secondary controller identifier number. SNMP Simple Network Management Protocol. TCP/IP Transmission Control Protocol/Internet Protocol. UDP User Datagram Protocol. UID Unit identification. VACM SNMP View Access Control Model. VC HP Virtual Connect. VIF Virtual interface. WINS Windows Internet Naming Service. WWN World Wide Name. A unique identifier assigned to a Fibre Channel device. WWNN World wide node name.
Index A Active Directory configure for CIFS, FTP, or HTTP, 8 configure on Windows X9000 clients, 6 LDAP ID mapping as secondary lookup source, 92 agile Fusion Manager, 49 allocation policy, 61 Antivirus support configure, 11 enable or disable, 11 schedule updates of definitions, 10 statistics, 10 authentication Active Directory, 8 LDAP , 90 LDAP ID mapping, 92 Local Users and Groups, 8 automated snapshots, hardware, 152 C case-insensitive file names, 14 certificates, SSL, 15 chassis, X9720 or X9730, 17 CIF
tuning parameters, 51 H hardware registered chassis and server information, 17 HBAs manage, 73 port monitoring, 73 health check sets, 77 health checks, 75 help obtaining, 164 high availability, configure, 71 hostgroups, manage, 81 hosts, activity snapshots, 161 HP technical support, 164 HP websites, 164 HTTP service configuration profile, 84 manage authentication, 8 shares, 86 SSL certificates, 15 virtual host, 88 I Ibrix_collect, 29 K kernel profiling, 119 L LDAP authentication, 90 LDAP ID mapping, 92
SNMP event notification, 43 SSL certificates, 15 Static user mapping , CIFS, 20 statistics, file serving nodes, 139 storage resources evacuate files, 42 manage, 148 Subscriber's Choice, HP, 164 system data collect for diagnosis, 29 T tape devices for NDMP backups, 140 tasks, manage, 141 technical support HP, 164 tuning parameters file serving nodes, 78 management console, 51 X9000 clients, 78 U user network interface, prefer or unprefer, 24 V validation, scan, 37 volume groups, manage, 146 W websites HP