管理存储设备

流程

1. 启动交互式 parted shell：

   # parted block-device

2. 确定该设备中是否已有一个分区表：

   (parted) print

   如果设备已经包含分区，则后续步骤中将删除它们。

3. 创建新分区表：

   (parted) mklabel table-type

   • 使用预期的分区表类型替换 table-type ：

     • 用于的 MBR 的 msdos
     • 用于 GPT 的 gpt

   例 4.1. 创建 GUID 分区表(GPT)表

   要在磁盘上创建 GPT 表，请使用：

   (parted) mklabel gpt

   在输入以下命令后，这些更改将开始应用。

4. 查看分区表以确认其已创建：

   (parted) print

5. 退出 parted shell:

   (parted) quit

流程

1. 启动 parted 工具。例如：以下输出列出了设备 /dev/sda ：

   # parted /dev/sda

2. 查看分区表：

   (parted) print
   
   Model: ATA SAMSUNG MZNLN256 (scsi)
   Disk /dev/sda: 256GB
   Sector size (logical/physical): 512B/512B
   Partition Table: msdos
   Disk Flags:
   
   Number  Start   End     Size    Type      File system  Flags
    1      1049kB  269MB   268MB   primary   xfs          boot
    2      269MB   34.6GB  34.4GB  primary
    3      34.6GB  45.4GB  10.7GB  primary
    4      45.4GB  256GB   211GB   extended
    5      45.4GB  256GB   211GB   logical

3. 可选：切换到您要检查的设备：

   (parted) select block-device

流程

1. 启动 parted 工具：

   # parted block-device

2. 查看当前的分区表来确定是否有足够空闲空间：

   (parted) print

   • 如果分区没有足够的可用空间，则调整分区大小。

   • 从分区表中决定：

     • 新分区的开始和结束点。
     • 在 MBR 上，应该是什么分区类型。

3. 创建新分区：

   对于 MS-DOS：

   (parted) mkpart part-type fs-type start end

   对于 GPT：

   (parted) mkpart part-name fs-type start end

   • 使用 primary、logical 或 extended 替换 part-type。这只适用于 MBR 分区表。
   • 使用任意分区名称替换 name。对于 GPT 分区表，这是必需的。
   • 将 fs-type 替换为 xfs、ext2、ext3、ext4、fat16、fat32、hfs、hfs+、linux-swap、ntfs 或 reiserfs。fs-type 参数是可选的。请注意，parted 实用程序不会在分区中创建文件系统。
   • 使用从磁盘开头计算分区开始和结束点的大小替换 start 和 end。您可以使用大小后缀，如 512MiB、20GiB 或 1.5TiB。默认的大小是 MB。

   例 4.2. 创建小的主分区

   要在 MBR 表上创建一个从 1024 MiB 到 2048 MiB 的主分区，请使用：

   (parted) mkpart primary 1024MiB 2048MiB

   在输入以下命令后，这些更改开始应用。

4. 查看分区表以确认创建的分区位于分区表中，并具有正确的分区类型、文件系统类型和大小：

   (parted) print

5. 退出 parted shell:

   (parted) quit

6. 验证内核是否识别了新的分区：

   # cat /proc/partitions

流程

1. 启动交互式 fdisk shell：

   # fdisk block-device

2. 查看当前的分区表以确定副分区号码：

   Command (m for help): print

   您可以在 Type 列中看到当前的分区类型，在 Id 列中看到相应的类型 ID 。

3. 输入分区类型命令并使用其次编号选择一个分区：

   Command (m for help): type
   Partition number (1-3, default 3): 2

4. 可选：显示分区类型：

   • 对于有 MBR 分区表的磁盘：

     Hex code or alias (type L to list all codes): L

   • 对于有 GPT 分区表的磁盘：

     Partition type or alias (type L to list all): L

5. 设置分区类型：

   • 对于有 MBR 分区表的磁盘：

     Hex code or alias (type L to list all codes): 8e

   • 对于有 GPT 分区表的磁盘：

     Partition type or alias (type L to list all): 44

6. 写入更改并退出 fdisk shell：

   Command (m for help): write
   The partition table has been altered.
   Syncing disks.

流程

1. 启动 parted 工具：

   # parted block-device

2. 查看当前的分区表：

   (parted) print

   从分区表中决定：

   • 分区的副号码。
   • 调整大小后现有分区的位置和新结束点。

1. 重新定义分区大小：

   (parted) resizepart 1 2GiB

   • 使用您要重新定义分区的副号码替换 1。
   • 将 2 替换为确定重新定义重新定义分区大小的新结束点的大小，从磁盘开始计算。您可以使用大小后缀，如 512MiB、20GiB 或 1.5TiB。默认的大小是 MB。

2. 查看分区表以确认调整了大小的分区位于分区表中，且大小正确：

   (parted) print

3. 退出 parted shell:

   (parted) quit

4. 验证内核是否注册了新分区：

   # cat /proc/partitions

5. 可选：如果您扩展分区，还要扩展它的文件系统。

流程

1. 启动交互式 parted shell：

   # parted block-device

   • 使用您要删除分区的设备的路径替换 block-device ：例如 /dev/sda。

2. 查看当前的分区表以确定要删除的分区的次号：

   (parted) print

3. 删除分区：

   (parted) rm partition-number

   • 使用您要删除的分区号替换 partition-number。

   输入此命令后，这些更改会立即应用。

4. 验证您是否已从分区表中删除了分区：

   (parted) print

5. 退出 parted shell:

   (parted) quit

6. 验证内核是否注册分区是否已删除：

   # cat /proc/partitions

7. 如果分区存在，从 /etc/fstab 文件中删除分区。找到声明删除的分区的行，并将其从文件中删除。

8. 重新生成挂载单元，以便您的系统注册新的 /etc/fstab 配置：

   # systemctl daemon-reload

   重要

   要删除 /proc/cmdline 中提到的分区或其是 LVM 的一部分，请参阅 配置和管理逻辑卷，以及您系统上的 dracut (8) 和 grubby (8) 手册页。

流程

1. 安装 targetcli 工具：

   # dnf install targetcli

2. 启动目标服务：

   # systemctl start target

3. 将目标配置为在引导时启动：

   # systemctl enable target

4. 在防火墙中打开端口 3260，并重新载入防火墙配置：

   # firewall-cmd --permanent --add-port=3260/tcp
   success

   # firewall-cmd --reload
   success

流程

1. 导航到 iSCSI 目录。您也可以使用 cd 命令导航到 iSCSI 目录。

   /> iscsi/

2. 使用以下选项之一创建 iSCSI 对象：

   1. 使用默认目标名称创建 iSCSI 对象：

      /iscsi> create
      
      Created target
      iqn.2003-01.org.linux-iscsi.hostname.x8664:sn.78b473f296ff
      Created TPG1

   2. 使用特定名称创建 iSCSI 对象：

      /iscsi> create iqn.2006-04.com.example:444
      
      Created target iqn.2006-04.com.example:444
      Created TPG1

      将 iqn.2006-04.com.example:444 替换为特定目标名称。

3. 验证新创建的目标：

   /iscsi> ls
   
   o- iscsi.......................................[1 Target]
       o- iqn.2006-04.com.example:444................[1 TPG]
           o- tpg1...........................[enabled, auth]
              o- acls...............................[0 ACL]
              o- luns...............................[0 LUN]
              o- portals.........................[0 Portal]

流程

1. 从 backstores/ 目录中进入 fileio/:

   /> backstores/fileio

2. 创建 fileio 存储对象：

   /backstores/fileio> create file1 /tmp/disk1.img 200M write_back=false
   
   Created fileio file1 with size 209715200

流程

1. 从 backstores/ 目录中进入 block/:

   /> backstores/block/

2. 创建 块 后备存储：

   /backstores/block> create name=block_backend dev=/dev/sdb
   
   Created block storage object block_backend using /dev/sdb.

流程

1. 从 backstores/ 目录中进入到 pscsi/ ：

   /> backstores/pscsi/

2. 为物理 SCSI 设备创建 pscsi 后端存储，本示例中是使用 /dev/sr0 的 TYPE_ROM 设备：

   /backstores/pscsi> create name=pscsi_backend dev=/dev/sr0
   
   Created pscsi storage object pscsi_backend using /dev/sr0

流程

1. 从 backstores/ 目录进入到 ramdisk/ ：

   /> backstores/ramdisk/

2. 创建 1GB RAM 磁盘后备存储：

   /backstores/ramdisk> create name=rd_backend size=1GB
   
   Created ramdisk rd_backend with size 1GB.

流程

1. 进入 TPG 目录：

   /iscsi> iqn.2006-04.com.example:444/tpg1/

2. 使用以下选项之一创建 iSCSI 门户：

   1. 创建默认门户使用默认 iSCSI 端口 3260，并允许目标侦听该端口上的所有 IP 地址：

      /iscsi/iqn.20...mple:444/tpg1> portals/ create
      
      Using default IP port 3260
      Binding to INADDR_Any (0.0.0.0)
      Created network portal 0.0.0.0:3260

   2. 使用特定 IP 地址创建门户：

      /iscsi/iqn.20...mple:444/tpg1> portals/ create 192.168.122.137
      
      Using default IP port 3260
      Created network portal 192.168.122.137:3260

流程

1. 创建已创建的存储对象的 LUN：

   /iscsi/iqn.20...mple:444/tpg1> luns/ create /backstores/ramdisk/rd_backend
   Created LUN 0.
   
   /iscsi/iqn.20...mple:444/tpg1> luns/ create /backstores/block/block_backend
   Created LUN 1.
   
   /iscsi/iqn.20...mple:444/tpg1> luns/ create /backstores/fileio/file1
   Created LUN 2.

2. 验证创建的 LUN：

   /iscsi/iqn.20...mple:444/tpg1> ls
   
   o- tpg.................................. [enabled, auth]
       o- acls ......................................[0 ACL]
       o- luns .....................................[3 LUNs]
       |  o- lun0.........................[ramdisk/ramdisk1]
       |  o- lun1.................[block/block1 (/dev/vdb1)]
       |  o- lun2...................[fileio/file1 (/foo.img)]
       o- portals ................................[1 Portal]
           o- 192.168.122.137:3260......................[OK]

   默认 LUN 名称以 0 开头。

   重要

   默认情况下，创建的 LUN 有读/写权限。如果在创建 ACL 后添加了新的 LUN，LUN 会自动映射到所有可用 ACL，并可能导致安全风险。要创建具有只读权限的 LUN，请参阅创建只读 iSCSI LUN。

3. 配置 ACL。如需更多信息，请参阅创建 iSCSI ACL。

流程

1. 设置只读权限：

   /> set global auto_add_mapped_luns=false
   
   Parameter auto_add_mapped_luns is now 'false'.

   这样可防止 LUN 自动映射到现有 ACL，从而允许手动映射 LUN。

2. 进入 initiator_iqn_name 目录：

   /> iscsi/target_iqn_name/tpg1/acls/initiator_iqn_name/

3. 创建 LUN：

   /iscsi/target_iqn_name/tpg1/acls/initiator_iqn_name> create mapped_lun=next_sequential_LUN_number tpg_lun_or_backstore=backstore write_protect=1

   例如：

   /iscsi/target_iqn_name/tpg1/acls/2006-04.com.example:888> create mapped_lun=1 tpg_lun_or_backstore=/backstores/block/block2 write_protect=1
   
   Created LUN 1.
   Created Mapped LUN 1.

4. 验证所创建的 LUN：

   /iscsi/target_iqn_name/tpg1/acls/2006-04.com.example:888> ls
    o- 2006-04.com.example:888 .. [Mapped LUNs: 2]
    | o- mapped_lun0 .............. [lun0 block/disk1 (rw)]
    | o- mapped_lun1 .............. [lun1 block/disk2 (ro)]

   mapping_lun1 行现在在结尾带有(ro)（不像 mapping_lun0 为 (rw)），这表示它是只读的。

5. 配置 ACL。如需更多信息，请参阅创建 iSCSI ACL。

流程

1. 可选：要禁用自动将 LUN 映射到 ACL，请参阅 创建一个只读 iSCSI LUN。

2. 进入 acls 目录：

   /> iscsi/target_iqn_name/tpg_name/acls/

3. 使用以下选项之一创建一个 ACL：

   • 使用启动器上的 /etc/iscsi/initiatorname.iscsi 文件中的 initiator_iqn_name ：

     iscsi/target_iqn_name/tpg_name/acls> create initiator_iqn_name
     
     Created Node ACL for initiator_iqn_name
     Created mapped LUN 2.
     Created mapped LUN 1.
     Created mapped LUN 0.

   • 使用 custom_name ，并更新启动器以匹配它：

     iscsi/target_iqn_name/tpg_name/acls> create custom_name
     
     Created Node ACL for custom_name
     Created mapped LUN 2.
     Created mapped LUN 1.
     Created mapped LUN 0.

     有关更新启动器名称的详情，请参考 创建一个 iSCSI 启动器。

流程

1. 设置属性身份验证：

   /iscsi/iqn.20...mple:444/tpg1> set attribute authentication=1
   
   Parameter authentication is now '1'.

2. 设置 userid 和密码 ：

   /tpg1> set auth userid=redhat
   Parameter userid is now 'redhat'.
   
   /iscsi/iqn.20...689dcbb3/tpg1> set auth password=redhat_passwd
   Parameter password is now 'redhat_passwd'.

3. 进入 acls 目录：

   /> iscsi/target_iqn_name/tpg1/acls/initiator_iqn_name/

4. 设置属性身份验证：

   /iscsi/iqn.20...:605fcc6a48be> set attribute authentication=1
   Parameter authentication is now '1'.

5. 设置 userid 和密码 ：

   /iscsi/iqn.20...:605fcc6a48be> set auth userid=redhat
   Parameter userid is now 'redhat'.
   
   /iscsi/iqn.20...:605fcc6a48be> set auth password=redhat_passwd
   Parameter password is now 'redhat_passwd'.

流程

1. 从目标登出：

   # iscsiadm -m node -T iqn.2006-04.com.example:444 -u

   有关如何登录到目标的更多信息，请参阅 创建一个 iSCSI 启动器。

2. 删除整个目标，包括所有 ACL、LUN 和门户：

   /> iscsi/ delete iqn.2006-04.com.example:444

   将 iqn.2006-04.com.example:444 替换为 target_iqn_name。

   • 删除 iSCSI 后端存储：

     /> backstores/backstore-type/ delete block_backend

     使用 fileio、block、pscsi 或 ramdisk 替换 backstore-type。

     使用您要删除的 backstore-name 替换 block_backend。

   • 要删除 iSCSI 目标的部分，如 ACL：

     /> /iscsi/iqn-name/tpg/acls/ delete iqn.2006-04.com.example:444

流程

1. 在客户端机器上安装 iscsi-initiator-utils:

   # dnf install iscsi-initiator-utils

2. 启动 iscsid 服务：

   # systemctl start iscsid

3. 检查 initiator 名称：

   # cat /etc/iscsi/initiatorname.iscsi
   
   InitiatorName=iqn.2006-04.com.example:888

4. 如果在创建 iSCI ACL 时，ACL 被指定了一个自定义名称，请更新启动器名称以匹配 ACL：

   1. 打开 /etc/iscsi/initiatorname.iscsi 文件，并修改启动器名称：

      # vi /etc/iscsi/initiatorname.iscsi
      
      InitiatorName=custom-name

   2. 重启 iscsid 服务：

      # systemctl restart iscsid

5. 发现目标并使用显示的目标 IQN 登录到目标：

   # iscsiadm -m discovery -t st -p 10.64.24.179
       10.64.24.179:3260,1 iqn.2006-04.com.example:444
   
   # iscsiadm -m node -T iqn.2006-04.com.example:444 -l
       Logging in to [iface: default, target: iqn.2006-04.com.example:444, portal: 10.64.24.179,3260] (multiple)
       Login to [iface: default, target: iqn.2006-04.com.example:444, portal: 10.64.24.179,3260] successful.

   将 10.64.24.179 替换为 target-ip-address。

   如果将相应的启动器名称添加到 ACL 中，您可以将这个步骤用于连接到同一目标的任意启动器名称，如创建 iSCSI ACL 所述。

6. 找到 iSCSI 磁盘名称并在这个 iSCSI 磁盘中创建文件系统：

   # grep "Attached SCSI" /var/log/messages
   
   # mkfs.ext4 /dev/disk_name

   使用 /var/log/messages 文件中显示的 iSCSI 磁盘名称替换 disk_name。

7. 挂载文件系统：

   # mkdir /mount/point
   
   # mount /dev/disk_name /mount/point

   使用分区的挂载点替换 /mount/point。

