en to ja translation catalogue (116 entries)

note: type: Title ==
en: LINSTOR Volumes in Openstack
ja: OpenStackでのLINSTORボリューム

note: type: Plain text
en: indexterm:[Openstack]indexterm:[Cinder] This chapter describes using LINSTOR to provision persistent, replicated, and high-performance block storage for Openstack.
ja: indexterm:[Openstack]indexterm:[Cinder] この章では、LINSTOR を使用して、Openstack 用の永続的で複製された高性能のブロックストレージをプロビジョニングする方法について説明します。

note: type: Title ===
en: Openstack Overview
ja: Openstack の概要

note: type: Plain text
en: Openstack consists of a wide range of individual services; The service responsible for provisioning and managing block storage is called https://docs.openstack.org/cinder/latest/[Cinder]. Other openstack services such as the compute instance service https://docs.openstack.org/nova/latest[Nova] can request volumes from Cinder. Cinder will then make a volume accessible to the requesting service.
ja: Openstack は、さまざまな個別のサービスで構成されています。ブロックストレージのプロビジョニングと管理を担当するサービスは https://docs.openstack.org/cinder/latest/[Cinder] と呼ばれます。コンピューティングインスタンスサービス https://docs.openstack.org/nova/latest[Nova] などの他の openstack サービスは、Cinder にボリュームをリクエストできます。その後、Cinder は、要求元のサービスがボリュームにアクセスできるようにします。

note: type: Plain text
en: LINSTOR can integrate with Cinder using a *volume driver*. The volume driver translates calls to the Cinder API to LINSTOR commands. For example: requesting a volume from Cinder will create new resources in LINSTOR, Cinder Volume snapshots translate to snapshots in LINSTOR and so on.
ja: LINSTOR は、ボリュームドライバーを使用して Cinder と統合できます。ボリュームドライバーは、CinderAPI への呼び出しを LINSTOR コマンドに変換します。例えば Cinderにボリュームを要求すると、LINSTOR に新しいリソースが作成され、Cinder ボリュームのスナップショットは LINSTOR のスナップショットに変換されます。

note: type: Title ===
en: LINSTOR for Openstack Installation
ja: Openstack のLINSTOR インストレーション

note: type: Plain text
en: An initial installation and configuration of DRBD and LINSTOR must be completed prior to using the OpenStack driver.
ja: OpenStack ドライバーを使用する前に、DRBD と LINSTOR の初期インストールと構成を完了する必要があります。

note: type: Plain text
en: A detailed installation guide can be found <<s-installation,here>>.
ja: インストールガイドの詳細は <<s-installation,こちら>> を参照ください。また以下も参照ください。

note: type: Plain text
en: <<s-linstor-init-cluster,Initialize>> your cluster
ja: <<s-linstor-init-cluster,クラスタの初期化>>

note: type: Plain text
en: Learn how to use the <<s-using_the_linstor_client,LINSTOR client>>
ja: <<s-using_the_linstor_client,LINSTOR クライアントの使用法>>

note: type: Plain text
en: <<s-adding_nodes_to_your_cluster,Add all storage nodes>> to the LINSTOR cluster
ja: <<s-adding_nodes_to_your_cluster,すべてのストレージノードをLINSTORクラスターに追加>>

note: type: Plain text
en: At this point you should be able to list your storage cluster nodes using the LINSTOR client:
ja: この時点で、LINSTOR クライアントを使用してストレージクラスターノードを一覧表示できるはずです。

note: type: delimited block -
en: $ linstor node info
    ╭────────────────────────────────────────────────────────────────────────────╮
    ┊ Node                      ┊ NodeType  ┊ Addresses                 ┊ State  ┊
    ╞════════════════════════════════════════════════════════════════════════════╡
    ┊ cinder-01.openstack.test  ┊ COMBINED  ┊ 10.43.224.21:3366 (PLAIN) ┊ Online ┊
    ┊ cinder-02.openstack.test  ┊ COMBINED  ┊ 10.43.224.22:3366 (PLAIN) ┊ Online ┊
    ┊ storage-01.openstack.test ┊ SATELLITE ┊ 10.43.224.11:3366 (PLAIN) ┊ Online ┊
    ┊ storage-02.openstack.test ┊ SATELLITE ┊ 10.43.224.12:3366 (PLAIN) ┊ Online ┊
    ┊ storage-03.openstack.test ┊ SATELLITE ┊ 10.43.224.13:3366 (PLAIN) ┊ Online ┊
    ╰────────────────────────────────────────────────────────────────────────────╯
