Adding logical paths by using a CSV file
You can create a comma-separated value (CSV) file to define logical paths. The CSV file specifies storage systems pairings and associated port pairings that are used for replication. Copy Services Manager uses the port pairings that are defined in the CSV file to establish logical paths. You can edit the port pairings file by using the Copy Services Manager GUI. You can also edit the file manually if necessary.
Before you begin
- Port pairings for all logical subsystems that are in a session.
- Port pairings for a logical subsystem to logical subsystem mapping.
- Port pairings for all logical subsystems. You can define a single set of port pairings for the logical subsystems or you can define different pairings for all even logical subsystems and all odd logical subsystems.
- Port pairings based on the direction of the copy.
Adding logical paths with a CSV file by using the GUI
You can use the DS8000 Port Pairings CSV panel in the Copy Services Manager GUI to add logical paths by editing a sample CSV file.
About this task
Complete these steps to add IBM® DS8000® logical paths with a CSV file in the Copy Services Manager GUI:
Procedure
- Log in to the Copy Services Manager GUI as a user with administrator privileges.
- Click .
- Click Edit to put the CSV file into edit mode.
- Enter the necessary changes to the sample portpairings.csv file for your environment. For more information, see the online help at for guidance and tips on editing the file.
- When you are finished updating the file, click Save to keep your changes, or click Cancel to exit without saving changes.
Results
Adding logical paths with a CSV file by editing it manually
You can manually edit a portpairings.csv sample file to add logical paths.
About this task
Complete these steps to add IBM DS8000 logical paths with a CSV file by editing it manually:
Procedure
What to do next
- The CSV file now supports Global Mirror control paths. Please refer Adding Global Mirror Control paths with a CSV file by editing it manually for more information.
- The entries for the port pairs are bidirectional unless the last comma-separated
entry on the line is the string
onedir
. The portpairings.csv file contains the following information about using theonedir
string:# 2. The entry for the port pairs are bi-directional unless the last # comma-separated entry on the line is the string "onedir". # This means that a line that has systemA:systemB is equivalent to a line # that has systemB:systemA, and the last entry in the file takes precedence. # # If the string "onedir" is the last entry in the line, as in the # following example: # 2107.04131:2107.01532,0x0331:0x0024,0x0330:0x0100, # 0x0331:0x000C,onedir # then the entry is not considered to be bi-directional, and the # port pairings are only used if the first box listed (2107:04131) # is the source of the pair, and the second box listed (2107.01532) # is the target of the pair. # NOTE: You can specify the "onedir" tag on any of the supported # formats for port pairs. However, if there is also an entry for # the same set of boxes without the "onedir" tag, the entry without # the "onedir" tag might take precedence. # # Example Session format: # 2107.ZA811:2107.BAY81:myMM,0x0133:0x0332,onedir # 2107.BAY81:2107.ZA811:myMM,0x0033:0x0030,onedir # The above example indicates that session "myMM" will use # 0x0133:0x0332 for any establishes from ZA811 to BAY81, # but will use 0x0033:0x0030 for any establishes # from BAY81 to ZA811. # # Example LSS to LSS format: # 2107.ZA811:0xD0:2107.BAY81:0xD0,0x0133:0x0332,onedir # 2107.BAY81:0xD0:2107.ZA811:0xD0,0x0033:0x0030,onedir # The above example indicates that ports 0x0133:0x0332 # will be used for any establishes from ZA811 LSS 0xD0 # to BAY81 LSS 0xD0, but that ports 0x0033:0x0030 # will be used from BAY81 LSS 0xD0 to ZA811 LSS 0XD0. # # Example Box to Box format: # 2107.ZA811:2107.BAY81,0x0133:0x0332,onedir # 2107.BAY81:2107.ZA811,0x0033:0x0030,onedir # The above example indicates that ports 0x0133:0x0332 # will be used for any establishes from ZA811 to BAY81, # but that ports 0x0033:0x0030 will be used for any # establishes from BAY81 to ZA811. # # 3. Lines that are incorrectly formatted are discarded. For example, # if a line contains ports without the 0x, or does not contain port # pairs delimited by the : character, then the whole line is discarded. # # 4. A line can be properly formatted but contain invalid ports for your # given storage system configuration. In this case, the ports will be # passed down to the storage system to be established, and no validation # is done. The valid ports might be established by the storage system, # while the invalid ones might be rejected. # # 5. If a file contains duplicate lines for the same storage systems, the # last line is used. And the ports on the last line are the ones that are used. # Also note that the entries are bi-directional (see rule 2). Therefore, if you # have systemA:systemB, and then a line with systemB:systemA, this second # line is the one that is used. # # 6. This file is read at most once every 60 seconds. Therefore, if you change # the file you might need to wait two minutes until you issue the next start # command. # # 7. Any line that starts with a # character is counted as a comment and is # discarded. The # must be at the start of the line. Placing it in other # positions might cause the line to be invalid. # # 8. The portpairings.csv file is not automatically shared between # two copy services management servers in a high availability environment. # Therefore, it is possible that different port pairings can be established # from the standby server after a takeover. In most cases you will want to # copy the portpairings.csv file to the standby server to ensure that the # two files are equal. # # 9. The following is the order in which each port pairing is checked. # The first match when going down this order is used as the port pairings: # a) If a Specific LSS pairing is found for the given LSS pairing being # established # b) If a Specific Session port pairing is found for the given session # c) If a box to box mapping is found for the given pair being established # # For more information on how the port pairings works, see the # user’s guide and other documentation. # # Examples: # Normal Box to Box Mappings #2107.04131:2107.01532,0x0331:0x0024,0x0330:0x0100,0x0331:0x000C #2107.05131:2107.01532,0x0330:0x0029,0x0331:0x0001 # Specific Session Option #2107.04131:2107.01532:GMP,0x0030:0x0303,0x0031:0x0303 # Specific LSS to LSS Mapping Option #2107.04131:0x50:2107.01532:0x51,0x0301:0x0303,0x0302:0x0303 # Box to Box Mapping with Even and Odd LSS pairings defined #2107.04131:2107.01532,even,0x0030:0x0031,0x0032:0x0033,0x0030: 0x0033,odd,0x0300:0x0301,0x0302:0x0303
- If the CSV file contains multiple lines that specify the same storage system to storage system pairing, Copy Services Manager uses the last line. This rule applies regardless of the order of the storage system pairing. For example, if you have storage systems 2107.04131:2107.01532 defined on the first line of the CSV file and then have 2107.01532:2107.04131 defined on the second line, Copy Services Manager uses second line.
- If a line in the CSV contains information that is not formatted correctly, the line is ignored. This rule includes lines that specify storage systems but do not include ports or include ports that are not formatted correctly.
- If the CSV file contains valid and invalid port pairs, the valid port pairs might or might not
be established. Invalid port pairs can cause the following errors to be displayed in the Copy
Services Manager console and on the
ESS/DS Paths page:
- Return Code F52: This error is displayed if a port is invalid.
- Return Code 0400: This error is displayed if a port is invalid and out of the range for the device.
- If the CSV file contains no valid port pairs, no logical paths are established and subsequent commands to the storage systems that require logical paths might fail. Any existing logical paths for a storage system are used until they are removed.
Adding Global Mirror Control paths with a CSV file by editing it manually
You can manually edit a sample.csv file to add logical paths.
About this task
Complete these steps to add IBM DS8000 logical paths with a CSV file by editing it manually: