Skip to content

Commit f4f00b3

Browse files
authored
(doc) xenopsd/walkthroughs/VM.migrate.md: Fix typos and spelling (#6304)
Quick initial typo and spelling fixes.
2 parents 5b99bed + 498a910 commit f4f00b3

File tree

2 files changed

+16
-16
lines changed

2 files changed

+16
-16
lines changed

doc/content/xenopsd/walkthroughs/VM.migrate.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ that we will describe in the documentation are:
2828
- PCI.plug
2929
- VM.set_domain_action_request
3030

31-
The command have serveral parameters such as: should it be ran asynchronously,
32-
should it be forwared to another host, how arguments should be marshalled and
31+
The command has several parameters such as: Should it be started asynchronously,
32+
should it be forwarded to another host, how arguments should be marshalled and
3333
so on. A new thread is created by [xapi/server_helpers.ml](https://github.com/xapi-project/xen-api/blob/7ac88b90e762065c5ebb94a8ea61c61bdbf62c5c/ocaml/xapi/server_helpers.ml#L55)
3434
to handle the command asynchronously. At this point the helper also check if
3535
the command should be passed to the [message forwarding](https://github.com/xapi-project/xen-api/blob/master/ocaml/xapi/message_forwarding.ml)
@@ -76,26 +76,26 @@ After checking with Qemu that the VM is suspendable we can start the migration.
7676

7777
As for *hooks*, commands to source domain are sent using [stunnel](https://github.com/xapi-project/xen-api/tree/master/ocaml/libs/stunnel) a daemon which
7878
is used as a wrapper to manage SSL encryption communication between two hosts on the same
79-
pool. To import metada an XML RPC command is sent to the original domain.
79+
pool. To import the metadata, an XML RPC command is sent to the original domain.
8080

81-
Once imported it will give us a reference id and will allow to build the new domain
81+
Once imported, it will give us a reference id and will allow building the new domain
8282
on the destination using the temporary VM uuid `XXXXXXXX-XXXX-XXXX-XXXX-000000000001`
8383
where `XXX...` is the reference id of the original VM.
8484

8585
## Setting memory
8686

87-
One of the first thing to do is to setup the memory. The backend will check that there
87+
One of the first thing to do is to set up the memory. The backend will check that there
8888
is no ballooning operation in progress. At this point the migration can fail if a
8989
ballooning operation is in progress and takes too much time.
9090

91-
Once memory checked the daemon will get the state of the VM (running, halted, ...) and
92-
information about the VM are retrieve by the backend like the maximum memory the domain
91+
Once memory has been checked, the daemon will get the state of the VM (running, halted, ...) and
92+
information about the VM is retrieved by the backend like the maximum memory the domain
9393
can consume but also information about quotas for example.
94-
Information are retrieve by the backend from xenstore.
94+
The backend retrieves this information from the Xenstore.
9595

9696
Once this is complete, we can restore VIF and create the domain.
9797

98-
The synchronisation of the memory is the first point of synchronisation and everythin
98+
The synchronisation of the memory is the first point of synchronisation and everything
9999
is ready for VM migration.
100100

101101
## VM Migration
@@ -148,12 +148,12 @@ We are almost done. The next step is to create the device model
148148
#### create device model
149149

150150
Create device model is done by using the atomic operation [VM.create_device_model](https://github.com/xapi-project/xen-api/blob/7ac88b90e762065c5ebb94a8ea61c61bdbf62c5c/ocaml/xenopsd/xc/xenops_server_xen.ml#L2375). This
151-
will configure **qemu-dm** and started. This allow to manage PCI devices.
151+
will configure **qemu-dm** and started. This allows to manage PCI devices.
152152

153153
#### PCI plug
154154

155155
[PCI.plug](https://github.com/xapi-project/xen-api/blob/7ac88b90e762065c5ebb94a8ea61c61bdbf62c5c/ocaml/xenopsd/xc/xenops_server_xen.ml#L3399)
156-
is executed by the backend. It plugs a PCI device and advertise it to QEMU if this option is set. It is
156+
is executed by the backend. It plugs a PCI device and advertises it to QEMU if this option is set. It is
157157
the case for NVIDIA SR-IOV vGPUS.
158158

159159
At this point devices have been restored. The new domain is considered survivable. We can
@@ -168,12 +168,12 @@ initiated.
168168

169169
Previously we spoke about some points called *hooks* at which `xenopsd` can execute some script. There
170170
is also a hook to run a post migrate script. After the execution of the script if there is one
171-
the migration is almost done. The last step is a handskake to seal the success of the migration
172-
and the old VM can now be cleaned.
171+
the migration is almost done. The last step is a handshake to seal the success of the migration
172+
and the old VM can now be cleaned up.
173173

174174
# Links
175175

176-
Some links are old but even if many changes occured they are relevant for a global understanding
176+
Some links are old but even if many changes occurred, they are relevant for a global understanding
177177
of the XAPI toolstack.
178178

179179
- [XAPI architecture](https://xapi-project.github.io/xapi/architecture.html)

doc/content/xenopsd/walkthroughs/VM.start.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ users:
3333

3434
- the XenAPI has many clients which are updated on long release cycles. The
3535
main property needed is backwards compatibility, so that new release of xapi
36-
remain compatible with these older clients. Quite often we will chose to
36+
remain compatible with these older clients. Quite often, we will choose to
3737
"grandfather in" some poorly designed interface simply because we wish to
3838
avoid imposing churn on 3rd parties.
3939
- the Xenopsd API clients are all open-source and are part of the xapi-project.
@@ -166,7 +166,7 @@ via the function
166166

167167
It is the responsibility of the client to call
168168
[TASK.destroy](https://github.com/xapi-project/xcp-idl/blob/2e5c3dd79c63e3711227892271a6bece98eb0fa1/xen/xenops_interface.ml#L406)
169-
when the Task is nolonger needed. Xenopsd won't destroy the task because it contains
169+
when the Task is no longer needed. Xenopsd won't destroy the task because it contains
170170
the success/failure result of the operation which is needed by the client.
171171

172172
What happens when a Xenopsd receives a VM.start request?

0 commit comments

Comments
 (0)