ja: ╭────────────────────────────────────────────────────────────────────────────╮
    ┊ Node                      ┊ NodeType  ┊ Addresses                 ┊ State  ┊
    ╞════════════════════════════════════════════════════════════════════════════╡
    ┊ cinder-01.openstack.test  ┊ COMBINED  ┊ 10.43.224.21:3366 (PLAIN) ┊ Online ┊
    ┊ cinder-02.openstack.test  ┊ COMBINED  ┊ 10.43.224.22:3366 (PLAIN) ┊ Online ┊
    ┊ storage-01.openstack.test ┊ SATELLITE ┊ 10.43.224.11:3366 (PLAIN) ┊ Online ┊
    ┊ storage-02.openstack.test ┊ SATELLITE ┊ 10.43.224.12:3366 (PLAIN) ┊ Online ┊
    ┊ storage-03.openstack.test ┊ SATELLITE ┊ 10.43.224.13:3366 (PLAIN) ┊ Online ┊
    ╰────────────────────────────────────────────────────────────────────────────╯

note: type: Plain text
en: You should <<s-storage_pools,configure one or more storage pools>> per node. This guide assumes the storage pool is named `cinderpool`. LINSTOR should list the storage pool for each node, including the diskless storage pool created by default.
ja: また、ノードごとに 1 つ以上の <<s-storage_pools,ストレージプール>> を構成する必要があります。このガイドでは、ストレージプールの名前が `cinderpool` であると仮定しています。LINSTOR は デフォルトで作成されたディスクレスストレージプールを含む、各ノードのストレージプールを一覧表示します。

note: type: Title ====
en: Upgrades of LINSTOR driver
ja: LINSTOR ドライバをアップグレード

note: type: Plain text
en: If this is a fresh installation, skip this section and continue with <<s-install_the_linstor_driver>>.
ja: 新規インストールの場合、このセクションをスキップして <<s-install_the_linstor_driver>> に進んでください。

note: type: Title =====
en: From 1.x to 2.x
ja: 1.x から 2.x へのアップグレード

note: type: Plain text
en: Driver version 2 dropped some static configuration options in favour of managing these options at runtime via <<s-openstack-volume-types,volume types>>.
ja: ドライバーバージョン 2 は、実行時に <<s-openstack-volume-types,ボリュームタイプ>> でこれらのオプションを管理するため、いくつかの静的構成オプションを削除しました。

note: type: Table
en: | Option in `cinder.conf` | Status | Replace with
    | `linstor_autoplace_count` | removed | Use the `linstor:redundancy` property on the volume type. Using a value of 0 for full cluster replication is not supported, use the advanced options of <<s-autoplace-linstor, the LINSTOR autoplacer>>
    | `linstor_controller_diskless` | removed | No replacement needed, the driver will create a diskless resource on the cinder host when required
    | `linstor_default_blocksize` | removed | This setting had no effect.
    | `linstor_default_storage_pool_name` | deprecated | This setting is deprecated for removal in a future version. Use the `linstor:storage_pool` property on the volume type instead.
    | `linstor_default_uri` | deprecated | Replaced by the more aptly named `linstor_uris`.
    | `linstor_default_volume_group_name` | removed | Creating nodes and storage pools was completely removed in Driver version 2. See <<s-openstack-linstor-install>>
    | `linstor_volume_downsize_factor` | removed | This setting served no purpose, it was removed without replacement.
ja: | Option in `cinder.conf` | Status | Replace with
    | `linstor_autoplace_count` | 削除 | ボリュームタイプで `linstor:redundancy` プロパティを使用します。フルクラスターレプリケーションで値 0 を使用することはサポートされていません。<<s-autoplace-linstor, the LINSTOR autoplacer>> オプションを使用してください
    | `linstor_controller_diskless` | 削除 | 置き換えは必要ありません。ドライバーは必要に応じて cinder ホスト上にディスクレスリソースを作成します
    | `linstor_default_blocksize` | 削除 | この設定は効果がありませんでした
    | `linstor_default_storage_pool_name` | 非推奨 | この設定は、将来のバージョンで削除するために非推奨になりました。代わりに、ボリュームタイプで `linstor:storage_pool` プロパティを使用してください
    | `linstor_default_uri` | 非推奨 | より適切な名前の `linstor_uris` に置き換えられました
    | `linstor_default_volume_group_name` | 削除 | ノードとストレージプールの作成は、ドライバーバージョン 2 で削除されました。<<s-openstack-linstor-install>> を参照してください
    | `linstor_volume_downsize_factor` | 削除 | この設定は目的を果たさず、置き換えなしで削除されました

note: type: Title ====
en: Install the LINSTOR driver
ja: LINSTOR ドライバをインストール

