Message ID | 20190801004053.7021-1-richardw.yang@linux.intel.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | [v2] docs/nvdimm: add example on persistent backend setup | expand |
On Thu, Aug 1, 2019 at 1:41 AM Wei Yang <richardw.yang@linux.intel.com> wrote: > Persistent backend setup requires some knowledge about nvdimm and ndctl > tool. Some users report they may struggle to gather these knowledge and > have difficulty to setup it properly. > > Here we provide two examples for persistent backend and gives the link > to ndctl. By doing so, user could try it directly and do more > investigation on persistent backend setup with ndctl. > > Signed-off-by: Wei Yang <richardw.yang@linux.intel.com> > Reviewed-by: Pankaj Gupta <pagupta@redhat.com> > > --- > v2: rephrase the doc based on Stefan Hajnoczi's suggestion > --- > docs/nvdimm.txt | 31 +++++++++++++++++++++++++++++++ > 1 file changed, 31 insertions(+) Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
On Thu, Aug 01, 2019 at 08:40:53AM +0800, Wei Yang wrote: >Persistent backend setup requires some knowledge about nvdimm and ndctl >tool. Some users report they may struggle to gather these knowledge and >have difficulty to setup it properly. > >Here we provide two examples for persistent backend and gives the link >to ndctl. By doing so, user could try it directly and do more >investigation on persistent backend setup with ndctl. > >Signed-off-by: Wei Yang <richardw.yang@linux.intel.com> >Reviewed-by: Pankaj Gupta <pagupta@redhat.com> > Would someone pick up this one? Thanks ~
On Thu, Aug 01, 2019 at 08:40:53AM +0800, Wei Yang wrote: > Persistent backend setup requires some knowledge about nvdimm and ndctl > tool. Some users report they may struggle to gather these knowledge and > have difficulty to setup it properly. > > Here we provide two examples for persistent backend and gives the link > to ndctl. By doing so, user could try it directly and do more > investigation on persistent backend setup with ndctl. > > Signed-off-by: Wei Yang <richardw.yang@linux.intel.com> > Reviewed-by: Pankaj Gupta <pagupta@redhat.com> > > --- > v2: rephrase the doc based on Stefan Hajnoczi's suggestion > --- > docs/nvdimm.txt | 31 +++++++++++++++++++++++++++++++ > 1 file changed, 31 insertions(+) Sorry, I was expecting someone else to pick this patch up. But since there have been no takers... Thanks, applied to my block-next tree: https://github.com/stefanha/qemu/commits/block-next Stefan
On Thu, Sep 12, 2019 at 02:16:00PM +0200, Stefan Hajnoczi wrote: >On Thu, Aug 01, 2019 at 08:40:53AM +0800, Wei Yang wrote: >> Persistent backend setup requires some knowledge about nvdimm and ndctl >> tool. Some users report they may struggle to gather these knowledge and >> have difficulty to setup it properly. >> >> Here we provide two examples for persistent backend and gives the link >> to ndctl. By doing so, user could try it directly and do more >> investigation on persistent backend setup with ndctl. >> >> Signed-off-by: Wei Yang <richardw.yang@linux.intel.com> >> Reviewed-by: Pankaj Gupta <pagupta@redhat.com> >> >> --- >> v2: rephrase the doc based on Stefan Hajnoczi's suggestion >> --- >> docs/nvdimm.txt | 31 +++++++++++++++++++++++++++++++ >> 1 file changed, 31 insertions(+) > >Sorry, I was expecting someone else to pick this patch up. But since >there have been no takers... > >Thanks, applied to my block-next tree: >https://github.com/stefanha/qemu/commits/block-next > Thanks :-) >Stefan
diff --git a/docs/nvdimm.txt b/docs/nvdimm.txt index b531cacd35..362e99109e 100644 --- a/docs/nvdimm.txt +++ b/docs/nvdimm.txt @@ -171,6 +171,35 @@ guest software that this vNVDIMM device contains a region that cannot accept persistent writes. In result, for example, the guest Linux NVDIMM driver, marks such vNVDIMM device as read-only. +Backend File Setup Example +-------------------------- + +Here are two examples showing how to setup these persistent backends on +linux using the tool ndctl [3]. + +A. DAX device + +Use the following command to set up /dev/dax0.0 so that the entirety of +namespace0.0 can be exposed as an emulated NVDIMM to the guest: + + ndctl create-namespace -f -e namespace0.0 -m devdax + +The /dev/dax0.0 could be used directly in "mem-path" option. + +B. DAX file + +Individual files on a DAX host file system can be exposed as emulated +NVDIMMS. First an fsdax block device is created, partitioned, and then +mounted with the "dax" mount option: + + ndctl create-namespace -f -e namespace0.0 -m fsdax + (partition /dev/pmem0 with name pmem0p1) + mount -o dax /dev/pmem0p1 /mnt + (create or copy a disk image file with qemu-img(1), cp(1), or dd(1) + in /mnt) + +Then the new file in /mnt could be used in "mem-path" option. + NVDIMM Persistence ------------------ @@ -212,3 +241,5 @@ References https://www.snia.org/sites/default/files/technical_work/final/NVMProgrammingModel_v1.2.pdf [2] Persistent Memory Development Kit (PMDK), formerly known as NVML project, home page: http://pmem.io/pmdk/ +[3] ndctl-create-namespace - provision or reconfigure a namespace + http://pmem.io/ndctl/ndctl-create-namespace.html