Skip to content

Commit 753a8ff

Browse files
committed
doc: Change default erasure code profile from jerasure to isa
Signed-off-by: Jamie Pryde <[email protected]>
1 parent 8c4f910 commit 753a8ff

File tree

6 files changed

+14
-11
lines changed

6 files changed

+14
-11
lines changed

doc/dev/erasure-coded-pool.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ Set the CRUSH failure domain to osd (instead of host, which is the default)::
6363
$ ceph osd erasure-code-profile get myprofile
6464
k=2
6565
m=2
66-
plugin=jerasure
66+
plugin=isa
6767
technique=reed_sol_van
6868
crush-failure-domain=osd
6969
$ ceph osd pool create ecpool erasure myprofile
@@ -75,7 +75,7 @@ Control the parameters of the erasure code plugin::
7575
$ ceph osd erasure-code-profile get myprofile
7676
k=3
7777
m=2
78-
plugin=jerasure
78+
plugin=isa
7979
technique=reed_sol_van
8080
$ ceph osd pool create ecpool erasure myprofile
8181

@@ -98,7 +98,7 @@ Display the default erasure code profile::
9898
$ ceph osd erasure-code-profile get default
9999
k=2
100100
m=2
101-
plugin=jerasure
101+
plugin=isa
102102
technique=reed_sol_van
103103

104104
Create a profile to set the data to be distributed on six OSDs (k+m=6) and sustain the loss of three OSDs (m=3) without losing data::
@@ -107,7 +107,7 @@ Create a profile to set the data to be distributed on six OSDs (k+m=6) and susta
107107
$ ceph osd erasure-code-profile get myprofile
108108
k=3
109109
m=3
110-
plugin=jerasure
110+
plugin=isa
111111
technique=reed_sol_van
112112
$ ceph osd erasure-code-profile ls
113113
default
@@ -129,7 +129,7 @@ Set the rule to ssd (instead of default)::
129129
$ ceph osd erasure-code-profile get myprofile
130130
k=2
131131
m=2
132-
plugin=jerasure
132+
plugin=isa
133133
technique=reed_sol_van
134134
crush-root=ssd
135135

doc/dev/osd_internals/erasure_coding/developer_notes.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ key=value pairs stored in an `erasure code profile`_.
171171
directory=/usr/lib/ceph/erasure-code
172172
k=2
173173
m=1
174-
plugin=jerasure
174+
plugin=isa
175175
technique=reed_sol_van
176176
crush-failure-domain=osd
177177
$ ceph osd pool create ecpool erasure myprofile
@@ -206,7 +206,7 @@ set in the erasure code profile, before the pool was created.
206206
207207
ceph osd erasure-code-profile set myprofile \
208208
directory=<dir> \ # mandatory
209-
plugin=jerasure \ # mandatory
209+
plugin=isa \ # mandatory
210210
m=10 \ # optional and plugin dependent
211211
k=3 \ # optional and plugin dependent
212212
technique=reed_sol_van \ # optional and plugin dependent

doc/rados/operations/erasure-code-isa.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
ISA erasure code plugin
33
=======================
44

5+
The *isa* plugin is the default for Ceph erasure coded pools.
56
The *isa* plugin encapsulates the `ISA
67
<https://01.org/intel%C2%AE-storage-acceleration-library-open-source-version/>`_
78
library.

doc/rados/operations/erasure-code-jerasure.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,10 @@
22
Jerasure erasure code plugin
33
============================
44

5-
The *jerasure* plugin is the most generic and flexible plugin, it is
6-
also the default for Ceph erasure coded pools.
5+
The *jerasure* plugin is a generic and flexible plugin. However,
6+
the *jerasure* library is no longer maintained and has not been
7+
updated to support modern CPU instructions that can improve
8+
performance when encoding and decoding data.
79

810
The *jerasure* plugin encapsulates the `Jerasure
911
<https://github.com/ceph/jerasure>`_ library. It is

doc/rados/operations/erasure-code-profile.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Where:
6767

6868
:Type: String
6969
:Required: No.
70-
:Default: jerasure
70+
:Default: isa
7171

7272
``{stripe_unit=stripe_unit}``
7373

doc/rados/operations/erasure-code.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ profile can be displayed with this command:
6464

6565
k=2
6666
m=2
67-
plugin=jerasure
67+
plugin=isa
6868
crush-failure-domain=host
6969
technique=reed_sol_van
7070

0 commit comments

Comments
 (0)