To rename a chunk, provide the old chunk location and the new chunk location, either at the command line or in a file.
The following table lists example values for two chunks that are used in the examples in this section.
| Element | Value for First Chunk | Value for Second Chunk |
|---|---|---|
| old path | /chunk1 | /chunk2 |
| old offset | 0 | 10000 |
| new path | /chunk1N | /chunk2N |
| new offset | 20000 | 0 |
To rename the chunks by supplying information on the command line, use this command:
onbar -r -rename -p /chunk1 -o 0 -n /chunk1N -o 20000
-rename -p /chunk2 -o 10000 -n /chunk2N -o 0
Perform a level-0 archive after the rename and restore operation is complete.
To rename the chunks by supplying a file named listfile, use this command:
onbar -r -rename -f listfile
The contents of the listfile file are:
/chunk1 0 /chunk1N 20000 /chunk2 10000 /chunk2N 0
Perform a level-0 archive after the rename and restore operation is complete.
To rename the chunks using command-line options while performing a physical restore on dbspace1 and dbspace2, where rootdbs is the name of the rootdbs, use the following command:
onbar -r -rename -p /chunk1 -o 0 -n /chunk1N -o 20000
-rename -p /chunk2 -o 10000 -n /chunk2N -o 0
-p rootdbs dbspace1 dbspace2
Alternatively, to rename the chunks using file while performing a physical restore on dbspace1 and dbspace2, use the following command:
onbar -r -rename -f listfile -p rootdbs dbspace1 dbspace2
Perform a level-0 archive after the rename and restore operation is complete.
To rename a chunk to a device that does not yet exist, you specify the new path name, but you do not restore its storage spaces until after you install the physical device. This option is useful if you need to rename a chunk and it is convenient to perform a cold restore before you install the new device. When the new chunk device is ready, you can perform a warm restore of a storage space onto it.
You can combine renaming chunks with existing devices and renaming chunks with nonexistent devices in the same rename operation. This example shows how to rename a single chunk to a nonexistent device name.
The following table lists example values for the chunks used in this example.
| Storage Space | Old Chunk Path | Old Offset | New Chunk Path | New Offset |
|---|---|---|---|---|
| sbspace1 | /chunk3 | 0 | /chunk3N | 0 |
onbar -r -rename -p /chunk3 -o 0 -n /chunk3N -o 0
The chunk /chunk3N does not exist. If you continue, the restore may fail later for the dbspace which contains this chunk. Continue without creating this chunk? (y/n)
The chunk /chunk3 is renamed to /chunk3N, but the data has not yet been restored to /chunk3N.
onbar -r sbspace1