note: type: Plain text
en: Starting with OpenStack Stein, the LINSTOR driver is part of the Cinder project. While the driver can be used as is, it might be missing features or fixes available in newer version. Due to OpenStacks update policy for stable versions, most improvements to the driver will not get back-ported to older stable releases.
ja: OpenStack Stein 以降、LINSTOR ドライバーは Cinder プロジェクトの一部です。ドライバはそのまま使用できますが、新しいバージョンで利用できる機能や修正が不足している可能性があります。安定バージョンの OpenStacks 更新ポリシーにより、ドライバーに対するほとんどの改善は、古い安定リリースにバックポートされません。

note: type: Plain text
en: https://github.com/LINBIT/openstack-cinder[LINBIT maintains a fork] of the Cinder repository with all improvements to the LINSTOR driver backported to the supported stable versions. Currently, these are:
ja: LINBIT は Cinder リポジトリーの https://github.com/LINBIT/openstack-cinder[フォーク] をメンテナンスしています。ここには、サポートされている安定したバージョンにバックポートされた LINSTOR ドライバーのすべての改善が含まれています。現在、これらは次のとおりです。

note: type: Plain text
en: The exact steps to enable the Linstor Driver depend on your OpenStack distribution. In general, the `python-linstor` package needs to be installed on all hosts running the Cinder volume service. The next section will cover the installation process for common OpenStack distributions.
ja: Linstor Driver を有効にする正しい手順は、OpenStack ディストリビューションによって異なります。一般に `python-linstor` パッケージは、Cinder ボリュームサービスを実行しているすべてのホストにインストールする必要があります。次のセクションでは、一般的な OpenStack ディストリビューションへのインストール手順について説明します。

note: type: Plain text
en: https://docs.openstack.org/devstack/latest/[DevStack] is a great way to try out OpenStack in a lab environment.  To use the most recent driver use the following DevStack configuration:
ja: https://docs.openstack.org/devstack/latest/[DevStack] は、ラボ環境で OpenStack を試すのに最適な方法です。最新のドライバーを使用するには、次の DevStack 構成を使用します。

note: type: Plain text
en: https://docs.openstack.org/kolla/latest/[Kolla] packages OpenStack components in containers. They can then be deployed, for example using https://docs.openstack.org/kolla-ansible/latest/[Kolla Ansible] You can take advantage of the available customisation options for kolla containers to set up the Linstor driver.
ja: https://docs.openstack.org/kolla/latest/[Kolla] は OpenStack コンポーネントをコンテナーにパッケージ化します。次に、例えば https://docs.openstack.org/kolla-ansible/latest/[Kolla Ansible] を使用してデプロイできます。kolla コンテナーで使用可能なカスタマイズオプションを利用して、Linstor ドライバーをセットアップできます。

note: type: Plain text
en: To ensure that the required `python-linstor` package is installed, use the following override file:
ja: 必要な `python-linstor` パッケージがインストールされるようにするには、次のオーバーライドファイルを使用します。

note: type: Plain text
en: To install the LINBIT version of the driver, update your `kolla-build.conf`
ja: LINBIT バージョンのドライバーをインストールするには `kolla-build.conf` を更新します。

note: type: Plain text
en: To rebuild the Cinder containers, run:
ja: Cinder コンテナを再構築するには、次のコマンドを実行します。

note: type: Plain text
en: When deploying OpenStack using Kolla Ansible, you need to make sure that:
ja: Kolla Ansible を使用して OpenStack をデプロイする場合は、次のことを確認する必要があります。

note: type: Plain text
en: the custom Cinder images, created in the section above, are used
ja: 上記のセクションで作成されたカスタム Cinder イメージが使用される

note: type: Plain text
en: deployment of Cinder services is enabled
ja: Cinder サービスのデプロイが有効である

note: type: Plain text
en: You can place the Linstor driver configuration in one of the override directories for kolla-ansible. For more details on the available configuration options, see the section below.
ja: Linstor ドライバー構成は kolla-ansible のオーバーライドディレクトリの 1 つに配置できます。使用可能な構成オプションの詳細については、以下のセクションを参照してください。

note: type: Plain text
en: https://docs.openstack.org/openstack-ansible/[OpenStack Ansible] provides Ansible playbooks to configure and deploy of OpenStack environments. It allows for fine-grained customization of the deployment, letting you set up the Linstor driver directly.
ja: https://docs.openstack.org/openstack-ansible/[OpenStack Ansible] は、OpenStack 環境を構成およびデプロイするための Ansible プレイブックを提供します。これにより、デプロイメントをきめ細かくカスタマイズできるため、Linstor ドライバーを直接セットアップできます。

note: type: Plain text
en: A detailed description of the available backend parameters can be found in the section below
ja: 使用可能なバックエンドパラメータの詳細な説明は、以下のセクションにあります。

