HP IBRIX 9000 Storage CLI Reference Guide Abstract This document describes commands provided with IBRIX software. It is intended for system administrators managing 9300 Storage Gateway, 9320 Storage, 9720 Storage, and 9730 Storage. For the latest IBRIX guides, browse to http://www.hp.com/support/IBRIXManuals.
© 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..............................................................................6 Executing IBRIX software commands............................................................................................6 Command syntax......................................................................................................................6 Command messages.................................................................................................................
ibrix_httpvhost......................................................................................................................101 ibrix_ldapconfig...................................................................................................................103 ibrix_ldapidmapping.............................................................................................................105 ibrix_license ..............................................................................................
Subscription service..............................................................................................................185 5 Documentation feedback.........................................................................186 Glossary..................................................................................................187 Index.......................................................................................................
1 General CLI information Executing IBRIX software commands The commands in “IBRIX software commands” (page 7) must be executed on the Fusion Manager host. Root privileges are required to run these commands. The commands in “Commands for Linux 9000 clients and file serving nodes” (page 177) can be executed on file serving nodes and/or Linux 9000 clients. Any user can run these commands. All commands are run from the working directory /usr/local/ibrix/bin. Command syntax Names.
2 IBRIX software commands This chapter lists commands used to configure and manage IBRIX 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 9000 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_archiving Manages the archiving system. Description The ibrix_archiving manages the Express Query system, including the database and scanner daemons. You can display the status of the Express Query system and start, stop, or restart the daemons. The Express Query database for each file system is stored on that file system. The Express Query database is closed before the file system is unmounted.
file system goes into a MIF state again. If recovery succeeds, the file system’s state is set to OK and it processes all outstanding logged file system changes and it will continue to update the database of new changes. Display the status of the Express Query system: ibrix_archiving -i Displays the status of the Express Query system.
Option Description -w [timeout] Changes the timeout period for the Express Query watchdog. ? Shows the usage for this command.
ibrix_audit_reports Generates audit reports. Description The ibrix_audit_reports command generates reports for events stored in an Express Query database’s audit log tables for a given file system. You can select the types of events you want to include in the report, and you can specify a start and end date for the report. Synopsis Generate an audit report: ibrix_audit_reports -t SORT_ORDER -f FILESYSTEM [-p PATH] [-b BEGIN_DATE] [-e END_DATE] [-o class1[,class2,...]] Generates an audit report.
the file system each day). Use the form hh:mm (a valid hour between 0 and 23 inclusive, and a 2-digit minute between 00 and 59 inclusive) to specify the SCHEDULE. The following example sets the time for reports cleanup to 2 am: ibrix_audit_reports -f ibrixfs1 –y 02:00 Display the global audit report expiration schedule for a file system or all file systems: ibrix_audit_reports -Y [-f FILESYSTEM] Displays the global audit report expiration schedule for a file system or all file systems.
Group Class event Description audit_event_disabled Auditing of a particular category of audit event was disabled audit_event_enabled Auditing of a particular category of audit event was enabled audit_log_keep_period_changed The audit log retention period was changed Configuration fs_mounted The file system was mounted fs_unmounted The file system was unmounted segment_added A segment was added to a file system or tier segment_assigned A tier was assigned to one or more segments segment_unass
ibrix_auth Configures Active Directory or Local Users and Groups authentication for SMB, FTP, and HTTP shares. Description The ibrix_auth command configures Active Directory or Local Users and Groups as the authentication method for users accessing SMB, 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 IBRIX 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 SMB 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.
Options Option Description -D Deletes quarantined files. -L Lists quarantined files on a particular file system. -M Moves quarantined files. -R Resets quarantined files.
ibrix_avscan Manages Antivirus scans on an IBRIX file system. The Antivirus scan command lets you specify a directory path under which all the files are subjected to an antivirus scan, unlike normal “antivirus scan on read.” Description The ibrix_avscan command starts or stops an Antivirus scan task. It can also be used to display information about Antivirus scan tasks. Multiple scan tasks can run in the cluster; however, you can run only one scan task at a time on a specific AV-enabled file system.
ibrix_caseinsensitive Manages case insensitivity on a file system or directory. Description By default, IBRIX 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. IBRIX 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 a 9720/9730 system, or unregister a chassis. Description The chassis in a 9720/9730 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 SMB 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 IBRIX software and should not be run directly. Description SMB is the file-sharing protocol used in Windows-based networks. Use the ibrix_cifs command to configure SMB 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 SMB. Description The ibrix_cifsconfig command configures global settings for SMB operations. The settings apply to all SMB shares configured in the cluster. Synopsis Configure SMB 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 30 IBRIX software commands
ibrix_cifsmonitor Monitors SMB services on file serving nodes. Description The ibrix_cifsmonitor command configures monitoring for the following SMB 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 SMB shares. Description The ibrix_cifsperms command adds a user or group to an SMB 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 an SMB share managed by the MMC cannot be modified by the IBRIX management console GUI or CLI.
ibrix_client Performs management and control procedures for IBRIX 9000 clients. Description ibrix_client enables the following IBRIX 9000 client procedures: • Registers a Linux 9000 client with a Fusion Manager. Clients that are to communicate with multiple management consoles must be registered on each console. (To register a Windows 9000 client, use the Windows 9000 client GUI.) • Sets a preferred user interface for a 9000 client. To prefer a user interface for a host group, 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 a 9000 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. Use -O to synchronize OS tunings.
Option Description • sysctl.vm.min_free_kbytes: Forces the virtual machine to keep a minimum number of KB free. The default value is 5742. • sysctl.vm.dirty_ratio: The percentage of total memory reached when a task will write dirty data. The default value is 40. • sysctl.vm.dirty_background_ratio: The percentage of total memory reached when the pdflush daemon will write dirty data. The default value is 10. • sysctl.kernel.
Description This command collects relevant information from IBRIX 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 IBRIX commands.
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 40 Option Description -C options Configures ibrix_collect. -a YES/NO Enables or disables automatic collection at the time of a system crash.
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 9000 Storage 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_crrhealth Checks the health of active remote replication tasks and generates reports.
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. 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 IBRIX 9000 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: 9730_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 IBRIX 9000 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.
Remove the access entry for a client: 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 a 9000 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.
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.
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 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 skippedCyclesBeforeClientFailure Sets the number of health reporting cycles that must fail before a client is considered to have failed. Value is an integer. Default: 120. 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.
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, disable, or display data retention, auditing, and Express Query settings on a file system. • Enable or disable export control on a file system.
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.
Other options for creating a file system The following options can be used with any of the create commands: -a Create a mount point with the same name as the file system and then mount the file system. -q Enable quotas on the file system. -t TIERNAME Assign the file-system segments to the specified tier. -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 file system is extended using the physical volumes in PVLIST. To extend the file system with tiered segments, include the -t option. If tiering rules are already defined for this file system, -t is required. Audit log expiration policy Use the following commands to manage the audit log expiration policy: Display the audit log expiration policy for one or all file systems: ibrix_fs -K [-f FSNAME] Displays the audit log expiration policy for one or all file systems.
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 -A -f fsname -oa audit_mode=on,all=on The same command without all=on enables auditing, but only for those events and event groups that have already been set to on. Display audit settings for one or all file systems: ibrix_fs -A [-f FSNAME] List all audit options (events and event groups): ibrix_fs –A –h Mark a bad segment Mark segment number(s) bad in the specified file system: ibrix_fs -B -f FSNAME {-n BADSEGNUMLIST | -s BADLVLIST} The -n option uses segment numbers to indicate bad segments.
Option Description -H HOSTLIST A list of one or more host names. -i Reports on one or more file systems, and optionally on their segments. -K [-f FSNAME] Displays the audit log expiration policy for one or all file systems. -k TIME -f FSNAME The command lets you modify the audit log expiration policy for a file system. In this instance, the name of the file system is FSNAME. In this instance, the name of the file system is FSNAME. The audit log events are kept by default for 45 days.
Option Description -s LVLIST A list of one or more logical volume (segment) names, expressed as a comma-separated list (for example, ilv1,ilv2,ilv3) or a range list (for example, ilv[1-3]). -t TIERNAME Specifies the tier to which segments are assigned when creating or expanding a file system. -w Disables 32-bit mode. -x When used with -i, omits segment details from the output report. -Y [-f FSNAME] Displays the archiving/auditing synchronizer scheduled time for one or all file systems.
ibrix_fs_ops Manages directory tree quota entries. IMPORTANT: The ibrix_fs_ops command is deprecated in the IBRIX 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 IBRIX 9000 clients. The policies define the following: • Preferred segments. The segments where a file serving node or 9000 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 IBRIX 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. Should be used only on the advice of HP support.
To set the policy for files, omit the -R option. To set the policy for directories, include the -R option. Reset the specified hosts or host groups 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 host groups: 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).
Disable 32-bit compatibility mode: ibrix_fs_tune -c -d -f FSNAME Options Option Description -N NFS readahead Specifies the number of KB that IBRIX 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 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 IBRIX 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 IBRIX high availability features are configured for file serving nodes.
Options 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. -w WWNN or WWNNLIST An HBA’s worldwide node name or a list of such names, specified as 16 hex digits grouped into eight dot-separated pairs (for example, 20.00.
ibrix_health Generates health reports for cluster components and IBRIX 9000 clients. Description The ibrix_health command includes options specific to 9720/9730 systems and other options for file serving nodes and IBRIX 9000 clients. For 9720/9730 systems, ibrix_health generates a detailed or summary health report for storage, chassis, or servers registered to a chassis.
-t SCRIPTNAMELIST: Runs the specified scripts and include them in the health report. Display a detailed health report for file serving nodes or IBRIX 9000 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 IBRIX 9000 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 IBRIX 9000 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 host groups. Description A host group is a named set of IBRIX 9000 clients. Host groups provide a convenient way to centrally manage clients. Group-wide procedures include: • Mounting file systems. • Preferring or unpreferring a network interface for a host group. You can locally override the preference on individual IBRIX 9000 clients with ibrix_lwhost. • Tuning host parameters. • Setting allocation policies.
Add a domain rule to a host group: ibrix_hostgroup -a -g GROUPNAME -D DOMAIN Delete one or more host groups from a host group tree: ibrix_hostgroup -d -g GROUPLIST Prefer a network interface for communication from a host group to a destination host: ibrix_hostgroup -n -g HOSTGROUP -A DESTHOST/IFNAME To prefer a network interface for all IBRIX 9000 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 IBRIX 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. NOTE: The file system must be mounted when you add the share.
List StoreAll REST API (also known as Object API) peer shares: ibrix_httpshare -l -o List the valid settings for a share: ibrix_httpshare -L Activate the WebDAV feature: ibrix_httpshare –S "davmethods=true" 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.
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 -S SETTINGLIST Specifies the settings that are to be applied to a virtual host. Use a comma to separate the settings, and enclose the settings in quotation marks, such as “sslcert=name,...”. To see a list of available settings for the vhost, use ibrix_httpvhost -L. -a VHOSTNAME Adds an HTTP virtual host. -c PROFILENAME Specifies a configuration profile. -d Deletes an HTTP virtual host. -i Displays information about HTTP virtual hosts. -l Lists HTTP virtual hosts.
ibrix_ldapconfig Configures LDAP as the primary user authentication method for SMB shares. Description The ibrix_ldapconfig command configures LDAP as the primary authentication method for users accessing SMB shares on an IBRIX 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 9000 Storage File System User Guide. LDAP authentication cannot be used with Active Directory.
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 IBRIX server. This can be any string that identifies the IBRIX host, such as IBRIX. -p LDAPBINDDNPASSWORD The password associated with the LDAP Bind DN. -v The certificate CN value (for example, centralldap.it.enxt.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 SMB shares, you can configure LDAP ID mapping as a secondary lookup source. This method allows the system to read SMB 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 IBRIX software license. Description ibrix_license lists the contents of the license file, which controls the operation of an IBRIX cluster. Synopsis Display the license contents: ibrix_license -i In the output, “Segment Server” refers to file serving nodes. Options Option Description -i Lists license contents. -? Shows the usage for this command.
ibrix_localgroups Manages local group accounts for SMB or HTTP access. Description If Local User authentication is configured for SMB 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 SMB or HTTP access. Description If Local User authentication is configured for SMB 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 IBRIX 9000 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). IBRIX 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 IBRIX 9000 clients the mount intention is stored in the Fusion Manager.
Options Option Description -O MOUNTOPTIONS Client mount options. The values for the -O option are: • atime: Update the inode access time when the file is accessed. NOTE: If you do not specifically set atime as an option, noatime is set instead (which means the inode access time is not updated when the file is accessed). There is not an option to specifically set noatime as an option. • dirsync: Ensures that all directory updates within the file system are done synchronously.
ibrix_mountpoint Creates and deletes mount points. Description The ibrix_mountpoint command immediately creates or deletes the specified mountpoint on file serving nodes and IBRIX 9000 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 mount points on all file serving nodes, IBRIX 9000 clients, and host groups, omit all options. To list mount points for certain file serving nodes and IBRIX 9000 clients, include only the HOSTLIST option. To list mount points for certain host groups, include only the GROUPLIST option. To list all file serving nodes, IBRIX 9000 clients, and host groups for a specific mountpoint, include only the -m MOUNTPOINTLIST option. Options Option Description -c Creates 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 9000 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 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 IBRIX 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 (9320 systems), use the ibrix_vs command to register the MSA. The chassis in 9720/9730 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. IBRIX 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 IBRIX cluster.
Option Description -f Includes free physical volumes only. -h HOSTLIST A list of one or more hosts. -i Lists detailed information about physical volumes. -l Lists physical volume information on hosts. -o FILTERDEVLIST Storage device names or the keywords allow_partitions, ata, loop, mpath, or powerpath. -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 IBRIX 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.
Option Description -o Specifies the output format (CSV or PDF). -s Scans the file system and collects data for reports. -? Shows the usage for this command.
ibrix_reten_adm The ibrix_reten_adm command does the following: • Manages retained and WORM files in a file system or directory enabled for data retention. • Enables data retention features for file systems created with IBRIX version 6.0 or earlier. IMPORTANT: Do not use the ibrix_reten_adm command on a post-6.1.1 file system that is not enabled for data retention, except in the case of upgrading a pre-6.1.1 file system as described in Upgrade a pre–6.1.
find /ibrixFS/mydir -type d -exec ibrix_reten_adm -h -f ibrixFS -P {}/*,{}/.??* \; 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.
Options Option Description -P Specifies a path to one or more files. The path can be either absolute or relative to the mountpoint of the file system. -c Removes the retention time for one or more files. -d Deletes retained files. -e expire_time Resets the expiration time for retained files. -fFSNAME Specifies a file system. -h Sets a legal hold on retained or WORM files. -l Lists retention attributes for files. -r Removes a legal hold on retained or WORM files.
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 IBRIX 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 file system 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 IBRIX 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.
Options Option Description -c yes|no Indicates whether community names or passwords are encrypted in the configuration file. Default: no encryption. When this option is set to yes, unencrypted community strings and passwords are encrypted and saved to a file when the agent starts. To make changes, replace the entry in the file with a new, unencrypted value. This value will automatically be encrypted when the agent restarts.
ibrix_snmpgroup Manages SNMP groups. Description A group defines the access control policy on managed objects for one or more users. All users must belong to a group. Users and groups exist only in SNMPv3. Groups are assigned a security level, which enforces use of authentication and privacy, and reference views to define the set of MIB data that group members can access. The default view, used when a read or write view is not specified, is excludeAll.
See also ibrix_snmpuser, ibrix_snmpview 152 IBRIX software commands
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. IBRIX 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.
Options Option Description -c Creates a trapsink. -d Deletes a trapsink. -h HOSTNAME or HOSTLIST Identifies a host, by name or IP address, where a trapsink is created or updated. Trapsinks can be deleted or listed on multiple hosts by specifying a HOSTLIST (use commas to separate the hosts). -j MD5 | SHA Specifies the user authentication algorithm to use. The default is MD5. -k AUTHORIZATION_PASSWORD Specifies the user authentication password. Passwords must contain at least eight characters.
ibrix_snmpuser Creates, updates, or deletes SNMPv3 users. Description Names the user whose keys were used to authenticate and encrypt packets. Synopsis Create a v3 user in a group: ibrix_snmpuser -c -n USERNAME -g GROUPNAME [-j {MD5|SHA}] [-k AUTHORIZATION_PASSWORD] [-y {DES|AES}] [-z PRIVACY_PASSWORD] Authentication and privacy settings are optional. An authentication password is required if the group has a security level of either authNoPriv or authPriv.
See also ibrix_snmpgroup, ibrix_snmpview 156 IBRIX software commands
ibrix_snmpview Adds entries to or deletes entries from the SNMP MIB view. Description A MIB view consists of a collection of view subtrees that can be included or excluded from the view. Each view subtree is defined by a combination of OID subtree and a bit string mask. The management console automatically creates the excludeAll view, which blocks access to all OIDs. This view cannot be deleted. It is the default read and write view if a view is not specified for a group with the ibrix_snmpgroup command.
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 158 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, IBRIX 9000 clients, and host groups. You can also locally unmount a file system from Linux 9000 clients with ibrix_lwumount. File serving nodes immediately unmount a file system. For IBRIX 9000 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 IBRIX 9000 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 9300/9320 systems, you will need to identify and discover vendor storage resources before they can be used to create block snapshots.
Option Description -n STORAGENAME or STORAGENAMELIST Storage system name or a list of system names. -r Registers storage. –s suffix Suffix. -t TYPE Storage system type (EVA, Lefthand, MSA, 3PAR, or EqualLogic). -? 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 mount points.
Options 172 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.
MDexport Saves custom metadata for a file system. Description Use the perl script MDExport to save, or export, metadata that is stored only in the Express Query data base and not in the files themselves. You can then use the file later on to import the metadata with the GUI or the MDimport command. Synopsis Save custom metadata to a CSV file: MDExport.pl [--help|?] --dbconfig --database --outputfile [--user ] [--verbose] Use perl to invoke MDexport.
MDimport Imports custom metadata to an Express Query database. Description The MDImport tool imports a CSV file containing custom or audit metadata into a new Express Query database. Synopsis Import metadata to a file system: MDImport -f -n -t The following command imports custom file system metadata: MDimport –f newIbrixFs -t custom -n /home/mydir/save.csv The next command imports audit metadata: MDimport –f target -t audit -n simple_report_for_source_at_1341513594723.
upgrade60.sh Upgrades pre-6.0 file systems for software snapshots. Description To support software snapshots, the inode format was changed in the IBRIX 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 9000 clients and file serving nodes The commands in this chapter are run directly on Linux 9000 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 IBRIX 9000 clients.
ibrix_lwhost Tunes Linux 9000 clients. This command can be run on IBRIX 9000 clients only. Description Use ibrix_lwhost to set Linux 9000 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 9000 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 9000 client. This command can be run on IBRIX 9000 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 a 9000 client. If the Export Control feature is not enabled, use this command to mount a file system on a 9000 client.
ibrix_lwumount Detaches a file system from a Linux 9000 client. This command can be run on IBRIX 9000 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 9000 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 IBRIX 9000 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 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 9000 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 9000 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. SMB Server Message Block. The protocol used in Windows environments for shared folders. 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.
Index A Active Directory configure for SMB, FTP, or HTTP, 15 configure on Windows 9000 clients, 7 LDAP ID mapping as secondary lookup source, 105 agile Fusion Manager, 60 allocation policy, 74 Antivirus support configure, 18 enable or disable, 18 quarantine, 20 scans, start, stop, or view, 22 schedule updates of definitions, 17 statistics, 17 audit reports, 12 authentication Active Directory, 15 LDAP , 103 LDAP ID mapping, 105 Local Users and Groups, 15 automated snapshots, hardware, 171 C case-insensitive
manage authentication, 15 shares, 82 SSL certificates, 24 Fusion Manager tuning parameters, 62 H hardware registered chassis and server information, 26 HBAs manage, 86 port monitoring, 86 health check sets, 90 health checks, 88 help obtaining, 185 high availability, configure, 84 host groups, manage, 94 hosts, activity snapshots, 182 HP technical support, 185 HP websites, 185 HTTP service configuration profile, 97 manage authentication, 15 shares, 99 SSL certificates, 24 virtual host, 101 I IBRIX 9000 cli
reports, 137 validation scan, 48 S segments activity snapshots, 182 evacuate data to other segments, 53 preferred, 74 rebalance files, 135 servers, manage, 142 shell tasks, 145 SMB add or delete shares, 27 global settings, 29 manage authentication, 15 monitor services, 31 user and group permissions, 32 SMB signing, SMB, 29 snapshots, hardware allocation policy, 169 automated, 171 configure, 169 create or delete, 169 snapshots, software create or delete, 146 enable snap tree, 146 reclaim file system space,