8. 编辑 /etc/fstab 文件，以便在系统引导时自动挂载文件系统：

   # vi /etc/fstab
   
   /dev/disk_name /mount/point ext4 _netdev 0 0

   使用 iSCSI 磁盘名称替换 disk_name，使用分区的挂载点替换 /mount/point。

流程

1. 在 iscsid.conf 文件中启用 CHAP 验证：

   # vi /etc/iscsi/iscsid.conf
   
   node.session.auth.authmethod = CHAP

   默认情况下，node.session.auth.authmethod 设置为 None

2. 在 iscsid.conf 文件中添加目标用户名和密码 ：

   node.session.auth.username = redhat
   node.session.auth.password = redhat_passwd

3. 重启 iscsid 服务：

   # systemctl restart iscsid

流程

1. 在客户端机器上安装 iscsi-initiator-utils:

   # dnf install iscsi-initiator-utils

2. 查找正在运行的会话的信息：

   # iscsiadm -m session -P 3

   这个命令显示会话或设备状态、会话 ID(sid)、一些协商的参数以及可通过会话访问的 SCSI 设备。

   • 如果只需要简短的输出，例如：只显示 sid-to-node 映射，请运行：

     # iscsiadm -m session -P 0
             or
     # iscsiadm -m session
     
     tcp [2] 10.15.84.19:3260,2 iqn.1992-08.com.netapp:sn.33615311
     tcp [3] 10.15.85.19:3260,3 iqn.1992-08.com.netapp:sn.33615311

     这些命令以以下格式显示了正在运行的会话列表： driver [sid] target_ip:port,target_portal_group_tag proper_target_name。

流程

1. 确定哪些设备是 多路径 逻辑单元的路径：

   # multipath -ll

2. 在使用多路径的系统中重新扫描光纤通道逻辑单元：

   $ echo 1 > /sys/block/<device_ID>/device/rescan

   将 <device_ID> 替换为您设备的 ID，如 sda。

流程

1. 创建 nvmet-rdma 子系统：

   # modprobe nvmet-rdma
   
   # mkdir /sys/kernel/config/nvmet/subsystems/testnqn
   
   # cd /sys/kernel/config/nvmet/subsystems/testnqn

   使用子系统名称替换 testnqn。

2. 允许任何主机连接到此控制器：

   # echo 1 > attr_allow_any_host

3. 配置命名空间：

   # mkdir namespaces/10
   
   # cd namespaces/10

   使用命名空间号替换 10

4. 设置 NVMe 设备的路径：

   # echo -n /dev/nvme0n1 > device_path

5. 启用命名空间：

   # echo 1 > enable

6. 创建带有 NVMe 端口的目录：

   # mkdir /sys/kernel/config/nvmet/ports/1
   
   # cd /sys/kernel/config/nvmet/ports/1

7. 显示 mlx5_ib0 的 IP 地址：

   # ip addr show mlx5_ib0
   
   8: mlx5_ib0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 4092 qdisc mq state UP group default qlen 256
       link/infiniband 00:00:06:2f:fe:80:00:00:00:00:00:00:e4:1d:2d:03:00:e7:0f:f6 brd 00:ff:ff:ff:ff:12:40:1b:ff:ff:00:00:00:00:00:00:ff:ff:ff:ff
       inet 172.31.0.202/24 brd 172.31.0.255 scope global noprefixroute mlx5_ib0
          valid_lft forever preferred_lft forever
       inet6 fe80::e61d:2d03:e7:ff6/64 scope link noprefixroute
          valid_lft forever preferred_lft forever

8. 为控制器设置传输地址：

   # echo -n 172.31.0.202 > addr_traddr

9. 将 RDMA 设置为传输类型：

   # echo rdma > addr_trtype
   
   # echo 4420 > addr_trsvcid

10. 为端口设置地址系列：

    # echo ipv4 > addr_adrfam

11. 创建软链接：

    # ln -s /sys/kernel/config/nvmet/subsystems/testnqn /sys/kernel/config/nvmet/ports/1/subsystems/testnqn

流程

1. 安装 nvmetcli 软件包：

   # dnf install nvmetcli

2. 下载 rdma.json 文件：

   # wget http://git.infradead.org/users/hch/nvmetcli.git/blob_plain/0a6b088db2dc2e5de11e6f23f1e890e4b54fee64:/rdma.json

3. 编辑 rdma.json 文件，并将 traddr 值更改为 172.31.0.202。

4. 通过载入 NVMe 控制器配置文件来设置控制器：

   # nvmetcli restore rdma.json

流程

1. 安装 nvme-cli 工具：

   # dnf install nvme-cli

2. 如果没有加载，则加载 nvme-rdma 模块：

   # modprobe nvme-rdma

3. 在 NVMe 控制器中发现可用的子系统：

   # nvme discover -t rdma -a 172.31.0.202 -s 4420
   
   Discovery Log Number of Records 2, Generation counter 2
   =====Discovery Log Entry 0======
   trtype: rdma
   adrfam: ipv4
   subtype: current discovery subsystem
   treq: not specified, sq flow control disable supported
   portid: 2
   trsvcid: 4420
   subnqn: nqn.2014-08.org.nvmexpress.discovery
   traddr: 172.31.0.202
   eflags: none
   rdma_prtype: not specified
   rdma_qptype: connected
   rdma_cms: rdma-cm
   rdma_pkey: 0000
   =====Discovery Log Entry 1======
   trtype: rdma
   adrfam: ipv4
   subtype: nvme subsystem
   treq: not specified, sq flow control disable supported
   portid: 2
   trsvcid: 4420
   subnqn: testnqn
   traddr: 172.31.0.202
   eflags: none
   rdma_prtype: not specified
   rdma_qptype: connected
   rdma_cms: rdma-cm
   rdma_pkey: 0000

4. 连接到发现的子系统：

   # nvme connect -t rdma -a 172.31.0.202 -s 4420 -n testnqn
   connecting to device: nvme0
   
   # lsblk
   NAME                         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
   sda                            8:0    0 465.8G  0 disk
   ├─sda1                         8:1    0     1G  0 part /boot
   └─sda2                         8:2    0 464.8G  0 part
     ├─rhel_rdma--virt--03-root 253:0    0    50G  0 lvm  /
     ├─rhel_rdma--virt--03-swap 253:1    0     4G  0 lvm  [SWAP]
     └─rhel_rdma--virt--03-home 253:2    0 410.8G  0 lvm  /home
   nvme0n1
   
   # cat /sys/class/nvme/nvme0/transport
   rdma

   使用 NVMe 子系统名称替换 testnqn。

   将 172.31.0.202 替换为控制器 IP 地址。

   使用端口号替换 4420。

流程

1. 安装 nvme-cli 工具：

   # dnf install nvme-cli

   这会在 /etc/nvme/ 目录中创建 hostnqn 文件。hostn 文件标识 NVMe 主机。

2. 查找本地和远程端口的全球节点名称(WWNN)和全球端口名称(WWPN)标识符：

   # cat /sys/class/scsi_host/host*/nvme_info
   
   NVME Host Enabled
   XRI Dist lpfc0 Total 6144 IO 5894 ELS 250
   NVME LPORT lpfc0 WWPN x10000090fae0b5f5 WWNN x20000090fae0b5f5 DID x010f00 ONLINE
   NVME RPORT       WWPN x204700a098cbcac6 WWNN x204600a098cbcac6 DID x01050e TARGET DISCSRVC ONLINE
   
   NVME Statistics
   LS: Xmt 000000000e Cmpl 000000000e Abort 00000000
   LS XMIT: Err 00000000  CMPL: xb 00000000 Err 00000000
   Total FCP Cmpl 00000000000008ea Issue 00000000000008ec OutIO 0000000000000002
       abort 00000000 noxri 00000000 nondlp 00000000 qdepth 00000000 wqerr 00000000 err 00000000
   FCP CMPL: xb 00000000 Err 00000000

   使用这些 host-traddr 和 traddr 值，找到子系统 NVMe 限定名称(NQN)：

   # nvme discover --transport fc \
                   --traddr nn-0x204600a098cbcac6:pn-0x204700a098cbcac6 \
                   --host-traddr nn-0x20000090fae0b5f5:pn-0x10000090fae0b5f5
   
   Discovery Log Number of Records 2, Generation counter 49530
   =====Discovery Log Entry 0======
   trtype:  fc
   adrfam:  fibre-channel
   subtype: nvme subsystem
   treq:    not specified
   portid:  0
   trsvcid: none
   subnqn:  nqn.1992-08.com.netapp:sn.e18bfca87d5e11e98c0800a098cbcac6:subsystem.st14_nvme_ss_1_1
   traddr:  nn-0x204600a098cbcac6:pn-0x204700a098cbcac6

   将 nn-0x204600a098cbcac6:pn-0x204700a098cbcac6 替换为 traddr。

   将 nn-0x20000090fae0b5f5:pn-0x10000090fae0b5f5 替换为 host-traddr。

