HP StoreAll Storage CLI Reference Guide Abstract This document describes commands provided with StoreAll software. It is intended for system administrators managing 9300 Storage Gateway, 9320 Storage, X9720 Storage, and 9730 Storage. For the latest StoreAll guides, browse to http://www.hp.com/support/StoreAllManuals.
© Copyright 2009, 2013 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 StoreAll software commands........................................................................................6 Command syntax......................................................................................................................6 Command messages.................................................................................................................
ibrix_httpvhost......................................................................................................................108 ibrix_ldapconfig...................................................................................................................110 ibrix_ldapidmapping.............................................................................................................112 ibrix_license ..............................................................................................
Subscription service..............................................................................................................192 5 Documentation feedback.........................................................................193 Glossary..................................................................................................194 Index.......................................................................................................
1 General CLI information Executing StoreAll software commands The commands in “StoreAll 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 StoreAll Linux clients and file serving nodes” (page 184) can be executed on file serving nodes and/or StoreAll Linux clients. Any user can run these commands. All commands are run from the working directory /usr/local/ibrix/bin. Command syntax Names.
2 StoreAll software commands This chapter lists commands used to configure and manage StoreAll 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 StoreAll 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.
correct. When a database is in a MIF state, all changes to files in this file system continue to be logged, but they are not processed into the database tables. The contents of the database are not updated until you correct the problem in the database. If you are not sure how to correct the problem, contact HP support. After you manually correct the problem that caused the MIF state, run the ibrix_archiving -C [FSNAME] command to re-enable the use of this database.
Option Description -i Displays the status of the Express Query system. -l Lists file systems registered to Express Query. -r Restarts the Express Query daemons. -s Starts the Express Query daemons. -t timeout secs Sets the time (in seconds) to wait for Express Query to stop gracefully. -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 Auditing audit_event_deleted Audited events were removed from the audit log, either by scheduled expiration or explicitly by the system or the user 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 w
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 a StoreAll 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.
This policy determines how targeted file operations are handled when an external virus scan engine is not available. The policies are: • A — Allow. All operations triggering scans are allowed to run to completion. • D — Deny. All operations triggering scans are blocked and returned with an error. Update the protocol-specific Antivirus scan setting: ibrix_avconfig -u -k PROTOCOL -G O|C|B The -G option specifies the policy that determines which file operations trigger AV scans.
Option Description -S Adds or removes an external Antivirus scan engine. -a Adds a new item to the Antivirus configuration. -d Disables Antivirus on specific file systems. -e Enables Antivirus on specific file systems. -f FSLIST Specifies file system names, separated by commas. -g Updates the Antivirus unavailable policy. -k PROTOCOL Specifies a file sharing protocol for scan policies. -l Lists the Antivirus configuration.
To obtain the corresponding filename for the hash name, enter the following command if you are not in the directory containing the file object: getfattr -n "user.bucket_mode_key" /fs1/dir1/2004/share1container/33b/32b/ce1be0ff4065a6e9415095c95f25f47a633cef2b In this instance /fs1/dir1/2004/share1container/33b/32b/ce1be0ff4065a6e9415095c95f25f47a633cef2b is the absolute path containing the hash name.
ibrix_avscan Manages Antivirus scans on a StoreAll 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, StoreAll 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.
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. StoreAll software supports PEM certificates.
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/9730 system, or unregister a chassis. Description The chassis in an X9720/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 StoreAll 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.
List valid SMB share settings: ibrix_cifs -L 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 StoreAll 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 StoreAll management console GUI or CLI.
ibrix_client Performs management and control procedures for StoreAll clients. Description ibrix_client enables the following StoreAll client procedures: • Registers a StoreAll Linux client with a Fusion Manager. Clients that are to communicate with multiple management consoles must be registered on each console. (To register a Windows StoreAll client, use the Windows StoreAll client GUI.) • Sets a preferred user interface for a StoreAll client.
When the command has completed, the default cluster interface will be used to communicate from the client to the DESTSERVER. 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 StoreAll client. -d Deletes a client from the configuration database. The -d option does not unmount the file system locally. To unmount the file system, use the ibrix_lwumount command.
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[,...
Remove an allocated address: 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.net.core.rmem_max: The maximum socket (in bytes) for the receive buffer size. The default value is 131071. • 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.
ibrix_collect Collects information from StoreAll cluster nodes for diagnosis by HP Support. Description This command collects relevant information from StoreAll 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 StoreAll commands.
Delete all data collection sets: ibrix_collect -d -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 Option Description -C options Configures ibrix_collect.
Creating an add-on script To create an add-on script: 1. Add-on Scripts names should be in the defined format. This should be strictly followed as _.sh. When you provide the version number, remove the period between the first and second digit of the version number. [root@host2 /]# ibrix_version -l Fusion Manager version: 6.3.
Running an add-on script To run an add-on script: 1. Verify that the add-on script is saved under the following location: /usr/local/ibrix/ibrixcollect/ibrix_collect_add_on_scripts/ The ibrix_collect command only runs add-on scripts saved in this location. 2. Enter the ibrix_collect command: ibrix_collect -c -n addOnCollection In this instance addOnCollection is the collection name. The output of the add-on scripts is included into the final tar collection along with other logs and command outputs.
5. A directory with the host name is extracted. The output of the add-on script is found in the //logs/add_on_script/local/ibrixcollect/ ibrix_collect_additional_data Find the directory containing the host name by entering the ls -l command, as shown in the following example: [root@host2 archive]# ls -l The following is the output of the command: total 5636 -rw-r--r-- 1 root root 2021895 Dec 20 12:41 addOnCollection.
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 StoreAll Storage File System User Guide.
-R Bypass retention compatibility checking. -e Use the -e option to provide a comma separated list of file and directory exclude patterns, which should be excluded during replication. Enter up to 16 patterns per task. Enclose the list of patterns in double-quotes. The syntax of the patterns should be proper.
You can limit the output to a specific file system or host name. When the command is run from a target, the -C argument identifies the source cluster and is required. It is optional when the command is run from the source cluster itself. Print detailed information about active replication tasks: ibrix_crr -i [-f SRC_FSNAME] [-h HOSTNAME] [-C SRC_CLUSTERNAME] You can limit the output to a specific file system or host name. The command can be run from the source or target cluster.
See also ibrix_crr_export, ibrix_crr_nic, ibrix_cluster ibrix_crr 47
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.
Option Description -s Performs a validation scan. -? Shows the usage for this command.
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 StoreAll 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 HP StoreAll Storage Administrator Guide for your system.
ibrix_exportfs Maintains the list of NFS-exported file systems and specifies file system access for StoreAll 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 StoreAll 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.
Unregister a Fusion Manager that has been uninstalled: ibrix_fm -u Display mode information about the management consoles in the cluster: ibrix_fm -i NOTE: If the Fusion Manager was not installed in an agile configuration, the output will report FusionServer: fusion manager name not set! (active, quorum is not configured).
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 2 Fusion Manager configuration tuning 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. clearSegmentUnavailableUponFailover Sets how the Fusion Manager handles an unavailable segment after failover. The following values are: • true (default value). Makes segments available after failover.
Table 2 Fusion Manager configuration tuning options (continued) Option name Description minFailbackInterval The minimum number of seconds that must elapse before attempting another failback. Value is an integer. Default: 60 sec. nbdPortsLimit The maximum number of network block device ports allowed. Range: 0-128. Default: 32 ports. nbdTimeout The maximum network block device timeout. Range: 10-300. Default: 60 sec. quotaMonitorLoopInterval Quota monitor loop interval. Value is an integer.
Option Description -c Selects the logging component. -l Lists configuration tuning options. -n OPTIONS Specifies a list of comma-separated options in the format option1,option2 and so on. -o OPTIONLIST Specifies a list of comma-separated option/value pairs in the format option1=value1,option2=value2 and so on. -v Sets the logging level. -? Shows the usage for this command.
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.
You can also enable Express Query and auditing when you create a file system: • Express Query: use -T • Auditing: use -oa OPTION1=VALUE1[,OPTION2=VALUE2,...] The -oa option specifies the file system events that are to be audited. See ibrix_audit_reports for the supported events.
To extend the file system with LVLIST representing tiered segments, include the -t option. If tiering rules are already defined for this file system, -t is required. Extend a file system using the specified segment/owner pairs: ibrix_fs -e -f FSNAME -S LV1:HOSTNAME1,LV2:HOSTNAME2,... [-t TIERNAME] For example, to add logical volume ilv1 (owned by s1.mycompany.com) to file system ifs1: ibrix_fs -e -f ifs1 -S ilv1:s1.mycompany.com To extend the file system with tiered segments, include the -t option.
The archiving/auditing synchronizer functionality can also be set by modifying the time value for Retention Expiration and Autocommit on the Data Retention tab for the Modify Filesystem Properties window. Delete a file system Delete the specified file systems: ibrix_fs -d -f FSLIST [-R] If data retention is enabled on the file system, include the -R option in the command. Migrate segment ownership Use the following commands to migrate ownership of segments to another file serving node.
The audit_mode option enables or disables auditing as a whole, without affecting the on/off state of the individual events or event groups. Setting this option to off turns off all auditing, and setting it to on enables auditing for those events and event groups that are already set to on. The all option sets the state of all events and event groups to on or off, but it does not change the overall on/off state of auditing as defined by audit_mode.
Options Option Description -A Enables, disables, or displays audit settings, when applied to an existing file system. -B Marks bad segments. -C Enables export control. -D When used with -q, disables quotas on the named file system. When used with -C, disables export control on a named file system. When used with -T on an existing file system, disables Express Query on that file system. -E When used with -q, enables quotas on the named file system.
Option Description -l Lists file-system details. -m Migrates a file system or file-system segments to a new host. -o OPTION=VALUE Specifies file-system parameters; written as option=value pairs. Pairs valid in the current version of StoreAll software are: 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.
ibrix_fs_ops Manages directory tree quota entries. IMPORTANT: The ibrix_fs_ops command is deprecated in the StoreAll 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 StoreAll clients. The policies define the following: • Preferred segments. The segments where a file serving node or StoreAll 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 StoreAll 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.
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 StoreAll 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.
Options Option Description -L Lists default profile settings. -R Restores the FTP configuration on a node that has been recovered with the QuickRestore DVD. -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.
ibrix_ftpshare Manages FTP shares. Description An FTP share provides access to data on StoreAll 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.
List FTP shares associated with a specific file system: ibrix_ftpshare -l -f FSNAME [-v level] 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.
ibrix_haconfig Reports whether StoreAll 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 StoreAll clients. Description The ibrix_health command includes options specific to X9720/9730 systems and other options for file serving nodes and StoreAll clients. For X9720/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 StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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.
Table 3 Adding an HTTP share (continued) Type of HTTP share to add Enter the following command on one line amount of objects in a container created and each object is assigned object key which is mapped to a relative file system path name. 1 The parameter userlist is optional, and it is not necessarily needed for the StoreAll REST API. All the other listed arguments are required for the StoreAll REST API.
Option Description -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. -a SHARENAME Adds an HTTP share. -c PROFILENAME Specifies a configuration profile. -d Deletes 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.
Options Option Description -I Specifies the IP addresses/ports assigned to this virtual host. IP-Address:Port -L Lists valid HTTP virtual host settings. -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.
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 a StoreAll 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 StoreAll Storage File System User Guide. LDAP authentication cannot be used with Active Directory.
Option Description -n NETBIOS Specifies the NetBIOS name of the StoreAll server. This can be any string that identifies the StoreAll host, such as StoreAll. -p LDAPBINDDNPASSWORD The password associated with the LDAP Bind DN. -v The certificate CN value (for example, centralldap.it.enxt.net). -w LDAPWRITEOU The OU (organizational unit) on the LDAP server to which configuration entries can be written. This OU must be pre-provisioned at the LDAP server end.
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 StoreAll software license. Description ibrix_license lists the contents of the license file, which controls the operation of a StoreAll cluster. Synopsis Display the license contents: ibrix_license -i In the output, “Segment Server” refers to file serving nodes. Options 114 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.
Options 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.
The following example uses a relative date: 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.
Example 2: This example modifies this rule to limit the files being migrated to two types of graphic files. The or expressions are enclosed in parentheses, and the * wildcard character is used to match file name patterns. # ibrix_migrator -A -f ifs2 -r 'mtime older than 1 month and ( name = "*.jpg" or name = "*.gif" )' -S T1 -D T2 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_mount Mounts a file system on file serving nodes and StoreAll 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). StoreAll 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 StoreAll clients the mount intention is stored in the Fusion Manager.
The following command mounts file system ifs1 on host group 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 host group finance read-write access, but limit the root user to RO access: /bin/ibrix_mount -f ifs1 -o RW root_ro -g finance -m /ifs1 Options Option Description -O MOUNTOPTIONS Client mount options.
ibrix_mountpoint Creates and deletes mount points. Description The ibrix_mountpoint command immediately creates or deletes the specified mountpoint on file serving nodes and StoreAll 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 mount points for certain file serving nodes and StoreAll 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, StoreAll clients, and host groups for a specific mountpoint, include only the -m MOUNTPOINTLIST option. Options Option Description -c Creates a mountpoint. -d Deletes a mountpoint. -e Modifies mount options on the specified mountpoint. -g GROUPLIST Specifies a list of host groups.
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 StoreAll 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 134 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 StoreAll 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 X9720/9730 systems are registered automatically.
Display the Phone Home configuration: ibrix_phonehome -l [-p { server | storage | chassis | trapsink | entitlement } ] To obtain details about servers, storage, chassis, or trapsinks, use the -p option with the corresponding keyword. Use the entitlement keyword to obtain statistics about the entitlement.
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. StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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.
The following script includes files beginning with a dot, such as .this. (This includes file uploaded to the file system, not file system files such as the .archiving tree.) 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.
Restrictions for rename options For file systems that were created in a release earlier than 6.0 but have not been upgraded, StoreAll software can preserve all name space data in snapshots but cannot preserve file data for objects (files). To help prevent “hybrid snap trees,” in which a snap tree contains objects with the old format, restrictions have been implemented on rename operations. The following restrictions apply to hybrid file systems: • Only directories created in version 6.
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 StoreAll 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 StoreAll 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 ibrix_snmpgroup 159
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. StoreAll 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 ibrix_snmpuser 163
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 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, StoreAll clients, and host groups. You can also locally unmount a file system from StoreAll Linux clients with ibrix_lwumount. File serving nodes immediately unmount a file system. For StoreAll 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 StoreAll 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 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.
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 StoreAll 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 StoreAll Linux clients and file serving nodes The commands in this chapter are run directly on StoreAll Linux 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 StoreAll clients.
ibrix_lwhost Tunes StoreAll Linux clients. This command can be run on StoreAll clients only. Description Use ibrix_lwhost to set StoreAll Linux 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 StoreAll 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 StoreAll Linux client. This command can be run on StoreAll 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 StoreAll client. If the Export Control feature is not enabled, use this command to mount a file system on a StoreAll client.
ibrix_lwumount Detaches a file system from a StoreAll Linux client. This command can be run on StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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 StoreAll 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 Name Service. WWN World Wide Name.
Index A Active Directory configure for SMB, FTP, or HTTP, 15 configure on Windows StoreAll clients, 7 LDAP ID mapping as secondary lookup source, 112 add-on scripts ibrix_collect, 40 agile Fusion Manager, 65 allocation policy, 80 Antivirus support configure, 18 enable or disable, 18 getfattr, 20 quarantine, 20 scans, start, stop, or view, 22 schedule updates of definitions, 17 statistics, 17 audit reports, 12 authentication Active Directory, 15 LDAP , 110 LDAP ID mapping, 112 Local Users and Groups, 15 auto
upgrade to allow autocommit, 146 view information, 73 FTP service configuration profile, 86 manage authentication, 15 shares, 88 SSL certificates, 24 Fusion Manager tuning parameters, 67 H hardware registered chassis and server information, 26 HBAs manage, 92 port monitoring, 92 health check sets, 96 health checks, 94 help obtaining, 192 high availability, configure, 90 host groups, manage, 100 hosts, activity snapshots, 189 HP technical support, 192 HP websites, 192 HTTP service configuration profile, 103
activity snapshots, 189 evacuate data to other segments, 58 preferred, 80 rebalance files, 142 servers, manage, 149 shell tasks, 152 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, 176 automated, 178 configure, 176 create or delete, 176 snapshots, software create or delete, 153 enable snap tree, 153 reclaim file system space, 155 upgrade file systems, 182 SNMP agent, 156