note: type: Title =====
en: Generic Cinder deployment
ja: 汎用 Cinder デプロイメント

note: type: Plain text
en: For other forms of OpenStack deployments, this guide can only provide non-specific hints.
ja: 他の形式の OpenStack デプロイメントの場合、このガイドでは一般的なヒントのみを提供できます。

note: type: Plain text
en: To update the Linstor driver version, find your cinder installation. Some likely paths are:
ja: Linstor ドライバーのバージョンを更新するには、インストールされた cinder ディレクトリを見つけてください。考えられるパスは次のとおりです。

note: type: Plain text
en: The Linstor driver consists of a single file called `linstordrv.py`, located in the Cinder directory:
ja: Linstor ドライバーは、cinder ディレクトリにある `linstordrv.py` というファイルです。

note: type: Plain text
en: To update the driver, replace the file with one from the LINBIT repository
ja: ドライバを更新するには、ファイルを LINBIT リポジトリのファイルに置き換えます

note: type: Plain text
en: You might also need to remove the Python cache for the update to be registered:
ja: 登録されたものを更新するには、Python キャッシュを削除する必要がある場合もあります。

note: type: Title ===
en: Configure a Linstor Backend for Cinder
ja: Cinder 用の Linstor バックエンドを構成

note: type: Plain text
en: To use the Linstor driver, configure the Cinder volume service. This is done by editing the Cinder configuration file and then restarting the Cinder Volume service.
ja: Linstor ドライバーを使用するには、Cinder ボリュームサービスを構成します。Cinder 構成ファイルを編集してから、Cinder ボリュームサービスを再起動することで構成できます。

note: type: Plain text
en: Most of the time, the Cinder configuration file is located at `/etc/cinder/cinder.conf`. Some deployment options allow manipulating this file in advance. See the section above for specifics.
ja: ほとんどの場合、Cinder 構成ファイルは `/etc/cinder/cinder.conf` にあります。一部のデプロイメントでは、このファイルを事前に編集できます。詳細は上記のセクションを参照してください。

note: type: Plain text
en: To configure a new volume backend using Linstor, add the following section to `cinder.conf`
ja: Linstor を使用して新しいボリュームバックエンドを構成するには、次のセクションを `cinder.conf` に追加します。

note: type: Plain text
en: The parameters described here are based on the latest release provided by Linbit. The driver included in OpenStack might not support all of these parameters. Take a look at the https://docs.openstack.org/cinder/latest/configuration/block-storage/drivers/linstor-driver.html[OpenStack driver documentation] to find out more.
ja: ここで説明するパラメーターは、Linbit が提供する最新のリリースに基づいています。 OpenStack に含まれているドライバーは、これらのパラメーターのすべてをサポートしているとは限りません。詳細は https://docs.openstack.org/cinder/latest/configuration/block-storage/drivers/linstor-driver.html[OpenStack ドライバーのドキュメント] を参照ください。

note: type: Plain text
en: The name of the volume backend. Needs to be unique in the Cinder configuration. The whole section should share the same name. This name is referenced again in `cinder.conf` in the `enabled_backends` setting and when creating a new volume type.
ja: ボリュームバックエンド名。 Cinder 構成で一意である必要があります。セクション全体で同じ名前を共有する必要があります。この名前は `enabled_backends` 設定の `cinder.conf` で、および新しいボリュームタイプを作成するときに再び参照されます。

note: type: Plain text
en: The version of the Linstor driver to use. There are two options:
ja: 使用する Linstor ドライバーのバージョン。2 つのオプションがあります。

note: type: Plain text
en: Which driver you should use depends on your Linstor set up and requirements. Details on each choice are documented in <<s-openstack-linstor-transport-options, the section below.>>
ja: どのドライバーを使用するかは Linstor のセットアップと要件によって異なります。各選択肢の詳細は <<s-openstack-linstor-transport-options, 以下のセクション>> を参照ください。

note: type: Plain text
en: The URL(s) of the Linstor Controller(s). Multiple Controllers can be specified to make use of <<s-linstor_ha,Linstor High Availability>>. If not set, defaults to `linstor://localhost`.
ja: Linstor コントローラーの URL。 <<s-linstor_ha,Linstor 高可用性>> を利用するために、複数のコントローラーを指定できます。設定されていない場合、デフォルトは `linstor://localhost` です。

note: type: Plain text
en: In driver versions prior to 2.0.0, this option is called `linstor_default_uri`
ja: 2.0.0 より前のバージョンのドライバーでは、このオプションは `linstor_default_uri` と呼ばれます。

note: type: Plain text
en: If <<s-linstor-rest-api-https,HTTPS is enabled>> the referenced certificate is used to verify the Linstor Controller authenticity.
ja: <<s-linstor-rest-api-https, HTTPS が有効の場合、>> 指定された証明書を使用して LINSTOR コントローラーの信頼性を検証します。

