バージョン: 3.1

外部ストレージの管理

このガイドでは、CubeCOS システム内で外部ストレージを設定および管理する方法について説明します。

主要用語

始める前に、このガイドで使用されている以下の専門用語について、あらかじめご確認ください：

モデル：特定の外部ストレージタイプに必要な設定やパラメータの仕様を定義するストレージテンプレート。
ベンダードライバー：CubeCOSがDell EMCや富士通などのベンダーが提供する特定のハードウェアと通信できるようにするソフトウェアブリッジ。
マルチパス：サーバーが複数の物理パスを通じてストレージにアクセスし、安定した接続を確保するためのフォールトトレランス機構。

ストレージモデルの管理

モデルは、ストレージ環境の構築における主要な設定ガイドとして機能します。

新しいモデルのインポート方法

ホーム > 連携 > ストレージ > モデル一覧 に移動します。

ドライバーを定義するには、YAMLファイルを作成し、「新しいモデルをインポート」をクリックして、そのYAMLファイルをアップロードしてください。

フォーマットが検証されると、成功を通知するポップアップが表示され、新しいモデルがモデル一覧に表示されます。

情報

5つの組み込みテンプレートは永続的なものであり、これらを削除しても、カスタマイズされた上書き設定がリセットされるだけです。

YAMLの設定とパラメータ定義

以下は、パラメータの説明がインラインコメントとして記載されたDell EMC SC FCテンプレートの例です：

# The specific Cinder driver class for the hardware vendor
driver: 'cinder.volume.drivers.dell_emc.sc.storagecenter_fc.SCFCDriver'
vendor: 'Test'
type: 'SC Series FC'

# Multipath Configuration: Defines how the system handles redundant paths
multipath:
  - section: 'devices'
    attributes: []
    subSections:
      storage:
        section: 'device'
        attributes:
          service:
            - key: 'vendor'
              value: 'COMPELNT' # Internal identifier for the storage hardware
            - key: 'product'
              value: 'Compellent Vol' # Specifies the volume product type
            - key: 'user_friendly_names'
              value: 'no' # Prevents renaming of paths for system consistency

# Driver-specific settings for network and performance
driverSection:
  - key: 'san_ip' # The Management IP address of the SAN hardware
    value: ''
  - key: 'san_login' # Administrative username for storage access
    value: ''
  - key: 'use_multipath_for_image_xfer'
    value: 'true' # Enables path redundancy specifically for moving VM images
  - key: 'image_upload_use_cinder_backend'
    value: 'true' # Directs image uploads through the Cinder driver for efficiency

トラブルシューティング

外部ストレージの接続や管理中にエラーが発生した場合は、以下の診断手順に従って根本原因を特定してください。

通知

これはシステムのアラートダッシュボードとして機能します。 CubeCOSの操作はクラスタ単位で行われるため、あるノードでは設定が正常に適用されても、別のノードでは失敗することがあります。通知センターでは、どのノードが同期が取れていないか、あるいは更新プロセス中に障害が発生したかを正確に特定します。これらの通知を確認するには、以下の方法をご参照ください：

ホーム > 通知に移動してください。（右上隅にベルのアイコンがあります）

ログ

通知は障害の発生を報告しますが、ログはその原因を説明しています。これは、CubeCOS APIとストレージハードウェア間の通信を確認する上で、最も詳細な方法です。ログを確認するには、以下の手順に従ってください：

障害が発生したノードにログインしてください。
```
ssh <user_name>@<your-node-ip>
```

コマンド変数：

<user_name>: これは障害が発生したノードのユーザー名です。

<your_node-ip>: これは障害が発生したノードのIPアドレスです。

次のコマンドを実行してログを確認してください：
```
$ journalctl -f -u cube-cos-api
```
ログから以下のキーワードを検索してください：
- hex_config: 内部設定エンジンに関する問題を指摘しています。
- cinder: OpenStackのブロックストレージサービスが、ボリュームのマウントまたは認識に問題を抱えていることを示します。
- storage / model: テンプレート内のパラメータ（SAN IP や認証情報など）が正しくないか、ベンダーのドライバによって拒否されたことを示しています。

推奨解像度

統合処理が失敗した場合、最も効果的な復旧方法は、該当するUI操作を再度実行することです。 UIがクラスタ単位の操作をトリガーするため、すべてのノードが同時に設定の再試行を余儀なくされます。これにより、すべてのノードが一貫した設定状態を維持し、同期された正常な状態に戻ることが保証されます。

主要用語​

ストレージモデルの管理​

新しいモデルのインポート方法​

YAMLの設定とパラメータ定義​

トラブルシューティング​

通知​

ログ​

推奨解像度​