Hitachi MK-96RD617-08

7-28 Using the Export Tool

Hitachi Universal Storage Platform V/VM Hitachi Performance Manager User’s Guide

Table 7-20 Termination Codes Returned by the Export Tool

Termination

Code Meaning

0 The Export Tool finished successfully.

1 An error occurred when the set subcommand (see set subcommand) executed,

because an attempt to switch to Modify mode failed. Some other user might have

been logged on in Modify mode.

2 An error occurred due to some reason unrelated to system option modes (i.e., View

mode and Modify mode)

3 An error occurred due to more than one reason. One of the reasons is that an attempt

to switch to Modify mode failed when the set subcommand (see set subcommand)

executed. Some other user might have been logged on in Modify mode.

4 The user ID has none of permissions for Performance Monitor, TrueCopy, TrueCopy

for IBM z/OS, Universal Replicator, and Universal Replicator for IBM z/OS.

If you want to use a reference to a termination code in your batch file, do the

following:

• To use such a reference in a Windows batch file, write %errorlevel% in

the batch file.

• To use such a reference in a UNIX Bourne shell script, write %? in the shell

script.

• To use such a reference in a UNIX C shell script, write %status in the shell

script.

A reference to a termination code is used in the following example of a

Windows batch file. If this batch file executes and the Export Tool returns the

termination code 1 or 3, the command prompt displays a message that

indicates the set subcommand fails.

Java -classpath "./lib/JSanExport.jar;./lib/JSanRmiServerSx.jar" -Xmx536870912 -

Dmd.command=command.txt -Dmd.logpath=log sanproject.getmondat.RJMdMain 

if %errorlevel%==1 echo THE SET SUBCOMMAND FAILED 

if %errorlevel%==3 echo THE SET SUBCOMMAND FAILED 

pause 

Figure 7-7 Example of a Batch File Including References to Termination

Codes

Note: The " " symbol indicates the end of a command line.

Contents