note: type: Plain text
en: If <<s-linstor-rest-api-https,HTTPS is enabled>> the referenced key and certificate will be presented to the Linstor Controller for authentication.
ja: <<s-linstor-rest-api-https, HTTPS が有効の場合、>> 指定されたキーと証明書が、認証のために LINSTOR コントローラーで使用されます。

note: type: Plain text
en: *Deprecated in 2.0.0, use <<s-openstack-volume-types,volume types>> instead.* The storage pools to use when placing
    resources. Applies to all diskfull resources created. Defaults to `DfltStorPool`.
ja: 2.0.0 で非推奨になったので、代わりに <<s-openstack-volume-types,volume types>> を使用してください。リソースを配置するときに使用するストレージプール。作成されたすべてのディスクフルリソースに適用されます。デフォルトは `DfltStorPool` です。

note: type: Plain text
en: *Removed in 2.0.0, use <<s-openstack-volume-types,volume types>> instead.* The number of replicas to create for the given
    volume. A value of `0` will create a replica on all nodes. Defaults to `0`.
ja: 2.0.0 で非推奨になったので、代わりに <<s-openstack-volume-types,volume types>> を使用してください。特定のボリュームに対して作成する複製数。値が `0` の場合、すべてのノードに複製が作成されます。デフォルトは `0` です。

note: type: Plain text
en: *Removed in 2.0.0, volumes are created on demand by the driver.* If set to true, ensures that at least one (diskless) replica is deployed on the Cinder Controller host. This is
    useful for ISCSI transports. Defaults to `true`.
ja: 2.0.0 で削除され、ボリュームはドライバーによって必要に応じて作成されます。true に設定すると、少なくとも 1 つの（ディスクレス）複製が Cinder コントローラーホストにデプロイされることを保証します。これは、iSCSIトランスポートに役立ちます。デフォルトは `true` です。

note: type: Plain text
en: You can specify more generic Cinder options here, for example `target_helper = tgtadm` for the ISCSI connector.
ja: ここでは、より一般的な Cinder オプションを指定できます。たとえば、iSCSI コネクタの場合は `target_helper = tgtadm` です。

note: type: Plain text
en: You can also configure multiple Linstor backends, choosing a different name and configuration options for each.
ja: 複数の Linstor バックエンドを構成して、それぞれに異なる名前と構成オプションを選択することもできます。

note: type: Plain text
en: After configuring the Linstor backend, it should also be enabled. Add it to the list of enabled backends in `cinder.conf`, and optionally set is as the default backend:
ja: Linstor バックエンドを構成した後、それも有効にする必要があります。これを `cinder.conf` の有効なバックエンドのリストに追加し、オプションでデフォルトのバックエンドとして設定します。

note: type: Plain text
en: As a last step, if you changed the Cinder configuration or updated the driver itself, make sure to restart the Cinder service(s). Please check the documentation for your OpenStack Distribution on how to restart services.
ja: 最後のステップとして、Cinder 構成を変更した場合、またはドライバー自体を更新した場合は、必ず Cinder サービスを再起動してください。サービスを再起動する方法については、OpenStack ディストリビューションのドキュメントを確認してください。

note: type: Title ====
en: Choice of Transport Protocol
ja: トランスポートプロトコルの選択

note: type: Plain text
en: The Transport Protocol in Cinder is how clients (for example nova-compute) access the actual volumes. With Linstor, you can choose between two different drivers that use different transports.
ja: Cinder のトランスポートプロトコルは、クライアント（たとえば、nova-compute）が実際のボリュームにアクセスする方法です。Linstor を使用すると、異なるトランスポートを使用する 2 つの異なるドライバーを選択できます。

note: type: Plain text
en: `cinder.volume.drivers.linstordrv.LinstorDrbdDriver`, which uses DRBD as transport
ja: `cinder.volume.drivers.linstordrv.LinstorDrbdDriver` : トランスポートプロトコルとして DRBD を使用

note: type: Plain text
en: `cinder.volume.drivers.linstordrv.LinstorIscsiDriver`, which uses ISCSI as transport
ja: `cinder.volume.drivers.linstordrv.LinstorIscsiDriver` : トランスポートプロトコルとして iSCSI を使用

note: type: Title =====
en: Using DRBD as Transport Protocol
ja: トランスポートプロトコルとして DRBD を使用

