- DL manuals
- IBM
- Storage
- XIV STORAGE SYSTEM
- User Manual
IBM XIV STORAGE SYSTEM User Manual - Contents
Contents
Chapter 1. Introduction . . . . . . . . 1
Purpose and Scope .
.
.
.
.
.
.
.
.
.
.
. 1
Intended Audience .
.
.
.
.
.
.
.
.
.
.
. 1
Related Documentation .
.
.
.
.
.
.
.
.
.
. 1
Documentation Conventions .
.
.
.
.
.
.
.
. 2
Abbreviations .
.
.
.
.
.
.
.
.
.
.
.
.
. 2
Parameter Definitions .
.
.
.
.
.
.
.
.
.
. 2
Accessibility features for IBM XIV Storage System .
. 2
Chapter 2. Host and Cluster
Management . . . . . . . . . . . . . 5
Adding a Host to a Cluster
.
.
.
.
.
.
.
.
. 6
Creating a Cluster
.
.
.
.
.
.
.
.
.
.
.
. 7
Deleting Clusters .
.
.
.
.
.
.
.
.
.
.
.
. 7
Listing Clusters
.
.
.
.
.
.
.
.
.
.
.
.
. 8
Removing a Host from a Cluster.
.
.
.
.
.
.
. 9
Renaming Clusters .
.
.
.
.
.
.
.
.
.
.
. 10
Adding a Port to a Host .
.
.
.
.
.
.
.
.
. 10
Defining a New Host .
.
.
.
.
.
.
.
.
.
. 11
Deleting a Host .
.
.
.
.
.
.
.
.
.
.
.
. 13
Listing Hosts .
.
.
.
.
.
.
.
.
.
.
.
.
. 14
Listing Ports .
.
.
.
.
.
.
.
.
.
.
.
.
. 15
Removing a Port from a Host .
.
.
.
.
.
.
. 16
Renaming a Host
.
.
.
.
.
.
.
.
.
.
.
. 17
Updating a Host Definition .
.
.
.
.
.
.
.
. 18
Mapping a Volume to a Host or Cluster .
.
.
.
. 19
Listing the Mapping of Volumes to Hosts or
Clusters
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Setting the Special Type of Hosts or Clusters .
.
. 23
Listing Hosts/Cluster to which a Volume is Mapped 23
Unmapping a Volume from a Host or Cluster .
.
. 24
Set the Default Idle Time for Unmapping a Volume
26
Creating a Performance Class .
.
.
.
.
.
.
. 26
Deleting a Performance Class .
.
.
.
.
.
.
. 27
Renaming a Performance Class .
.
.
.
.
.
.
. 28
Listing Details on Performance Classes .
.
.
.
. 29
Adding a Host to a Performance Class .
.
.
.
. 29
Removing a Host from its Performance Class .
.
. 30
Setting the Rate for a Performance Class.
.
.
.
. 31
Listing Host Profiles
.
.
.
.
.
.
.
.
.
.
. 32
Updates the Host Profile .
.
.
.
.
.
.
.
.
. 33
Removes the Profile of the Specified Host .
.
.
. 34
Enable Host Profiler Functionality .
.
.
.
.
.
. 34
Disable Host Profiler Functionality
.
.
.
.
.
. 35
Chapter 3. Volume Management . . . . 37
Clearing Reservations of a Volume
.
.
.
.
.
. 37
Listing Reservation Keys .
.
.
.
.
.
.
.
.
. 38
Listing Volume Reservations.
.
.
.
.
.
.
.
. 39
Finding a Volume Based on a SCSI Serial Number
40
Copying Volumes .
.
.
.
.
.
.
.
.
.
.
. 42
Creating a Volume .
.
.
.
.
.
.
.
.
.
.
. 44
Deleting a Volume .
.
.
.
.
.
.
.
.
.
.
. 46
Formatting a Volume .
.
.
.
.
.
.
.
.
.
. 48
Listing Volumes .
.
.
.
.
.
.
.
.
.
.
.
. 49
Locking a Volume .
.
.
.
.
.
.
.
.
.
.
. 52
Renaming a Volume
.
.
.
.
.
.
.
.
.
.
. 53
Resizing a Volume .
.
.
.
.
.
.
.
.
.
.
. 54
Unlocking a Volume
.
.
.
.
.
.
.
.
.
.
. 58
Chapter 4. LUN Mapping Management
61
Chapter 5. Volume Snapshot
Management . . . . . . . . . . . . 63
Changing a Snapshot Deletion Priority .
.
.
.
. 63
Creating a Snapshot
.
.
.
.
.
.
.
.
.
.
. 64
Deleting a Snapshot
.
.
.
.
.
.
.
.
.
.
. 67
Duplicating a Snapshot
.
.
.
.
.
.
.
.
.
. 68
Formatting a Snapshot.
.
.
.
.
.
.
.
.
.
. 70
Listing Snapshot Information
.
.
.
.
.
.
.
. 71
Restoring a Volume from a Snapshot .
.
.
.
.
. 73
Chapter 6. Consistency Group
Management . . . . . . . . . . . . 77
Adding a Volume to a Consistency Group .
.
.
. 77
Creating Consistency Groups
.
.
.
.
.
.
.
. 81
Deleting a Consistency Group .
.
.
.
.
.
.
. 82
Listing Consistency Groups .
.
.
.
.
.
.
.
. 83
Removing a Volume from a Consistency Group .
. 84
Renaming Consistency Groups .
.
.
.
.
.
.
. 86
Suspend I/O Execution on Consistency Group
.
. 87
Resume I/O Execution
.
.
.
.
.
.
.
.
.
. 88
List Consistency Groups Pause I/O State
.
.
.
. 89
Creates a Cross-System Consistency Group .
.
.
. 90
Associates an Existing Consistency Group to a
Cross-System Consistency Group Definition
.
.
. 91
Removes an Existing Consistency Group from a
Cross-System Consistency Group Definition
.
.
. 93
Adds a Remote System Name to the Cross-System
Consistency Group Definition .
.
.
.
.
.
.
. 94
Removes a Remote System Name from a
Cross-System Consistency Group Definition
.
.
. 95
Lists Cross-System Consistency Group Definitions
Along With Contained Consistency Groups.
.
.
. 96
Retrieve The Names of Remote Systems Part of The
Specified Cross-System Consistency Group .
.
.
. 97
Deletes a Cross-System Consistency Group .
.
.
. 98
Lists Cross-System Consistency Group Definitions
99
Chapter 7. Snapshot Set Management
101
Snapshotting a Consistency Group .
.
.
.
.
. 101
Changing Snapshot Group Deletion Priority .
.
. 104
Deleting a Snapshot Group .
.
.
.
.
.
.
.
. 105
Disbanding a Snapshot Group .
.
.
.
.
.
.
. 106
Duplicating a Snapshot Group.
.
.
.
.
.
.
. 107
Formatting a Snapshot Group .
.
.
.
.
.
.
. 108
Listing Snapshot Groups
.
.
.
.
.
.
.
.
. 109
Locking a Snapshot Group .
.
.
.
.
.
.
.
. 111
Renaming a Snapshot Group .
.
.
.
.
.
.
. 112
iii
Summary of XIV STORAGE SYSTEM
Page 1
Version 11.4.X ibm xiv storage system user manual gc27-3914-05.
Page 2
The following paragraph does not apply to any country (or region) where such provisions are inconsistent with local law. International business machines corporation provides this publication “as is” without warranty of any kind, either express or implied, including, but not limited to, the implied w...
Page 3: Contents
Contents chapter 1. Introduction . . . . . . . . 1 purpose and scope . . . . . . . . . . . . 1 intended audience . . . . . . . . . . . . 1 related documentation . . . . . . . . . . . 1 documentation conventions . . . . . . . . . 2 abbreviations . . . . . . . . . . . . . . 2 parameter definitions . ....
Page 4
Restoring a consistency group from a snapshot group . . . . . . . . . . . . . . . . 113 unlocking a snapshot group . . . . . . . . 114 sets a snapshot group descriptor . . . . . . 115 returns the snapshot group's descriptor . . . . 116 chapter 8. Storage pool management 119 moving consistency groups...
Page 5
Chapter 13. Ibm hyper-scale mobility 247 creating an ibm hyper-scale mobility relation 247 activates the volume migration . . . . . . . 250 deactivates ibm hyper-scale mobility migration 251 aborts a defined or activated ibm hyper-scale mobility process . . . . . . . . . . . . 252 moves the ibm hype...
Page 6
Removing an ldap server definition . . . . . 375 running ldapsearch utility . . . . . . . . . 376 defining a new user . . . . . . . . . . . 377 deleting a user. . . . . . . . . . . . . 379 adding users to a user groups . . . . . . . 380 creating user groups . . . . . . . . . . 381 deleting a user gr...
Page 7: Chapter 1. Introduction
Chapter 1. Introduction reliable high-end storage systems are critical for the successful operation of businesses. The xiv grid storage platform is designed to guarantee secure, dependable, enterprise-grade data storage and access, straightforward and non-intrusive installation and upgrade and full ...
Page 8
Documentation conventions v notes are embedded in the text, as shown in the example below. Note: this is an example of a note. V code samples or output samples are documented in monospaced font. The text box for examples and output is framed around it. For example: – example: vol_rename vol=dbvolume...
Page 9
Keyboard navigation you can use keys or key combinations to perform operations and initiate menu actions that can also be done through mouse actions. You can navigate this publication and the information center from the keyboard by using the shortcut keys for your browser or screen-reader software. ...
Page 10
4 ibm xiv storage system user manual.
Page 11
Chapter 2. Host and cluster management the following sections describe the xiv command line interface (xcli) for host and cluster management. The sections are listed as follows: v cluster_add_host(adds a host to a cluster.) v cluster_create(creates a new cluster.) v cluster_delete(deletes a cluster....
Page 12
V host_luns_list (this command has been replaced by map_list_luns) adding a host to a cluster adds a host to a cluster. Cluster_add_host cluster=clustername host=hostname map=mapname parameters: name type description mandatory cluster object name name of the cluster to contain the host. Y host objec...
Page 13
Completion codes: v host_bad_name host name does not exist v cluster_bad_name cluster name does not exist v host_belongs_to_another_cluster host already belongs to another cluster v host_and_cluster_have_conflicting_mappings host mapping conflicts with cluster mapping v host_and_cluster_have_differe...
Page 14
Parameters: name type description mandatory cluster object name cluster to be deleted. Y this command deletes a cluster. All hosts contained in the cluster remain active and are not deleted. The special type of each host is set to the cluster's special type. The mapping of each host is set to the cl...
Page 15
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians disallowed removing a host from a cluster removes a host from a cluster. Cluster_re...
Page 16
Renaming clusters renames a cluster. Cluster_rename cluster=clustername new_name=name parameters: name type description mandatory cluster object name cluster to be renamed. Y new_name object name new name of cluster. Y this command renames the specified cluster. Access control: user category permiss...
Page 17
Only the following alphanumeric characters are valid: 0-9, a-f, a-f. In addition to the 16 characters, colons (:) may be used as separators in the 16 character port name. The iscsi initiator name may not exceed 253 characters and may not contain any blank spaces. Access control: user category permis...
Page 18
Name type description mandatory default iscsi_ chap_name string the host's chap name identifier n [none] iscsi_ chap_ secret string password of initiator used to authenticate to xiv when chap is enabled n [none] this command defines a host that will attach to the ibm xiv storage system. The name of ...
Page 19
User category permission read-only users disallowed technicians disallowed warnings: v iscsi_chap_name_and_secret_not_unique both iscsi chap name and secret are already used by another host. Are you sure you want to reuse those values? Completion codes: v host_name_exists host name already exists v ...
Page 20
Warnings: v are_you_sure_you_want_to_delete_host are you sure you want to delete host host? Completion codes: v host_bad_name host name does not exist listing hosts lists a specific host or all hosts. Host_list [ host=hostname ] [ perf_class=perfclassname ] parameters: name type description mandator...
Page 21
Id name default position cluster cluster 6 perf_class performance class 7 iscsi_chap_ name iscsi chap name n/a access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-onl...
Page 22
User category permission storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians disallowed removing a port from a host removes a port from a host. Host_remove_port host=hostname parameters: name type descripti...
Page 23
Remote port address is illegal or does not belong to the remote target v host_port_exists host with this port id already defined v max_ports_reached maximum number of ports already defined in the system v port_exists port is already defined v remote_max_virtual_hosts_reached maximum number of remote...
Page 24
Completion codes: v host_bad_name host name does not exist v host_name_exists host name already exists updating a host definition updates a host definition. Host_update host=hostname [ iscsi_chap_name=iscsichapname ] [ iscsi_chap_secret=iscaipass ] parameters: name type description mandatory default...
Page 25
Output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed warnings: v iscsi_chap_name...
Page 26
Parameters: name type description mandatory default host object name host name. N n/a cluster object name cluster name. N n/a vol object name volume name. Y n/a lun integer lun identifier. Y n/a override boolean override existing mapping. N no this command maps a volume to a host or to a cluster. It...
Page 27
V host_belongs_to_cluster host is part of a cluster v cluster_bad_name cluster name does not exist v volume_bad_name volume name does not exist v snapshot_is_internal internal snapshots cannot be mapped, modified or deleted. V volume_already_assigned mapping conflict: volume is already assigned v lu...
Page 28
Id name default position lun lun 1 volume volume 2 proxy proxy 3 size size 4 master master 5 serial serial number 6 locked locked 7 host host 8 example: e mapping_list host=tlib_host_lsihost034_fc10000006072d0190 output: lun volume size master serial locked number ----- -----------------------------...
Page 29
Setting the special type of hosts or clusters sets the special type of a host or a cluster. Special_type_set type= parameters: name type description mandatory host object name host name. N cluster object name cluster name. N type enumeration special map type. Y this command sets a special type for a...
Page 30
Parameters: name type description mandatory vol object name volume name. Y this command lists all the hosts and clusters to which a volume is mapped, as well as hosts that are part of a cluster and have host-specific mapping to the volume. The output list contains two columns: name of host/cluster a...
Page 31
The command fails if the specified host is contained in a cluster. In this case, the unmapping of the host must be performed through the cluster. The command does not fail when the volume is not mapped to the host/cluster. Access control: user category permission condition storage administrator allo...
Page 32
Set the default idle time for unmapping a volume sets the default idle time required for a volume before unmapping it unmap_vol_set_default_idle_time idle_time_seconds=idleseconds parameters: name type description mandatory idle_time_ seconds integer how many seconds the volume needs to be idle befo...
Page 33
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v perf_class_exists performance class already ex...
Page 34
Are_you_sure_you_want_to_delete_a_perf_class_ associated_with_ hosts deleting performance class performance class will remove the performance limits set for hosts associated with the performance class. Are you sure you want to delete performance class performance class? Completion codes: v perf_clas...
Page 35
Listing details on performance classes lists performance classes perf_class_list [ perf_class=perfclassname ] parameters: name type description mandatory default perf_class string name of a performance class. If left unspecified - all performance classes will be listed. N all performance classes. Th...
Page 36
Name type description mandatory host object name name of a host that will be added to the performance class y this command adds a host to a performance class. If the host is already associated to another performance class, it is removed from it. Example: perf_class_add_host perf_class=p1 host=h1 acc...
Page 37
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v host_bad_name host name does not exist v perf_...
Page 38
Perf_class_set_rate perf_class=p1 max_io_rate=1000 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion code...
Page 39
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed updates the host profile updates the host profile host_profile_set profile_...
Page 40
Removes the profile of the specified host removes the profile of the specified host host_profile_clear host=hostname parameters: name type description mandatory host object name the host name. Y removes the profile of the specified host example: xcli -u -c xiv1 host_profile_clear host access control...
Page 41
User category permission application administrator allowed security administrator disallowed read-only users disallowed technicians disallowed disable host profiler functionality disable host profiler functionality host_profiler_disable disable host profiler functionality example: xcli -u -c xiv1 ho...
Page 42
36 ibm xiv storage system user manual.
Page 43
Chapter 3. Volume management the following sections describe the xiv command line interface (xcli) for volume management. Other commands that are relevant to this topic are: listing volumes, renaming a volume, moving a volume between storage pools . See also: v volume snapshot management v consisten...
Page 44
Reservation_clear vol=vol1 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_bad_name volume...
Page 45
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians disallowed completion codes: v volume_bad_name volume name does not exist listing v...
Page 46
Id name description default position persistent_ reservation_ type persistent reservation type n/a 5 access_type persistent access type n/a 6 reserving_ initiator_uid initiator uid uid of reserving host 7 pr_generation pr generation n/a 8 reservation_ age reservation age n/a 9 access control: user c...
Page 47
Id name default position proxy proxy n/a capacity capacity (blocks) n/a modified modified n/a sg_name snapshot group name n/a delete_ priority deletion priority n/a locked locked n/a serial serial number n/a snapshot_time snapshot creation time n/a snapshot_time_ on_master master copy creation time ...
Page 48
Output: name size (gb) master name consistency group pool creator used capacity(gb) volume_1 51 0 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allow...
Page 49
If the target volume is larger then the source volume, excess storage space is freed and returned to the target volume's storage pool. If the target volume is smaller than the source volume, all storage space that is needed to support the additional volume's capacity is reserved from the storage poo...
Page 50
No space to allocate volume v source_volume_bad_name source volume name does not exist v source_volume_data_migration_unsynchronized data migration has not completed to source volume v target_volume_bad_name target volume name does not exist v target_volume_locked target volume is locked v target_vo...
Page 51
Name type description mandatory pool object name the name of the storage pool to which the volume belongs. Y this command creates a new volume. The name of the volume must be unique in the system. Space for the volume is allocated from the specified storage pool and the volume belongs to that storag...
Page 52
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_cannot_have_zero_size volume size canno...
Page 53
This command cannot be applied to a snapshot. To delete a snapshot, use deleting a snapshot. All storage space allocated (or reserved) for the volume is freed and returned to the volume's storage pool. The volume is removed from all lun maps that contain a mapping of the volume. This command deletes...
Page 54
Internal snapshots cannot be mapped, modified or deleted. V volume_belongs_to_cg volume belongs to a consistency group v volume_is_mapped volume that is mapped to a host cannot be deleted v volume_has_mapped_snapshot volume which has a snapshot that is mapped to a host cannot be deleted v snapshot_h...
Page 55
Command executed successfully access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed warnings: v are_you_sure_you_want_to...
Page 56
Name type description mandatory default cg object name list all the volumes in this consistency group. N all consistency groups. Show_proxy boolean returns data on proxy volumes (volumes in proxy state) as well n no this command lists volumes according to: v volume name v pool v consistency group if...
Page 57
Id name default position sg_snapshot_of snapshot of snap group n/a wwn wwn n/a mirrored mirrored n/a locked_by_pool locked by pool n/a used_capacity used capacity (gb) 7 used_capacity_ mib used capacity (mib) n/a short_lived_io short live io n/a enable_vaai vaai enabled n/a user_disabled_ vaai vaai ...
Page 58
User category permission technicians disallowed locking a volume locks a volume so that it is read-only. Vol_lock vol=volname parameters: name type description mandatory vol object name name of the volume to lock. Y this command locks a volume so that hosts cannot write to it. A volume that is locke...
Page 59
User category permission condition application administrator conditionally allowed the volume is a snapshot, where its master volume is mapped to a host or cluster associated with the user and the snapshot was created by an application administrator. Security administrator disallowed n/a read-only u...
Page 60
Vol_rename vol=dbvolume new_name=dbvolume1 output: command completed successfully access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed the volume is a snapshot, where its mas...
Page 61
Parameters: name type description mandatory default vol object name the name of the volume to be resized. Y n/a size n/a the new volume size. N n/a size_ blocks n/a new size of volumes in number of blocks. N n/a shrink_ volume boolean must be specified as yes if the new size is smaller than the curr...
Page 62
V these snapshots can still be used to restore their individual master volumes. V the same goes for resizing a snapshot: it does not change the size of its master volume. If applied on a volume that is part of an ibm hyper-scale mobility relation, the command has to be acknowledged by both source an...
Page 63
No space to allocate volume v remote_volume_size_above_limit volume size specified is above limit of remote machine v volume_locked volume is locked v volume_has_data_migration data migration is defined for this volume v can_not_shrink_mapped_volume mapped volume's size cannot be decreased v can_not...
Page 64
Unlocking a volume unlocks a volume, so that it is no longer read-only and can be written to. Vol_unlock vol=volname parameters: name type description mandatory vol object name the name of the volume to unlock. Y this command unlocks a volume so that it is no longer read-only and can be written into...
Page 65
User category permission condition application administrator conditionally allowed the volume is a snapshot, where its master volume is mapped to a host or cluster associated with the user and the snapshot was created by an application administrator. Security administrator disallowed n/a read-only u...
Page 66
60 ibm xiv storage system user manual.
Page 67
Chapter 4. Lun mapping management all the lun mapping commands are obsolete and were replaced by the clustering commands. The following commands are no longer in use: v map_add_vol (the concept of mapping has been replaced by clusters. See map_volume.) v map_create (the concept of mapping has been r...
Page 68
62 ibm xiv storage system user manual.
Page 69
Chapter 5. Volume snapshot management the following sections describe the xiv command line interface (xcli) for snapshot management. Other commands that are relevant to this topic are: listing volumes, renaming a volume, changing pool settings for snapshots. See also: v volume management v consisten...
Page 70
Snapshot_change_priority snapshot=dbvolume.Snapshot1 delete_priority=4 output: command completed successfully access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed the master ...
Page 71
Name type description mandatory default name object name names of the new snapshots. N auto-generated names. Delete_ priority integer the deletion priority of the volume's snapshot. N 1 overwrite object name name of an existing snapshots to be overwritten with the current volumes content. N n/a this...
Page 72
This may happen due to the redirect-on-write mechanisms which share unchanged data between volumes and their snapshots, as well as between snapshots of the same volume. The auto delete priority is from the list (1-4), as follows: v 1 = is last to be deleted automatically ("1" is the default set by t...
Page 73
Completion codes: v volume_bad_name volume name does not exist v max_volumes_reached maximum number of volumes already defined v snapshot_illegal_priority illegal snapshot priority; must be an integer between 1 and 4. V volume_is_snapshot operation is not permitted on snapshots v volume_exists volum...
Page 74
This command deletes a snapshot. It cannot be used to delete a master volume, to delete a snapshot which is mapped to a host or cluster, or to delete an internal snapshot of a mirroring. Example: snapshot_delete snapshot=dbvolume.Snapshot1 output: command completed successfully access control: user ...
Page 75
Parameters: name type description mandatory default snapshot object name the name of the snapshot to duplicate. Y n/a name object name name of the new snapshot to be generated. N automatically generated name. This command duplicates an existing snapshot. The newly created snapshot is initially locke...
Page 76
Completion codes: v volume_bad_name volume name does not exist v max_volumes_reached maximum number of volumes already defined v volume_is_not_a_snapshot operation is permitted only on snapshots v volume_exists volume name already exists v snapshot_is_part_of_snapshot_group snapshot is part of a sna...
Page 77
User category permission storage integration administrator allowed application administrator allowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v snapshot_is_part_of_snapshot_group snapshot is part of a snapshot group v snapshot_has_active_s...
Page 78
V snapshot_format id name default position name name 1 size size (gb) 2 size_mib size (mib) n/a master_name master name 3 cg_name consistency group 4 pool_name pool 5 creator creator 6 proxy proxy n/a capacity capacity (blocks) n/a modified modified n/a sg_name snapshot group name n/a delete_ priori...
Page 79
Id name default position user_disabled_ unmap unmap disabled by user n/a marked marked n/a example: snapshot_list vol=dbvolume output: name size (gb) master name consistency group pool dbvolume.Sp1 2508 dbvolume default dbvolume.Sp1.Copy 2508 dbvolume default access control: user category permission...
Page 80
All the snapshots associated with the volume are left unchanged during a restore operation. It is possible to snapshot the volume before restoring it, so that the generated snapshot can be used and the data is not lost. It is possible to restore another snapshot (the target snapshot) from the source...
Page 81
V volume_bad_name volume name does not exist v volume_is_not_a_snapshot operation is permitted only on snapshots v not_enough_space no space to allocate volume v snapshot_is_part_of_snapshot_group snapshot is part of a snapshot group v volume_has_mirror mirror is defined for this volume v volume_loc...
Page 82
76 ibm xiv storage system user manual.
Page 83
Chapter 6. Consistency group management the following sections describe the xiv command line interface (xcli) for consistency group management. Other commands that are relevant to this topic are: snapshotting a consistency group, moving a volume between storage pools , moving consistency groups betw...
Page 84
Parameters: name type description mandatory cg object name name of a consistency group. Y vol object name name of the volume to add. Y this command adds a volume to a consistency group. The consistency group is capable of containing up to 128 volumes. Requirements for successful command completion: ...
Page 85
V whenever the command is issued on a mirrored cg master - and the master does not receive an acknowledgment from the slave (until the command timed out or due to any unexpected failure), a completion code is returned (mirror_possible_cons_group_membership_mismatch). If the command cg_add_volume is ...
Page 86
Consistency group contains maximum number of volumes. V max_volumes_in_remote_cons_group_reached the maximum permitted number of volumes per the remote consistency group is reached. Remote consistency group contains maximum number of volumes. V mirror_has_sync_job operation is not permitted on a mir...
Page 87
V mirror_possible_cons_group_membership_mismatch mirrored cg may contain different volumes on master and slave. This problem occurs whenever the cg_add_vol command results with the master not receiving an acknowledgment from the slave until the command timed out, or any other unexpected failure. V r...
Page 88
Output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v cons_gr...
Page 89
Command completed successfully access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v cons_group_bad_...
Page 91
– if the consistency group is mirrored, the mirroring definition of the removed volume is retained. The mirroring definition is based on the same settings as the consistency group. V the peer volume is also removed from the peer consistency group v the removed mirrored volume is set the rpo of the m...
Page 92
Completion codes: v volume_bad_name volume name does not exist v volume_not_in_cons_group volume does not belong to a consistency group v target_not_connected there is no connection to the target system v volume_is_snapshot operation is not permitted on snapshots v cons_group_is_slave consistency gr...
Page 93
This command succeeds even if the new name is identical to the current name. Example: cg_rename cg=dbgroup new_name=dbvolumes output: command completed successfully access control: user category permission storage administrator allowed storage integration administrator allowed application administra...
Page 94
Example: io_pause cg=test_cg milli_seconds_to_resume=10000 output: command: code = "success" status = "0" status_str = "command completed successfully" return: token_id = "6343971831808" access control: user category permission condition storage administrator allowed n/a storage integration administ...
Page 95
Parameters: name type description mandatory token_id positive integer token returned by resume_io command y resume io execution on cg previously suspended with resume_io example: io_resume token_id=6343971831808 output: command: code = "success" status = "0" status_str = "command completed successfu...
Page 96
Parameters: name description mandatory default token_id optional filter value to show status for specific token, 0 means unfiltered n 0 gives detailed status of pause_io_state of cgs suspended with io_pause example: io_pause_list output: command: code = "success" status = "0" status_str = "command c...
Page 97
Parameters: name type description mandatory xcg object name name of a cross-system consistency group. Y creates a cross-system consistency group (xcg) definition to which consistency groups on different xiv systems may be associated. Example: xcg_create xcg=dbbackup output: command completed success...
Page 98
Name type description mandatory cg object name name of a consistency group. Y associates an existing consistency group to a cross-system consistency group definition. Example: xcg_add_cg xcg=dbbackup cg=cgbackup output: command completed successfully access control: user category permission conditio...
Page 99
Removes an existing consistency group from a cross-system consistency group definition removes an existing consistency group from a cross-system consistency group definition. Xcg_remove_cg xcg=xcgname cg=cgname parameters: name type description mandatory xcg object name name of a cross-system consis...
Page 100
V cons_group_bad_name consistency group name does not exist. V xcg_is_empty consistency group is empty. V cons_group_not_in_xcg consistency group doesnt belong to cross consistency group. Adds a remote system name to the cross-system consistency group definition adds a remote system name to the cros...
Page 101
Completion codes: v xcg_bad_name cross consistency group name does not exist. V max_remote_systems_in_xcg_reached cross consistency group contains maximum number of remote systems. V remote_system_already_added remote system belongs to cross consistency group removes a remote system name from a cros...
Page 102
Completion codes: v xcg_bad_name cross consistency group name does not exist. V remote_system_not_in_xcg remote system doesnt belong to cross consistency group lists cross-system consistency group definitions along with contained consistency groups lists cross-system consistency group definitions al...
Page 103
Completion codes: v xcg_bad_name cross consistency group name does not exist. Retrieve the names of remote systems part of the specified cross-system consistency group retrieve the names of remote systems part of the specified cross-system consistency group. Xcg_get_remote_systems xcg=xcgname parame...
Page 104
Completion codes: v xcg_bad_name cross consistency group name does not exist. Deletes a cross-system consistency group deletes a cross-system consistency group (xcg) definition. Xcg_delete xcg=xcgname parameters: name type description mandatory xcg object name name of a cross-system consistency grou...
Page 105
Lists cross-system consistency group definitions lists cross-system consistency group definitions along with contained consistency groups. Xcg_list [ xcg=xcgname ] parameters: name type description mandatory default xcg object name name of a cross-system consistency group. N all cross-system consist...
Page 106
100 ibm xiv storage system user manual.
Page 107
Chapter 7. Snapshot set management the following sections describe the xiv command line interface (xcli) for snapshot set management. Use the cg_snapshot_create command to create the snapshot group. See also: v volume management v volume snapshot management v consistency group management the section...
Page 108
Name type description mandatory default overwrite object name existing snapshot group which is overwritten with current content. N n/a auto_ resume positive integer indication whether to resume io to the consistency group by providing the token id. N 0 this command creates a consistent snapshot grou...
Page 109
This command fails if one or more of the volumes in the consistency group is a slave of a synchronous mirroring, and it is currently inconsistent due to either a re-synchronization or an initialization process. Mirroring limitations: v this command fails if the volume is a slave of an asynchronous m...
Page 110
Snapshot group belongs to another consistency group. V pool_snapshot_limit_reached there is not enough space to create a snapshot. V volume_is_not_consistent_slave operation not allowed on slave volume that is not consistent. V snapshot_group_is_internal internal snapshots cannot be mapped, modified...
Page 111
Access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed at least one of the volumes in the master consistency group is mapped to a host or cluster associated with the user and s...
Page 112
Command completed successfully. Access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed at least one of the volumes in the master consistency group is mapped to a host or cluste...
Page 113
Output: command completed successfully. Access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed at least one of the volumes in the master consistency group is mapped to a host o...
Page 114
Example: snap_group_duplicate snap_group=dbbackup new_snap_group=dbbackup_copy output: command completed successfully access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed at ...
Page 115
V they can be overridden v they can be deleted v their deletion priority can be changed example: snap_group_format snap_group output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administra...
Page 116
Parameters: name type description mandatory default snap_group object name name of a specific snapshot group to be listed. N all snapshot groups. Cg object name list all the snapshot groups of this consistency group. N all snapshot groups. This command lists snapshot groups. When a snapshot group na...
Page 117
User category permission technicians disallowed completion codes: v cons_group_does_not_exist consistency group does not exist. V snapshot_group_bad_name snapshot group name does not exist. Locking a snapshot group locks a snapshot group by locking all its snapshot. Snap_group_lock snap_group=snapsh...
Page 118
Completion codes: v snapshot_group_bad_name snapshot group name does not exist. V snapshot_group_is_internal internal snapshots cannot be mapped, modified in any way or deleted. Renaming a snapshot group renames a snapshot group. Snap_group_rename snap_group=snapshotgroupname new_name=name parameter...
Page 119
Restoring a consistency group from a snapshot group restores the master volumes of a consistency group, or a snapshot group from one of its associated snapshot groups. Snap_group_restore snap_group=snapshotgroupname [ target_snap_group=snapgroupname ] parameters: name type description mandatory snap...
Page 120
User category permission condition application administrator conditionally allowed both target and source are snapshots groups of the same master consistency group, where at least one of the master volumes in this consistency group is mapped to a host or cluster associated with the user, and the tar...
Page 121
This command unlocks a snapshot group by unlocking all its snapshots. This is functionally equivalent to executing unlocking a volume on each snapshot. You may refer to the documentation of unlocking a volume for a description of unlocking behavior. Example: snap_group_unlock snap_group=dbbackup out...
Page 122
Example: snap_group_set_descriptor snap_group=dbbackup descriptor=blabla output: command completed successfully access control: user category permission condition storage administrator allowed n/a storage integration administrator allowed n/a application administrator conditionally allowed at least ...
Page 123
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians disallowed completion codes: v snapshot_group_bad_name snapshot group name does not...
Page 124
118 ibm xiv storage system user manual.
Page 125
Chapter 8. Storage pool management the following sections describe the xiv command line interface (xcli) for storage pool management. See also: v volume management v volume snapshot management v consistency group management the sections are listed as follows: v cg_move(moves a consistency group, all...
Page 126
V if the cg is mirrored, it can only be moved to a pool that is not thin-provisioned example: cg_move cg=dbgroup pool=dbpool output: command completed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administra...
Page 127
Example: pool_change_config pool=vol_breed_none_0 lock_behavior=read_only output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed rea...
Page 128
Name type description mandatory default protected_ snapshot_ priority integer specifies a snapshot delete priority between 0 - 4; snapshots with a lower delete priority (i.E., higher number) than the specified value might be deleted by the system automatically to free space, before pausing mirroring...
Page 129
– snapshots with priority level 1, 2 and 3 will not be deleted. V if the value is set to 4, the system will deactivate mirroring before deleting any of the snapshots. V if the value is set to 0, the system can delete any snapshot regardless of deletion priority. Access control: user category permiss...
Page 130
Creating storage pools creates a storage pool. Pool_create pool=poolname > snapshot_size=gb [ lock_behavior= ] parameters: name type description mandatory default pool object name name of the storage pool. Y n/a size positive integer size of the storage pool (in gigabytes). N n/a hard_size positive ...
Page 131
Both hard and soft sizes are subtracted from the free hard/soft space. For thin provisioned storage pools, the lock_behavior parameter sets whether and how the pool is locked upon space depletion. The pool can be locked for write, or for both read and write. Example: pool_create pool=dbpool size=100...
Page 132
Deleting a storage pool deletes a storage pool. Pool_delete pool=poolname parameters: name type description mandatory pool object name the name of the storage pool to delete. Y this command deletes a storage pool. This command fails if the storage pool is not empty, meaning that it still contains vo...
Page 133
Listing storage pools lists all storage pools or the specified one. Pool_list [ pool=poolname ] parameters: name type description mandatory default pool object name name of a storage pool. N all pools. This command lists all storage pools. When the pool parameter is provided, only the specified stor...
Page 134
Id name default position empty_space_ hard_mib hard empty (mib) n/a used_by_ volumes hard vols (gb) 7 used_by_ volumes_mib hard vols (mib) n/a used_by_ snapshots hard snaps (gb) 9 used_by_ snapshots_mib hard snaps (mib) n/a creator creator n/a locked locked 8 lock_behavior lock behavior n/a create_l...
Page 135
This command renames a storage pool. The new name of the storage pool must be unique in the system. This command succeeds even if the new name is identical to the current name. Example: pool_rename pool=dbpool new_name=erppool output: command completed successfully. Access control: user category per...
Page 136
Name type description mandatory default hard_size positive integer hard size of the storage pool (actual physical capacity). N n/a soft_size positive integer soft size of the storage pool (maximal size of capacity seen by the hosts, used for thin provisioning). N n/a snapshot_ size integer sets a ne...
Page 137
User category permission application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed warnings: v pool_snapshot_size_too_small snapshot size is very small. It will only allow snapshots of volumes which do no change. All other snapshots will...
Page 138
Name type description mandatory pool object name name of the storage pool to which to move. Y this command moves a volume and all of its snapshots from one storage pool to another. When moving a master volume from one storage pool to another, all of its snapshots are moved together with it to the de...
Page 139
V not_enough_hard_space no space to allocate for volume's current usage v volume_is_snapshot operation is not permitted on snapshots v volume_belongs_to_cg volume belongs to a consistency group v not_enough_snapshot_space snapshot usage will exceed snapshot limit chapter 8. Storage pool management 1...
Page 140
134 ibm xiv storage system user manual.
Page 141
Chapter 9. System management the following sections describe the xiv command line interface (xcli) for system management. The sections are listed as follows: v cod_list(displays current consumed capacity of the system.) v config_get(shows the values of configuration parameters.) v config_set(sets co...
Page 142
V elicense_status_get(retrieves the electronic license acceptance status.) v elicense_blob_get(retrieves a fragment of the electronic license file.) v elicense_accept(accept the electronic license agreement.) the following commands are no longer in use: v upgrade_download_status (the data will be in...
Page 143
User category permission technicians allowed printing configuration parameters shows the values of configuration parameters. Config_get [ name=name ] parameters: name type description mandatory default name string name of parameter to print. N all parameters. Id name default position name name 1 val...
Page 144
Config_get output: name value ------------------------ ----------------------------------- email_sender_address support@ibm.Com email_reply_to_address storage@ibm.Com dns_primary 10.0.0.10 dns_secondary iscsi_name iqn.2005-10.Com.Xivstorage:010140 system_name ibm storage system access control: user ...
Page 145
V system_name - name used as the sender's name when sending email messages. V defaultuser - default user to be used if no user is specified for the cli. If null, a user must be specified. V snmp_sysname - snmp system name as shown in the snmp mib. (.1.3.6.1.2.1.1.5.0) v snmp_location - snmp location...
Page 146
Parameters: name description mandatory default name name of the host to be resolved. Y n/a type type of query. N according to the dns server type this command attempts to translate the dns name into an ip address. Translation is attempted through each of the defined dns servers. This command fails i...
Page 147
Parameters: name type description mandatory default category string category name. N n/a search string search string. N n/a command string command name. N n/a format enumeration output format for command help. N short. This command prints the help as follows: v no parameters - lists all the commands...
Page 148
Id name default position fields fields n/a description description 3 example example n/a access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator allowed read-only users allowed technicia...
Page 149
Adding a patch script that will be run on system's modules adds a patch script that will be run on system's module(s). Patch_script_add tar_file=tarfile name=name exe_file=exefile [ module_list=modulelist ] [ module_type= ] [ version=version ] [ persistence= ] [ run_option= ] [ parameters=(p1,p2,p3....
Page 150
Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed warnings: v patch_script_not_all_ras_nodes_are_up not all ras n...
Page 151
Deletes a patch script deletes a patch script. Patch_script_delete name=name parameters: name type description mandatory name string script name. Y deletes a patch script. Example: xcli -u -c xiv1 patch_script_delete name=upgrade_script access control: user category permission storage administrator ...
Page 152
Id name default position execution_ flags.Enabled enabled 2 general_ info.Tar_file tar file 3 general_ info.Exe_file exe file 4 general_ info.Parameter s parameters 5 execution_ flags.Module_ type module type 6 execution_ flags.Module_ list module list 7 execution_ flags.Run_ option run option 8 exe...
Page 153
Updating a patch script that will be run on systems modules updates a patch script that will be run on system's module(s). Patch_script_update name=name [ module_list=modulelist ] [ module_type= ] [ version=version ] [ persistence= ] [ run_option= ] [ parameters=(p1,p2,p3....P10) ] [ enabled= ] [ de...
Page 154
User category permission application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v patch_script_doesnt_exist patch script does not exist. V patch_script_module_list_is_not_relevant module list is relevant only when using...
Page 155
Completion codes: v patch_script_doesnt_exist patch script does not exist. V cannot_read_from_file cannot read from file 'filename' troubleshooting: contact support trigger patch script execution on one or all modules. Trigger patch script execution on one or all modules. Patch_script_activate name=...
Page 156
Completion codes: v patch_script_is_disabled patch script is disabled. V patch_script_not_all_modules_got_activate_now_request one or more modules didn't get the activate now request. V patch_script_doesnt_exist patch script does not exist. Get patch script execution inforamtion get patch script exe...
Page 157
Id name default position number_of_ times_executed times executed 5 number_of_ times_failed_ to_execute times failed executing 6 last_ execution_ status last execution status 7 last_ execution_ return_code last return code 8 access control: user category permission storage administrator disallowed s...
Page 158
Note: using this option may cause data loss. Example: shutdown output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only u...
Page 159
Changing the operational state changes the operational state of a system. State_change target_state= parameters: name type description mandatory target_ state enumeration the operational state after the command is executed. Y this command changes the system's states. The systems' states can be trans...
Page 160
V cannot_write_to_key_repository failed writing keys to the key repository. Troubleshooting: contact support. V no_live_keyserver_gateway_node there is no live key server gateway node on the system. Troubleshooting: please restart the key server gateway node and retry. V no_master_keyserver_defined ...
Page 161
Example: xcli -u -c xiv1 local_storage_show output: module free space in bytes -------- --------------------- 3 2017837056 6 2042654720 9 2041233408 14 2037891072 15 2042384384 access control: user category permission storage administrator disallowed storage integration administrator disallowed appl...
Page 162
Runtime min required runtime power consumption psus with no input power runtime reference ------- -------------------- ----------------- ------------------------ ----------------- 11 5 5979 0 actual access control: user category permission storage administrator allowed storage integration administra...
Page 163
User category permission storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians disallowed showing the current time shows the current system time. Time_list this command shows the current time, date and tim...
Page 164
Parameters: name description mandatory time new current time. Y this command sets the system's time. Example: time_set time=2006-05-04.03:02:01 access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed sec...
Page 165
User category permission read-only users allowed technicians allowed setting the time zone sets the time zone of the system. Timezone_set timezone=timezone parameters: name type description mandatory timezone string new time zone of the system. Y this command sets the new time zone of the system. Se...
Page 166
User category permission storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v hot_upgrade_is_not_ongoing hot upgrade is not currently ongoing initiating download of a new...
Page 167
None of the ports of the specified role is active. V upgrade_download_could_not_be_started failed starting upgrade download of an unknown reason. V repository_ip_must_be_supplied_for_download repository ip must be supplied for download if the interface type is management or vpn. V no_ports_of_specif...
Page 168
User category permission security administrator disallowed read-only users disallowed technicians allowed warnings: v are_you_sure_you_want_to_shut_down are you sure you want to shut down the machine and all its components? Completion codes: v command_is_not_valid_in_current_system_state the request...
Page 169
V ready for upgrade v preparing v finalizing upgrade (after the i/os resumes) additional upgrade-related values: v requires a reboot v update is required v the number of times the system attempted to stop i/os v time to the next retry v abort reason (in case the upgrade was aborted) v failed to comm...
Page 170
User category permission technicians allowed upgrading a system upgrades the software version of the system. Upgrade_system upgrade_type= parameters: name type description mandatory upgrade_ type enumeration the type can can be "hot" (for hot upgrade) or "utilities_only" (for warm upgrade). Y this c...
Page 171
V upgrade_related_script_already_running pre-upgrade or post-upgrade script cannot be invoked since an upgrade related script is currently running v system_upgrade_incompatible_upgrade_type_specified the specified upgrade type specified is incompatible with the kind of change imposed by the new vers...
Page 172
V no_live_admin_server_found could not invoke pre-upgrade script because no module can run cli commands printing the current system version prints the current version of the system. Version_get this command prints the current version of the system. Id name default position system_version version 1 e...
Page 173
Shows the values of vpd parameters. See setting vpd parameters for a full list of available settings. Example: vpd_config_get name=site.City output: name value ----------- -------- site.City gotham access control: user category permission storage administrator allowed storage integration administrat...
Page 174
V customer.Secondary_contact.Office_phone v customer.Secondary_contact.Time_zone v hardware_info.Hw_ats_monitoring v hardware_info.Hw_ats_type v hardware_info.Hw_cable_bundle v hardware_info.Hw_door v hardware_info.Hw_patch_panel v hardware_info.Hw_patch_panel_label v hardware_info.Hw_power_cable_co...
Page 175
Vpd_config_set name= value= access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed showing values of maintenance module p...
Page 176
User category permission technicians disallowed displaying the system's mib file displays the system's mib file. Mib_get displays the system's mib file. Id default position line 1 example: xcli -u -c xiv1 mib_get output: ---------------------------------------------- --------------------------------...
Page 177
Retrieves the electronic license acceptance status. Retrieves the electronic license acceptance status. Elicense_status_get retrieves the electronic license acceptance status. Example: xcli -u -c xiv1 elicense_status_get output: status ---------- accepted id name default position status status 1 acc...
Page 178
Output: access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed completion codes: v cannot_read_from_file cannot read from file ...
Page 179
User category permission technicians disallowed completion codes: v elicense_incompatible_version the accepted version of the electronic license dose not match the current version troubleshooting: please retrieve the current electronic license version and accept it v elicense_allready_accepted elect...
Page 180
174 ibm xiv storage system user manual.
Page 181
Chapter 10. Remote target connectivity the following sections describe the xiv command line interface (xcli) for defining remote target connectivity. The sections are listed as follows: v target_change_connection_threshold(setting a threshold for link disruption that lasts more than a specified dura...
Page 182
V target_portset_port_deactivate (portsets are not in use any more. Use target_port_deactivate.) v target_portset_list (port sets are no longer in use in this version. Ports are associated directly with targets.) setting a threshold for link disruption duration that triggers an event setting a thres...
Page 183
Updating the target mirroring configuration changes the target's mirroring configuration. Target_config_sync_rates target=targetname [ max_initialization_rate=maxinitializationrate ] [ max_syncjob_rate=maxsyncjobrate ] [ max_resync_rate=maxresyncrate ] parameters: name type description mandatory def...
Page 185
V ipinterface_does_not_exist ip interface name does not exist v target_port_bad_address remote port address is illegal or does not belong to the remote target v bad_local_ip_port an id of a local ip port must be specified deactivating connectivity to a remote target deactivates connectivity between ...
Page 186
Command completed successfully access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v target_bad_name...
Page 187
Name type description mandatory local_ ipinterfac e object name local ip interface to be connected to the remote port (iscsi only). N fcaddress n/a fc address of the port on the remote target (fc targets only). N local_port n/a fc port (fc only). N this command defines connectivity between a port on...
Page 188
Operation is not allowed on management ip interface v ipinterface_does_not_exist ip interface name does not exist v target_port_bad_address remote port address is illegal or does not belong to the remote target deleting connectivity to a remote target deletes connectivity between a port on the local...
Page 189
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v target_bad_name target name does not exist v c...
Page 190
Id name default position local_fc_port fc port 3 local_ip_port ip interface 4 active active 5 up up 6 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users a...
Page 191
This command defines the communication topology between a local storage system and a remote storage system in order to enable various features, such as remote mirroring. The local storage system can write to or read from the remote storage system or allow the target storage system to write to or rea...
Page 192
Deleting a remote target deletes the definition of a specified remote target. Target_delete target=targetname [ force_on_olvm_peer= ] parameters: name type description mandatory default target object name target that is deleted. Y n/a force_on_ olvm_peer boolean informs the system if the command sho...
Page 193
Listing remote targets lists a specified remote target definition, or all the target definitions. Target_list [ target=targetname ] parameters: name type description mandatory default target object name target name that is listed. N all targets this command lists a specified remote target definition...
Page 194
Allowing remote mirroring access allows remote mirroring operations initiated from the remote target. Target_mirroring_allow target=targetname parameters: name type description mandatory target object name remote target name. Y this command is performed on a local storage system in order to allow th...
Page 195
Activating a port activates a port of a remote target. Target_port_activate target=targetname parameters: name type description mandatory target object name remote target of the port. Y ipaddress n/a ip address of the port on the remote target (iscsi targets only). N fcaddress n/a fc address of the ...
Page 196
V target_bad_name target name does not exist adding a new port to a remote target adds a port to a remote target. Target_port_add target=targetname parameters: name type description mandatory target object name remote target to which to add the port. Y ipaddress n/a ip address of the port on the rem...
Page 197
Troubleshooting: port names for iscsi hosts must contain only printable characters. V host_port_exists host with this port id already defined deactivating a port deactivates a port of a remote target. Target_port_deactivate target=targetname [ force_on_olvm_peer= ] parameters: name type description ...
Page 198
User category permission technicians disallowed completion codes: v target_bad_name target name does not exist v target_port_bad_address remote port address is illegal or does not belong to the remote target v target_bad_port_state port is already in requested activation state v target_has_olvm_rela...
Page 199
User category permission security administrator disallowed read-only users disallowed technicians disallowed completion codes: v target_bad_name target name does not exist v target_port_bad_address remote port address is illegal or does not belong to the remote target v target_port_has_connectivity ...
Page 200
Renaming a remote target renames a remote target. Target_rename target=targetname new_name=name parameters: name type description mandatory target object name target that is renamed. Y new_name object name new name of the target. Y this command renames an existing target. Example: target_rename targ...
Page 201
Name type description mandatory system_id string id of the remote system. Should be the same as the output of printing configuration parameters of the system_id variable on the remote system. Y this command changes the system id of the remote target. Access control: user category permission storage ...
Page 202
196 ibm xiv storage system user manual.
Page 203
Chapter 11. Remote mirroring the following sections describe the xiv command line interface (xcli) for remote mirroring. Other command that are relevant to this topic is: setting a threshold for link disruption duration that triggers an event. The sections are listed as follows: v mirror_cancel_snap...
Page 204
The following commands are no longer in use: v mirror_change_config (command is no longer in use in this version. Parameter create_last_consistent_snapshot is associated directly with pools) v sync_rates_set (command is no longer in use in this version. Supplanted by command target_config_sync_rates...
Page 205
Warnings: v are_you_sure_you_want_to_cancel_snapshot_ mirrors_for_the_volume are you sure you want to delete snapshot mirrors for volume? V are_you_sure_you_want_to_cancel_snapshot_ mirrors_for_the_consistency_group are you sure you want to delete snapshot mirrors for consistency group? Completion c...
Page 206
Name type description mandatory default name object name name of the new snapshot. Y n/a delete_ priority integer the deletion priority of the volume's snapshot. N 1 slave_name object name name of the new snapshot on the slave. Y n/a slave_ delete_ priority integer the deletion priority of the slave...
Page 207
These two last_replicated snapshots are different and denoted" master" and "slave" accordingly. The outcome for the synchronous mirroring: v the master blocks host i/o for the duration of creating the snapshots v the master completes synchronizing pending writes v a snapshot of the master and slave ...
Page 208
V overwrite_snapshot_bad_name snapshot name does not exist v overwrite_snapshot_group_does_not_belong_to_given_group snapshot group belongs to another consistency group. V pool_snapshot_limit_reached there is not enough space to create a snapshot. V remote_max_volumes_reached maximum number of volum...
Page 209
V snapshot_is_part_of_snapshot_group snapshot is part of a snapshot group v synched_snapshots_not_supported_in_target synchronized snapshot capability is not supported by the mirror's target. V volume_bad_prefix volume name has a reserved prefix v volume_belongs_to_mirrored_cons_group volume mirror ...
Page 210
Note: if the new activation state is the same as the existing state nothing is done and a success code is returned. The mirroring can't be activated: v if the time stamps of the last_replicated snapshots on the master and the slave do not match. V if the command is issued on a master that did not re...
Page 211
V mirror_can_not_be_activated mirroring cannot be activated because state cannot be established troubleshooting: delete and recreate mirror v mirror_cons_group_membership_mismatch mirrored cg contains different volumes on master and slave. This problem occurs whenever the cg_add_vol or cg_remove_vol...
Page 212
User category permission application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_bad_name volume name does not exist v cons_group_no_mirror local consistency group does not have remote mirroring definitions v...
Page 213
Parameters: name type description mandatory default vol object name master volume name. N n/a cg object name master cg name. N n/a new_ designatio n enumeration the new designation of the peer if not specified, the command will act as a toggle - changing the designation of the peers between primary ...
Page 214
Local volume does not have remote mirroring definitions v cons_group_bad_name consistency group name does not exist. V cons_group_no_mirror local consistency group does not have remote mirroring definitions v local_peer_is_not_master local peer is not the master v mirror_designation_not_supported_by...
Page 215
V the specified target exists v the specified target is mirrored v the specified target is not a volume that belongs to a mirrored consistency group v the specified target is of sync type async_interval v the specified target is a master v the link is up access control: user category permission stor...
Page 216
Changing the roles of a mirrored volume changes the role of a local mirroring peer between master and slave mirror_change_role [ new_role= ] parameters: name type description mandatory default vol object name local volume name. Must be specified if the command concerns a volume. N n/a cg object name...
Page 217
– completion of process is recorded in log o mirroring state is standby v when applied on the slave: – the slave will become a master, start accepting requests from hosts, and upon explicit activation will start replicating to the other peer (the original master). – if the slave volume has a last_co...
Page 218
User category permission read-only users disallowed technicians disallowed warnings: v some_data_will_be_lost_are_you_sure are you sure you want the mirror's local peer to become slave and loose data that was not replicated? V are_you_sure_you_want_to_change_a_peer_ with_lcs_to_master are you sure y...
Page 219
Parameters: name type description mandatory vol object name volume name on the local system. N cg object name cg name on the local system n schedule object name a reference to a mirroring schedule y this command changes the replication schedule for a peer on the local system. The new scheduling will...
Page 220
V sync_mirror_does_not_use_schedule definition of synchronous mirror does not require a schedule object to be specified. V volume_belongs_to_mirrored_cons_group volume mirror is part of consistency group mirror. V interval_should_be_shorter_than_rpo schedule interval must me shorter than the rpo. Th...
Page 221
Name type description mandatory default rpo positive integer mirror recovery point objective value for master. Ranges from 30 to 86400 seconds (i.E., up to 24 hours) applies and mandatory to asynchronous mirroring only. N [none] remote_rpo positive integer mirror recovery point objective value when ...
Page 222
Mirroring is created in the standby state. The mirroring coupling must then be activated in order to start the initialization process, which copies the data from the master to the slave. A storage system can have multiple mirroring definitions between pairs of peers on various remote systems. Howeve...
Page 223
V async_mirror_remote_rpo_too_short specified remote rpo is too short. V async_mirror_rpo_too_short specified rpo is too short. V async_mirror_rpo_too_long specified rpo is too long. V async_not_supported_in_target asynchronous mirror is not supported by specified target. V bad_remote_volume_name sl...
Page 224
A pool on remote machine must be specified when a slave volume is to be created v remote_target_not_connected there is currently no connection from the target system v volume_is_snapshot operation is not permitted on snapshots v remote_volume_is_snapshot slave volume is a snapshot v target_bad_name ...
Page 225
Maximum capacity for mirrored volumes already defined on remote machine v mirror_retry_operation there is an operation in progress on this mirror , please retry your request in a few seconds troubleshooting: please retry the command in a few seconds v mirroring_incompatible_target_version mirroring ...
Page 226
V deactivating a consistency group affects all of its volumes note: v the command can't be issued on the slave. The command fails under the following conditions: v the specified target does not exist v the specified target is non-mirrored v the specified target is a volume that belongs to a consiste...
Page 227
Deleting a remote mirroring definition deletes a remote mirroring coupling definition. Mirror_delete [ force_on_slave= ] parameters: name type description mandatory default vol object name local master volume name. N n/a cg object name local master cg name. N n/a force_on_ slave boolean forces the d...
Page 228
– run the mirror_change_role command to turn the slave into the master – run mirror_delete the force_on_slave parameter: v the parameter force_on_slave can be issued by a user only if mirroring is in initialization (in any other mode the role can be changed to master and the peer mirror can be delet...
Page 230
V schedule name (schedule name) v last replicated snapshot time (yyyy-mm-dd hh:mm:ss) v specified rpo (value in h:mm:ss format) the following deactivation reasons can be read from the output list (available only in xml output format): v inactive_user - no_error v inactive_secondary_locked - secondar...
Page 231
Id name description default position last_ replicated_ snapshot_ exists has last replicated snapshot n/a n/a specified_rpo rpo n/a n/a remote_rpo remote rpo n/a n/a application_ consistent app consistency n/a n/a validate validation n/a n/a output: access control: user category permission storage ad...
Page 232
User category permission security administrator disallowed read-only users allowed technicians disallowed obtaining statistics on past sync jobs the command presents statistics that are automatically gathered by the system on past sync jobs corresponding to a specified mirrored volume or consistency...
Page 233
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users allowed technicians disallowed completion codes: v volume_bad_name volume name does not exist v cons...
Page 234
V the volume that was previously the slave becomes the master before this command switches roles, the system stops accepting new writes to the local volume. With synchronous mirrors the system will perform all pending writes, and only after all pending writes have been committed, the roles are switc...
Page 235
Mirror master was written to after the last replicated snapshot was taken v remote_mirror_is_not_active remote mirroring is not active retrieving rpo threshold listing system rpo related thresholds, that once crossed will trigger the creation of a corresponding event rpo_thresholds_get this command ...
Page 236
Parameters: name type description mandatory default increase_ percentage integer threshold for rpo increase beyond which an event should be created n none increase_ absolute integer threshold for rpo increase beyond which an event should be created n none setting system rpo related thresholds, that ...
Page 237
Name type description mandatory interval n/a a value that indicates the interval for asynchronous mirroring. Format: hh:mm [ :ss ]. Y this command updates the schedule definition. Such definition can be referenced to when specifying asynchronous mirroring couplings. Limitation: v schedule must be on...
Page 238
Exclusion period may defined only is exclude_time is set v zero_length_exclusion_period exclusion period start time must be differnt than its end time creating a schedule object defines a schedule for replication. Schedule_create schedule=schedule [ interval=intervalsize ] [ type= ] parameters: name...
Page 239
Manual specifies that synchronization jobs for a mirror assigned the schedule can be triggered by the command schedule_create_tick v once set - the schedule type cannot be changed access control: user category permission storage administrator allowed storage integration administrator allowed applica...
Page 240
Schedule (and only whenever the schedule is of a non-interval type) which is equivalent to the 'new-interval-arrived' event triggered automatically by the system for a mirror (with a schedule of type interval). V the command is different from mirror_create_snapshot whereas it is applied to mirrors t...
Page 241
Schedule_delete schedule=hourly output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disall...
Page 242
Example: schedule_list output: name interval never min_interval 00:00:20 async_none_3 00:02:00 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disal...
Page 243
Completion codes: v schedule_does_not_exist specified schedule does not exist v schedule_name_exists new schedule name already exists v schedule_can_not_be_updated specified schedule cannot be updated viewing sync job status lists the status of queued and running sync jobs for asynchronous couplings...
Page 244
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed 238 ibm xiv storage system user manual.
Page 245
Chapter 12. Data migration the following sections describe the xiv command line interface (xcli) for data migration. The sections are listed as follows: v dm_activate(activates the data migration process.) v dm_deactivate(deactivates the data migration process.) v dm_define(defines a data migration ...
Page 246
V volume_no_dm local volume does not have data migration definitions v target_not_connected there is currently no connection to the target system v remote_volume_no_lun remote volume's lun is unavailable v remote_volume_no_read_access remote volume cannot be read v remote_volume_no_write_access remo...
Page 247
Defining data migration configuration defines a data migration configuration. Dm_define vol=volname target=targetname lun=sourcelun source_updating= [ create_vol= ] [ pool=poolname ] parameters: name type description mandatory default vol object name data migration destination volume on the local sy...
Page 248
The local volume must be formatted. If create_vol is specified as yes, the volume is created. In this case the size of the newly created volume is identical to the size of the source volume. When creating a volume, a pool name must be specified. Creating a volume fails if there is no connectivity to...
Page 249
V max_volumes_reached maximum number of volumes already defined v illegal_volume_size illegal volume size v remote_volume_no_lun remote volume's lun is unavailable v target_not_connected there is currently no connection to the target system v volume_cannot_have_zero_size volume size cannot be zero v...
Page 250
User category permission application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_bad_name volume name does not exist v volume_no_dm local volume does not have data migration definitions v dm_is_not_synchroniz...
Page 251
Id name default position sync_state status 5 connected target connected 6 size_to_ synchronize size to sync (mb) n/a operational operational n/a sync_progress sync progress (%) n/a start_ migration_ automatically start data migration automatically n/a access control: user category permission storage...
Page 252
Completion codes: v volume_bad_name volume name does not exist v volume_no_dm local volume does not have data migration definitions v target_not_connected there is currently no connection to the target system v remote_volume_no_lun remote volume's lun is unavailable v remote_volume_no_read_access re...
Page 253
Chapter 13. Ibm hyper-scale mobility the following sections describe the xiv command line interface (xcli) for ibm hyper-scale mobility. The sections are listed as follows: v olvm_create(defines an ibm hyper-scale mobility configuration.) v olvm_activate(activates an ibm hyper-scale mobility migrati...
Page 254
User category permission security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_not_applicable_for_olvm the volume is not applicable for ibm hyper-scale mobility. V volume_bad_name volume name does not exist v volume_is_snapshot operation is no...
Page 255
Volume name has a reserved prefix v remote_volume_has_data_migration data migration is defined for slave volume v remote_volume_locked slave volume is locked v volume_has_mirroring_snapshots volume has snapshots created by previous mirroring process. V remote_max_mirror_capacity_reached maximum capa...
Page 256
Slave volume is a snapshot v volume_exists volume name already exists v slave_volume_not_formatted slave volume is not formatted v volume_belongs_to_cg volume belongs to a consistency group v volume_has_data_migration data migration is defined for this volume v max_mirrors_reached maximum number of ...
Page 257
Access control: user category permission storage administrator allowed storage integration administrator allowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_bad_name volume name does not exist v c...
Page 258
Parameters: name type description mandatory vol object name the source volume. Y this command deactivates the migration of an ibm hyper-scale mobility volume. This command is issued on the source volume. Access control: user category permission storage administrator allowed storage integration admin...
Page 259
Name type description mandatory default force_ abort boolean a boolean that determines whether to delete an ibm hyper-scale mobility relationship on the source. N no force_ abort_on_ destinatio n boolean a boolean that determines whether to delete an ibm hyper-scale mobility relationship on the dest...
Page 260
The source is in an unsupported ibm hyper-scale mobility state v command_not_supported_for_olvm_destination_in_this_state the destination is in an unsupported ibm hyper-scale mobility state v olvm_is_active the ibm hyper-scale mobility relation is active. V force_abort_not_allowed a forced ibm hyper...
Page 261
The destination is in an unsupported ibm hyper-scale mobility state v volume_not_defined_for_olvm the volume does not have ibm hyper-scale mobility definitions v olvm_link_is_not_up ibm hyper-scale mobility link is not up. The mapping list cannot be updated. V host_bad_name host name does not exist ...
Page 262
User category permission read-only users disallowed technicians disallowed warnings: v are_you_sure_you_want_to_delete_olvm_ relationship_in_this_phase are you sure you want to delete ibm hyper-scale mobility relationship? V are_you_sure_you_want_to_force_delete_ olvm_relationship_in_this_phase are ...
Page 263
V active (yes, no) v phase (migration, proxy-ready, proxy) v state v link up id name description default position name volume name n/a 1 role role n/a 2 target_name remote system n/a 3 active active n/a 4 phase phase n/a 5 state state n/a 6 connected link up n/a 7 sync_progress sync progress (%) n/a...
Page 264
258 ibm xiv storage system user manual.
Page 265
Chapter 14. Event handling the following sections describe the xiv command line interface (xcli) for event handling, including listing events, filtering and sending notifications. The sections are listed as follows: v custom_event(generates a custom event.) v dest_define(defines a new destination fo...
Page 266
V smtpgw_list(lists smtp gateways.) v smtpgw_prioritize(sets the priority of which smtp gateway should be used to send emails. ) v smtpgw_rename(renames an smtp gateway.) v smtpgw_update(updates the configuration of an smtp gateway.) generating a custom event generates a custom event. Custom_event d...
Page 268
V email destinations are used for sending notifications via email. When defining a new destination of type email, either the email address of the recipient must be specified in email_address or the user name must be specified in user (in this case the email address of that user is used). V sms desti...
Page 269
Completion codes: v cannot_change_event_conf_with_alerting_events cannot change event configuration while there are alerting events troubleshooting: clear all alerting events before changing event configuration v dest_max_reached maximum number of destinations already defined v dest_name_already_exi...
Page 270
Parameters: name type description mandatory dest object name name of destination to be deleted. Y the command deletes an event notification destination. Destinations that are part of a destination group or used by a rule cannot be deleted. Destinations cannot be deleted while there are uncleared ale...
Page 271
Listing event notification destinations lists event notification destinations. Dest_list [ dest=destname ] [ type= ] parameters: name type description mandatory default dest object name destinations to be listed. N all destinations. Type enumeration filter only destinations of the specified type. N ...
Page 272
User category permission condition application administrator conditionally allowed only the technician can run this command with the internal parameter security administrator disallowed n/a read-only users conditionally allowed only the technician can run this command with the internal parameter tec...
Page 273
V dest_name_is_destgroup_name destination name already exists as a destination group name v dest_name_already_exists destination name already exists testing a destination sends a test message to an event notification destination. Dest_test dest=destname management_ip=ipaddress [ smtpgw=smtpgatewayna...
Page 274
Completion codes: v dest_name_does_not_exist destination name does not exist v dest_test_not_performed_system_busy test of destination 'destination name' not performed because the system is busy troubleshooting: please wait a few seconds and try again v gateway_name_does_not_exist gateway name does ...
Page 275
Name type description mandatory default area_code n/a area code of the cellular number for sms notification. N keep unchanged. Number n/a cellular number for sms notification. N keep unchanged. Smsgws object name sms gateways to be used. N keep unchanged. User object name user name, where the user's...
Page 276
V area_code_not_allowed_for_dest_type destination cannot have an area code v cannot_change_event_conf_with_alerting_events cannot change event configuration while there are alerting events troubleshooting: clear all alerting events before changing event configuration v email_must_be_specified_for_de...
Page 277
V snmp_manager_must_be_specified_for_dest_type destination must have an snmp manager v no_sms_gateways_are_defined an sms destination cannot be defined if no sms gateways are defined adding a destination to a destination group adding an event notification destination to a destination group. Destgrou...
Page 278
V dest_name_does_not_exist destination name does not exist v destgroup_max_dests_reached maximum number of destinations already defined in destination groups v destgroup_already_includes_dest destination group already includes destination name creating a destination group creates an event notificati...
Page 279
V destgroup_max_reached maximum number of destination groups already defined v destgroup_name_already_exists destination group name already exists v destgroup_name_is_dest_name destination group name already exists as a destination name deleting a destination group deletes an event notification dest...
Page 280
Listing destination groups lists destination groups. Destgroup_list [ destgroup=groupname ] parameters: name type description mandatory default destgroup object name destination group to be listed. N all groups. This command lists all destination groups or a specific one. All the destinations are li...
Page 281
Name type description mandatory dest object name destination to be removed from the group. Y this command removes an event notification destination from a destination group. This command cannot be executed while there are uncleared alerting events. Example: destgroup_remove_dest destgroup=alladmins ...
Page 282
Name type description mandatory new_name object name new name of the destination group. Y this command renames an event notification destination group. This command can not be executed while there are uncleared alerting events. Example: destgroup_rename destgroup=alladmins new_name=itstaff output: c...
Page 283
Name type description mandatory default all_ preceding boolean clears all events preceding the specified event. N no. Internal boolean clears xiv-internal events. N no this command clears alerting events. In order to ensure that an event was indeed received, an event notification may be sent repeate...
Page 285
This command lists system events according to specified criteria, such as minimum severity, event type and so on. The event list displays the following information for each event: timestamp, severity, code, user and description. Events are listed and sorted by time of creation, where the latest even...
Page 286
Timestamp severity code 2009-05-12 15:10:16 informational start_work 2009-05-12 15:16:11 informational pool_create 2009-05-12 15:16:22 critical would_be_emergency_shutdown 2009-05-12 15:16:23 informational volume_create additional output fields (lines are broken to fit the page width of this guide):...
Page 287
Output: index code severity ------- --------------- --------------- 318 volume_create informational 666 volume_delete informational id name default position index index 1 code code 2 severity severity 3 access control: user category permission storage administrator allowed storage integration admini...
Page 288
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v event_does_not_have_thresholds event does n...
Page 289
Id name default position default_ thresholds.3 major(def) 10 default_ thresholds.4 critical(def) 11 thresholds.0 informational 2 thresholds.1 warning 3 thresholds.2 minor 4 thresholds.3 major 5 thresholds.4 critical 6 example: event_threshold_list output: code informational warning minor -----------...
Page 290
Generating a custom event generates a mm event. Mm_event description=description [ severity= ] category=category mm_data=additionaldata parameters: name type description mandatory default descriptio n string description of the event. Y n/a severity n/a severity of the event. N informational category...
Page 291
Name type description mandatory serial string serial number of mm. Y part_ number string part number of mm. Y version string version of sw running on mm. Y total_ memory integer total ram of mm. Y free_ memory integer free ram on mm. Y temperatur e integer temperature of mm. Y free_disk_ root intege...
Page 292
Activating a rule activates an event notification rule. Rule_activate rule=rulename parameters: name type description mandatory rule object name name of the rule to be activated. Y this command activates the specified rule. An active rule is matched against events and generates notifications. If the...
Page 293
Name type description mandatory default except_ codes n/a filter only events with other codes. N all events. Escalation _only boolean specifies that this rule can only be used for escalation. N no dests object name comma separated list of destinations and destination groups for event notification. Y...
Page 294
The repeated sending of notifications can be defined by two ways: v the snooze parameter causes the notifications to be sent again and again to the same destinations. The time in minutes between the repeated transmissions is determined by the snooze value. V the escalation_time and escalation_rule p...
Page 295
V event_rule_cannot_escalate_to_non_alerting_rules event rule cannot escalate to non-alerting rule troubleshooting: alerting rule can only escalate to another escalating rule v dest_appears_twice destination or destination group appears twice v event_rule_name_already_exists event rule name already ...
Page 296
This command deactivates the specified rule. A deactivated rule is not matched against events and does not generate notifications. If the rule is already inactive, then this command has no effect. In-active rules can not be used as escalation rules. Escalation_only rules can not be deactivated. Acce...
Page 297
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed warnings: v are_you_sure_you_want_to_delete_rule are you sure y...
Page 298
Id name default position snooze_time snooze time n/a escalation_ rule escalation rule n/a escalation_ only escalation only 7 category category n/a creator creator n/a example: rule_list output: name minimum severity event code destinations ---------------- ---------------- ---------- ---------------...
Page 299
Command completed successfully access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v cannot_chang...
Page 300
Name type description mandatory default dests object name comma separated list of destinations and destination groups for event notification. N leave unchanged. Snooze_ time integer snooze time in minutes. N leave unchanged. Escalation _time integer escalation time in minutes. N leave unchanged. Esc...
Page 301
Troubleshooting: alerting rule can only escalate to another escalating rule v dest_appears_twice destination or destination group appears twice v event_rule_missing_escalation_rule an alerting event rule must have an escalation rule troubleshooting: if escalation time is specified, then an escalatio...
Page 302
Defining an sms gateway defines an sms gateway. Smsgw_define smsgw=smsgatewayname email_address=email subject_line=subjectlinescheme email_body=emailbodyscheme [ smtpgw= ] parameters: name type description mandatory default smsgw object name sms gateway name. Y n/a email_ address token string format...
Page 303
V {areacode}. This escape sequence is replaced by the destination's cellular number area code. V {number}. This escape sequence is replaced by the destination's cellular local number. V {message}. This escape sequence is replaced by the text to be shown to the user. V \{, \}, \\. These are replaced ...
Page 304
Gateway name already exists deleting an sms gateway deletes an sms gateway. Smsgw_delete smsgw=smsgatewayname parameters: name type description mandatory smsgw object name sms gateway to be deleted. Y this command deletes an sms gateway. A gateway cannot be deleted if it is part of a notification ru...
Page 305
Listing sms gateways lists sms gateways. Smsgw_list [ smsgw=smsgatewayname ] parameters: name type description mandatory default smsgw object name name of sms gateway to list. N all gateways. Lists all sms gateways or a specific one. For each sms gateway all its configuration information is listed. ...
Page 306
Parameters: name type description mandatory order object name list of all sms gateways ordered by priority. Y this command sets the priority in which sms gateways are used to send smss. Sms messages can be sent to cell phones through one of the email-to-sms gateways in this list. This command determ...
Page 307
Renaming an sms gateway renames an sms gateway. Smsgw_rename smsgw=smsgatewayname new_name=name parameters: name type description mandatory smsgw object name sms gateway to be renamed. Y new_name object name new name for the sms gateway. Y this command renames an sms gateway. Sms gateways cannot be ...
Page 308
Updating an sms gateway updates an sms gateway. Smsgw_update smsgw=smsgatewayname [ email_address=email ] [ subject_line=subjectlinescheme ] [ email_body=emailbodyscheme ] [ smtpgw= ] parameters: name type description mandatory default smsgw object name sms gateway name. Y n/a email_ address token s...
Page 309
User category permission technicians disallowed completion codes: v cannot_change_event_conf_with_alerting_events cannot change event configuration while there are alerting events troubleshooting: clear all alerting events before changing event configuration v gateway_name_appears_twice gateway name...
Page 310
V many smtp gateways require a valid sender address, otherwise they will not forward the email, as a security measure in order to prevent unauthorized usage of the smtp server. Often this sender address must be limited to a specific domain. V the sender's address is used as the destination for error...
Page 311
Deleting an smtp gateway deletes a specified smtp gateway. Smtpgw_delete smtpgw=smtpgatewayname parameters: name type description mandatory smtpgw object name smtp gateway to be deleted. Y this command deletes a specified smtp gateway. A gateway cannot be deleted if it is part of a notification rule...
Page 312
Gateway is used by an sms gateway listing smtp gateways lists smtp gateways. Smtpgw_list [ smtpgw=smtpgatewayname ] parameters: name type description mandatory default smtpgw object name name of smtp gateway to list. N no. This command lists defined smtp gateways and their configuration information....
Page 313
User category permission condition technicians allowed n/a prioritizing smtp gateways sets the priority of which smtp gateway should be used to send emails. Smtpgw_prioritize order= parameters: name type description mandatory order object name list of all the smtp gateways in order of their priority...
Page 314
V gateway_name_does_not_exist gateway name does not exist v gateway_name_missing_from_list gateway name is missing from the list renaming an smtp gateway renames an smtp gateway. Smtpgw_rename smtpgw=smtpgatewayname new_name=name parameters: name type description mandatory smtpgw object name smtp ga...
Page 315
Updating an smtp gateway updates the configuration of an smtp gateway. Smtpgw_update smtpgw=smtpgatewayname [ address=address ] [ from_address= ] [ reply_to_address= ] [ internal= ] parameters: name type description mandatory default smtpgw object name smtp gateway name. Y n/a address n/a smtp gatew...
Page 316
User category permission condition application administrator conditionally allowed only the technician can run this command with the internal parameter security administrator disallowed n/a read-only users disallowed n/a technicians allowed n/a completion codes: v gateway_name_does_not_exist gateway...
Page 317
Chapter 15. Ip configuration the following sections describe the xiv command line interface (xcli) for ip configuration. The sections are listed as follows: v ipinterface_add_port(adds an ethernet port to the link aggregation group of an ip interface.) v ipinterface_create(creates a new ip interface...
Page 318
Parameters: name type description mandatory ipinterfac e object name ip interface to which the port is to be added. Y port integer number of the port to be added to the group. Y this command adds an ethernet port to the link aggregation group of an ip interface. The specified port is added to the li...
Page 319
Creating a new ip interface creates a new ip interface for iscsi. Ipinterface_create ipinterface=ipinterfacename address=address netmask=networkmask [ gateway=defaultgateway ] [ mtu=mtu ] module=modulenumber ports= [ speed= ] parameters: name type description mandatory default ipinterfac e object na...
Page 320
Ports defined as a link aggregation must be connected to the same ethernet switch, and the parallel link aggregation must be defined on that switch. Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowe...
Page 321
Deleting ip interfaces deletes an ip interface. Ipinterface_delete ipinterface=ipinterfacename parameters: name type description mandatory ipinterfac e object name ip interface to be deleted. Y this command deletes the ip interface. Only the interfaces defined for iscsi traffic can be deleted. Manag...
Page 322
Name type description mandatory default address6 n/a ipv6 address of the interface to be listed. N all interfaces this command lists configuration information for the specified ip interface or for all ip interfaces (including management). The management or vpn name can only be used to view the confi...
Page 324
User category permission read-only users allowed technicians allowed showing the status and configuration of ethernet ports lists all ethernet ports together with their configuration and status. Ipinterface_list_ports this command lists all ethernet ports together with their configuration and status...
Page 325
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed removing ethernet ports from ip interfaces removes an ethernet port from...
Page 326
V port_not_in_interface port is not part of the specified ip interface v command_not_allowed_on_management_interface operation is not allowed on management ip interface v ipinterface_last_port last port in ip interface cannot be removed renaming an ip interface renames an ip interface. Ipinterface_r...
Page 327
Parameters: name description mandatory localipadd ress ip address of the ip interface for which the arp database should be printed. N localipadd ress6 ipv6 address of the ip interface for which the arp database should be printed. N this command prints the arp database of an ip interface, meaning a l...
Page 328
This command runs a route trace to the specified remote host through the specified ip interface. The ip address must be one of the ip addresses defined for iscsi ip interfaces or the management or vpn name. Id name default position traceroute_ output traceroute output 1 access control: user category...
Page 329
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v no_ip_interface_matches_criteria no ip interfa...
Page 330
Name type description mandatory default mtu integer maximum transmission unit: the packet size that is supported by the connecting ethernet switch. N keep unchanged. This command updates the configuration of an existing ip interface. Fields that are not specified do not change their values. The name...
Page 331
Specified mtu value is too large v illegal_ipaddress illegal ip address was entered v duplicate_ipaddresses duplicate ip addresses were specified v illegal_gateway_ipaddress illegal ip address was specified for default gateway v illegal_ipv6address illegal ipv6 address was entered v duplicate_ipv6ad...
Page 332
Name type description mandatory default certificat e n/a the content of a .Pem file, with asterisks (*) instead of newlines. N n/a this command defines a new ipsec connection between an ip interface and a right side. Ip interface could be either management or vpn. If specified, the address of the ri...
Page 334
Completion codes: v ipsec_connection_does_not_exist the specified ipsec connection does not exist v ipsec_connection_exists the ipsec connection already exists v left_interface_not_found the specified left side interface was not found v ipsec_unsupported_for_iscsi ipsec is unsupported for iscsi port...
Page 335
Parameters: name type description mandatory default ipsec_ connection object name ipsec connection to be listed. N all ipsec connections lists specific ipsec connection or all of them. The following information is listed: v name v type (psk, rsa, rsa/psk) v interface v right ip id name default posit...
Page 336
Name type description mandatory default right_ip n/a ipsec tunnels to this right ip to be listed. N ipsec tunnels to any right ip module n/a limits the listing to a specific module. N all modules lists specific ipsec tunnels, or all the ipsec tunnels. The following information is listed: v ipsec con...
Page 337
Parameters: name type description mandatory default timeout n/a specifies the duration of the session. After the duration elapses, the session will be disconnected. Time is specified in hh:mm format. N none idle_ timeout n/a specifies the idle time for the session after which it will be disconnected...
Page 338
Completion codes: v no_support_centers_are_defined no support centers are defined v idle_timeout_must_be_lower_than_timeout the idle timeout, if specified, must be lower than the regular timeout v module_has_no_support_center_port the specified module does not have a port from which support center c...
Page 339
Completion codes: v max_support_centers_defined maximum number of support centers is already defined. Deleting a support center this command deletes a support center. Support_center_delete support_center=supportcentername parameters: name type description mandatory support_ center object name the na...
Page 340
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed warnings: v are_you_sure_you_want_to_disconnect_busy_remote_suppor...
Page 341
Presenting status of a support center this command lists information about all defined support centers. Support_center_status this command lists information about all defined support centers. Id name default position state state 1 connected_ support_ sessions connected sessions 2 minutes_to_ timeout...
Page 342
Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v could_not_get_hw_mon_local could not get ha...
Page 343
Chapter 16. Pki configuration the following sections describe the xiv command line interface (xcli) for pki configuration. The sections are listed as follows: v pki_list(listing pki items) v pki_generate_csr(generate certificate signing request) v pki_generate_private_key_and_csr(generate a private ...
Page 344
V fingerprint v has signed certificate v services id name default position name name 1 fingerprint fingerprint 2 authenticated has signed certificate 3 services services 4 access control: user category permission storage administrator allowed storage integration administrator disallowed application ...
Page 345
User category permission storage integration administrator disallowed application administrator disallowed security administrator allowed read-only users disallowed technicians disallowed completion codes: v failed_creating_certificate_signing_request failed to generate the certificate signing reque...
Page 346
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator allowed read-only users disallowed technicians disallowed completion codes: v failed_creating_certificate_signing_request fa...
Page 347
User category permission read-only users disallowed technicians disallowed warnings: v are_you_sure_you_want_to_delete_certificate are you sure you want to delete certificate? Completion codes: v certificate_name_does_not_exist certificate name was not found troubleshooting: choose a different name ...
Page 349
Troubleshooting: check the parameters import pkcs#12 certificate import pkcs#12 certificate pki_set_pkcs12 name=name password=password certificate=base64data [ services= ] parameters: name type description mandatory default services n/a comma seperated list of services to use this certificate n none...
Page 350
Show signed certificate details show signed certificate details pki_show_certificate name=name parameters: name type description mandatory name string the certificate symbolic name y show signed certificate details example: xcli -u -c xiv1 pki_show_certificate name=ibm id name default position certi...
Page 351
Parameters: name type description mandatory default services n/a comma seperated list of services that need to use this certificate n none name string the certificate symbolic name y n/a certificat e n/a if this parameter is mentioned - the certificate will be replaced n none update pki certificate ...
Page 352
346 ibm xiv storage system user manual.
Page 353: Chapter 17. Infiniband
Chapter 17. Infiniband the following sections describe the xiv command line interface (xcli) for infiniband fabric management. The sections are listed as follows: v ib_port_move(moves existing infiniband port definition to a different port number on the same switch.) v ib_port_list(lists configured ...
Page 354
Completion codes: v ib_port_not_present specified port is not defined in the system. V ib_port_exists specified ib port is already defined in the system. V ib_port_not_valid illegal number for ib port was given. V ib_port_not_licensed specified ib port is not licensed in this switch. V ib_port_move_...
Page 355
V sm port status id name default position port port 1 component_id connected component 2 status status 3 skip_miswire allow any guid 4 saved_ info.Peer_guid guid 5 saved_ info.Last_ state state 6 saved_ info.Port_ down_reason failure reason 7 currently_ functioning currently functioning n/a requires...
Page 356
Parameters: name description mandatory ib_port component specification of infiniband port. Y resume a port that was shutdown due to performance problems. Port must be defined in the configuration. Example: xcli -u -c xiv1 ib_port_perf_resume ib_port=1:ib_switch_port:1:15 access control: user categor...
Page 357
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v ib_port_not_valid illegal number for ib port was ...
Page 358
List configured ib switches. Lists configured ib switches. Switch_list [ switch=componentid ] parameters: name description mandatory default switch ib switch to list. N all ib switchs lists a table of configured ib switches. Example: xcli -u -c xiv1 switch_list id name default position component_id ...
Page 359
Id name default position voltage.1 expected voltage #2 n/a expected_ voltage.1 expected voltage #2 n/a voltage.2 expected voltage #3 n/a expected_ voltage.2 expected voltage #3 n/a voltage.3 expected voltage #4 n/a expected_ voltage.3 expected voltage #4 n/a voltage.4 expected voltage #5 n/a expecte...
Page 360
Id name default position curr_vpd.Mgmt_ sn current vpd - management s/n n/a curr_vpd.Cpu_ sn current vpd - cpu s/n n/a curr_vpd.Asic_ fw_version current asic firmware version n/a curr_vpd.Mgmt_ fw_version current management firmware version n/a prev_ vpd.Chassis_ type previous vpd - chassis type n/a...
Page 361
Id name default position initial_ vpd.Cpu_type initial vpd - cpu type n/a initial_ vpd.Chassis_pn initial vpd - chassis p/n n/a initial_ vpd.Mgmt_pn initial vpd - management p/n n/a initial_ vpd.Cpu_pn initial vpd - cpu p/n n/a initial_ vpd.Chassis_sn initial vpd - chassis s/n n/a initial_ vpd.Mgmt_...
Page 362
Example: xcli -u -c xiv1 sm_service_list id name default position module_id module 1 sm_port1_ status port1 status 2 sm_port2_ status port2 status 3 sm_port1_ config port1 conf 4 sm_port2_ config port2 conf 5 is_port1_ master port1_is_m 6 is_port2_ master port2_is_m 7 access control: user category p...
Page 363
Chapter 18. Access control the following sections describe the xiv command line interface (xcli) for user access control. The sections are listed as follows: v access_define(defines an association between a user group and a host.) v access_delete(deletes an access control definition.) v access_list(...
Page 364
Parameters: name type description mandatory user_group object name user group to be associated with the host or cluster. Y host object name host to be associated with the user group. N cluster object name cluster to be associated with the user group. N this command associates a user group with a hos...
Page 365
Parameters: name type description mandatory user_group object name user group of the access control definition to be deleted. Y host object name host of the access control definition to be deleted. N cluster object name cluster of the access control definition to be deleted. N this command deletes t...
Page 367
Completion codes: v host_bad_name host name does not exist v cluster_bad_name cluster name does not exist v user_group_name_does_not_exist user group name does not exist determining whether challenge-response authentication is enabled on system consoles. Shows whether challenge-response authenticati...
Page 368
Parameters: name type description mandatory value boolean boolean parameter to determine whether challenge-response authentication shall be used. Y sets or unsets challenge-response authentication on system consoles. Example: cr_require_console_access value=yes output: command executed successfully....
Page 369
Name type description mandatory default secure_ port integer secure port number n 636 this command adds an ldap server to the system. Example: ldap_add_server fqdn=ldap.Example.Com address=1.2.3.4 output: command executed successfully. Access control: user category permission storage administrator a...
Page 370
Name type description mandatory default user string the username of the tested user y n/a password string the password of the tested user y n/a this command tries to authenticate a specified user against an ldap server, based on existing configuration access control: user category permission storage...
Page 371
User user name was not authenticated by ldap server 'server fqdn'. V login_failure_user_has_no_recognized_role user user name has no recognized ldap role. V login_failure_user_has_more_than_one_recognized_role user user name has more than one recognized ldap role. V login_failure_user_missing_id_att...
Page 372
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed configuring ldap in the system configures general system parame...
Page 373
Name type description mandatory default storage_ admin_role string ldap value mapped to the xiv storage administrator role. Multiple (up to 8) values are supported and must be separated using a semicolon (;). Multiple roles are not available for sun directory ldap servers. N none read_only_ role str...
Page 374
Name type description mandatory default second_ expiration _event positive integer number of days before expiration of certificate to set second alert (severity: warning) n 30/14/7 (third is smallest) third_ expiration _event positive integer number of days before expiration of certificate to set th...
Page 375
Predefined user, the user will be granted the rights of the corresponding predefined user, regardless of its ldap settings (e.G., association with an xiv application admin role), as ldap is not consulted for predefined users. Example: ldap_config_set base_dn version xiv_group_attrib storage_admin_ro...
Page 376
Ldap role contains duplicated parts v ldap_storage_admin_role_has_wrong_number_of_parts ldap storage admin role contains too many parts troubleshooting: the role is divided to parts by ';' the number of parts shold be between 0 and 8 v ldap_security_admin_role_has_wrong_number_of_parts ldap security...
Page 377
Id name default position secure_port secure port 7 access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed list ldap se...
Page 378
User category permission storage integration administrator disallowed application administrator disallowed security administrator allowed read-only users disallowed technicians disallowed completion codes: v ldap_authentication_is_not_active ldap authentication is not active v ldap_is_not_fully_conf...
Page 379
User category permission security administrator disallowed read-only users disallowed technicians disallowed enabling or disabling ldap-based authentication mode enables/disables ldap-based authentication mode. Ldap_mode_set mode=mode parameters: name type description mandatory mode boolean required...
Page 380
No ldap servers with an ldap certificate are defined in the system v no_ldap_servers_are_defined no ldap servers are defined in the system updating an ldap server definition update an existing server configuration ldap_update_server fqdn=fqdn [ address=address ] [ base_dn=ldapdn ] [ port=portnum ] [...
Page 381
User category permission technicians disallowed warnings: v are_you_sure_you_want_to_update_ldap_server are you sure you want to update the ldap server configuration? Completion codes: v ldap_server_not_found ldap server with specified fqdn is not defined in the system v ssl_certificate_has_expired ...
Page 382
User category permission technicians disallowed warnings: v are_you_sure_you_want_to_remove_ldap_server are you sure you want to remove ldap server? Completion codes: v ldap_server_not_found ldap server with specified fqdn is not defined in the system v ldap_is_active_but_this_is_the_last_server del...
Page 383
Name index value -------------- ------- ------------------------------------------------------ command_line 0 ldapsearch -h ldap://ldapwin2003.Xivldap2.Com:389... Returncode 0 0 stderr 0 stdout 0 dn: cn=employee,cn=users,dc=xivldap2,dc=com stdout 1 description: group one stdout 2 objectsid:: aquaaaa...
Page 384
Name type description mandatory category enumeration the role of the user to be created. Available roles: storageadmin, applicationadmin, securityadmin and readonly. Y email_ address n/a email address of this user. The email address specified here can be used for event notification. Entering this ad...
Page 385
User category permission read-only users disallowed technicians disallowed completion codes: v user_name_already_exists user name already exists v max_users_reached maximum number of users already defined v passwords_do_not_match passwords must be identical v user_phone_number_must_accompany_area_co...
Page 386
User category permission security administrator disallowed read-only users disallowed technicians disallowed completion codes: v ldap_authentication_is_active command is not available while ldap authentication is active v user_name_does_not_exist user name does not exist v user_cannot_be_deleted use...
Page 387
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v user_group_name_does_not_exist user group n...
Page 388
This command creates a new user group. A user group is a group of application administrators who share the same set of snapshot creation limitations. After user groups are created, the limitations of all the users in a user group can be updated using a single command. These limitations are enforced ...
Page 389
Completion codes: v user_group_name_already_exists user group name already exists v max_user_groups_reached maximum number of user groups already defined v ldap_role_already_used ldap role is already in use in ldap configuration or in a user group deleting a user group deletes a user group. User_gro...
Page 390
One or more ldap users might be associated to user group. Are you sure you want to delete this user group? V are_you_sure_you_want_to_delete_user_group are you sure you want to delete user group? V are_you_sure_you_want_to_delete_populated_user_group one or more internal users are associated to user...
Page 391
User category permission application administrator allowed security administrator disallowed read-only users allowed technicians disallowed removing a user from a user group removes a user from a user group. User_group_remove_user user_group=usergroup user=username parameters: name type description ...
Page 392
Completion codes: v user_group_name_does_not_exist user group name does not exist v user_name_does_not_exist user name does not exist v user_group_does_not_include_user user group does not include user v ldap_authentication_is_active command is not available while ldap authentication is active renam...
Page 393
Updating a user group updates a user group. User_group_update user_group=usergroup [ ldap_role=ldaprole ] [ access_all= ] parameters: name type description mandatory default user_group object name the name of the user group to be updated. Y n/a ldap_role string the value representing the user group ...
Page 395
Name category group xiv_development xiv_development yes xiv_maintenance xiv_maintenance yes admin storageadmin yes technician technician yes access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security ...
Page 396
Completion codes: v user_name_does_not_exist user name does not exist v user_name_already_exists user name already exists v user_cannot_be_renamed user cannot be renamed v ldap_authentication_is_active command is not available while ldap authentication is active v user_owns_recovery_key user owns re...
Page 397
A user with the predefined password admin can change the passwords of other users. The category (role) of a user cannot be changed. The user technician does not require a phone number and an email address. Limitations on password changes are as follows: v any user can change his/her own password. V ...
Page 398
V user_not_allowed_to_have_phone_number user not allowed to have phone number v user_not_allowed_to_have_email_address user not allowed to have email address v user_not_allowed_to_change_passwords this user cannot change passwords of other users v user_cannot_be_updated_while_ldap_ authentication_is...
Page 399
Chapter 19. Fibre channel and iscsi configuration and status the following sections describe the xiv command line interface (xcli) for fibre channel port configuration. The sections are listed as follows: v fc_connectivity_list(discovers fc hosts and targets on the fc network.) v fc_port_config(conf...
Page 400
V port id (can be correlated with the switch database) v role: initiator, target, dual v initiator/target (is the same for all lines of the same command) v login status (yes/no) id name default position component_id component id 1 wwpn wwpn 2 port_id port id 3 role role 4 access control: user catego...
Page 401
User category permission read-only users disallowed technicians disallowed completion codes: v component_is_not_an_fc_port component must specify an fc port v fc_port_does_not_exist specified fc port does not exist listing fc ports lists the status and configuration of the system's fc ports. Fc_port...
Page 402
Id name default position currently_ functioning currently functioning 3 port_num port number n/a wwpn wwpn 4 port_id port id 5 role role 6 user_enabled user enabled 7 max_supported_ rate maximum supported rate (gbaud) n/a configured_ rate configured rate (gbaud) n/a current_rate current rate (gbaud)...
Page 403
User category permission security administrator disallowed read-only users allowed technicians allowed resetting fc ports resets an fc port. Fc_port_reset fc_port=componentid fc_port_reset fc_port=componentid [ firmware_reset= ] parameters: name type description mandatory default fc_port n/a fc port...
Page 404
Parameters: name type description mandatory default host object name limits viewing to the ports of a specific host. N all hosts. Fc_host_ port n/a limits viewing to this specific port. N all ports module n/a limits output to only enable connectivity to this module. N all modules fcport n/a limits o...
Page 405
User category permission technicians allowed chapter 19. Fibre channel and iscsi configuration and status 399.
Page 406
400 ibm xiv storage system user manual.
Page 407
Chapter 20. Hardware maintenance the following sections describe the xiv command line interface (xcli) for maintaining hardware components. The sections are listed as follows: v ats_list(list information about ats components) v cf_list(lists the cfs in the xiv system.) v component_list(lists system ...
Page 408
V traces_snapshot(create traces snapshotcreate traces snapshot) v traces_snapshot_list(lists traces snapshots on a module.) v technician_work_in_progress(notifies the system of a technician at work.) v xiv_support_enable(enables xiv support access for a specific period of time limiting access from t...
Page 409
Component id status currently functioning model l1 input ok l2 input ok -------------- -------- ----------------------- --------- ------------- ------------- 1:ats:1 ok yes ats-60a no yes cont.: outlet 1 state outlet 2 state outlet 3 state firmware version ---------------- ---------------- ---------...
Page 410
Id name default position ats_connect_ errors ats connect errors n/a requires_ service requires service n/a service_reason service reason n/a us_type us type n/a l1_source j1 source n/a l2_source j2 source n/a interlock_ failed interlock failed n/a p1_current_ fault p1 current fault n/a p2_current_ f...
Page 412
Id name default position serial serial n/a original_ serial original serial n/a part_number part # n/a original_part_ number original part number n/a size size n/a requires_ service requires service n/a service_reason service reason n/a access control: user category permission storage administrator ...
Page 413
Id name default position component_id component id 1 status status 2 currently_ functioning currently functioning 3 requires_ service requires service n/a service_reason service reason n/a access control: user category permission storage administrator allowed storage integration administrator disall...
Page 414
Once the phase-out process is completed, the component's state is either fail or ready, depending on the argument markasfailed. If true, the phased-out component is marked as a failed component (in order to replace the component). If false, the phased-out component is in the ready state. Access cont...
Page 415
Troubleshooting: check that all psus are properly wired, and ensure that none is failed v system_upgrade_canceled_because_of_node_failure_ during_upgrade last upgrade was canceled because a node failed while the upgrade process was running v failed_not_supported_for_this_component_type this componen...
Page 416
Data to the components (redistribution) begins. Components must be in ready or phasing out states. There is no phase-in for power supplies, sfps or batteries. Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administra...
Page 417
Troubleshooting: please restart the key server gateway node and retry. V no_master_keyserver_defined there is no master key server defined on the system. Troubleshooting: please define a master key server by invoking encrypt_key server_update and retry. V keyserver_communication_generic_error cannot...
Page 418
V containing_component_in_wrong_status operation not allowed in current status of containing component. V ups_not_enough_spares there are not enough spare ups's in the rack to safely complete the command troubleshooting: contact support v hard_reset_not_supported_for_this_component_type hard reset i...
Page 419
Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed warnings: v are_you_sure_you_want_to_hard_reset_module are you ...
Page 420
There is no live key server gateway node on the system. Troubleshooting: please restart the key server gateway node and retry. V no_master_keyserver_defined there is no master key server defined on the system. Troubleshooting: please define a master key server by invoking encrypt_key server_update a...
Page 421
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed forces the service required of a component to ok forces the service requ...
Page 422
Parameters: name type description mandatory default firmware_ type enumeration determines which firmware type is to be upgraded. Y n/a upgrade_ type enumeration determines the procedure for the upgrade: hot or cold. Only hot is currently supported. N hot scope n/a determines, which components are to...
Page 423
Completion codes: v firmware_upgrade_in_progress firmware upgrade in progress troubleshooting: contact support v firmware_upgrade_ups_calibrating firmware upgrade cannot start while a ups is calibrating v module_is_not_ok module status is not ok v firmware_upgrade_invalid_label firmware upgrade labe...
Page 424
User category permission read-only users disallowed technicians allowed completion codes: v no_firmware_upgrade_in_progress no firmware upgrade is in progress status of a firmware upgrade process displays overall status of the ongoing or most recently completed firmware upgrade process component_fir...
Page 425
Id name default position value value 2 example: xcli -u -c xiv1 component_firmware_upgrade_status output: name value ------------------ ------------ last_process_start 2012-11-08 12:30:46 last_process_end in_progress yes abort no abort_reason firmware_type disk upgrade_type hot scope 1:module:3 labe...
Page 426
Id name default position component_id component id 1 state state 2 result result 3 example: xcli -u -c xiv1 component_firmware_upgrade_progress output: component id state result -------------- ------------- --------- 1:disk:3:1 done success 1:disk:3:2 done success 1:disk:3:3 done success 1:disk:3:4 ...
Page 427
Hca_list output: component id status currently functioning board description board id part number ------------- ------- ---------------------- ------------------ --------------- ----------- 1:hca:10:1 ok yes falcon ddr mt_0d80120008 mhrh29b-xtr 1:hca:13:1 ok yes owl ddr mt_0f90120008 mhrh2a-xtr 1:hc...
Page 428
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed listing cna adapters in the system lists the cna adapters in the xiv sys...
Page 429
Id name default position original_ board_ description original board description n/a board_id board id 5 original_ board_id original board id n/a board_type board type n/a original_ board_type original board type n/a serial serial n/a original_ serial original serial n/a part_number part number 6 or...
Page 430
Parameters: name description mandatory default module limits the listing to a specific module. N all dimms in all modules. Dimm lists only a specific dimm. N a specific dimm. This command lists the dimms in the xiv system. Example: dimm_list -f all output: component id status currently functioning h...
Page 431
Id name default position slot slot n/a size size(mb) n/a speed speed(mhz) n/a manufacturer manufacturer n/a serial serial n/a original_ serial original serial n/a part_number part # n/a original_part_ number original part number n/a requires_ service requires service n/a service_reason service reaso...
Page 432
Component id status currently functioning hardware status cpu number family -------------- -------- ----------------------- ----------------- ------------ -------- 1:cpu:10:1 ok yes ok 1 xeon 1:cpu:11:1 ok yes ok 1 xeon 1:cpu:12:1 ok yes ok 1 xeon 1:cpu:13:1 ok yes ok 1 xeon 1:cpu:1:1 ok yes ok 1 xe...
Page 433
Id name default position requires_ service requires service n/a service_reason service reason n/a access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users al...
Page 434
Component id status currently functioning enabled version ----------------------- -------- ----------------------- --------- ---------- 1:maintenancemodule:1 ok yes yes mgmt-4.5 temperature serial original serial part # original part number ------------- ------------ ----------------- ------------ -...
Page 435
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed listing nics in the system lists the nics in the xiv system. Nic_list [ ...
Page 436
Root@nextra-mn00058-module-5:/# xcli.Py nic_list -f all component id status currently functioning hardware status device name -------------- -------- ----------------------- ----------------- ------------- 1:nic:4:1 ok yes ok eth0 1:nic:4:10 ok yes ok eth9 1:nic:4:2 ok yes ok eth1 1:nic:4:3 ok yes o...
Page 437
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed listing modules internal temperatures lists the modules' internal temper...
Page 438
Id name default position normalized_ temperature normalized ambient 2 ses_ temperatures.0 raw ambient 3 ses_ temperatures.1 midplane 4 ses_ temperatures.2 em card 5 ses_ temperatures.3 fan controller 6 ses_ temperatures.4 cpu 1 7 ses_ temperatures.5 cpu 2 n/a ses_ temperatures.6 dimm 1 n/a ses_ temp...
Page 439
Id name default position ses_ temperatures.1 5 dimm 10 n/a ses_ temperatures.1 6 dimm 11 n/a ses_ temperatures.1 7 dimm 12 n/a ses_ temperatures.1 8 pcie 11 ib_hca_ temperature infiniband hca 12 cna_ temperature cna 13 sas_ controller_ temperature sas controller n/a fc_adapter_ temperature.0 fibre c...
Page 440
Monitoring rebuild or redistribution processes monitors the status of a rebuild or redistribute process. Monitor_redist this command outputs the current rebuild or redistribution process. This command may show that no such process exists. If such a process exists, the following information is shown:...
Page 442
Id name default position original_ firmware original firmware n/a original_group original group n/a requires_ service requires service n/a service_reason service reason n/a revision revision n/a original_ revision original revision n/a drive_pn drive p/n n/a original_ drive_pn original drive p/n n/a...
Page 443
Id name default position desc.Temperatu re_ status.Tempera ture disk temperature n/a security_state security state n/a security_ state_last last security state n/a access control: user category permission storage administrator allowed storage integration administrator disallowed application administ...
Page 444
Id name default position currently_ functioning currently functioning 3 target_status target status 4 type type 5 disk_bay_count data disks 6 fc_port_count fc ports 7 ethernet_port_ count iscsi ports 8 normalized_ temperature temperature 9 serial serial n/a original_ serial original serial n/a part_...
Page 445
Id name default position electronics_ serial electronics serial n/a electronics_ part_number electronics part number n/a access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowe...
Page 446
Ethernet interface is out of bounds, bigger than the last ethernet interace index v illegal_ethernet_interface_role only internal ethernet interfaces can be reset v ethernet_interface_is_active ethernet interface is active and used in network routing, cannot reset it check modules serial connections...
Page 447
Monitoring module desired module connected module status is module alive ------------------- ---------------- ------------------ ---------------- ----------------- 1:module:1 1:module:3 1:module:3 good yes 1:module:15 1:module:14 1:module:14 good yes 1:module:2 1:module:1 1:module:1 good yes 1:modul...
Page 448
Parameters: name description mandatory default ups lists the status only for the specified ups. N all ups systems. This command lists the status of the components of upss. The following information is provided: v generic status v input power on: y/n v battery charge level v last date of self-test v ...
Page 449
Id name default position runtime_ remaining runtime remaining 5 battery_ charge_level battery charge level 6 last_self_ test_date last self test date 7 last_self_ test_result last self test result 8 is_enabled monitoring enabled 9 ups_status ups status 10 last_ calibration_ date last calibration dat...
Page 450
Id name default position self_test_ status self-test status n/a component_ test_status component test status n/a battery_year.0 first battery year born n/a battery_week.0 first battery week born n/a battery_year.1 second battery year born n/a battery_week.1 second battery week born n/a battery_seria...
Page 451
Parameters: name description mandatory default service service to be listed. N all services this command lists the statuses that apply to services. The list includes the following information: v component generic status v service on/failed v comment (optional) id name default position component_id c...
Page 452
Component id status currently functioning hardware status power -------------- -------- ----------------------- ----------------- --------- 1:psu:13:1 failed no no input power 1:psu:13:2 ok yes ok 92.69w 1:psu:14:1 failed no no input power 1:psu:14:2 ok yes ok 114.13w 1:psu:15:1 failed no no input p...
Page 453
User category permission read-only users allowed technicians allowed resetting a failed command service. Resets a specified command service on a specified module. Reset_command_service service=servicename module=modulenumber parameters: name type description mandatory module n/a target module on whi...
Page 454
Stopping system traces stops system traces. Traces_stop stops system traces. Id name default position module module 1 status status 2 example: xcli -u -c nextra1 traces_stop output: module status ------------- --------- 1:module:1 stopped 1:module:2 stopped 1:module:3 stopped 1:module:4 stopped 1:mo...
Page 455
Id name default position module module 1 status status 2 example: xcli -u -c nextra1 traces_resume output: module status ------------- --------- 1:module:1 running 1:module:2 running 1:module:3 running 1:module:4 running 1:module:5 running 1:module:6 running 1:module:7 running 1:module:8 running 1:m...
Page 456
Output: module status ------------- --------- 1:module:1 running 1:module:2 running 1:module:3 stopped 1:module:4 running 1:module:5 running 1:module:6 running 1:module:7 running 1:module:8 running 1:module:9 running 1:module:10 running 1:module:11 running 1:module:12 running 1:module:13 running 1:m...
Page 457
Xcli.Py traces_snapshot snapshot_back_time=60 snapshot_delay_time=1 access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowe...
Page 458
Notifying the system of a technician at work notifies the system of a technician at work. Technician_work_in_progress [ mode=mode ] [ timeout=timeout ] [ comment=comment ] parameters: name type description mandatory default mode enumeration mode of the command. Start resets the timeout. End notifies...
Page 459
Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v technician_work_timeout_cannot_be_specified...
Page 460
Name type description mandatory default from n/a the source address that xiv support access limited. It may be either ipv4 or ipv6 address, or any , or technician denoting laptop port. Y n/a comment string reason why xiv support access is enabled. Y n/a enables xiv support access for a specific peri...
Page 461
Disables xiv support access disables xiv support access xiv_support_disable disables xiv support acess example: xcli -u -c xiv1 xiv_support_disable output: command executed successfully. Access control: user category permission storage administrator allowed storage integration administrator disallow...
Page 462
Id name default position from from 2 start start 3 finish finish 4 comment comment 5 access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technic...
Page 463
Component does not exist v ups_not_in_calibration ups calibration is not in calibration troubleshooting: contact support check ups monitor cables check ups monitor cables ups_check_monitor_cables ups=componentid parameters: name description mandatory ups the ups to check its monitor cables y check u...
Page 464
Parameters: name type description mandatory battery_ serial string first battery serial number y second_ battery_ serial string second battery serial number y ups n/a the ups to set the batteries date on y set the ups batteries date example: ups_set_battery_date ups=1:ups:2 battery_serial=tv10021601...
Page 465
Start ups calibration example: xcli -u -c xiv1 ups_start_calibration ups access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technician...
Page 466
This command has no output. Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians allowed completion codes: v ups_is_unmonito...
Page 467
User category permission technicians allowed warnings: v are_you_sure_you_want_to_turn_ups_off are you sure you want to turn the ups output power off? Troubleshooting: contact support completion codes: v ups_is_unmonitored the specified ups is not monitored and commands cannot be run on it troublesh...
Page 468
Component id status currently functioning ------------- -------- ----------------------- 1:fan:1:1 ok yes 1:fan:1:10 ok yes 1:fan:1:2 ok yes 1:fan:1:3 ok yes 1:fan:1:4 ok yes 1:fan:1:5 ok yes 1:fan:1:6 ok yes 1:fan:1:7 ok yes 1:fan:1:8 ok yes 1:fan:1:9 ok yes id name default position component_id co...
Page 469
Component id status currently functioning ------------- -------- ----------------------- 1:ssd:1:1 ok yes 1:ssd:10:1 ok yes 1:ssd:2:1 ok yes 1:ssd:3:1 ok yes 1:ssd:4:1 ok yes 1:ssd:5:1 ok yes 1:ssd:6:1 ok yes 1:ssd:7:1 ok yes 1:ssd:8:1 ok yes 1:ssd:9:1 ok yes id name default position component_id co...
Page 470
Id name default position drive_pn drive_pn n/a original_ drive_pn original drive pn n/a desc.Last_ sample_serial last sample serial n/a desc.Last_ sample_time last sample time n/a desc.Power_on_ hours power on hours n/a desc.Block_ wear_leveling block wear leveling n/a desc.Secure_ erase_status secu...
Page 471
Example: xcli -u -c xiv1 ssd_caching_disable output: command executed successfully access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed ...
Page 472
Completion codes: v component_does_not_exist component does not exist v ssd_caching_already_enabled ssd caching feature was already enabled. V hot_upgrade_is_not_ongoing hot upgrade is not currently ongoing v cannot_write_to_key_repository failed writing keys to the key repository. Troubleshooting: ...
Page 473
Completion codes: v ssd_caching_not_enabled ssd caching feature was not enabled. Setting a default state for ssd caching sets a default state for ssd caching vol_default_ssd_caching_set default= parameters: name type description mandatory default enumeration the ssd caching state that will be the de...
Page 474
Overrides the default ssd caching state for a volume. Example: xcli -u -c xiv1 vol_ssd_caching_set vol state output: command executed successfully access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed ...
Page 475
Example: xcli -u -c xiv1 system_average_power_consumption output: todo access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed s...
Page 476
470 ibm xiv storage system user manual.
Page 477: Chapter 21. Statistics
Chapter 21. Statistics the following sections describe the xiv command line interface (xcli) for getting system statistics. Other command that are relevant to this topic is: obtaining statistics on past sync jobs the sections are listed as follows: v statistics_get(retrieves performance statistics f...
Page 478
Name type description mandatory default local_fc_ port n/a limits statistics to i/o performed on the specified fc port only. N all ports. Vol object name limits statistics to the specified volume only. N all volumes. Start n/a starting point for the statistics report. N n/a end n/a ending point for ...
Page 479
The year, month and day are separated by dashes, and the optional hours, minutes and seconds are separated by colons. Output units: v very large blocks - are >512kb v large blocks - are 64-512kb v medium blocks - are 8-64kb v small blocks - are 0-8kb v the latency is in microsecond v the bandwidth i...
Page 480
Id name default position read_hit_ small_latency read hit small - latency 12 read_hit_ small_ throughput read hit small - throughput 13 read_miss_ very_large_ iops read miss very large - iops 14 read_miss_ very_large_ latency read miss very large - latency 15 read_miss_ very_large_ throughput read m...
Page 481
Id name default position write_hit_ very_large_ latency write hit very large - latency 27 write_hit_ very_large_ throughput write hit very large - throughput 28 write_hit_ large_iops write hit large - iops 29 write_hit_ large_latency write hit large - latency 30 write_hit_ large_ throughput write hi...
Page 482
Id name default position write_miss_ large_latency write miss large - latency 42 write_miss_ large_ throughput write miss large - throughput 43 write_miss_ medium_iops write miss medium - iops 44 write_miss_ medium_latency write miss medium - latency 45 write_miss_ medium_ throughput write miss medi...
Page 483
Id name default position read_memory_ hit_medium_ latency read memory-hit medium - latency 57 read_memory_ hit_medium_ throughput read memory-hit medium - throughput 58 read_memory_ hit_small_iops read memory-hit small - iops 59 read_memory_ hit_small_ latency read memory-hit small - latency 60 read...
Page 484
Port id is not defined v ipinterface_does_not_exist ip interface name does not exist v perf_class_bad_name performance class does not exist v iscsi_host_illegal_port_name port name for iscsi host is illegal troubleshooting: port names for iscsi hosts must contain only printable characters. Retrievin...
Page 485
Access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator disallowed read-only users disallowed technicians disallowed completion codes: v volume_bad_name volume name does not exist ...
Page 486
480 ibm xiv storage system user manual.
Page 487: Chapter 22. Meta-Data
Chapter 22. Meta-data the following sections describe the xiv command line interface (xcli) for meta-data handling. The sections are listed as follows: v metadata_set(sets a meta-data of an object.) v metadata_delete(deletes a meta-data of an object.) v metadata_list(lists a meta-data of an object.)...
Page 488
User category permission condition application administrator conditionally allowed metadata can be set for only volumes, snapshots, snapshot groups, clusters or hosts, and only for objects associated with the application administrator executing the command. Hosts or clusters should be associated wit...
Page 489
User category permission condition application administrator conditionally allowed metadata can be set for only volumes, snapshots, snapshot groups, clusters or hosts, and only for objects associated with the application administrator executing the command. Hosts or clusters should be associated wit...
Page 490
Id name default position key key 3 value value 4 access control: user category permission storage administrator allowed storage integration administrator allowed application administrator allowed security administrator disallowed read-only users allowed technicians allowed 484 ibm xiv storage system...
Page 491
Chapter 23. Encryption enablement and support commands the following sections describe the xiv command line interface (xcli) for encryption configuration. The sections are listed as follows: v encrypt_disable(disable the data protection feature) v encrypt_enable(enable the data protection feature) v...
Page 492
Output: command executed successfully. Access control: user category permission storage administrator disallowed storage integration administrator disallowed application administrator disallowed security administrator allowed read-only users disallowed technicians disallowed warnings: v are_you_sure...
Page 493
Cannot connect to an active key server. Troubleshooting: invoke encrypt_key server_list and event_list for more details. Enabling encryption enable the data protection feature encrypt_enable [ recovery_keys= ] parameters: name type description mandatory default recovery_ keys boolean are recovery ke...
Page 494
V invalid_recovery_key_state recovery key state is inconsistent with the option provided. Troubleshooting: check the recovery key state using encrypt_recovery_key_list. V encryption_already_enabled encryption has already been enabled. Troubleshooting: check the state_list command v cannot_enroll_som...
Page 495
Name type description mandatory default ipv6 n/a the ipv6 address of the keyserver being added. Either one ipv4 and/or one ipv6 must be used n none port integer port used for keyserver communication. N 5696 this command defines a keyserver to be used by the system upon startup or encryption activati...
Page 496
Troubleshooting: add ipv4= or ipv6= to the command v encryption_keyserver_ipv4_already_exists the ipv4 address or host name already exists. Troubleshooting: check the currently defined key servers v encryption_keyserver_ipv6_already_exists the ipv6 address or host name already exists. Troubleshootin...
Page 497
Unknown key server name. Troubleshooting: check the currently defined key servers v encryption_delete_master_keyserver removal of master key server is not permitted. Troubleshooting: a new master key server must be defined before removing the current master. V encryption_last_defined_keyserver canno...
Page 498
Id name default position heartbeat_ status_ip network status 3 heartbeat_ keyserver_ status app/key status 4 last_heartbeat last time checked 5 master master 6 port port 7 address address 8 access control: user category permission storage administrator allowed storage integration administrator disal...
Page 499
User category permission application administrator disallowed security administrator allowed read-only users disallowed technicians disallowed completion codes: v unsupported_hardware cannot utilize encryption on unsupported hardware. Troubleshooting: contact support to verify encryption status. V e...
Page 500
V keyserver_communication_generic_error cannot connect to an active key server. Troubleshooting: invoke encrypt_key server_list and event_list for more details. Rename keyserver change the name of a defined keyserver encrypt_keyserver_rename name=name new_name=name parameters: name type description ...
Page 501
Change keyserver properties change a keyserver ip address and/or port encrypt_keyserver_update name=name [ ipv4=address ] [ ipv6=address ] [ port=portnumber ] [ master= ] [ certificate=pemcertificate ] parameters: name type description mandatory default name string name of the keyserver to update y ...
Page 502
Troubleshooting: check the currently defined key servers v encryption_keyserver_ipv4_already_exists the ipv4 address or host name already exists. Troubleshooting: check the currently defined key servers v encryption_keyserver_ipv6_already_exists the ipv6 address or host name already exists. Troubles...
Page 503
User category permission read-only users disallowed technicians disallowed completion codes: v unsupported_hardware cannot utilize encryption on unsupported hardware. Troubleshooting: contact support to verify encryption status. V invalid_recovery_key_fragment recovery key fragment given does not ma...
Page 504
Parameters: name type description mandatory default min_req integer minimum number of required security administrators recovery key shares. N 2 users object name user names of the security administrators. Y n/a this command specifies the security administrators receive the recovery keys (or, more ac...
Page 505
Troubleshooting: please restart the key server gateway node and retry. V cannot_write_to_key_repository failed writing keys to the key repository. Troubleshooting: contact support. V cannot_get_new_key_request error requesting encryption keys from the key server gateway node. Troubleshooting: check ...
Page 506
This command presents the recovery key generated for the current user (via encrypt_recovery_key_generate or encrypt_recovery_key_rekey) for the user to store in a secure manner. Then, after running this command, the user needs to 'prove' that they have the key by entering it via the encrypt_recovery...
Page 507
Troubleshooting: please define a master key server by invoking encrypt_key server_update and retry. V invalid_recovery_key_state recovery key state is inconsistent with the option provided. Troubleshooting: check the recovery key state using encrypt_recovery_key_list. V recovery_key_already_verified...
Page 508
User category permission technicians disallowed completion codes: v unsupported_hardware cannot utilize encryption on unsupported hardware. Troubleshooting: contact support to verify encryption status. V no_live_keyserver_gateway_node there is no live key server gateway node on the system. Troublesh...
Page 509
Entered his recovery key. Information about how many shares have been defined and the minimum number required for recovery is available via encrypt_recovery_key_list. Example: xcli -u secadmin1 -p password -c xiv1 encrypt_recovery_key_status output: mon aug 12 20:04:43 idt 2013 date created user sta...
Page 510
Recovery key verification used to confirm that the current user has correctly copied the recovery key share presented by encrypt_recovery_key_get encrypt_recovery_key_verify key=key parameters: name description mandatory key the 64 character hexadecimal recovery key y this command is meant to be use...
Page 511
User is not a valid recovery key administrator. Troubleshooting: check that the user names provided are valid v cannot_read_from_key_repository failed reading keys from the key repository. Troubleshooting: contact support. V rk_failed_verify_sleep too many failed verify attempts, please wait and try...
Page 512
Id name default position number_of_ shares number of shares 2 min_req min required 3 access control: user category permission storage administrator allowed storage integration administrator disallowed application administrator disallowed security administrator allowed read-only users allowed technic...
Page 513: Chapter 24. Events
Chapter 24. Events volume_create severity informational description volume was created with name 'volume.Name' and size volume.Sizegb in storage pool with name 'volume.Pool_name'. Volume_create_failed_too_many severity warning description volume with name 'name' could not be created. You are attempt...
Page 514
Volume_format severity informational description volume with name 'volume.Name' was formatted. Volume_copy severity informational description volume with name 'source.Name' was copied to volume with name 'target.Name'. Volume_lock severity informational description volume with name 'volume.Name' was...
Page 515
Volume_set_default_ssd_caching severity informational description default ssd caching for volumes was set to be 'state'. Data_rebuild_started severity informational description rebuild process started because system data is not protected. Data_percent% of the data must be rebuilt. Data_rebuild_compl...
Page 516
Storage_pool_unlocked severity major description pool 'pool' has empty space. All volumes are unlocked. Troubleshooting n/a storage_pool_volume_usage_increased severity variable description usage by volumes of storage pool with name 'pool.Name' has reached current%. Troubleshooting n/a storage_pool_...
Page 517
Host_connected severity informational description host 'host' has connected to the system. Troubleshooting n/a host_disconnected severity informational description host 'host' has disconnected from the system. Troubleshooting n/a host_multipath_ok severity informational description host 'host' has r...
Page 518
Description storage pool of size pool.Sizegb was created with name 'pool.Name'. Pool_create_thin severity informational description storage pool of soft size pool.Soft_sizegb and hard_ size pool.Hard_sizegb was created with name 'pool.Name'. Pool_create_failed_too_many severity warning description s...
Page 519
Pool_config_snapshots severity informational description management policy of mirroring snapshots of storage pool with name 'pool.Name' has changed'. Pool_delete severity informational description storage pool with name 'pool.Name' was deleted. Command_service_failed_too_many_times severity major de...
Page 520
Troubleshooting please contact support. Requirement_is_missing severity critical description requirement requirement name is missing critical_thread_did_not_heartbeat severity critical description thread named 'thread name' in process 'process_name' for node node id on module module did not heartbea...
Page 521
Module_download_version_timeout severity warning description timeout expired trying to download current version of the system to module module id. Troubleshooting please contact support. Error_setting_up_interface severity major description error attempting setup ethernet interface interface name on...
Page 522
Troubleshooting please contact your administrator. Ipsec_tunnel_opened severity informational description the ipsec tunnel named 'name' between module module and right ip was opened ipsec_tunnel_closed severity informational description the ipsec tunnel named 'name' between module module and right i...
Page 523
Boidem_missing_mount_point severity warning description boidem is missing a mount point at missing mount point on module module. Boidem_fs_is_ro severity warning description boidem mount point read-only mount point is in a read-only state on module module. Boidem_disk_unresponsive severity warning d...
Page 524
Boidem_disk_keepalive_ok severity minor description disk disk id is responding to keepalives of type type after time from last success msecms boidem_disk_keepalive_failed severity warning description disk disk id is not responding to keepalives of type type for time from last success msecms troubles...
Page 525
Remote_operation_failed_timed_out severity warning description operation on remote machine timed out. Invoking 'function name' on target 'target name' timed out. Troubleshooting retry operation. If problem persists contact support. Mirror_resync_failed severity major description synchronization of m...
Page 526
Description synchronization of remote mirror of peer 'local peer name' on target 'target name' can not be synced , insufficent volume available for this operation. Mirror_reestablish_failed severity major description mirror reestablish failed. Connection to remote mirror of peer 'local peer name' on...
Page 527
Description the remote mirror relation of peer 'local peer name' to a peer on target 'target name' was deleted. Mirror_reverse_role_to_slave severity informational description local peer 'local peer name' is now slave of a peer on target 'target name'. Mirror_reverse_role_to_master severity informat...
Page 528
Mirror_change_designation severity informational description local peer 'local peer name' switched its designated role with peer on target 'target name'. It is now designation. Mirror_cancel_snapshot severity informational description all mirrored snapshots which were created for mirror of peer 'loc...
Page 529
Dm_deactivate severity informational description migration to volume 'local volume name' from target 'target name' was deactivated. Dm_deactivate_lun_unavailable severity minor description migration to volume 'local volume name' from target 'target name' was deactivated since lun is not available on...
Page 530
Mirror_rpo_lagging severity informational description mirror of local peer 'local peer name' is now behind its specified rpo. Mirror_change_rpo severity informational description rpo or mirror of local peer 'local peer name' is now rpo. Mirror_is_lagging_beyond_percent_threshold severity warning des...
Page 531
Cluster_define_exception severity informational description lun 'lun' was defined as having host specific mapping in cluster 'cluster'. Cluster_cancel_exception severity informational description lun 'lun' was defined as having uniform mapping in cluster 'cluster'. Special_type_set severity informat...
Page 532
Module_failed severity critical description component id failed. Troubleshooting please contact support. Node_failed severity critical description node #node id of type node type on module component id failed because of failure_reason. Troubleshooting please contact support. Node_reset severity info...
Page 533
Ssd_has_failed severity major description ssd component id failed. Troubleshooting please contact your administrator. Disk_info_extra_event severity informational description disk component id extra information event. Troubleshooting n/a ssd_info_extra_event severity informational description ssd co...
Page 534
Disk_started_phasein severity informational description system started phasing in component id. Troubleshooting n/a disk_finished_phasein severity informational description system finished phasing in component id. Troubleshooting n/a disk_finished_phaseout severity informational description system f...
Page 535
Module_stopped_phaseout_due_to_management_ requirement severity major description system stopped phasing out component id due to management requirement. Troubleshooting n/a module_phaseout_failure_reason severity informational description system could not phaseout component id due to lack of nodes o...
Page 536
Shutdown_params severity major description system action is 'shutdown action'. Target state is 'target state'. Safemode is 'safe mode'. Ups sleep time=ups sleep time in seconds seconds. Disk_started_auto_phasein severity critical description system started phasing in component id in order to ensure ...
Page 537
Service_was_restarted severity informational description module id was restarted. Data_service_started_phaseout severity informational description system started phasing out component id. Troubleshooting n/a data_service_finished_phaseout severity informational description system finished phasing ou...
Page 538
Description disk component id has a size of new sizegb which is smaller than system disk size system sizegb. Disk_larger_than_system_disk_size severity variable description disk component id has a size of new sizegb which is larger than system disk size system sizegb. Disk_model_different_than_syste...
Page 539
Flash_cache_enable severity informational description flash cache feature enabled. Ssds can now be installed. Troubleshooting n/a flash_cache_disable severity informational description flash cache feature disabled. Troubleshooting n/a cf_failed severity major description component id has failed. Har...
Page 540
Module_original_serial_cleaned severity major description component id had an illegal original serial number of original serial which was changed to clean original serial. Troubleshooting is this a pre-ga module? Module_original_part_number_cleaned severity major description component id had an ille...
Page 541
Infiniband_hca_board_id_change_detected severity major description adapter module board id changed from 'old board id' to 'new board id'. Troubleshooting was this infiniband hca actually replaced? Cna_change_detected severity major description adapter cna id serial number changed from old_serial to ...
Page 542
Psu_change_detected severity informational description component id has been changed from a serial number old_serial, part number 'old_part_number', to serial number new_serial and part number 'new_part_number'. Troubleshooting was this psu actually replaced? Cpu_change_detected severity major descr...
Page 543
Technician_work_ended severity informational description technician work has ended after elapsed time minutes. Comment: comment. Troubleshooting n/a technician_work_timed_out severity warning description technician work has timed out after elapsed time minutes. Comment: comment. Troubleshooting n/a ...
Page 544
Cluster_create severity informational description cluster was defined with name 'cluster.Name'. Host_define_failed_too_many severity warning description host with name 'name' could not be defined. You are attempting to define more hosts than the system permits. Troubleshooting delete hosts to allow ...
Page 545
Cluster_add_host severity informational description host with name 'host.Name' was added to cluster with name 'cluster.Name'. Host_remove_port severity informational description port of type type and id 'port_name' was removed from host with name 'host.Name' was deleted. Cluster_remove_host severity...
Page 546
Destination_group_rename severity informational description destination group with name 'old name' was renamed 'new name'. Destination_group_add_destination severity informational description destination with name 'destination name' was added to destination group 'destgroup name'. Destination_group_...
Page 547
Smtp_gateway_delete severity informational description smtp gateway with name 'name' was deleted. Smtp_gateway_rename severity informational description smtp gateway with name 'old name' was renamed 'new name'. Smtp_gateway_prioritize severity informational description smtp gateways were prioritized...
Page 548
Sms_gateway_prioritize severity informational description sms gateways were prioritized; the new order is order. Events_were_discarded severity variable description number of events pending events of maximal severity 'maximal severity' were discarded because of overload. Troubleshooting please conta...
Page 549
Cons_group_remove_volume severity informational description volume with name 'volume.Name' was removed from consistency group with name 'cg.Name'. Slave_cons_group_remove_volume severity informational description volume with name 'volume.Name' was removed from consistency group with name 'cg.Name' b...
Page 550
Description mirrored snapshot group for consistency group with name 'cg.Name' was created with name 'cs_name'. Mirror_cons_group_snapshots_overwrite severity informational description mirrored snapshot group named 'cs_name' was overriden for consistency group with name 'cg.Name'. Mirror_snapgroup_cr...
Page 551
Description deletion priority of all snapshots in snapshot group with name 'cs_name' were changed from 'old priority' to 'new priority'. Snapshot_group_lock severity informational description all snapshots in snapshot group with name 'cs_name' were locked. Snapshot_group_unlock severity informationa...
Page 552
Xcg_add_cg severity informational description cg with name 'cg.Name' was added to cross consistency group with name 'xcg'. Xcg_remove_cg severity informational description cg with name 'cg.Name' was removed from cross consistency group with name 'xcg'. Target_define severity informational descriptio...
Page 553
Target_port_activate severity informational description port 'port_name' in target named 'target.Name' was activated. Target_port_deactivate severity informational description port 'port_name' was deactivated in target named 'target.Name'. Target_connectivity_create severity informational descriptio...
Page 554
Description connectivity between port 'connection remote port address' of target named 'connection target name' and local fc port was activated. Target_iscsi_connectivity_activate severity informational description connectivity between port 'connection remote port address' of target named 'connectio...
Page 555
Description snapshot named 'snapshot.Name' was created for volume named 'volume.Name'. Snapshot_overwrite severity informational description snapshot named 'snapshot.Name' was overriden for volume named 'volume.Name'. Snapshot_format severity informational description snapshot named 'snapshot.Name' ...
Page 556
Snapshot_deleted_due_to_pool_exhaustion severity warning description snapshot named 'snap.Name' has been deleted because storage pool named 'snap.Pool_name' is full. Troubleshooting n/a mirror_snapshot_create severity informational description mirrored snapshot named 'snapshot.Name' was created for ...
Page 557
Cache_has_less_memory severity warning description data module has less memory than expected. Node=node - gb_missing gb missing. Troubleshooting some of the dimms might have failed unusual_conf_lock_time severity warning description very long conf-lock duration. Node=node, duration_msec=duration, tr...
Page 558
Troubleshooting n/a invalid_partition_static_flag severity critical description partition static flag doesn't match requested metadata static flag. Partition number partition number volume volume number flags partition flags metadata flags metadata flags. Troubleshooting n/a suspect_data_loss severi...
Page 559
Scrubbing_remote_digest_diff_identified_and_ corrected severity informational description scrubbing identified and corrected data on remote system. Disk disk tracks diff count tracks were different. First diff track track local: (local digest 0, local digest 1) remote: (remote digest 0, remote diges...
Page 560
Buffer_pool_empty severity major description the memory pool of cache buffers in node=node is exhausted. All pool_size buffers are allocated. Troubleshooting n/a orphaned_async_partition severity warning description an active async job (job id) running on cache node disk disk id found partition logi...
Page 561
Troubleshooting n/a disk_deferred_error severity warning description deferred error on disk id, start lba=start lba, last lba=last lba, latency=latency msec, key=key troubleshooting n/a ssd_medium_error severity warning description media errors on ssd id, start lba=start lba, last lba=last lba, late...
Page 562
Disk_long_latency severity variable description long latencies on disk i/os in the last 30 minutes on disk id, start lba=start lba, last lba=last lba, command=command, latency=latency msec. Troubleshooting n/a ssd_long_latency severity variable description long latencies on ssd i/os in the last 30 m...
Page 563
Ssd_keepalive_ok severity major description ssd ssd id is responding to keepalives of type type after time from last success msecms troubleshooting n/a disk_unresponsive severity major description disk disk id is unresponsive for time msecs, cache dirty level is dirty level% ssd_unresponsive severit...
Page 564
Scrubber_was_repositioned severity major description the position of the scrubber on disk disk id was modified by the user (from old value to new value). User_defined severity informational description a user with name 'name' and category category was defined. Troubleshooting n/a user_deleted severi...
Page 565
Description a user group with name 'name' was created. Troubleshooting n/a user_group_deleted severity informational description a user group with name 'name' was deleted. Troubleshooting n/a user_group_renamed severity informational description user group with name 'old name' was renamed 'new name'...
Page 566
User_login_has_failed severity warning description user 'user name' from ip 'client address' failed logging into the system. Troubleshooting n/a user_has_failed_to_run_command severity warning description user 'user name' from ip 'client address' failed authentication when trying to run command 'com...
Page 567
Access_to_host_granted_to_user_group severity informational description user group 'user group name' was granted access to host 'host name'. Troubleshooting n/a access_of_user_group_to_host_removed severity informational description access of user group 'user group name' to host 'host name' was remo...
Page 568
Description test of component id started. Troubleshooting n/a ib_switch_component_test_started severity informational description test of component id started. Troubleshooting n/a ssd_component_test_started severity informational description test of component id started. Troubleshooting n/a componen...
Page 569
Description component id was unequipped. Troubleshooting n/a interface_services_activated severity informational description interface services of module id were activated. Troubleshooting n/a interface_services_deactivated severity informational description interface services of module id were deac...
Page 570
Description cannot phase out component id: error. Firmware upgrade result was: upgrade result. Troubleshooting n/a component_firmware_cannot_fail_component severity minor description cannot fail component id: error. Firmware upgrade result was: upgrade result. Troubleshooting n/a mirroring_connectiv...
Page 571
Emergency_console_access severity warning description emergency login to 'unix account name' account on module 'component id' from tty 'tty device'. Troubleshooting n/a cr_bypass_access severity warning description command that bypasses cr mechanism access to 'unix account name' account on module 'c...
Page 572
Clear_factory_settings_started severity informational description started clear factory settings. Troubleshooting please contact support. Clear_factory_settings_finished severity informational description finished clear factory settings. Troubleshooting please contact support. Clear_factory_settings...
Page 573
Disk_high_media_error_rate_cleared severity informational description component id no longer exhibits high media error rate. Troubleshooting please contact support. Ssd_problematic_behavior_detected severity variable description component id exhibits problematic behavior. Troubleshooting please cont...
Page 574
Description system started phasing in component id. Troubleshooting n/a ib_switch_config_failed severity warning description component id could not be configured; reason troubleshooting please contact support ib_switch_is_not_answering severity warning description component id is not answering troub...
Page 575
Description fan #fan failure for component id. Troubleshooting check fans, replace switch ib_switch_fan_restored severity informational description fan #fan restored for component id. Ib_switch_has_temperature severity variable description component id - temperature of temperature sesnsor is tempera...
Page 576
Troubleshooting check switch ib_switch_intern_error severity warning description we got bad indication of type indication for component id. Troubleshooting check switch ib_switch_bad_management_wiring severity warning description the wiring for ib switch management is incorrect. Ib switch component ...
Page 577
Description log collection for ib switch 'switch_id' completed successfuly. Log can be found in module 'log_module' in the following directory: 'log_location'. Ib_switch_log_collect_failed severity warning description log collection for ib switch 'switch_id' failed. Failure reason: 'failure_reason'....
Page 578
Ups_was_reconfigured severity informational description new configuration was uploaded to component id. Ups_was_not_reconfigured severity warning description unable to load new configuration to component id. Ups_needs_a_firmware_upgrade severity informational description ups component id needs firmw...
Page 579
Ups_self_test_was_skipped severity warning description a ups self-test for ups component id has been skipped since not all ups's/psu's are ok or too close to last self test. Ups_self_test_is_possibly_inaccurate severity informational description a ups self-test for component id might be inaccurate, ...
Page 580
Ups_self_test_timed_out severity warning description component id self-test failed to complete in reasonable time. Troubleshooting n/a ups_clock_out_of_sync severity minor description component id clock is more than a day out of sync troubleshooting if it repeats, contact support ups_power_load_perc...
Page 581
Troubleshooting contact support ups_predictive_remaining_runtime_ok severity informational description ups component id has a remaining runtime of remaining runtime minutes, the time will drop to predictive remaining runtime minutes in case one of the other upses stops working. Troubleshooting conta...
Page 582
Ups_battery_is_weak severity major description component id has weak battery . Troubleshooting replace battery. Ups_battery_is_not_weak severity major description component id has no weak battery . Ups_battery_is_predictive_weak severity major description component id has weak battery . Troubleshoot...
Page 583
Troubleshooting try running command again, make sure input line wasn't switched by using ats_list and/or looking at the ats leds. If all fail, switch the lines manually by disconnecting one input line and reconnecting it. Ats_set_input_to_down_line severity warning description line jinput line of at...
Page 584
Description ups calibration canceled for componend id, due to origin cancel. Ups_disabled severity informational description component id has been disabled (will not be monitored). Ups_enabled severity informational description component id has been enabled. Ups_network_link_up severity warning desc...
Page 585
Description cable check of component id failed, either its serial or network cables are crosswired with hostname. Troubleshooting either the cable is disconnected or network and serial cables are miswired. Ups_cable_check_passed severity informational description cable check of component id passed. ...
Page 586
Ats_line_output_on severity informational description ats component id output line name turned on. Troubleshooting n/a ats_source_has_switched severity informational description ats component id source line switched from jprevious to jcurrent. Troubleshooting n/a ats_source_has_switched_for_outlet s...
Page 587
Description ats component id exhibits a failure state. Troubleshooting please contact support. Ats_recovered severity informational description ats component id exited from the failure state. Troubleshooting n/a module_no_ip_connectivity severity warning description there is no ip connectivity to fa...
Page 588
Description the failed module failed module has not been powered off as a failsafe due to failed ipmi module not having ipmi set. Troubleshooting information sent to event center in case of module failure. Module_failed_could_not_be_powered_off severity major description the failed module failed mod...
Page 589
Connection_to_maintenance_module_is_ok severity informational description the maintenance module can now be reached from component id. Troubleshooting please contact support no_connection_to_maintenance_module severity major description the maintenance module can not be reached from component id. Tr...
Page 590
System_temperature_is_too_high_and_stabilizing severity major description system temperature is system temperaturec. It is stabilizing, but is still higher than the maximal allowable value. If the system doesn't cool down soon, it might be automatically shut down. Troubleshooting contact support. Sy...
Page 591
Troubleshooting please contact support. Mm_failed severity major description component id has failed. Hardware status: status. Troubleshooting please contact support. Mm_change_detected severity major description component id has been changed from a serial of old_serial to new_serial. Troubleshootin...
Page 592
Disk_firmware_not_upgradeable severity major description component id - failed firwmare upgrade. Troubleshooting please contact support. Component_fru_rejected severity major description component id - failed fru validation. Troubleshooting please contact support. Component_fru_accepted_implicit sev...
Page 593
Description component id exhibits excessive bms activity, fill time is time to fill bms log minutes. Troubleshooting please contact support. Sata_smart_status_reading_failed severity warning description reading smart attributes of disk id failed. Smart trip value= troubleshooting please contact supp...
Page 594
Ses_status_is_normal_now severity informational description on module ses component 'sensor name' is in state 'state'. Troubleshooting n/a ses_alarm_is_signaling severity warning description on module alarm of type 'component type' is signaling. Troubleshooting please contact support. Ses_alarm_no_l...
Page 595
Description the pdb module module is working now. Troubleshooting n/a ses_bmc_error_signal severity warning description the bmc on module module signals an error. Troubleshooting please contact support. Ses_bmc_is_ok_now severity informational description the bmc on module module is ok now. Troubles...
Page 596
Cna_overheating severity major description adapter cna component id is overheating and reached a temperature of cna temperature. Troubleshooting please contact support. Component_temperature_is_normal severity informational description component id temperature is temperaturec. The temperature is nor...
Page 597
Component_temperature_is_very_high severity major description component id temperature is temperaturec. The temperature is very high and may effect on component performance or even damage it. Component_temperature_is_very_high_and_ stabilizing severity major description component id temperature is t...
Page 598
Disk_media_pre_scan_off severity informational description component id - disk media pre scan is off. Troubleshooting please contact support. Ses_fan_has_speed_changed severity informational description fan speed changed from previous rpm rpm to new rpm rpm. Ses_fan_status_ok severity informational ...
Page 599
Description both psus on module report critical failures, this is probably because of a faulty pdb. Troubleshooting please contact support. Ses_ambient_temperature_severity_changed severity variable description module module sensor desc reports (readingc) state desc. Troubleshooting adjust ambient t...
Page 600
Description pdb firmware on component - unexpected code-level, found major.Minor which is old and should be upgraded troubleshooting please contact support. Pcm_firmware_version_unexpected severity warning description pcm-id firmware on component - unexpected code-level, found major.Minor which is o...
Page 601
Description fan controller firmware on component - unexpected code-level, found major.Minor.Level.Build (configuration major.Minor.Level) which is old and should be upgraded troubleshooting please contact support. Ipmi_bmc_firmware_version_unexpected severity warning description ipmi bmc firmware on...
Page 602
Ipmi_watchdog_has_errors severity major description ipmi watchdog on module experienced command errors. Troubleshooting please contact support. Sas_version_is_unexpected severity warning description sas controller firmware version on module module version actual is old and should be upgraded trouble...
Page 603
Ipmi_user_setup_failed severity major description error setting up ipmi user for module module. Troubleshooting contact support. Ipmi_lan_setup_failed severity major description error setting up ipmi lan channel channel for module module. Troubleshooting contact support. Ipmi_sel_entry_crit severity...
Page 604
Fc_link_error_thresh_exceeded severity major description fc port component counter threshold exceeded: value limit: max troubleshooting please contact support. Fc_monitor_alert severity informational description fc port component counter counter is out of range: now value range: min max troubleshoot...
Page 605
Description network interface interface role #interface index on component id - link has no data flowing through for the last time not flowing seconds. Troubleshooting please contact support. Network_link_no_data_long severity major description network interface interface role #interface index on co...
Page 606
Description daisy chain on module module, device device name is miswired. Troubleshooting please contact support. Daisy_chain_is_wired_ok severity informational description daisy chain on module module, device device name is wired ok. Troubleshooting please contact support. Daisy_chain_link_is_down ...
Page 607
Troubleshooting the compact flash has inconsistencies on some of it's partitions. Ups_warmstart severity informational description component id did a warmstart troubleshooting normally this is fine, if there is another issue at around the same time, it is worth mentioning this event to the support c...
Page 608
Process_core_dump severity warning description process process name with pid process id killed by signal signal on module module component id. Too_many_syslog_msgs severity informational description syslog messages got updated more than once today on module module component id. Troubleshooting there...
Page 609
Sas_link_too_many_resets_phaseout_disk severity minor description sas link sas type[id] on module module had delta resets, only allowed resets are allowed. Please phase out disk disk. Troubleshooting phase out the disk and contact support. Error_on_sata_host severity major description sata device fa...
Page 610
Description fru product information area checksum on module component id can't be read. Troubleshooting please contact support. Fru_product_info_area_unreadable severity minor description fru product information area on module component id can't be read. Troubleshooting please contact support. Fru_p...
Page 611
Pci_adapter_compliance_check_failed severity major description specification compliance check failed for pci adapters on module component id. Troubleshooting please contact support. Pci_adapter_compliance_check_adapter_failed severity major description pci adapter on module component id does not con...
Page 612
Cf_compliance_check_failed severity major description installed compact flash card on module component id does not conform to the specification. Troubleshooting please contact support. Cf_bigger_than_expected severity warning description installed compact flash card on module component id has a size...
Page 613
Ssd_smaller_than_expected severity major description installed ssd component id has a size of sizegb which is smaller than the expected size of spec sizegb. Troubleshooting please contact support. Ssd_found_unexpected severity warning description ssd component id was found while ssd caching feature ...
Page 614
Description ssd component id smart attribute life gauge exceeds a threshold. Value is value. Troubleshooting please contact support. Ssd_change_was_detected severity informational description component id has been changed. Troubleshooting confirm that the ssd replacement was intended. Ssd_smart_attr...
Page 615
Description memory uncorrectable ecc errors were detected on module, count errors on dimm channel channel, position position. Troubleshooting please contact support. Dimm_errors_phasing_out_module severity major description module will be phased out as we detected too many dimm errors there. Trouble...
Page 616
Disk_glist_changed severity warning description disk component id glist changed from previous glist size to current glist size. Troubleshooting please contact support. Bus_reset_was_sent severity warning description a bus reset was sent on module module. Troubleshooting please contact support. Bus_r...
Page 617
Description a disk reset was sent to component id. Troubleshooting please contact support. Disk_reset_failed severity major description reset to disk component id has failed. Reset duration reset duration, ios pending ios pending. Troubleshooting please contact support. Disk_reset_succeeded severity...
Page 618
Description disk component id failed reading log page. Opcode is opcode, page code is page code. Troubleshooting n/a ssd_log_page_reading_failed severity warning description ssd component id failed reading log page log. Troubleshooting n/a module_is_missing_memory severity major description componen...
Page 619
Description ssds in module component have unexpected firmware level. Check full event details for the complete list of the mismatched ssds. Troubleshooting please update the firmware level. Interface_node_choking severity warning description interface node #node has long cache latency. Entered choke...
Page 620
Perf_class_resoure_exhaustion severity warning description exhausted all allowed resources for performance classes on module id, busy until resources available. Connected_hosts_limit_reached severity informational description number of connected hosts was reached for port 'port_id' in module module ...
Page 621
Ipinterface_create severity informational description a new iscsi ip interface was defined with name 'interface name' on module module with ports 'port list' and ip address ip address ipinterface_delete severity informational description iscsi ip interface with name 'interface name' was deleted ipin...
Page 622
Description vpn ip interfaces were updated. Vpn ips are ip addresses ipinterface_update_vpn_ipv6 severity informational description vpn ipv6 interfaces were updated. Vpn ipv6 addresses are ip addresses auxiliary_internal_ports_enabled severity informational description port count auxiliary internal ...
Page 623
Description a new private key named 'name' with fingerprint 'fingerprint' and size key_size bits was added. Certificate_removed severity informational description the certificate named 'name' was removed. Pkcs12_certificate_added severity informational description a new pkcs#12 named 'name' with fin...
Page 624
Sms_not_sent severity variable description sending event event code (event index) to destination list via sms gateway and smtp gateway was waived because of failed smtp gateway. It will be not be used until retry time. Troubleshooting please contact support. Heartbeat_email_has_failed severity minor...
Page 625
Description event index of count test events (description: description; severity: severity; node: node). Troubleshooting n/a custom_event severity variable description description troubleshooting n/a mm_event severity variable description maintenance module category event : description troubleshooti...
Page 626
Interconnect_timed_out severity major description node #node id of type node type on module component id could not establish connection to node #node id of type node type on module component id for timeout seconds. Troubleshooting please contact support. Events_were_lost severity variable descriptio...
Page 627
Upgrade_starts severity informational description system starting an upgrade. Troubleshooting n/a pre_upgrade severity informational description system preparing an upgrade procedure type type . Troubleshooting n/a upgrade_is_over severity informational description system went up after an upgrade. T...
Page 628
Upgrade_was_cancelled severity informational description upgrade was cancelled with reason reason . Troubleshooting contact support hot_upgrade_aborted severity critical description hot upgrade aborted with reason reason. Troubleshooting contact support hot_upgrade_has_failed severity critical descr...
Page 629
Description all of the pre-upgrade validations passed successfully. Troubleshooting n/a post_upgrade_script_started severity informational description post-upgrade script started. Troubleshooting n/a post_upgrade_script_finished severity informational description post-upgrade script finished success...
Page 630
Ups_initialization_timed_out severity informational description component id initialization timed out. Ups_bad_battery_found_in_self_test severity major description component id has low capacity or discharge state following self test. Troubleshooting replace battery. Ups_problem_causing_maintenance_...
Page 631
Metadata_delete severity warning description metadata object deleted for object type with name 'object name'. Troubleshooting n/a patch_script_added severity informational description added patch patch name. Troubleshooting was patch supposed to have been added. Patch_script_deleted severity informa...
Page 632
Remote_support_disconnected severity variable description system disconnected from remote support center destination while the connection was in state disconnected session state. Remote_support_client_moved severity informational description the remote support client moved from old module to new mod...
Page 633
Troubleshooting n/a module_sm_prio_changed severity informational description sm: sm priority changed on module 'component id' from 'priority' to 'priority'. Change reason: 'change reason'. Troubleshooting n/a master_sm_rescan severity informational description master sm on module 'component id' has...
Page 634
Troubleshooting n/a ib_module_port_bad_guid_format severity warning description module port#port number, connected to switch port 'component id' has guid:'port guid' which is not xiv-guid or its serial is not compatible with the machine. Troubleshooting n/a ib_bad_configuration severity major descri...
Page 635
Ib_switch_is_missing severity warning description an infiniband switch is missing 'component id'. Troubleshooting n/a ib_missing_switch_found severity informational description an infiniband switch 'component id' which was missing is now found. Troubleshooting n/a ib_port_force_down_success severity...
Page 636
Infiniband_port_error severity major description failed to bring up infiniband port hca port number on module module id. Error is: error description. Troubleshooting possible physical problem with module. Contact support. Component_requires_servicing severity major description component component id...
Page 637
Perf_class_add_host severity informational description host with name 'host_name' was added to performance class with name 'name' perf_class_remove_host severity informational description host with name 'host_name' was removed from performance class with name 'name' status_agent_error severity criti...
Page 638
Io_resumed_for_cons_group_upon_system_error severity warning description pause io on cg with name 'cg_name' and token 'token' was resumed after system error. Io_resumed_for_cons_group_upon_timeout_ expiration severity warning description pause io on cg with name 'cg_name' and token 'token' was cance...
Page 639
Symon_component_failure_would_have_been_ recommended severity informational description symptomatic monitoring would have recommended failing componentid but suppressionreason. Troubleshooting n/a medium_error_recovered severity informational description medium error on volume=volume, logical-partit...
Page 640
634 ibm xiv storage system user manual.
Page 641: Chapter 25. Return Codes
Chapter 25. Return codes the following are the return codes. Return code error description 0 success. 1 command execution failed. 2 no connection to the system. 3 password is required. 4 password does not match system password. 7 command not allowed from this client. 8 bad xcli option. 9 internal xc...
Page 642
636 ibm xiv storage system user manual.
Page 643: Notices
Notices this information was developed for products and services offered in the u.S.A. Ibm may not offer the products, services, or features discussed in this document in other countries. Consult your local ibm representative for information on the products and services currently available in your a...
Page 644
Ibm may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs ...
Page 645: Glossary
Glossary this glossary includes terms and definitions for ibm xiv storage system. This glossary includes selected terms and definitions from: v the american national standard dictionary for information systems, ansi x3.172–1990, copyright 1990 by the american national standards institute (ansi), 11 ...
Page 646
Auto-delete priority as the storage capacity reaches its limits, snapshots are automatically deleted to make more space. The deletion takes place according to the value set for each snapshot, as follows: 1 last to be deleted 4 first to be deleted each snapshot is given a default auto delete priority...
Page 647
F fabric the hardware that connects workstations and servers to storage devices in a san. The san fabric enables any-server-to-any-storage device connectivity through the use of fibre-channel switching technology. Fc-al also known as arbitrated loop. A fibre-channel topology that requires no fibre-c...
Page 648
Ldap server a server that provides directory services through ldap. Ldap status the status of an ldap server. Line cord the electrical connection between the ac power source and the automatic transfer switch (ats). Load balancing even distribution of load across all components of the system. Locking...
Page 649
Smtp gateway an external host that is used to relay e-mail messages through the smtp protocol. Snapshot set the resulting set of synchronized snapshots of a volume set in a consistency group. See also consistency group, volume set. Snapshot a point-in-time snapshot or copy of a volume. See also imag...
Page 650
X xcli ibm xiv command-line interface (xcli) command set. See command line interface. Xcli client the system on which the xcli command is entered. Xcli identification parameters parameters that identify the user issuing the command and the xiv system (if any) on which the command is to run. Xcli ide...
Page 652
Printed in usa gc27-3914-05.