esxcli 명령을 사용하여 시스템의 클레임 규칙 집합에 다중 경로 지정 PSA 클레임 규칙을 추가합니다. 새 클레임 규칙을 활성화하려면 규칙을 먼저 정의한 후 시스템에 로드해야 합니다.

PSA 클레임 규칙을 추가하는 경우의 예는 다음과 같습니다.
  • 타사 MPP를 로드하고 이 모듈이 할당하는 경로를 지정해야 합니다.
  • 네이티브 HPP를 사용하도록 설정해야 합니다.
경고: 서로 다른 플러그인 두 개가 동일한 디바이스에 대한 경로를 할당하는 규칙은 생성할 수 없습니다. 이러한 클레임 규칙을 생성하려고 하면 vmkernel.log에 경고가 표시되고 작업이 실패합니다.

사전 요구 사항

vCLI를 설치하거나 vMA(vSphere Management Assistant) 가상 시스템을 배포합니다. "vSphere Command-Line Interface 시작" 을 참조하십시오. 문제를 해결하려면 ESXi Shell에서 esxcli 명령을 실행합니다.

프로시저

  1. 다음 명령을 사용하여 새 클레임 규칙을 정의합니다.
    esxcli storage core claimrule add

    이 명령에는 다음 옵션이 해당됩니다.

    옵션 설명
    -A|--adapter=<adapter> 사용할 경로의 어댑터입니다. --type이 location인 경우에만 유효합니다.
    -u|--autoassign 해당 특성을 기준으로 클레임 규칙을 추가합니다. 규칙 번호는 필요하지 않습니다.
    -C|--channel=<channel> 사용할 경로의 채널입니다. --type이 location인 경우에만 유효합니다.
    -c|--claimrule-class=<cl> 이 작업에 사용할 클레임 규칙 클래스입니다. MP(기본값), Filter 또는 VAAI를 지정할 수 있습니다.

    새 어레이에 대해 하드웨어 가속을 구성하려면 VAAI 필터와 VAAI 플러그인에 하나씩 두 개의 클레임 규칙을 추가합니다. 자세한 지침은 하드웨어 가속 클레임 규칙 추가 항목을 참조하십시오.

    -d|--device=<device_uid> 디바이스의 UID입니다. --type이 device인 경우에만 유효합니다.
    -D|--driver=<driver> 사용할 경로의 HBA에 대한 드라이버입니다. --type이 driver인 경우에만 유효합니다.
    -f|--force 유효성 검사를 무시하고 클레임 규칙을 강제로 설치합니다.
    --force-reserved 예약된 규칙 ID 범위의 보호를 재정의합니다.

    예약된 클레임 규칙은 ID가 100 미만인 규칙입니다. 이러한 규칙을 사용하여 로컬 디바이스를 특정 플러그인에 다시 할당할 수 있습니다. 예를 들어 NVMe 디바이스를 HPP에 다시 할당할 수 있습니다.

    --if-unset=<str> 이 고급 사용자 변수가 1로 설정되지 않은 경우 이 명령을 실행합니다.
    -i|--iqn=<iscsi_name> 대상의 iSCSI 정규화된 이름입니다. --type이 target인 경우에만 유효합니다.
    -L|--lun=<lun_id> 경로의 LUN입니다. --type이 location인 경우에만 유효합니다.

    LUN ID는 고급 구성 옵션 /Disk/MaxLUN의 값보다 작아야 합니다.

    -M|--model=<model> 사용할 경로의 모델입니다. --type이 vendor인 경우에만 유효합니다.

    유효한 값은 SCSI 조회 문자열의 모델 문자열 값입니다. 모델 문자열 값을 보려면 각 디바이스에서 vicfg-scsidevs <conn_options> -l 명령을 실행합니다.

    -P|--plugin=<plugin> 사용할 PSA 플러그인입니다. 값은 NMP, MASK_PATH 또는 HPP입니다. 타사가 자체 PSA 플러그인을 제공할 수도 있습니다. 필수.
    -r|--rule=<rule_ID> 사용할 규칙 ID입니다. 규칙 ID는 클레임 규칙이 평가되는 순서를 나타냅니다. 사용자 정의 클레임 규칙은 101부터 시작하는 숫자순으로 평가됩니다.

    esxcli storage core claimrule list 명령을 실행하여 사용 가능한 규칙 ID를 확인할 수 있습니다.
    -T|--target=<target> 사용할 경로의 대상입니다. --type이 location인 경우에만 유효합니다.
    -R|--transport=<transport>

    사용할 경로의 전송입니다. --type이 transport인 경우에만 유효합니다. 다음 값이 지원됩니다.

    • block - 블록 스토리지
    • fc - Fibre Channel
    • iscsivendor - iSCSI
    • iscsi - 현재 사용되지 않음
    • ide - IDE 스토리지
    • sas - SAS 스토리지
    • sata - SATA 스토리지
    • usb - USB 스토리지
    • parallel - 병렬
    • fcoe - FCoE
    • unknown
    -t|--type=<type> 작업에 사용할 일치 유형입니다. 유효한 값은 다음과 같습니다. 필수.
    • vendor
    • location
    • driver
    • transport
    • device
    • target
    -V|--vendor=<vendor> 사용할 경로의 벤더입니다. --type이 vendor인 경우에만 유효합니다.

    유효한 값은 SCSI 조회 문자열의 벤더 문자열 값입니다. 벤더 문자열 값을 보려면 각 디바이스에서 vicfg-scsidevs <conn_options> -l 명령을 실행합니다.

    --wwnn=<wwnn> 대상의 WWNN(World-Wide Node Number)입니다.
    --wwpn=<wwpn> 대상의 WWPN(World-Wide Port Number)입니다.
    -a|--xcopy-use-array-values 어레이 보고 값을 사용하여 스토리지 어레이로 전송할 XCOPY 명령을 생성합니다. VAAI 클레임 규칙에만 적용됩니다.
    -s|--xcopy-use-multi-segs XCOPY 요청을 실행할 때 다중 세그먼트를 사용합니다. --xcopy-use-array-values가 지정된 경우에만 유효합니다.
    -m|--xcopy-max-transfer-size 어레이가 보고한 것과 다른 전송 크기를 사용하는 경우 최대 데이터 전송 크기(MB)입니다. --xcopy-use-array-values가 지정된 경우에만 유효합니다.
    -k|--xcopy-max-transfer-size-kib 어레이가 보고한 것과 다른 전송 크기를 사용하는 경우 XCOPY 명령의 최대 전송 크기(KiB)입니다. --xcopy-use-array-values가 지정된 경우에만 유효합니다.
  2. 다음 명령을 사용하여 새 클레임 규칙을 시스템에 로드합니다.
    esxcli storage core claimrule load
    이 명령은 새로 생성된 모든 다중 경로 지정 클레임 규칙을 esx.conf 구성 파일에서 VMkernel로 로드합니다. 이 명령에는 옵션이 없습니다.
  3. 로드된 클레임 규칙을 적용하려면 다음 명령을 사용합니다.
    esxcli storage core claimrule run

    이 명령에는 다음 옵션이 해당됩니다.

    옵션 설명
    -A|--adapter=<adapter> --type이 location인 경우 클레임 규칙을 실행할 경로의 HBA 이름입니다. 모든 어댑터의 경로에서 클레임 규칙을 실행하려면 이 옵션을 생략합니다.
    -C|--channel=<channel> --type이 location인 경우 클레임 규칙을 실행할 경로의 SCSI 채널 번호 값입니다. 모든 채널 번호의 경로에서 클레임 규칙을 실행하려면 이 옵션을 생략합니다.
    -c|--claimrule-class=<cl> 이 작업에 사용할 클레임 규칙 클래스입니다.
    -d|--device=<device_uid> 디바이스의 UID입니다.
    -L|--lun=<lun_id> --type이 location인 경우 클레임 규칙을 실행할 경로의 SCSI LUN 값입니다. 모든 LUN의 경로에서 클레임 규칙을 실행하려면 이 옵션을 생략합니다.
    -p|--path=<path_uid> --type이 path인 경우 이 옵션은 클레임 규칙을 실행할 경로의 UID(고유 식별자) 또는 런타임 이름을 나타냅니다.
    -T|--target=<target> --type이 location인 경우 클레임 규칙을 실행할 경로의 SCSI 대상 번호 값입니다. 모든 대상 번호의 경로에서 클레임 규칙을 실행하려면 이 옵션을 생략합니다.
    -t|--type=<location|path|all> 수행할 클레임의 유형입니다. 기본적으로 all을 사용합니다. 즉, 클레임 규칙이 특정 경로 또는 SCSI 주소에 대한 제한 없이 실행됩니다. 유효한 값은 location, path 및 all입니다.
    -w|--wait 이 옵션을 사용하려면 --type all을 함께 사용해야만 합니다.

    이 옵션을 포함하면 클레임이 경로가 설정될 때까지 대기한 후 클레임 작업을 실행합니다. 이 경우 할당 프로세스를 시작하기 전에 시스템의 모든 경로가 표시되어야 할당 프로세스가 시작됩니다.

    할당 프로세스가 시작되면 디바이스 등록이 완료되기 전까지 명령이 반환하지 않습니다.

    할당 또는 검색 프로세스 중에 경로를 추가하거나 제거하면 이 옵션이 올바르게 작동하지 않을 수 있습니다.

예: 다중 경로 클레임 규칙 정의

다음 예제에서는 규칙 번호 500을 추가하고 로드합니다. 이 규칙은 NMP 플러그인에 대해 모델 문자열이 NewMod이고 벤더 문자열이 NewVend인 모든 경로를 할당합니다.

# esxcli storage core claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP

# esxcli storage core claimrule load

esxcli storage core claimrule list 명령을 실행하면 새 클레임 규칙이 목록에 나타납니다.

다음 출력은 클레임 규칙 500이 시스템에 로드되어 활성 상태임을 나타냅니다. 
Rule Class  Rule   Class    Type       Plugin     Matches
...         ...    ...      ...        ...        ...
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod  
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod