ECS. Выполнение базовых операций API CAS в ECS с помощью JCASScript.jar

Summary: В этой статье объясняется, как выполнять основные операции API CAS в ECS с помощью JCASScript.jar.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Примечание. Все операции, которые можно выполнить, см. во вложенном PDF-файле JCASScript.

Предпосылка.
  • ECS CAS позволяет клиентским приложениям на базе CAS SDK хранить, извлекать и удалять фиксированные объекты содержимого из хранилища ECS.
  • Перед настройкой ECS необходимо выделить базовое хранилище ECS. Предоставление ресурсов считается завершенным, когда установлена новая стойка ECS.
  • Это включает настройку пула хранения данных, виртуального ЦОД и группы репликации. В ECS CAS можно использовать стандартную документацию, если необходимо создать или изменить эти объекты для поддержки CAS.
Создайте файл PEA.
  1. Найдите владельца контейнера CAS, в данном примере это cas_user.

Найдите владельца контейнера CAS, в данном примере это <код<>b>cas_user</b></code>

  1. Перейдите на вкладку Users сбоку и отредактируйте этого пользователя.

Перейдите на вкладку пользователей сбоку и измените этого пользователя

  1. Сгенерируйте файл PEA и щелкните в поле, которое он создает, а затем нажмите CTRL+A,CTRL+C , чтобы скопировать его целиком.

Сгенерируйте файл PEA и щелкните в поле, которое он генерирует, затем нажмите CTRL+A, CTRL+C, чтобы скопировать его целиком 

Использование JCAS из узла ECS:

  1. Войдите в любой узел в качестве пользователя admin и войдите в Object-main container:
# sudo dockobj
  1. Измените на castools каталог:
# cd /opt/storageos/tools/castools
  1. Создайте файл PEA :
example-ecs-1:/opt/storageos/tools/castools # vi cas_user.pea
example-ecs-1:/opt/storageos/tools/castools # cat ./cas_user.pea
<pea version="1.0.0">
<defaultkey name="cas_user">
<credential id="csp1.secret" enc="base64">V2VsY29tZTEh</credential>
</defaultkey>
<key type="cluster" id="23a0767d-d6e7-3f41-bc1d-89d139549fe2" name="cas_user">
<credential id="csp1.secret" enc="base64">V2VsY29tZTEh</credential>
</key>
</pea>
example-ecs-1:/opt/storageos/tools/castools #
  1. Экспортировать castools к $LD_LIBRARY_PATH.
# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/storageos/tools/castools/
  1. Получение IP-адресов:
# sudo ss -nap | grep :3218 | grep LISTEN | grep -oP "(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
  1. Запуск JCASScript.jar интерактивный интерфейс командной строки:
# java -jar JCASScript.jar
  1. Подключение к пулу:
# poolOpen <ipaddress>?<path to pea file>

Пример результата:

CASScript>po 127.0.0.1?cas_user.pea

Attempting to connect to: 127.0.0.1?cas_user.pea

Connected to: 127.0.0.1?cas_user.pea

CASPool Properties:
         Connection String:                 127.0.0.1?cas_user.pea
         Cluster Time:                      2018.12.26 06:42:01 GMT
         Buffer Size:                       16384
         Prefetch Buffer Size:              32768
         Connection Timeout:                120000
         Multi-Cluster Failover Enabled:    True
         Collision Avoidance Enabled:       False
  1. Запишите файл (тестовый файл должен находиться в каталоге /opt/storageos/tools/castools/)
CASScript>filetoclip testfile
 
Creating new clip with blob containing the file:        testfile
New Clip ID: 29LSHRVIN10G1e0D7LFD3TACA15G41C71KTL0H0CDOTLK84CTBTK1
  1. Убедитесь, что клип можно прочитать.
CASScript>co 29LSHRVIN10G1e0D7LFD3TACA15G41C71KTL0H0CDOTLK84CTBTK1
 
Clip Properties:
        Name:                testfile
        Creation Date:       2018.02.23 03:36:18 GMT
        Size:                6
        Number of Tags:      1
        Number of Blobs:     1
        Retention Class:
        Retention Seconds:   0
        Modified:            False
        EBR Enabled :        False
        Retention Hold:      False

Допустимый идентификатор клипа CAS — это 27 или 53 символа со строчным регистром e в позиции 13-го символа.

Если идентификатор клипа недействителен или идентификатора клипа не существует, он может создать clip not found Выходные данные (FP_CLIP_NOT_FOUND_ERR) или parameter not valid Ошибка (FP_PARAM_ERR).

CASScript>co 6655272457874768783

SDK Error Occurred:

         Error Number: -10006
         System Error: 0
         Error:        FP_PARAM_ERR
         Error Class:  Client Error
         Trace:        FPObjectGuid::SetID(6655272457874768783)<FPClip_Open(-,6655272457874768783,1)
  1. Проверьте большие двоичные объекты для клипа:
CASScript>cbs 29LSHRVIN10G1e0D7LFD3TACA15G41C71KTL0H0CDOTLK84CTBTK1
  1. Перенаправление нескольких команд JCAS из файла в JCASScript - Создайте файл со списком команд, которые вы хотите выполнить по порядку. См. пример ниже:
example-ecs-1:/opt/storageos/tools/castools # head clips_to_read
po 127.0.0.1?cas_user.pea
co ESU38IQDS2QUHeA0SU0BMTMEO8AG41BTJACA7A0E8SKCGK6OG0G2B
co 03GCAN7MUUM61e03HC08DPGT9TJG41ABB1RMH50H0NJ3BQ8DE2KR7
co 02C4I1F0F27PQeAL4103IM3Q3CVG41AV9DGDRB0T49UBABCBD9SA6
co D276VGDGL864Ief1T9HJRUADVNRG41BEL3DU060S5LMGDCBG7OA60
co FUJREF9BKLUTE46OC4ATL511RVRG41C2LDG31L07BMJ4RR3B83INS
co 24K6TC8C6J1T0e45B41RKERADSRG41CEGICJAJ02275MEG3FKHIJM
co 08FFBQ1B007LUeB5ORFIB0T680MG41AJOSD1V10P4FS76P5QMO9CQ
co 04ND0FMFH5M8Te5B2ULT40KVLKGG41A9SSMSBO0L8BAFM4CRVE2B9
co AA5LVAEG03SEJe14L08V00L28AAG41CG5TK2HV0S1HG5J7T450E42
example-ecs-1:/opt/storageos/tools/castools #
  1. Экспортировать castools к LD_LIBRARY_PATH.
# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/storageos/tools/castools/
  1. Перенаправить файл в JCASScript.
# java -jar JCASScript.jar < clips_to_read >

Additional Information


https://uima.apache.org/d/uimaj-current/apidocs/org/apache/uima/jcas/JCas.htmlhttps://community.emc.com/docs/DOC-2456

Affected Products

ECS Appliance Hardware Gen1 U-Series

Products

ECS Appliance Hardware Gen1 U-Series, ECS Appliance Software with Encryption, ECS Appliance Software without Encryption
Article Properties
Article Number: 000020515
Article Type: How To
Last Modified: 27 Aug 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.