Main Hitachi Universal Storage Platform V Hitachi Universal Storage Platform VM Hitachi Performance Manager Users Guide Performance Monitor and Server Priority Manager F L Page Contents Preparing for Performance Manager Operations ...................................... 3-1 Using the Performance Manager GUI ..................................................... 4-1 Performance Monitor Operations ........................................................... 5-1 Server Priority Manager Operation ......................................................... 6-1 Page Page Preface Intended Audience Product Version Document Revision Level Preface ix Hitachi Universal Storage Platform V/VM Hitachi Performance Manager Users Guide Source Documents for this Revision MK-96RD617-08d-RSD-V03 Changes in This Revision Support Center for Volume Migration support. Referenced Documents Document Conventions Convention for Storage Capacity Values Getting Help Comments Overview of Performance Manager Performance Monitor Server Priority Manager Performance Monitor Load-Balanced HDD Arrangement Server Priority Mgr Prioritized Host I/O Controlling Figure 1-2 Performance Management Process Flow Diagram About Performance Manager Operations Components Overview of Performance Monitor Understanding Statistical Storage Ranges Parity Group Usage Statistics Volume Usage Statistics External Volume Group Usage Statistics External Volume Usage Statistics Channel Processor Usage Statistics Disk Processor Usage Statistics Table 2-1 Migrating Volumes in USP V Storage Systems When Disk Processor Usage Rate is High Cluster Disk Adapter Disk Processor Migrating Volumes in USP V Storage System Note DRR Processor Usage Statistics Write Pending Rate and Cache Memory Usage Statistics Access Path Usage Statistics Figure 2-1 Access Paths Hard Disk Drive Workload Statistics Port Traffic Statistics LU Paths Traffic Statistics Traffic between HBAs and Storage System Ports Overview of Server Priority Manager Performance of High-Priority Hosts Upper-Limit Control Overview of Export Tool Figure 2-2 Example of a Text File Page Interoperability with Other Products Performance Monitor Maintenance Server Priority Manager Figure 2-3 Line Graphs Indicating Changes in Port Tra ffic Page System Requirements Storage Partition Administrators Limitations Performance Monitor Limitations Table 3-1 Limitations for Storage Partition Administrators (Performance Monitor) Page Export Tool Limitations Page Page Using the Performance Monitor Windows Performance Monitor Window Physical Performance Management Window, Physical Tab Figure 4-1 Physical Tab of the Performance Management Window Figure 4-2 Storing Period of Statistics (Physical Tab) Figure 4-3 List of Disk Adapters The Page area displays the number of the current page and the following N/M The Volume Migration button starts the Volume Migration if that program The Draw button displays a line graph illustrating changes in usage Long-Range Storage Short-Range Storage LDEV Tab of the Performance Monitor Window Figure 4-5 LDEV Tab of the Performance Management Window When Monitoring Switch is Enable, Performance Monitor is monitoring Page The Page area displays the number of the current page and the following N/M The Draw button displays a line graph illustrating changes in the I/O rate, Figure 4-6 Selecting an Item to be Displayed in the Graph (LDEV Tab) Table 4-1 Items You Can Select in the List and the Types of Statistics (LDEV Tab) Figure 4-7 Chart Y Axis Rate List and Detail Check Box (LDEV Tab) Table 4-2 Detailed Information that can be Displayed in the Graph (LDEV Tab) Port-LUN Tab of the Performance Monitor Window Figure 4-8 Port-LUN tab of the Performance Management Window The The SPM button starts the Server Priority Manager program product if that The Draw button displays a line graph illustrating changes in the I/O rate Viewing Port Workload Statistics Figure 4-10 Graphs Illustrating Changes in Workloads on a Port Viewing Workload Statistics on LU Paths Table 4-3 Detailed Information that can be Displayed in the Graph (Port- LUN Tab) WWN Tab of the Performance Monitor Window Figure 4-11 WWN tab of the Performance Management Window When Monitoring Switch is Enable, Performance Monitor is monitoring The The SPM button starts the Server Priority Manager program product if The Draw button displays a line graph illustrating changes in the I/O rate Monitoring Options Window Figure 4-13 Monitoring Options Window of Performance Monitor PG list: LDKC list: CU table: Table 4-4 Relationship between the Display of a Cell and the CU Status in the CU Table The Select button adds the CU selected in the CU table to the CUs to be Table 4-5 Characters Indicated in a Cell When the Select Button is Clicked The Release button removes the CU from monitoring targets. Table 4-6 Characters Indicated in a Cell When Release Button is Clicked Other Windows Using the Server Priority Manager Windows Port Tab of the Server Priority Manager Window Page The Close button closes the Server Priority Manager window. The Apply button applies the settings in this window to the storage The Reset button restores the last applied settings in the window. When WWN Tab of the Server Priority Manager Window Figure 4-15 WWN Tab in the Server Priority Manager Window The Add WWN button lets you add a host bus adapter to an SPM group. Page The Close button closes the Server Priority Manager window. The Apply button applies the settings in this window to the storage The Reset button restores the last applied settings in the window. When Page Performance Monitor Operations Overview of Performance Monitor Operations Start Monitoring Figure 5-1 Monitoring Options Window of Performance Monitor View the Monitoring Results Figure 5-2 Performance Management Window Physical tab Starting and Stopping Storage System Monitoring Page Monitoring Resources in the Storage System Viewing Usage Statistics on Parity Groups Figure 5-3 Example of Parity Group Usage Rates Displayed in the List PG: RAID: Usage: CLPR: Viewing Usage Statistics on Volumes in Parity Groups Figure 5-4 Examples of Volume Usage Rates Displayed LDEV: This column indicates volumes (LDEVs), in this format: Emulation: This column indicates device emulation types. Usage: CLPR: This column indicates numbers and names of CLPRs corresponding Viewing Usage Statistics on External Volume Groups Figure 5-5 Example of Usage Statistics of an External Volume Group Usages Displayed in the List Page Viewing Usage Statistics on External Volumes in External Volume Groups Figure 5-6 Example of External Volume Usage Rates Displayed ExLDEV: This column indicates external volumes, in this format: Emulation: This column indicates device emulation types. Trans.: This column indicates the sizes of data transferred between the CLPR: This column indicates numbers and names of CLPRs corresponding Viewing Usage Statistics on Channel Processors Figure 5-7 Example of Channel Processors Usage Rates Displayed ID: This column displays ID numbers for channel processors. Usage: Viewing Usage Statistics on Disk Processors Figure 5-8 Example of Disk Processor Usage Rates Displayed ID: This column displays ID numbers for disk processors. Usage: Viewing Usage Statistics on Data Recovery and Reconstruction Processors Figure 5-9 Example of DRR Usage Rates Displayed in the List ID: This column displays ID numbers for DRRs. Usage: Viewing Write Pending and Cache Memory Usage Statistics Figure 5-10 Selecting an Item to be Displayed in the Graph (Short- range) Figure 5-11 Example of Write Pending Rate and Cache Usage Rate Displayed CLPR: Usage: This item is displayed only when you select shortrange for the Viewing Usage Statistics on Access Paths Monitoring Hard Disk Drives Viewing I/O Rates for Disks Page Figure 5-13 I/O Rates for Disks LDEV: Indicates the volume ID. If the ID ends with the pound or gate Viewing Transfer Rates for Disks Page Figure 5-14 Transfer Rates for Disks Page Monitoring Ports Viewing I/O Rates for Ports Page Initiator/External: Indicates the port attribute. Initiator Viewing Transfer Rates for Ports Page Attribute: Indicates the priority of each port. Prio. indicates a prioritized Initiator/External: Indicates the port attribute. Initiator Viewing Details about the I/O and Transfer Rates Monitoring LU Paths Viewing LU Paths I/O Rates Figure 5-17 I/O Rates for LU Paths LDEV: Indicates IDs of volumes, in the following format: LDKC:CU:LDEV. Viewing LU Paths Transfer Rates Page Monitoring Paths between Host Bus Adapters and Ports Viewing HBA Information Viewing I/O Rates between HBAs Page Viewing Transfer Rates between HBAs Figure 5-20 Transfer Rates for Host Bus Adapters (WWN Tab) Group: Indicates SPM groups. Page Server Priority Manager Operation Overview of Server Priority Manager Operations If One-to-One Connections Link HBAs and Ports Figure 6-1 Network A (One-to-one Connections between HBAs and Ports) Figure 6-2 Priority Specified in the Server Priority Ma nager Window Figure 6-3 Traffic at Ports If Many-to-Many Connections Link HBAs and Ports Figure 6-4 Network B (Many-to-Many Connections are Established between HBAs and Ports) Figure 6-5 Specifying Host Bus Adapters to be Monitored Figure 6-6 Priority Specified in the Server Priority Ma nager Window Figure 6-7 Traffic at Ports Figure 6-8 Setting Upper Limits Page Starting Server Priority Manager Page Port Tab Operations Analyzing Traffic Statistics Setting Priority for Ports on the Storage System Setting Upper-Limit Values to Traffic at Non-prioritized Ports Setting a Threshold WWN Tab Operations Monitoring All Traffic between HBAs and Ports Page Figure 6-9 Add WWN Window Analyzing Traffic Statistics Setting Priority for Host Bus Adapters Page Setting Upper-Limit Values for Non-Prioritized WWNs Setting a Threshold Changing the SPM Name of a Host Bus Adapter Figure 6-10 Change WWN and SPM Name Window Replacing a Host Bus Adapter Grouping Host Bus Adapters Containing Multiple HBAs in an SPM Group Figure 6-11 Add New SPM Group Window Deleting an HBA from an SPM Group Switching Priority of an SPM Group Setting an Upper-Limit Value to HBAs in an SPM Group Figure 6-12 Change Upper Limit Window Renaming an SPM Group Figure 6-13 Rename SPM Group Window Deleting an SPM Group Page Using the Export Tool Files to be Exported Table 7-1 Performance Management Windows and Monitoring Data Saved by the Export Tool Table 7-2 Files with Statistics about Resource Usage and Write Pending Rates Table 7-3 Files with Statistics about Parity Groups, External Volume Groups or V-VOL Groups Page Page Table 7-5 Files with Statistics about Ports Table 7-6 Files with Statistics about Host Bus Adapters Connected to Ports Table 7-7 Files with Statistics about Volumes (LUs) Table 7-8 Files with Statistics about SPM Groups Table 7-9 Files with Statistics about Host Bus Adapters Belonging to SPM Groups Page Page Page Table 7-13 Files with Statistics about Remote Copy Operations by TC and TC for IBM z/OS (At CLPR) Note Preparing for Using the Export Tool Requirements for Using the Export Tool Installing the Export Tool on a Windows Computer Installing the Export Tool on a UNIX Computer Using the Export Tool login expusr passwd Preparing a Command File Figure 7-1 Example of a Command File show group PhyPG Long short-range 200610010850:200610010910 and outpath out option compress apply Preparing a Batch File Figure 7-2 Scripts in Batch Files Figure 7-3 Scripts in Batch Files (When Specifying the Host Name of a Proxy Host) Figure 7-4 Scripts in Batch Files (When Specifying the IP Addre ss of a Proxy Host) Running the Export Tool Figure 7-5 Example of Executing a Batch File (on a Windows Computer) Figure 7-6 Example of Command Prompt Outputs from Export Tool Table 7-18 Errors for Which Export Tool Retries Processing Page Table 7-19 Estimate of Time Required for Exporting Files Table 7-20 Termination Codes Returned by the Export Tool Figure 7-7 Example of a Batch File Including References to Termination Codes Command Reference Table 7-21 Subcommand List Command Syntax Table 7-22 Syntax Descriptions Figure 7-8 Examples of Comments svpip Subcommand retry Subcommand Syntax Description Operands Example login Subcommand Syntax Description Operands Example show Subcommand Page group Subcommand Table 7-23 Operands of the group Subcommand and Saved Monitoring Data Page group PortWWN CL1-A:CL1-B group PPCG spmg01:spmg02 group RemoteCopy group PortWWN CL1-A:CL1-B group PortWWN CL2-A:CL2-B Page Page Page Page Page Page Page Page Page Page Page short-range Subcommand Syntax Description The Performance Management window with selecting short-range as the The The UR Monitor and URz Monitor windows Figure 7-10 Starting and Ending Time for Collecting Monitoring Data Examples Page long-range Subcommand Table 7-24 Monitoring Items To Which the long-range Subcommand Can be Applied Figure 7-11 Starting and Ending Time for Collecting Monitoring Data yyyyMMddhhmm Examples Page outpath Subcommand option Subcommand apply Subcommand set subcommand Page help Subcommand Java Command for Exporting Data In Files -Xmxmemory-size(bytes) -Dmd.logpath=path-to-log-file Page Causes of Invalid Monitoring Data Table 7-25 Causes of Invalid Monitoring Data Page Troubleshooting Troubleshooting Performance Monitor Although Monitoring Switch is set to Enable, the monitoring data is not Troubleshooting Server Priority Manager Troubleshooting the Export Tool Table 8-1 explains possible problems with the Export Tool and probable solutions to the problems. Table 8-1 Troubleshooting the Export Tool Java -version Page Table 8-2 Messages Issued by the Export Tool Note Page Note Calling the Hitachi Data Systems Support Center Acronyms and Abbreviations Page Index Page Page MK-96RD617-08