Step 8 - Create Partitions on New LUNs - Parallel Upgrade Tool (PUT)

Parallel Upgrade Tool (PUT) Reference

Parallel Upgrade Tool (PUT)
Release Number
February 2020
English (United States)
Last Update
Product Category
Teradata Tools and Utilities
  1. Determine the number of Teradata partitions that need to be created for the new LUN.
    The simplest way to do this is to examine the partitions of an existing LUN of the same size on the same disk array as the new LUN.
    1. Determine if the system uses sfdisk or parted for partitioning.

      start with sfdisk

      sfdisk -l /dev/sdXX (where xx is the device entry for an existing LUN on the array)

      If the output gives an warning or error, use parted instead.

      parted –s device unit s print (where device is the /dev/tdmp device name and unit s specifies the unit to be displayed in sectors)

    2. Do one of the following to specify the number of Teradata partitions on the device:
      • If the device is sfdisk-partitioned, record the number of partitions of type “da”.
      • If the device is partitioned from parted, use how many Teradata partitions are listed in the table.

      Example sfdisk:

      sfdisk -l /dev/sdb

      Disk /dev/sdb: 2349 cylinders, 255 heads, 63 sectors/track
      Units = cylinders of 8225280 bytes, blocks of 1024 bytes, counting from 0
      Device Boot 	Start     End   #cyls    #blocks   Id  System
      /dev/sdb1          0+      0-      1-        31+  83  Linux
      /dev/sdb2          0+   2348-   2349-  18868288   da  Non-FS data
      /dev/sdb3          0       -       0          0    0  Empty
      /dev/sdb4          0       -       0          0    0  Empty

      Example parted:

      parted /dev/sdm unit s print

      Model: LSI VirtualDisk (scsi)
      Disk /dev/sdm: 1171074048s
      Sector size (logical/physical): 512B/512B
      Partition Table: gpt
      Number  Start        End          Size       File system  Name      Flags
       1      3872s        83646815s    83642944s               Teradata
       2      83646816s    167289759s   83642944s               Teradata
       3      167289760s   250932703s   83642944s               Teradata
       4      250932704s   334575647s   83642944s               Teradata
       5      334575648s   418218591s   83642944s               Teradata
       6      418218592s   501861535s   83642944s               Teradata
       7      501861536s   585504479s   83642944s               Teradata
       8      585504480s   669147423s   83642944s               Teradata
       9      669147424s   752790367s   83642944s               Teradata
      10      752790368s   836433311s   83642944s               Teradata
      11      836433312s   920076255s   83642944s               Teradata
      12      920076256s   1003719199s  83642944s               Teradata
      13      1003719200s  1087362143s  83642944s               Teradata
      14      1087362144s  1171005087s  83642944s               Teradata
  2. Partition the new LUN using the partitionLUN command:

    partitionLUN -c dev -l parts -w width -s sig [-g]

    • dev: The full path to the physical device name of the new LUN.
    • parts: The number of Teradata partitions to create.
    • width: The stripe width to use for the partitions. This should be the same value specified for segment size when the LUN was created. Typical values are either 64 for Non NetApp storage, and either 64 or 3872 for NetApp storage depending on the Array Model.
    • sig: The digital signature. Any valid eight-digit hex number will work.

    Example from above partitioning /dev/sdc using /dev/sdm for example size:

    node1:/opt/teradata/TDput/bin # partitionLUN -c /dev/sdc -l 14 -w 3872 -s 12345678 [-g]

    The –g option tells partitionLUN to use the parted command. If you do not use the -g option, then sfdisk is used for partitioning.
  3. To create entries for the new partitions in the /dev/disk/by-id directory on all nodes, run the partprobe command on all nodes in the clique.
  4. Record which entries point to the new partitions on the new LUN.
    Note: Repeat this step for each node in the clique.
    1. Go to the /dev/disk/by-id directory.
    2. Within the directory, use the ls -l command.
    3. Identify the entries using /dev/sd or /dev/tdmp as the destination for the link.
    4. Record the entries.
      The by-id entries are required when recreating the pdisk links.
  5. Proceed based on the type of LUN you are repairing:
    LUN Type Recovery Path
    Non-Cylinder Index Segregation Complete the remaining steps in the current process, beginning with Step 9 - Create Pdisk Links.
    Cylinder Index Segregation Complete the steps outlined under Recovering a Cylinder Index Segregation LUN.