Skip to content

Commit 5659289

Browse files
author
David Scott
committed
Split out the XenCenter conventions
Signed-off-by: David Scott <[email protected]>
1 parent 7cdd568 commit 5659289

File tree

3 files changed

+33
-26
lines changed

3 files changed

+33
-26
lines changed

_data/navbar.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@
2525
- xen-api/consoles.md
2626
- xen-api/install-vms.md
2727
- xen-api/networking.md
28+
- xen-api/xencenter.md
2829
- xen-api/udhcp.md
2930
- xen-api/index.html
3031
- title: Xapi

xen-api/extensions.md

Lines changed: 0 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -23,29 +23,3 @@ If it is a Linux-based VM, install the COMPANY\_TOOLS and use the `xenstore-read
2323
> **Note**
2424
>
2525
> Only prefixes beginning with `vm-data` are permitted, and anything not in this name-space will be silently ignored when starting the VM.
26-
27-
Internationalization for SR names
28-
---------------------------------
29-
30-
The SRs created at install time now have an `other_config` key indicating how their names may be internationalized.
31-
32-
`other_config["i18n-key"]` may be one of
33-
34-
- `local-hotplug-cd`
35-
36-
- `local-hotplug-disk`
37-
38-
- `local-storage`
39-
40-
- `xenserver-tools`
41-
42-
Additionally, `other_config["i18n-original-value-<field name>"]` gives the value of that field when the SR was created. If XenCenter sees a record where `SR.name_label` equals `other_config["i18n-original-value-name_label"]` (that is, the record has not changed since it was created during XenServer installation), then internationalization will be applied. In other words, XenCenter will disregard the current contents of that field, and instead use a value appropriate to the user's own language.
43-
44-
If you change `SR.name_label` for your own purpose, then it no longer is the same as `other_config["i18n-original-value-name_label"]`. Therefore, XenCenter does not apply internationalization, and instead preserves your given name.
45-
46-
Hiding objects from XenCenter
47-
-----------------------------
48-
49-
Networks, PIFs, and VMs can be hidden from XenCenter by adding the key `HideFromXenCenter=true` to the `other_config` parameter for the object. This capability is intended for ISVs who know what they are doing, not general use by everyday users. For example, you might want to hide certain VMs because they are cloned VMs that shouldn't be used directly by general users in your environment.
50-
51-
In XenCenter, hidden Networks, PIFs, and VMs can be made visible, using the View menu.

xen-api/xencenter.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: XenCenter
3+
layout: default
4+
---
5+
6+
XenCenter uses some conventions on top of the XenAPI:
7+
8+
Internationalization for SR names
9+
---------------------------------
10+
11+
The SRs created at install time now have an `other_config` key indicating how their names may be internationalized.
12+
13+
`other_config["i18n-key"]` may be one of
14+
15+
- `local-hotplug-cd`
16+
17+
- `local-hotplug-disk`
18+
19+
- `local-storage`
20+
21+
- `xenserver-tools`
22+
23+
Additionally, `other_config["i18n-original-value-<field name>"]` gives the value of that field when the SR was created. If XenCenter sees a record where `SR.name_label` equals `other_config["i18n-original-value-name_label"]` (that is, the record has not changed since it was created during XenServer installation), then internationalization will be applied. In other words, XenCenter will disregard the current contents of that field, and instead use a value appropriate to the user's own language.
24+
25+
If you change `SR.name_label` for your own purpose, then it no longer is the same as `other_config["i18n-original-value-name_label"]`. Therefore, XenCenter does not apply internationalization, and instead preserves your given name.
26+
27+
Hiding objects from XenCenter
28+
-----------------------------
29+
30+
Networks, PIFs, and VMs can be hidden from XenCenter by adding the key `HideFromXenCenter=true` to the `other_config` parameter for the object. This capability is intended for ISVs who know what they are doing, not general use by everyday users. For example, you might want to hide certain VMs because they are cloned VMs that shouldn't be used directly by general users in your environment.
31+
32+
In XenCenter, hidden Networks, PIFs, and VMs can be made visible, using the View menu.

0 commit comments

Comments
 (0)