ECS：如何使用 JCASScript.jar 在 ECS 上執行基本的 CAS API 作業

Summary: 本文說明如何使用 JCASScript.jar 在 ECS 上執行基本的 CAS API 作業。

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.
Check out other resources

Instructions

注意：請參閱隨附的 PDF，瞭解您可以使用其中執行的所有操作 JCASScript。

背景：
  • ECS CAS 允許 CAS SDK 型用戶端應用程式從 ECS 儲存裝置中儲存、擷取和刪除固定內容物件。
  • 您必須先佈建基礎 ECS 儲存，才能設定 ECS 設定。當新的 ECS 機架安裝完成隨即完成隨需分配。
  • 這包括設定儲存集區、VDC 和複寫群組。在 ECS CAS 中，如果您必須建立或編輯這些物件以支援 CAS，則可以使用標準文件。
生成 PEA 檔。
  1. 尋找 CAS 儲存桶的擁有者，在此範例中為 cas_user：

尋找 CAS 儲存桶的擁有者，在此範例中為<代碼<>b>cas_user</b></code>

  1. 前往側邊 的使用者 標籤， 然後編輯 該使用者：

移至側邊的使用者標籤，然後編輯該使用者

  1. 生成一個 PEA 檔並按下它生成的框，然後按 CTRL+A、CTRL+C 複製整個檔。

生成一個 PEA 檔並按下它生成的框，然後 CTRL+A、CTRL+C 複製整個檔案 

從 ECS 節點使用 JCAS：

  1. 以系統管理員使用者身分登入任何節點，請輸入 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 互動式 CLI：
# 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 剪輯 ID 為 27 或 53 個字元，並採用小寫字母 e 在第 13 個字元的位置。

如果剪輯 ID 無效或剪輯 ID 不存在，則可能會生成 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. 確認剪輯的 Blob ：
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.