Skip to content

Commit 04700bc

Browse files
committed
doc(XCP-ng): Fix broken link to XO doc from XO Web UI page
Some links pointed to websites that no longer exist, with no known replacement. These links are now removed. The other links have been fixed to point to the correct location, where possible. Signed-off-by: Thomas Moraine <[email protected]>
1 parent 52a6eeb commit 04700bc

File tree

10 files changed

+35
-28
lines changed

10 files changed

+35
-28
lines changed

docs/installation/upgrade.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -315,7 +315,7 @@ To start the process, just tell the host to reboot. It is best to watch the prog
315315

316316
### Live migration
317317

318-
Live migration **should work** from any older XenServer/XCP-ng toward the latest release. However, there are some cases where it doesn't. For example, XenServer (and XCP-ng) 7.6 has a regression that makes live migration with storage motion crash guests that are based on the "Other installation media" template when the source host has a version lower than 7.6 ([reported here to Citrix](https://bugs.xenserver.org/browse/XSO-924)). But **this bug has been fixed in latest XCP-ng 7.6 updates**.
318+
Live migration **should work** from any older XenServer/XCP-ng toward the latest release. However, there are some cases where it doesn't. For example, XenServer (and XCP-ng) 7.6 has a regression that makes live migration with storage motion crash guests that are based on the "Other installation media" template when the source host has a version lower than 7.6. But **this bug has been fixed in latest XCP-ng 7.6 updates**.
319319

320320
### Warm migration
321321