3. 使用 nvme-cli 连接到 NVMe 控制器：

   # nvme connect --transport fc \
                  --traddr nn-0x204600a098cbcac6:pn-0x204700a098cbcac6 \
                  --host-traddr nn-0x20000090fae0b5f5:pn-0x10000090fae0b5f5 \
                  -n nqn.1992-08.com.netapp:sn.e18bfca87d5e11e98c0800a098cbcac6:subsystem.st14_nvme_ss_1_1 \
                  -k 5

   注意

   如果您在连接时间超过默认的 keep-alive timeout 值时看到 keep-alive timer (5 seconds) expired! 错误，请使用 -k 选项增加它。例如，您可以使用 -k 7。

   在这里，

   将 nn-0x204600a098cbcac6:pn-0x204700a098cbcac6 替换为 traddr。

   将 nn-0x20000090fae0b5f5:pn-0x10000090fae0b5f5 替换为 host-traddr。

   将 nqn.1992-08.com.netapp:sn.e18bfca87d5e11e98c0800a098cbcac6:subsystem.st14_nvme_ss_1_1 替换为 subnqn。

   将 5 替换为 keep-alive timeout 值（以秒为单位）。

流程

1. 安装 nvme-cli 工具：

   # dnf install nvme-cli

   这会在 /etc/nvme/ 目录中创建 hostnqn 文件。hostn 文件标识 NVMe 主机。

2. 重新载入 qla2xxx 模块：

   # modprobe -r qla2xxx
   # modprobe qla2xxx

3. 查找本地和远程端口的全球节点名称(WWNN)和全球端口名称(WWPN)标识符：

   # dmesg |grep traddr
   
   [    6.139862] qla2xxx [0000:04:00.0]-ffff:0: register_localport: host-traddr=nn-0x20000024ff19bb62:pn-0x21000024ff19bb62 on portID:10700
   [    6.241762] qla2xxx [0000:04:00.0]-2102:0: qla_nvme_register_remote: traddr=nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6 PortID:01050d

   使用这些 host-traddr 和 traddr 值，找到子系统 NVMe 限定名称(NQN)：

   # nvme discover --transport fc \
                   --traddr nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6 \
                   --host-traddr nn-0x20000024ff19bb62:pn-0x21000024ff19bb62
   
   Discovery Log Number of Records 2, Generation counter 49530
   =====Discovery Log Entry 0======
   trtype:  fc
   adrfam:  fibre-channel
   subtype: nvme subsystem
   treq:    not specified
   portid:  0
   trsvcid: none
   subnqn:  nqn.1992-08.com.netapp:sn.c9ecc9187b1111e98c0800a098cbcac6:subsystem.vs_nvme_multipath_1_subsystem_468
   traddr:  nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6

   将 nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6 替换为 traddr。

   将 nn-0x20000024ff19bb62:pn-0x21000024ff19bb62 替换为 host-traddr。

4. 使用 nvme-cli 工具连接到 NVMe 控制器：

   # nvme connect --transport fc \
                   --traddr nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6 \
                   --host-traddr nn-0x20000024ff19bb62:pn-0x21000024ff19bb62 \
                   -n nqn.1992-08.com.netapp:sn.c9ecc9187b1111e98c0800a098cbcac6:subsystem.vs_nvme_multipath_1_subsystem_468\
                  -k 5

   注意

   如果您在连接时间超过默认的 keep-alive timeout 值时看到 keep-alive timer (5 seconds) expired! 错误，请使用 -k 选项增加它。例如，您可以使用 -k 7。

   在这里，

   将 nn-0x203b00a098cbcac6:pn-0x203d00a098cbcac6 替换为 traddr。

   将 nn-0x20000024ff19bb62:pn-0x21000024ff19bb62 替换为 host-traddr。

   将 nqn.1992-08.com.netapp:sn.c9ecc9187b1111e98c0800a098cbcac6:subsystem.vs_nvme_multipath_1_subsystem_468 替换为 subnqn。

   将 5 替换为 keep-live timeout 值（以秒为单位）。

流程

1. 安装 nvme-cli 工具：

   # dnf install nvme-cli

   此工具在 /etc/nvme/ 目录中创建 hostnqn 文件，该文件标识 NVMe 主机。

2. 找到 nvme hostid 和 hostnqn ：

   # cat /etc/nvme/hostnqn
   nqn.2014-08.org.nvmexpress:uuid:8ae2b12c-3d28-4458-83e3-658e571ed4b8
   
   # cat /etc/nvme/hostid
   09e2ce17-ccc9-412d-8dcf-2b0a1d581ee3

   使用 hostid 和 hostn 值配置 NVMe/TCP 控制器。

3. 检查控制器的状态：

   # nmcli device show ens6
   GENERAL.DEVICE:                         ens6
   GENERAL.TYPE:                           ethernet
   GENERAL.HWADDR:                         52:57:02:12:02:02
   GENERAL.MTU:                            1500
   GENERAL.STATE:                          30 (disconnected)
   GENERAL.CONNECTION:                     --
   GENERAL.CON-PATH:                       --
   WIRED-PROPERTIES.CARRIER:               on

4. 使用静态 IP 地址为新安装的以太网控制器配置主机网络：

   # nmcli connection add con-name ens6 ifname ens6 type ethernet ip4 192.168.101.154/24 gw4 192.168.101.1

   此处，将 192.168.101.154 替换为主机 IP 地址。

   # nmcli connection mod ens6 ipv4.method manual
   # nmcli connection up ens6

   由于创建了一个新网络来将 NVMe/TCP 主机连接到 NVMe/TCP 控制器，因此也在控制器上重复此步骤。

流程

1. 如果还没有加载 nvme-tcp 模块，请加载它：

   # modprobe nvme-tcp

2. 在 NVMe 控制器中发现可用的子系统：

   # nvme discover --transport=tcp --traddr=192.168.101.55 --host-traddr=192.168.101.154 --trsvcid=8009
   
   Discovery Log Number of Records 2, Generation counter 7
   =====Discovery Log Entry 0======
   trtype:  tcp
   adrfam:  ipv4
   subtype: current discovery subsystem
   treq:	not specified, sq flow control disable supported
   portid:  2
   trsvcid: 8009
   subnqn:  nqn.2014-08.org.nvmexpress.discovery
   traddr:  192.168.101.55
   eflags:  not specified
   sectype: none
   =====Discovery Log Entry 1======
   trtype:  tcp
   adrfam:  ipv4
   subtype: nvme subsystem
   treq:	not specified, sq flow control disable supported
   portid:  2
   trsvcid: 8009
   subnqn:  nqn.2014-08.org.nvmexpress:uuid:0c468c4d-a385-47e0-8299-6e95051277db
   traddr:  192.168.101.55
   eflags:  not specified
   sectype: none

   在这里，192.168.101.55 是 NVMe/TCP 控制器 IP 地址，192.168.101.154 是 NVMe/TCP 主机 IP 地址。

3. 配置 /etc/nvme/discovery.conf 文件，以添加 nvme discover 命令中使用的参数：

   # echo "--transport=tcp --traddr=192.168.101.55 --host-traddr=192.168.101.154 --trsvcid=8009" >> /etc/nvme/discovery.conf

4. 将 NVMe/TCP 主机连接到控制器系统：

   # nvme connect-all

流程

1. 生成一个身份验证 secret：

   1. 对于主机：

      # hostkey=$(nvme gen-dhchap-key -n ${HOSTNQN})

   2. 对于子系统：

      # ctrlkey=$(nvme gen-dhchap-key -n ${SUBSYSTEM})

2. 配置主机以进行身份验证：

   # nvme connect -t tcp -n ${SUBSYSTEM} -a ${TRADDR} -s 4420 --dhchap-secret=${hostkey} --dhchap-ctrl-secret=${ctrlkey}

   这为 nvme-connect 工具提供了身份验证 secret，以便它可以验证并建立到目标的连接。

   • 可选：要启用自动登录，请设置持久的 NVMe fabrics 配置。为此，请将 --dhchap-secret 和 --dhchap-ctrl-secret 参数添加到 /etc/nvme/discovery.conf 或 /etc/nvme/config.json。