note: type: Plain text
en: The `LinstorDrbdDriver` works by ensuring a replica of the volume is available locally on the node where a client (i.e. nova-compute) issued a request. This only works if _all_ compute nodes are also running Linstor Satellites that are part of the same Linstor cluster.
ja: `LinstorDrbdDriver` は、クライアント（つまり、nova-compute）がリクエストを発行したノードでボリュームの複製がローカルで利用できるようにすることで機能します。これはすべての compute ノードが同じ Linstor クラスターの一部である Linstor サテライトを実行している場合にのみ機能します。

note: type: Plain text
en: The advantages of this option are:
ja: このオプションの利点は次のとおりです。

note: type: Plain text
en: Once set up, the Cinder host is no longer involved in the data path. All read and write to the volume are handled by the local DRBD module, which will handle replication across its configured peers.
ja: セットアップが完了すると、Cinder ホストはデータパスに関与しなくなります。ボリュームへのすべての読み書きは、構成された対向ノード間でのレプリケーションを処理するローカル DRBD モジュールによって処理されます。

note: type: Plain text
en: Since the Cinder host is not involved in the data path, any disruptions to the Cinder service do not affect volumes that are already attached.
ja: Cinder ホストはデータパスに関与していないため、Cinder サービスが中断しても、すでに接続されているボリュームには影響しません。

note: type: Plain text
en: ====== Known limitations:
ja: ====== 既知の制限:

note: type: Plain text
en: Not all hosts and hypervisors support using DRBD volumes. This restricts deployment to Linux hosts and `kvm` hypervisors.
ja: すべてのホストとハイパーバイザーが DRBD ボリュームの使用をサポートしているわけではありません。Linux ホストと `kvm` ハイパーバイザーがデプロイメントの対象として制限されます。

note: type: Plain text
en: Resizing of attached and in-use volumes does not fully work. While the resize itself is successful, the compute service will not propagate it to the VM until after a restart.
ja: 接続しているボリュームと使用中のボリュームのサイズ変更は完全には機能しません。サイズ変更自体は成功していますが、サービスは再起動するまで VM にサイズ変更を伝えません。

note: type: Plain text
en: Multi-attach (attaching the same volume on multiple VMs) is not supported.
ja: マルチアタッチ（複数の VM に同じボリュームをアタッチする）はサポートされていません。

note: type: Plain text
en: https://docs.openstack.org/cinder/latest/configuration/block-storage/volume-encryption.html#create-an-encrypted-volume-type[Encrypted volumes] only work if udev rules for DRBD devices are in place.
ja: https://docs.openstack.org/cinder/latest/configuration/block-storage/volume-encryption.html#create-an-encrypted-volume-type[暗号化されたボリューム] は、DRBD デバイスの udev ルールが設定されている場合にのみ機能します。

note: type: Plain text
en: `udev` rules are either part of the `drbd-utils` package or have their own `drbd-udev` package.
ja: `udev` ルールは `drbd-utils` パッケージの一部であるか、独自の `drbd-udev` パッケージの中にあります。

note: type: Title =====
en: Using ISCSI as Transport Protocol
ja: iSCSI トランスポートプロトコルを使用

note: type: Plain text
en: The default way to export Cinder volumes is via iSCSI. This brings the advantage of maximum compatibility - iSCSI can be used with every hypervisor, be it VMWare, Xen, HyperV, or KVM.
ja: Cinder ボリュームをエクスポートするデフォルトの方法は、iSCSI 経由です。これにより最大の互換性が得られます。iSCSI は、VMWare、Xen、HyperV、または KVM などのあらゆるハイパーバイザーで使用できます。

note: type: Plain text
en: The drawback is that all data has to be sent to a Cinder node, to be processed by an (userspace) iSCSI daemon; that means that the data needs to pass the kernel/userspace border, and these transitions will cost some performance.
ja: 欠点は、すべてのデータを（ユーザースペースの）iSCSI デーモンで処理するためにCinder ノードに送信する必要があることです。これは、データがカーネル/ユーザスペース境界を通過する必要があることを意味し、パフォーマンスに影響を与えます。

note: type: Plain text
en: Another drawback is the introduction of a single point of failure. If a Cinder node running the iSCSI daemon crashes, other nodes lose access to their volumes.  There are ways to configure Cinder for automatic fail-over to mitigate this, but it requires considerable effort.
ja: もう1つの欠点は、単一障害点になりうる点です。iSCSI デーモンを実行している Cinder ノードがクラッシュすると、他のノードはボリュームにアクセスできなくなります。これを軽減するために自動フェイルオーバー用に Cinder を構成する方法はいくつかありますが、かなりの労力が必要です。

note: type: Plain text
en: In driver versions prior to 2.0.0, the Cinder host needs access to a local replica of every volume. This can be achieved by either setting `linstor_controller_diskless=True` or using `linstor_autoplace_count=0`. Newer driver versions will create such a volume on demand.
ja: 2.0.0 より前のバージョンのドライバーでは、Cinder ホストはすべてのボリュームのローカルレプリカにアクセスする必要があります。これは `linstor_controller_diskless=True` を設定するか `linstor_autoplace_count=0` を使用することで実現できます。新しいバージョンのドライバーは、必要に応じてそのようなボリュームを作成します。

note: type: Title ====
en: Verify status of Linstor backends
ja: Linstor バックエンドのステータスを確認

note: type: Plain text
en: To verify that all backends are up and running, you can use the OpenStack command line client:
ja: すべてのバックエンドが稼働していることを確認するには、OpenStack コマンドラインを使用できます。

note: type: Plain text
en: If you have the Horizon GUI deployed, check `Admin > System Information > Block Storage Service` instead.
ja: Horizon GUI をデプロイしている場合は、代わりに `Admin > System Information > Block Storage Service` を確認してください。

note: type: Plain text
en: In the above example all configured services are `enabled` and `up`. If there are any issues, please check the logs of the Cinder Volume service.
ja: 上記の例では、構成されているすべてのサービスが `enabled` と `up` になっています。問題がある場合は、Cinder ボリュームサービスのログを確認してください。

note: type: Title ===
en: Create a new volume type for Linstor
ja: Linstor の新しいボリュームタイプを作成

note: type: Plain text
en: Before creating volumes using Cinder, you have to create a volume type. This can either be done via the command line:
ja: Cinder を使用してボリュームを作成する前に、ボリュームタイプを作成する必要があります。これは、コマンドラインから実行できます。

note: type: Plain text
en: Alternatively, you can create volume types via the Horizon GUI. Navigate to `Admin > Volume > Volume Types` and click "Create Volume Type". You can assign it a backend by adding the `volume_backend_name` as "Extra Specs" to it.
ja: あるいは Horizon GUI でボリュームタイプを作成することもできます。`Admin > Volume > Volume Types` から "Create Volume Type" をクリックします。 `volume_backend_name` を "Extra Specs" として追加することで、バックエンドを割り当てることができます。

note: type: Title ====
en: Advanced Configuration of volume types
ja: ボリュームタイプの詳細設定

note: type: Plain text
en: Each volume type can be customized by adding properties or "Extra Specs" as they are called in the Horizon GUI.
ja: 各ボリュームタイプは、Horizon GUI で呼び出されるプロパティまたは "Extra Specs" を追加することでカスタマイズできます。

note: type: Plain text
en: To add a property to a volume type on the command line use:
ja: コマンドラインでボリュームタイプにプロパティを追加するには、次を使用します。

note: type: Plain text
en: Alternatively, you can set the property via the GUI by navigating tp `Admin > Volume > Volume Types`. In the `Actions` column, open the dropdown menu and click the `View Extra Specs` button. This opens a dialog you can use to create, edit and delete properties.
ja: または GUI で `Admin > Volume > Volume Types` から プロパティを設定することもできます。 `Actions` 列で、ドロップダウンメニューを開き `View Extra Specs` ボタンをクリックします。これにより、プロパティの作成、編集、削除に使用できるダイアログが開きます。

note: type: Title =====
en: Available volume type properties
ja: 使用可能なボリュームタイプのプロパティ

note: type: Plain text
en: Create diskless replicas on non-selected nodes after auto-placing.
ja: 自動配置後、選択されていないノードにディスクレスレプリカを作成する。

note: type: Plain text
en: Do not place the resource on a node which has a resource with a name matching the regex.
ja: 正規表現と一致する名前のリソースを持つノードにリソースを配置しない。

note: type: Plain text
en: Comma-separated list of layers to apply for resources. If empty, defaults to DRBD,Storage.
ja: リソースを適用するためのレイヤーのコンマ区切りリスト。空の場合、デフォルトはDRBD、Storageです。

note: type: Plain text
en: Comma-separated list of providers to use. If empty, Linstor will automatically choose a suitable provider.
ja: 使用するプロバイダーのコンマ区切りリスト。空の場合、LINSTOR は適切なプロバイダーを自動的に選択します。

note: type: Plain text
en: Number of replicas to create. Defaults to 2.
ja: 作成するレプリカの数。デフォルトは 2 です。

note: type: Plain text
en: A comma-separated list of key or key=value items used as autoplacement selection labels when autoplace is used to determine where to provision storage.
ja: 自動配置を使用してストレージをプロビジョニングする場所を決定するときに、自動配置選択ラベルとして使用される key または key=value アイテムのコンマ区切りのリスト。

note: type: Plain text
en: Comma-separated list of storage pools to use when auto-placing.
ja: 自動配置時に使用するストレージプールのコンマ区切りリスト。

note: type: Plain text
en: If a key is prefixed by `linstor:property:`, it is interpreted as a LINSTOR property. The property gets set on the <<s-linstor-resource-groups,Resource Group>> created for the volume type.
ja: キーの前に `linstor:property:` が付いている場合、そのキーは LINSTOR プロパティとして解釈されます。プロパティはボリュームタイプ用に作成された <<s-linstor-resource-groups,Resource Group>> に設定されます。

note: type: Plain text
en: For example: To change the <<s-linstor-auto-quorum,quorum policy>> `DrbdOptions/auto-quorum` needs to be set. This can be done by setting the `linstor:property:DrbdOptions/auto-quorum` property.
ja: 例: <<s-linstor-auto-quorum,quorum policy>> を変更するには `DrbdOptions/auto-quorum` を設定する必要があります。これは `linstor:property:DrbdOptions/auto-quorum` プロパティを設定することで実行できます。

note: type: Title ===
en: Using volumes
ja: ボリュームの使用

note: type: Plain text
en: Once you have a volume type configured, you can start using it to provision new volumes.
ja: ボリュームタイプを構成したら、それを使用して新しいボリュームのプロビジョニングを開始できます。

note: type: Plain text
en: For example, to create a simple 1Gb volume on the command line you can use:
ja: たとえば、コマンドラインで単純な 1Gb ボリュームを作成するには、次のコマンドを使用できます。

note: type: Plain text
en: If you set `default_volume_type = linstor-drbd-volume` in your `/etc/cinder/cinder.conf`, you may omit the `--type linstor-drbd-volume` from the `openstack volume create ...` command above.
ja: `/etc/cinder/cinder.conf` に `default_volume_type = linstor-drbd-volume` を設定した場合、上記の `openstack volume create ...` コマンドから `--type linstor-drbd-volume` を省略できます。

note: type: Title ===
en: Troubleshooting
ja: トラブルシューティング

note: type: Plain text
en: This section describes what to do in case you encounter problems with using Linstor volumes and snapshots.
ja: このセクションでは、Linstor ボリュームとスナップショットの使用で問題が発生した場合の対処方法について説明します。

note: type: Title ====
en: Checking for error messages in Horizon
ja: Horizon でエラーメッセージを確認する

note: type: Plain text
en: Every volume and snapshot has a Messages tab in the Horizon dashboard. In case of errors, the list of messages can be used as a starting point for further investigation. Some common messages in case of errors:
ja: すべてのボリュームとスナップショットには、Horizon ダッシュボードに Messages タブがあります。エラーが発生した場合は、メッセージのリストをさらに調査するための開始点として使用できます。以下はエラーの場合によくあるメッセージです。

note: type: Plain text
en: There was an error creating a new volume. Check the Cinder Volume service logs for more details
ja: 新しいボリュームの作成中にエラーが発生しました。詳細については、Cinder ボリュームサービスログを確認してください。

note: type: Plain text
en: If this is the only error message, this means the Cinder Scheduler could not find a volume backend suitable for creating the volume. This is most likely because:
ja: これが唯一のエラーメッセージである場合、Cinder スケジューラがボリュームの作成に適したボリュームバックエンドを見つけられなかったことを意味します。これは以下の理由が考えられます。

note: type: Plain text
en: The volume backend is offline. See <<s-openstack-linstor-backend-status>>
ja: ボリュームバックエンドはオフラインである。詳細は <<s-openstack-linstor-backend-status>> を参照ください。

note: type: Plain text
en: The volume backend has not enough free capacity to fulfil the request. Check the output of `cinder get-pools --detail` and `linstor storage-pool list` to ensure that the requested capacity is available.
ja: ボリュームバックエンドには、リクエストを満たすのに十分な空き容量がありません。 `cinder get-pools--detail` と `linstor storage-pool list` の出力をチェックして、リクエストされた容量が使用可能であることを確認します。

note: type: Title ====
en: Checking the Cinder Volume Service
ja: Cinder ボリュームサービスの確認

note: type: Plain text
en: The Linstor driver is called as part of the Cinder Volume service.
ja: Linstor ドライバーは、Cinder ボリュームサービスの一部として呼び出されます。

note: type: Title ====
en: Checking the compute srvice logs
ja: Compute サービスログの確認

note: type: Plain text
en: Some issues will not be logged in the Cinder Service but in the actual consumer of the volumes, most likely the compute service (Nova). As with the volume service, the exact host and location to check depends on your Openstack distribution:
ja: 一部の問題は Cinder サービスログに記録されませんが、ボリュームの実際のコンシューマー、おそらく Compute サービス（Nova）に記録されます。ボリュームサービスと同様に、確認するホストと正確な場所は、Openstack ディストリビューションによって異なります。