docs/management/manage-at-scale/xo-web-ui.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Take a look at [the official doc](https://xen-orchestra.com/docs/) to take a tou
2929
Xen Orchestra is fully Open Source, and it comes in 2 "flavors":
3030

3131
1. the turnkey/preinstalled virtual appliance, called **XOA** that you can [deploy in a minute](https://vates.tech/deploy/) tested and bundled with actual commercial support
32-
2. manual install from GitHub ([documentation](https://xen-orchestra.com/docs/from_the_sources.html)), no QA nor stable version, community supported only
32+
2. manual install from GitHub ([documentation](https://docs.xen-orchestra.com/installation#from-the-sources)), no QA nor stable version, community supported only
3333

3434
:::info
3535
We advise to start using XOA by deploying it really easily in [few clicks on this page](https://vates.tech/deploy/). You can always decide later to build it yourself from GitHub.

docs/management/manage-locally/api.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# XCP-ng API
22

3-
XCP-ng is entirely managed by its API, called "XAPI". XAPI project is hosted [inside the Linux Foundation](https://xenproject.org/developers/teams/xen-api/) and the documentation is available on [its dedicated website](https://xapi-project.github.io/xen-api/).
3+
XCP-ng is entirely managed by its API, called "XAPI". XAPI project is hosted [on GitHub](https://github.com/xapi-project/xen-api) and the documentation is available on [its dedicated website](https://xapi-project.github.io/xen-api/).
44

55
XAPI is requested by multiple **clients**, like Xen Orchestra or `xe` CLI. See [our management](../../../management) section for more details.
66

docs/project/development-process/what-xcp-ng-is-made-of.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,5 +7,5 @@ XCP-ng is a collection of components, that put together create a complete turnke
77
As usual in the Free Software world, we stand *on the shoulders of giants*:
88
* **CentOS**: many RPM packages come from the [CentOS](https://www.centos.org/) Linux distribution, which in turn is based on Red Hat's [RHEL](https://en.wikipedia.org/wiki/Red_Hat_Enterprise_Linux), mostly based itself on the work of the [Fedora](https://getfedora.org/) project, all based on the work of all the developers who wrote the [FLOSS](https://en.wikipedia.org/wiki/Free/Libre_Open_Source_Software) software that is packaged in those Linux distributions. Examples: glibc, GNU coreutils, crontabs, iptables and many others. However, the list keeps shrinking while we rebuild, patch or update sensitive components directly in XCP-ng repositories.
99
* **EPEL**: a few packages come from [EPEL](https://fedoraproject.org/wiki/EPEL).
10-
* **XenServer**: most packages that make XCP-ng what it is have been rebuilt from source RPMs released by the [XenServer](https://xenserver.org/) project, with or without modifications. This includes xen, a patched Linux kernel, the Xen API, and many others. This also includes redistributable drivers or tools from third party vendors.
10+
* **XenServer**: most packages that make XCP-ng what it is have been rebuilt from source RPMs released by the [XenServer](https://www.xenserver.com/) project, with or without modifications. This includes xen, a patched Linux kernel, the Xen API, and many others. This also includes redistributable drivers or tools from third party vendors.
1111
* **XCP-ng**: the remaining packages are additions (or replacements of closed-source components) to the original XenServer distribution.

docs/releases/release-8-1.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Citrix announces:
4646
* Support for **AMD EPYC 7xx2(P)** added
4747

4848
Other changes:
49-
* Windows drivers delivered through Windows Update should now work well with non-English locales. Source: [XSO-951](https://bugs.xenserver.org/browse/XSO-951).
49+
* Windows drivers delivered through Windows Update should now work well with non-English locales.
5050
* `chrony` replaces `ntp` for time synchronisation
5151
* **PV guests are not supported anymore**
5252
* Templates for creating PV guests have been removed
@@ -187,7 +187,7 @@ If the ntp server can't be reached, the `chrony-wait` service may stall the boot
187187
* up to 10 minutes if you installed with `xcp-ng-8.1.0.iso`, or with yum update before 2020-04-03;
188188
* up to 2 minutes only if you installed with `xcp-ng-8.1.0-2.iso`, with yum update after 2020-04-03, or have updated your host after 2020-04-03.
189189

190-
Reported to Citrix: [XSO-981](https://bugs.xenserver.org/browse/XSO-981)
190+
Reported to Citrix.
191191

192192
We must stress that it is important that all your hosts have accurate date and time and so be able to connect an ntp server.
193193

@@ -202,7 +202,7 @@ See [this forum thread](https://xcp-ng.org/forum/topic/2822/xcp-ng-8-0-upgrade-t
202202
### Backup partition restore from installer fails on UEFI hosts
203203
Context: the installer creates a backup of the root partition when you upgrade. It also allows to restore that backup when a backup is found.
204204

205-
On UEFI hosts, the backup restore function of the installer fails with the following error message: `setEfiBootEntry() takes exactly 5 arguments (4 given)`. This is [a bug inherited from Citrix Hypervisor 8.1](https://bugs.xenserver.org/browse/XSO-984).
205+
On UEFI hosts, the backup restore function of the installer fails with the following error message: `setEfiBootEntry() takes exactly 5 arguments (4 given)`. This is a bug inherited from Citrix Hypervisor 8.1.
206206

207207
Consequences: although the root filesystem is correctly restored, the system is unbootable.
208208

docs/releases/release-8-2.md

+2-4
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Main changes announced by Citrix:
4848

4949
Other changes:
5050
* Bug fixed for hosts configured with DHCP. `xcp-networkd` used not to send the hostname along with the DHCP request. Fix contributed by XCP-ng team.
51-
* [Backup restore fixed for UEFI hosts](https://bugs.xenserver.org/browse/XSO-984). Bug reported by XCP-ng community.
51+
* Backup restore fixed for UEFI hosts. Bug reported by XCP-ng community.
5252

5353
**The rest, below, is about changes specific to XCP-ng.**
5454

@@ -189,7 +189,7 @@ When a host is upgraded to XCP-ng 8.2 using the installation ISO, two files are
189189
* `/etc/modprobe.d/blacklist-bridge.conf`
190190
* `/etc/modprobe.d/disable-ipv6.conf`
191191

192-
We reported the issue to Citrix: [https://bugs.xenserver.org/browse/XSO-991](https://bugs.xenserver.org/browse/XSO-991)
192+
We reported the issue to Citrix.
193193

194194
There are no known consequences of having those files missing, except possible slightly increased memory usage.
195195

@@ -230,8 +230,6 @@ Live migrating a VM from an old XenServer can sometimes end with an error, with
230230

231231
Would require a hotfix to the old XenServer, but since those versions are not supported anymore, Citrix won't develop one.
232232

233-
Reference: [XSO-938](https://bugs.xenserver.org/browse/XSO-938)
234-
235233
#### Dell servers do not get the best partitioning
236234

237235
Due to the presence of the diagnostic partition on Dell servers, the installer does not create all partitions, so for example there's no dedicated /var/log partition (side-effect: log rotation switches to aggressive mode, so old logs are deleted quickly, sometimes even the same day!).

docs/storage/storage.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -223,11 +223,10 @@ Note: If you use ZFS, assign at least 16GB RAM to avoid swapping. ZFS (in standa
223223

224224
#### ZFS Knowledge & status
225225

226-
Do not hesitate to take a look at these links for more advanced explanations:
226+
Feel free to look at these links for more advanced explanations:
227227

228228
* Wikipedia: [https://en.wikipedia.org/wiki/ZFS](https://en.wikipedia.org/wiki/ZFS)
229229
* OpenZFS Basics: [https://www.youtube.com/watch?v=MsY-BafQgj4](https://www.youtube.com/watch?v=MsY-BafQgj4)
230-
* Blog full of useful information: [http://www.zfsbuild.com](http://www.zfsbuild.com)
231230

232231
You can monitor your ZFS pool using:
233232

docs/troubleshooting/common-problems.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -191,7 +191,7 @@ If you need to modify your XCP-ng root password, you may follow the steps below.
191191

192192
### Solution
193193

194-
The full prodecure can also be found on [this page](https://support.citrix.com/article/CTX214360).
194+
The full prodecure can also be found on [this page](https://linuxconfig.org/how-to-reset-an-administrative-root-password-on-xenserver-7-linux).
195195

196196
* Reboot your XCP-ng into Grub boot menu.
197197
* Select XCP-ng boot menu entry and press <kbd>e</kbd> key to edit boot options.

docs/troubleshooting/storage/iscsi-troubleshooting.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ This apply to setup using DRBD/Corosync/Pacemaker.
4747

4848
The problem is that in a storage-cluster environment every time the node changes or pacemaker start /stop /restart iSCSI resources the "iSCSI SN" for a lun are new generated and differs from that before.
4949
Xen uses the "iSCSI SN" as an identifier, so you have to ensure that "iSCSI SN" is the same on all cluster nodes.
50-
You can read more about it [here](https://smcleod.net/tech/2015/12/14/iscsi-scsiid-persistence.html).
50+
You can read more about it [here](https://smcleod.net/2015/12/iscsi-scsi-id-/-serial-persistence/).
5151

5252
* error message xen orchestra
5353

docs/vms/vms.md

+23-13
Original file line numberDiff line numberDiff line change
@@ -309,7 +309,7 @@ Versions 12.0-U1 and higher of TrueNAS include the package by default, to instal
309309
```bash
310310
# sed -i '' 's/enabled: no/enabled: yes/' /usr/local/etc/pkg/repos/FreeBSD.conf
311311
```
312-
If you are using FreeNAS v11.2 or higher, you also have to disable the local package repository [to avoid an issue in that particular release and that may affect later versions](https://www.justinsilver.com/random/fix-pkg-on-freenas-11-2/) before running `pkg install`:
312+
If you are using FreeNAS v11.2 or higher, you also have to disable the local package repository to avoid an issue in that particular release and that may affect later versions before running `pkg install`:
313313
```bash
314314
# sed -i '' 's/enabled: yes/enabled: no/' /usr/local/etc/pkg/repos/local.conf
315315
```
@@ -503,18 +503,28 @@ Through many tests, a user came up with a similar yet slightly different procedu
503503
Help is welcome to help us reconcile both procedures into one.
504504
:::
505505

506-
* Follow the steps 0 to 4 of the "confident option" above if not done yet.
507-
* Follow this (ignore steps 6 and 7, do not try to install the tools yet) [https://support.citrix.com/article/CTX215427](https://support.citrix.com/article/CTX215427)
508-
* Now open regedit and go to HKLM\SYSTEM\CurrentControlSet\Services and delete entries for all xen* services.
509-
* In regedit, also go to HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\DIFx\DriverStore and remove ONLY xennet* xenvif*
510-
* Go to C:\Windows\System32 and remove: (you may not have all these)
511-
* xenbus_coinst*.dll
512-
* xenvbd_coinst*.dll
513-
* liteagent.exe
514-
* Now go to C:\Windows\System32\drivers and remove any files named xen*
515-
* Go to C:\Windows\system32\DriverStore\FileRepository and remove xennet* and Xenvif* directories.
516-
* Open the Device Manager and Click View --> Show Hidden Devices. Select Other Devices and Right click on XENBUS VIF and select uninstall. If it asks to delete the driver, check yes. Do this for any xen related thing you see in device manager. Also do the same for any unknown devices.
517-
* Lastly, reboot the VM. You should now hopefully be able to install xen tools regularly.
506+
1. If not done yet, follow Steps 0 to 4 of the "confident option" above.
507+
2. Open the **Windows Registry** (regedit).
508+
3. Go to `HKLM\SYSTEM\CurrentControlSet\Services` and delete entries for all `xen*` services.
509+
4. Delete the following entries:
510+
- `HKLM\SYSTEM\CurrentControlSet\Enum\XENBUS`
511+
- `HKLM\SYSTEM\CurrentControlSet\Enum\XENVIF`
512+
5. Go to `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\DIFx\DriverStore` and remove these entries ONLY:
513+
- `xennet`
514+
- `xenvif*`
515+
6. Go to `C:\Windows\System32` and remove: (you may not have all these)
516+
- `xenbus_coinst*.dll`
517+
- `xenvbd_coinst*.dll`
518+
- `liteagent.exe`
519+
7. Go to `C:\Windows\System32\drivers` and remove any files named `xen*`.
520+
8. Go to `C:\Windows\system32\DriverStore\FileRepository` and remove these directories:
521+
- `xennet*`
522+
- `Xenvif*`
523+
9. Open the **Device Manager** and click **View → Show Hidden Devices**.
524+
10. Select **Other Devices**, right-click **XENBUS VIF** and select **uninstall**.\
525+
If it asks to delete the driver, check **yes**. Do this for any xen-related thing you see in Device Manager. Do the same for any unknown devices.
526+
10. Reboot the VM.\
527+
You should now be able to install xen tools regularly.
518528

519529
**Note**: Also have a look at our [Troubleshooting Guide - Windows PV-Tools](../troubleshooting/windows-pv-tools.md).
520530

0 commit comments

Comments
 (0)