流程

1. 配置预共享密钥 Keyring 。

   1. 识别主机 NQN ：

      # HOSTNQN=$(nvme show-hostnqn)

   2. 生成并复制新配置的 PSK：

      # PSK=$(nvme gen-tls-key)

      # echo $PSK

   3. 配置预共享密钥 Keyring ：

      # nvme check-tls-key --insert --hostnqn=${HOSTNQN} --subsysnqn=${SUBSYSTEM} --keydata=${PSK} --identity=1

2. 配置 tlshd 服务。

   1. 将 keyring 名称添加到 /etc/tlshd.conf 配置文件中：

      ...
      [authenticate]
      keyring=.nvme
      ...

   2. 重启 tlshd 服务：

      # systemctl restart tlshd

3. 为 NVMe fabrics 连接启用 TLS：

   # nvme discover -t tcp --tls -a ${TRADDR} -s 4420

   # nvme connect -t tcp --tls -a ${TRADDR} -s 4420 -n ${SUBSYSTEM}

流程

1. 创建大小为 4 GB 的 LVM2 逻辑卷：

   # lvcreate -n LogVol02 -L 4G VolGroup00

2. 格式化新 swap 空间：

   # mkswap /dev/VolGroup00/LogVol02

3. 在 /etc/fstab 文件中添加以下条目：

   /dev/VolGroup00/LogVol02 none swap defaults 0 0

4. 重新生成挂载单元以便您的系统注册新配置：

   # systemctl daemon-reload

5. 在逻辑卷中激活 swap：

   # swapon -v /dev/VolGroup00/LogVol02

流程

1. 以 MB 为单位确定新交换文件的大小，再乘以 1024 来确定块的数量。例如，64 MB 文件所需的 1024 字节大小的块的数量为 65536。

2. 创建一个空文件：

   # dd if=/dev/zero of=/swapfile bs=1024 count=65536

   将 65536 替换为等于所需块大小的值。

3. 使用以下命令设定 swap 文件：

   # mkswap /swapfile

4. 更改交换文件的安全性，使其不可读。

   # chmod 0600 /swapfile

5. 使用以下条目编辑 /etc/fstab 文件，以在引导时启用交换文件：

   /swapfile none swap defaults 0 0

   下次系统引导时，它会激活新的 swap 文件。

6. 重新生成挂载单元，以便您的系统注册新的 /etc/fstab 配置：

   # systemctl daemon-reload

7. 立即激活 swap 文件：

   # swapon /swapfile

流程

1. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Create a disk device with swap
     hosts: managed-node-01.example.com
     roles:
       - rhel-system-roles.storage
     vars:
       storage_volumes:
         - name: swap_fs
           type: disk
           disks:
             - /dev/sdb
           size: 15 GiB
           fs_type: swap

   卷名称（示例中的 swap_fs ）目前是任意的。存储 角色根据 disks: 属性下列出的磁盘设备来识别卷。

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/rhel-system-roles.storage/README.md 文件。

2. 验证 playbook 语法：

   $ ansible-playbook --syntax-check ~/playbook.yml

   请注意，这个命令只验证语法，不能防止错误的、但有效的配置。

3. 运行 playbook：

   $ ansible-playbook ~/playbook.yml

流程

1. 为关联的逻辑卷禁用交换：

   # swapoff -v /dev/VolGroup00/LogVol02

2. 将 LVM2 逻辑卷调整为 2 GB ：

   # lvresize -L +2G /dev/VolGroup00/LogVol02

3. 格式化新 swap 空间：

   # mkswap /dev/VolGroup00/LogVol02

4. 启用扩展的逻辑卷：

   # swapon -v /dev/VolGroup00/LogVol02

流程

1. 为关联的逻辑卷禁用交换：

   # swapoff -v /dev/VolGroup00/LogVol02

2. 清理 swap 签名：

   # wipefs -a /dev/VolGroup00/LogVol02

3. 将 LVM2 逻辑卷减少 512 MB：

   # lvreduce -L -512M /dev/VolGroup00/LogVol02

4. 格式化新 swap 空间：

   # mkswap /dev/VolGroup00/LogVol02

5. 在逻辑卷中激活 swap：

   # swapon -v /dev/VolGroup00/LogVol02

流程

1. 为关联的逻辑卷禁用交换：

   # swapoff -v /dev/VolGroup00/LogVol02

2. 删除 LVM2 逻辑卷：

   # lvremove /dev/VolGroup00/LogVol02

3. 从 /etc/fstab 文件中删除以下关联的条目：

   /dev/VolGroup00/LogVol02 none swap defaults 0 0

4. 重新生成挂载单元以注册新配置：

   # systemctl daemon-reload

流程

1. 禁用 /swapfile swap 文件：

   # swapoff -v /swapfile

2. 相应地从 /etc/fstab 文件中删除其条目。

3. 重新生成挂载单元以便您的系统注册新配置：

   # systemctl daemon-reload

4. 删除实际的文件：

   # rm /swapfile

先决条件

1. 已安装 mt-st 软件包。如需更多信息，请参阅安装磁带驱动器管理工具。

2. 加载磁带驱动器：

   # mt -f /dev/st0 load

流程

1. 检查磁带头：

   # mt -f /dev/st0 status
   
   SCSI 2 tape drive:
   File number=-1, block number=-1, partition=0.
   Tape block size 0 bytes. Density code 0x0 (default).
   Soft error count since last status=0
   General status bits on (50000):
    DR_OPEN IM_REP_EN

   在这里：

   • 当前文件号为 -1。
   • 块编号 定义磁带头。默认情况下，它被设置为 -1。
   • 块大小 0 表示磁带设备没有固定的块大小。
   • 软错误数表示在执行 mt status 命令后遇到的错误数量。
   • General status 位解释了磁带设备的状态。
   • DR_OPEN 表示公开，磁带设备为空。IM_REP_EN 是即时报告模式。

2. 如果磁带设备不是空的，覆盖它：

   # tar -czf /dev/st0 _/source/directory

   该命令使用 /source/directory 目录的内容覆盖 tape 设备中的数据

3. 将 /source/directory 目录备份到磁带设备中：

   # tar -czf /dev/st0 _/source/directory
   tar: Removing leading `/' from member names
   /source/directory
   /source/directory/man_db.conf
   /source/directory/DIR_COLORS
   /source/directory/rsyslog.conf
   [...]

4. 查看磁带设备的状态：

   # mt -f /dev/st0 status

先决条件

1. 已安装 mt-st 软件包。如需更多信息，请参阅安装磁带驱动器管理工具。

2. 加载磁带驱动器：

   # mt -f /dev/nst0 load

流程

1. 检查非回卷磁带设备 /dev/nst0 的磁带头：

   # mt -f /dev/nst0 status

2. 指定位于头或磁带末尾的指针：

   # mt -f /dev/nst0 rewind

3. 附加磁带设备中的数据：

   # mt -f /dev/nst0 eod
   # tar -czf /dev/nst0 /source/directory/

4. 将 /source/directory/ 备份到磁带设备中：

   # tar -czf /dev/nst0 /source/directory/
   tar: Removing leading `/' from member names
   /source/directory/
   /source/directory/man_db.conf
   /source/directory/DIR_COLORS
   /source/directory/rsyslog.conf
   [...]

5. 查看磁带设备的状态：

   # mt -f /dev/nst0 status

先决条件

1. 已安装 mt-st 软件包。如需更多信息，请参阅安装磁带驱动器管理工具。
2. 数据被写入磁带设备。如需更多信息，请参阅写入回卷磁带设备，或写入非回卷磁带设备。

先决条件

1. 已安装 mt-st 软件包。如需更多信息，请参阅安装磁带驱动器管理工具。
2. 数据被写入磁带设备。如需更多信息，请参阅写入回卷磁带设备，或写入非回卷磁带设备。

先决条件

1. 已安装 mt-st 软件包。如需更多信息，请参阅安装磁带驱动器管理工具。
2. 数据被写入磁带设备。如需更多信息，请参阅写入回卷磁带设备，或写入非回卷磁带设备。

流程

1. 从磁带设备中删除数据：

   # mt -f /dev/st0 erase

2. 卸载磁带设备：

   # mt -f /dev/st0 offline

流程

1. 在 Manual Partitioning 窗口左面地框中，选所需的分区。
2. 点击设备类型下拉菜单并选择 RAID。
3. 在 Device(s) 部分点 修改。此时会打开 Configure Mount Point 对话框。
4. 选择您要包含在 RAID 设备中的磁盘，然后点击 Select 关闭对话框。
5. 点击文件系统下拉菜单并选择您首选的文件系统类型。
6. 点击RAID 级别下拉菜单并选择您需要的 RAID 级别。
7. 点击 更新设置 保存您的更改。
8. 点 Done 应用设置并返回到按照概述窗口。

流程

1. 创建两个块设备的 RAID，如 /dev/sda1 和 /dev/sdc1 ：

   # mdadm --create /dev/md0 --level=0 --raid-devices=2 /dev/sda1 /dev/sdc1
   mdadm: Defaulting to version 1.2 metadata
   mdadm: array /dev/md0 started.

   level_value 选项定义 RAID 级别。

2. 可选：检查 RAID 的状态：

   # mdadm --detail /dev/md0
   /dev/md0:
              Version : 1.2
        Creation Time : Thu Oct 13 15:17:39 2022
           Raid Level : raid0
           Array Size : 18649600 (17.79 GiB 19.10 GB)
         Raid Devices : 2
        Total Devices : 2
          Persistence : Superblock is persistent
   
          Update Time : Thu Oct 13 15:17:39 2022
                State : clean
       Active Devices : 2
      Working Devices : 2
       Failed Devices : 0
        Spare Devices : 0
   [...]

3. 可选：观察 RAID 中每个设备的详细信息：

   # mdadm --examine /dev/sda1 /dev/sdc1
   /dev/sda1:
             Magic : a92b4efc
           Version : 1.2
       Feature Map : 0x1000
        Array UUID : 77ddfb0a:41529b0e:f2c5cde1:1d72ce2c
              Name : 0
     Creation Time : Thu Oct 13 15:17:39 2022
        Raid Level : raid0
      Raid Devices : 2
   [...]

4. 在 RAID 驱动器中创建文件系统：

   # mkfs -t xfs /dev/md0

   使用您选择格式化驱动器的文件系统替换 xfs。

5. 为 RAID 驱动器创建挂载点并挂载它：

   # mkdir /mnt/raid1
   # mount /dev/md0 /mnt/raid1

   使用挂载点替换 /mnt/raid1。

   如果您希望 RHEL 在系统引导时自动挂载 md0 RAID 设备，请将设备的条目添加到 /etc/fstab 文件中 ：

   /dev/md0   /mnt/raid1 xfs  defaults   0 0

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，单击菜单按钮，然后选择 Create MDRAID device。
4. 在 Create RAID Device 字段中，为新 RAID 输入一个名称。
5. 在 RAID 级别下拉列表中，选择您要使用的 RAID 级别。

6. 在 Chunk Size 下拉列表中，从可用选项列表中选择大小。

   Chunk Size 值指定用于写数据的每个块有多大。例如，如果块大小为 512 KiB，系统将把第一个 512 KiB 写入第一个磁盘中，第二个 512 KiB 将被写入第二个磁盘中，第三个块将被写入第三个磁盘中。如果您的 RAID 中有三个磁盘，则第四个 512 KiB 被再次写入第一个磁盘中。

7. 选择您要用于 RAID 的磁盘。
8. 点 Create。

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，点您要格式化的 RAID 设备的菜单按钮 ⋮。
4. 从下拉菜单中选择 Format。
5. 在 Format 字段中输入名称。
6. 在 Mount Point 字段中添加挂载路径。
7. 从 Type 下拉列表中选择文件系统的类型。
8. 可选：检查 Overwrite existing data with zeros 选项，如果磁盘包含任何敏感数据，并且您要覆盖它们。否则 RHEL web 控制台只重写磁盘头。
9. 在 Encryption 下拉菜单中选择加密类型。如果您不想加密卷，请选择 No encryption。
10. 在 At boot 下拉菜单中选择您要何时挂载卷。

11. 在 Mount options 部分中：

    1. 如果要将卷挂载为只读逻辑卷，请选择 Mount read only 复选框。
    2. 如果要更改默认挂载选项，请选择 Custom mount options 复选框，并添加挂载选项。

12. 格式化 RAID 分区：

    • 如果要格式化并挂载分区，请点 Format and mount 按钮。
    • 如果您只想格式化分区，请点 Format only 按钮。

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，点您要在其上创建分区表的 RAID 设备。
4. 点 MDRAID device 部分中的菜单按钮 ⋮。
5. 从下拉菜单中选择 Create partition table。

6. 在 Initialize disk 对话框中选择以下内容：

   1. Partitioning ：

      • 如果分区应该与所有系统和设备兼容，请选择 MBR。
      • 如果分区应该与现代系统兼容，且硬盘必须大于 2 TB，请选择 GPT。
      • 如果您不需要进行分区，请选择 No partitioning。

   2. Overwrite ：

      • 如果磁盘包含任何敏感数据并且您想覆盖它们，请检查 Overwrite existing data with zeros 选项。否则 RHEL web 控制台只重写磁盘头。
7. 单击 Initialize。

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 点击您要在其上创建分区的 RAID 设备。
4. 在 RAID 设备页面中，滚动到 GPT partitions 部分，然后点击菜单按钮[⋮]。
5. 点 Create partition，然后在 Create partition 字段中输入文件系统的名称。不要在名称中使用空格。
6. 在 Mount Point 字段中输入挂载路径。
7. 在 Type 下拉列表中选择文件系统的类型。
8. 在 Size 滑块中设置分区的大小。
9. 可选：如果磁盘包含任何敏感数据并且您要覆盖它们，请选择 Overwrite existing data with zeros。否则 RHEL web 控制台只重写磁盘头。
10. 在 Encryption 下拉菜单中选择加密类型。如果您不想加密卷，请选择 No encryption。
11. 在 At boot 下拉菜单中选择您要何时挂载卷。

12. 在 Mount options 部分中：

    1. 如果要将卷挂载为只读逻辑卷，请选择 Mount read only 复选框。
    2. 如果要更改默认挂载选项，请选择 Custom mount options 复选框，并添加挂载选项。

13. 创建分区：

    • 如果要创建并挂载分区，请点 Create and mount 按钮。

    • 如果您只想创建分区，点 Create only 按钮。

      根据卷大小以及选择格式化选项，格式化可能需要几分钟。

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，点菜单按钮 [⋮] 并选择 Create LVM2 volume group。
4. 在 Create LVM2 volume group 字段中，为输入新卷组的名称。

5. 在 Disks 列表中选择一个 RAID 设备。

   如果您在列表中没有看到 RAID，从系统中卸载 RAID。RAID 设备必须没有被 RHEL 10 系统使用 。

6. 点 Create。

流程

1. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Manage local storage
     hosts: managed-node-01.example.com
     tasks:
       - name: Create a RAID on sdd, sde, sdf, and sdg
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.storage
         vars:
           storage_safe_mode: false
           storage_volumes:
             - name: data
               type: raid
               disks: [sdd, sde, sdf, sdg]
               raid_level: raid0
               raid_chunk_size: 32 KiB
               mount_point: /mnt/data
               state: present

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/rhel-system-roles.storage/README.md 文件。

2. 验证 playbook 语法：

   $ ansible-playbook --syntax-check ~/playbook.yml

   请注意，这个命令只验证语法，不能防止错误的、但有效的配置。

3. 运行 playbook：

   $ ansible-playbook ~/playbook.yml

流程

1. 扩展 RAID 分区。如需更多信息，请参阅使用 parted 重新定义分区。

2. 将 RAID 扩展到最大分区容量：

   # mdadm --grow --size=max /dev/md0

   要设置特定大小，设置 --size 参数的值（单位为 kB），如 --size=524228。

3. 增加文件系统的大小。例如，如果卷使用 XFS 并挂载到 /mnt/，请输入：

   # xfs_growfs /mnt/

流程

1. 缩小文件系统。如需更多信息，请参阅管理文件系统。

2. 减少 RAID 的大小，例如 512 MB ：

   # mdadm --grow --size=524228 /dev/md0

   写 --size 参数（单位为 kB）。

3. 将分区缩小到您需要的大小。

流程

1. 将 PowerPC Reference Platform (PReP) 引导分区从 /dev/sda1 复制到 /dev/sdb1 ：

   # dd if=/dev/sda1 of=/dev/sdb1

2. 在两个磁盘的第一个分区中更新 prep 和 boot 标志：

   $ parted /dev/sda set 1 prep on
   $ parted /dev/sda set 1 boot on
   
   $ parted /dev/sdb set 1 prep on
   $ parted /dev/sdb set 1 boot on

流程

1. 插入安装磁盘。
2. 在初始启动过程中，选择 Rescue Mode 而不是 Install 或 Upgrade。当系统完全引导至 Rescue mode 时，您可以看到命令行终端。

3. 在这个终端中执行以下命令：

   1. 使用 parted 命令在目标硬盘上创建 RAID 分区。
   2. 使用这些分区中的 mdadm 命令，使用任何以及所有可用的设置和选项来手动创建 raid 阵列。
4. 可选：创建阵列后，在阵列上创建文件系统。
5. 重新启动计算机，再选择要安装的 Install 或 Upgrade。当 Anaconda 安装程序搜索系统中的磁盘时，它会找到预先存在的 RAID 设备。
6. 当问到如何使用系统中的磁盘时，请选择 Custom Layout ，并点 Next。在设备列表中，会列出预先存在的 MD RAID 设备。
7. 选择一个 RAID 设备并点 Edit。
8. 如果之前没有创建挂载点，则配置其挂载点以及应使用的文件系统类型，然后点 Done。Anaconda 安装至此已存在的 RAID 设备，保留在 Rescue Mode 中创建时选择的自定义选项。

流程

1. 通过扫描 RAID 详情来创建 /etc/mdadm.conf 配置文件来监控阵列：

   # mdadm --detail --scan >> /etc/mdadm.conf

   请注意，ARRAY 和 MAILADDR 是强制的变量。

2. 使用您选择的文本编辑器打开 /etc/mdadm.conf 配置文件，并使用通知的电子邮件地址添加 MAILADDR 变量。例如，添加新行：

   MAILADDR example@example.com

   在这里，example@example.com 是从阵列监控接收警报的电子邮件地址。

3. 保存 /etc/mdadm.conf 文件中的更改并关闭它。

流程

1. 检查失败的磁盘：

   1. 查看内核日志：

      # journalctl -k -f

   2. 搜索类似如下的消息：

      md/raid:md0: Disk failure on sdd, disabling device.
      
      md/raid:md0: Operation continuing on 3 devices.

   3. 按 Ctrl+C 键退出 journalctl 程序。

2. 将失败的磁盘标记为故障：

   # mdadm --manage /dev/md0 --fail /dev/sdd

3. 可选：检查失败的磁盘是否已正确标记：

   # mdadm --detail /dev/md0

   输出末尾是 /dev/md0 RAID 中的磁盘列表，其中磁盘 /dev/sdd 具有 faulty 状态 ：

   Number   Major   Minor   RaidDevice State
      0       8       16        0      active sync   /dev/sdb
      1       8       32        1      active sync   /dev/sdc
      -       0        0        2      removed
      3       8       64        3      active sync   /dev/sde
   
      2       8       48        -      faulty   /dev/sdd

4. 从 RAID 中删除失败的磁盘：

   # mdadm --manage /dev/md0 --remove /dev/sdd

   警告

   如果您的 RAID 无法与另一个磁盘失败，在新磁盘有 active sync 状态前不会删除任何磁盘。您可以使用 watch cat /proc/mdstat 命令监控进度。

5. 在 RAID 中添加新磁盘：

   # mdadm --manage /dev/md0 --add /dev/sdf

   /dev/md0 RAID 现在包括新磁盘 /dev/sdf，mdadm 服务将自动从其他磁盘将数据复制到其中。

流程

1. 检查阵列失败的磁盘行为：

   # echo check > /sys/block/md0/md/sync_action

   这会检查数组和 /sys/block/md0/md/sync_action 文件显示 sync 操作。

2. 使用您选择的文本编辑器打开 /sys/block/md0/md/sync_action 文件，并查看是否有任何有关磁盘同步失败的消息。
3. 查看 /sys/block/md0/md/mismatch_cnt 文件。如果 mismatch_cnt 参数不是 0，这意味着 RAID 磁盘需要修复。

4. 修复阵列中的磁盘：

   # echo repair > /sys/block/md0/md/sync_action

   这会修复阵列中的磁盘，并将结果写入 /sys/block/md0/md/sync_action 文件。

5. 查看同步进度：

   # cat /sys/block/md0/md/sync_action
   repair
   
   # cat /proc/mdstat
   Personalities : [raid0] [raid6] [raid5] [raid4] [raid1]
   md0 : active raid1 sdg[1] dm-3[0]
         511040 blocks super 1.2 [2/2] [UU]
   unused devices: <none>

流程

1. 卸载您要加密的设备上的所有文件系统，例如：

   # umount /dev/mapper/vg00-lv00

2. 为存储 LUKS 标头腾出空间。使用以下适合您场景的选项之一：

   • 如果是加密逻辑卷，您可以扩展逻辑卷而无需调整文件系统的大小。例如：

     # lvextend -L+32M /dev/mapper/vg00-lv00

   • 使用分区管理工具（如 parted ）扩展分区。
   • 缩小该设备的文件系统。您可以对 ext2、ext3 或 ext4 文件系统使用 resize2fs 工具。请注意，您无法缩小 XFS 文件系统。

3. 初始化加密：

   # cryptsetup reencrypt --encrypt --init-only --reduce-device-size 32M /dev/mapper/vg00-lv00 lv00_encrypted
   
   /dev/mapper/lv00_encrypted is now active and ready for online encryption.

4. 挂载该设备：

   # mount /dev/mapper/lv00_encrypted /mnt/lv00_encrypted

5. 向 /etc/crypttab 文件添加持久映射的一个条目：

   1. 查找 luksUUID ：

      # cryptsetup luksUUID /dev/mapper/vg00-lv00
      
      a52e2cc9-a5be-47b8-a95d-6bdf4f2d9325

   2. 在您选择的文本编辑器中打开 /etc/crypttab，并在此文件中添加设备：

      $ vi /etc/crypttab
      
      lv00_encrypted UUID=a52e2cc9-a5be-47b8-a95d-6bdf4f2d9325 none

      将 a52e2cc9-a5be-47b8-a95d-6bdf4f2d9325 替换为您设备的 luksUUID。

   3. 使用 dracut 刷新 initramfs：

      $ dracut -f --regenerate-all

6. 如果 /etc/fstab 文件中存在这个设备的条目，请确定它使用文件系统 UUID，而不是设备名称。

7. 恢复在线加密：

   # cryptsetup reencrypt --resume-only /dev/mapper/vg00-lv00
   
   Enter passphrase for /dev/mapper/vg00-lv00:
   Auto-detected active dm device 'lv00_encrypted' for data device /dev/mapper/vg00-lv00.
   Finished, time 00:31.130, 10272 MiB written, speed 330.0 MiB/s

验证

1. 验证现有数据是否已加密：

   # cryptsetup luksDump /dev/mapper/vg00-lv00
   
   LUKS header information
   Version: 2
   Epoch: 4
   Metadata area: 16384 [bytes]
   Keyslots area: 16744448 [bytes]
   UUID: a52e2cc9-a5be-47b8-a95d-6bdf4f2d9325
   Label: (no label)
   Subsystem: (no subsystem)
   Flags: (no flags)
   
   Data segments:
     0: crypt
   	offset: 33554432 [bytes]
   	length: (whole device)
   	cipher: aes-xts-plain64
   [...]

2. 查看加密的空白块设备的状态：

   # cryptsetup status lv00_encrypted
   
   /dev/mapper/lv00_encrypted is active and is in use.
     type:    LUKS2
     cipher:  aes-xts-plain64
     keysize: 512 bits
     key location: keyring
     device:  /dev/mapper/vg00-lv00

流程

1. 卸载设备上的所有文件系统，例如：

   # umount /dev/<nvme0n1p1>

   将 <nvme0n1p1> 替换为与您要卸载的分区对应的设备标识符。

2. 初始化加密：

   # cryptsetup reencrypt --encrypt --init-only --header </home/header> /dev/<nvme0n1p1> <nvme_encrypted>
   
   WARNING!
   ========
   Header file does not exist, do you want to create it?
   
   Are you sure? (Type 'yes' in capital letters): YES
   Enter passphrase for </home/header>:
   Verify passphrase:
   /dev/mapper/<nvme_encrypted> is now active and ready for online encryption.

   替换：

   • </home/header> 替换为带有分离的 LUKS 头的文件的路径。分离的 LUKS 标头必须可以访问，以便稍后解锁加密设备。
   • <nvme_encrypted> 替换为加密后创建的设备映射器的名称。

3. 挂载该设备：

   # mount /dev/mapper/<nvme_encrypted> /mnt/<nvme_encrypted>

4. 向 /etc/crypttab 文件添加持久映射的一个条目：

   # <nvme_encrypted> /dev/disk/by-id/<nvme-partition-id> none header=</home/header>

   将 <nvme-partition-id> 替换为 NVMe 分区的标识符。

5. 使用 dracut 重新生成 initramfs：

   # dracut -f --regenerate-all -v

6. 向 /etc/fstab 文件中添加一个永久挂载条目：

   1. 查找活跃 LUKS 块设备的文件系统 UUID：

      $ blkid -p /dev/mapper/<nvme_encrypted>
      
      /dev/mapper/<nvme_encrypted>: UUID="37bc2492-d8fa-4969-9d9b-bb64d3685aa9" BLOCK_SIZE="4096" TYPE="xfs" USAGE="filesystem"

   2. 在文本编辑器中打开 /etc/fstab，并在此文件中添加一个设备，例如：

      $ vi /etc/fstab
      
      UUID=<file_system_UUID> /home auto rw,user,auto 0

      将 <file_system_UUID> 替换为您的文件系统的 UUID。

7. 恢复在线加密：

   # cryptsetup reencrypt --resume-only --header </home/header> /dev/<nvme0n1p1>
   
   Enter passphrase for /dev/<nvme0n1p1>:
   Auto-detected active dm device '<nvme_encrypted>' for data device /dev/<nvme0n1p1>.
   Finished, time 00m51s,   10 GiB written, speed 198.2 MiB/s

验证

1. 验证使用带有分离标头的 LUKS2 块设备上的现有数据是否已加密：

   # cryptsetup luksDump </home/header>
   
   LUKS header information
   Version:       	2
   Epoch:         	88
   Metadata area: 	16384 [bytes]
   Keyslots area: 	16744448 [bytes]
   UUID:          	c4f5d274-f4c0-41e3-ac36-22a917ab0386
   Label:         	(no label)
   Subsystem:     	(no subsystem)
   Flags:       	(no flags)
   
   Data segments:
     0: crypt
   	offset: 0 [bytes]
   	length: (whole device)
   	cipher: aes-xts-plain64
   	sector: 512 [bytes]
   [...]

2. 查看加密的空白块设备的状态：

   # cryptsetup status <nvme_encrypted> --header </home/header>
   
   /dev/mapper/<nvme_encrypted> is active and is in use.
     type: LUKS2
     cipher: aes-xts-plain64
     keysize: 512 bits
     key location: keyring
     device: /dev/<nvme0n1p1>
     sector size: 512
     offset: 0 sectors
     size: 10485760 sectors
     mode: read/write

流程

1. 将分区设置为加密的 LUKS 分区：

   # cryptsetup luksFormat /dev/nvme0n1p1
   
   WARNING!
   ========
   This will overwrite data on /dev/nvme0n1p1 irrevocably.
   Are you sure? (Type 'yes' in capital letters): YES
   Enter passphrase for /dev/nvme0n1p1:
   Verify passphrase:

2. 打开加密的 LUKS 分区：

   # cryptsetup open /dev/nvme0n1p1 nvme0n1p1_encrypted
   
   Enter passphrase for /dev/nvme0n1p1:

   这会解锁分区，并使用设备映射器将其映射到新设备。要不覆盖加密的数据，这个命令会警告内核，该设备是一个加密设备，并使用 /dev/mapper/device_mapped_name 路径通过 LUKS 解决了。

3. 创建一个文件系统来将加密的数据写入分区，该分区必须可通过设备映射名称访问：

   # mkfs -t ext4 /dev/mapper/nvme0n1p1_encrypted

4. 挂载该设备：

   # mount /dev/mapper/nvme0n1p1_encrypted mount-point

验证

1. 验证空白块设备是否已加密：

   # cryptsetup luksDump /dev/nvme0n1p1
   
   LUKS header information
   Version:       	2
   Epoch:         	3
   Metadata area: 	16384 [bytes]
   Keyslots area: 	16744448 [bytes]
   UUID:          	34ce4870-ffdf-467c-9a9e-345a53ed8a25
   Label:         	(no label)
   Subsystem:     	(no subsystem)
   Flags:       	(no flags)
   
   Data segments:
     0: crypt
   	offset: 16777216 [bytes]
   	length: (whole device)
   	cipher: aes-xts-plain64
   	sector: 512 [bytes]
   [...]

2. 查看加密的空白块设备的状态：

   # cryptsetup status nvme0n1p1_encrypted
   
   /dev/mapper/nvme0n1p1_encrypted is active and is in use.
     type:    LUKS2
     cipher:  aes-xts-plain64
     keysize: 512 bits
     key location: keyring
     device:  /dev/nvme0n1p1
     sector size:  512
     offset:  32768 sectors
     size:    20938752 sectors
     mode:    read/write

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，点您要加密的存储设备的菜单按钮 ⋮，然后单击 Format。
4. 在 Encryption field 中，选择加密规格 LUKS1 或 LUKS2。
5. 设置并确认您的新密码短语。
6. 可选：修改进一步的加密选项。
7. 完成格式化设置。
8. 点 Format。

流程

1. 更改 LUKS 加密设备上现有的密码短语：

   # cryptsetup luksChangeKey /dev/<device_ID>

   将 <device_ID> 替换为设备标识符，例如 sda。

   如果您配置了多个密钥插槽，您可以指定要使用的插槽：

   # cryptsetup luksChangeKey /dev/<device_ID> --key-slot <slot_number>

   将 <slot_number> 替换为您要修改的密钥插槽的编号。

2. 插入当前的密码短语和新密码短语：

   Enter passphrase to be changed:
   Enter new passphrase:
   Verify passphrase:

3. 验证新密码短语：

   # cryptsetup --verbose open --test-passphrase /dev/<device_ID>

验证

1. 验证新密码短语是否可以解锁设备：

   Enter passphrase for /dev/<device_ID>:
   Key slot <slot_number> unlocked.
   Command successful.

流程

1. 登录到 RHEL 10 web 控制台。
2. 在面板中，单击 Storage。
3. 在 Storage 表中，选择带有加密数据的磁盘。
4. 在磁盘页面中，滚动到 Keys 部分，然后点 edit 按钮。

5. 在更改密码短语对话框中：

   1. 输入您当前的密码短语。
   2. 输入您的新密码短语。
   3. 确认您的新密码短语。
6. 点击 Save。

流程

1. 将敏感变量存储在加密的文件中：

   1. 创建 vault ：

      $ ansible-vault create ~/vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>

   2. 在 ansible-vault create 命令打开编辑器后，以 <key>: <value> 格式输入敏感数据：

      luks_password: <password>

   3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

2. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Manage local storage
     hosts: managed-node-01.example.com
     vars_files:
       - ~/vault.yml
     tasks:
       - name: Create and configure a volume encrypted with LUKS
         ansible.builtin.include_role:
           name: redhat.rhel_system_roles.storage
         vars:
           storage_volumes:
             - name: barefs
               type: disk
               disks:
                 - sdb
               fs_type: xfs
               fs_label: <label>
               mount_point: /mnt/data
               encryption: true
               encryption_password: "{{ luks_password }}"
               encryption_cipher: <cipher>
               encryption_key_size: <key_size>
               encryption_luks_version: luks2

   示例 playbook 中指定的设置包括如下：

   encryption_cipher: <cipher>

   指定 LUKS 密码。可能的值有：twofish-xts-plain64,serpent-xts-plain64 和 aes-xts-plain64 （默认）。

   encryption_key_size: <key_size>

   指定 LUKS 密钥大小。默认值为 512 位。

   encryption_luks_version: luks2

   指定 LUKS 版本。默认为 luks2。

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/rhel-system-roles.storage/README.md 文件。

3. 验证 playbook 语法：

   $ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml

   请注意，这个命令只验证语法，不能防止错误的、但有效的配置。

4. 运行 playbook：

   $ ansible-playbook --ask-vault-pass ~/playbook.yml