NuKVM/xen-orchestra
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

grammar updates v15 (#137)

Browse Source 
* Clarification, update links, organize

* add nfs warning, fix debian version

* add ENOSPC troubleshooting

* add more enospc detail

* add note on editing username

* Documentation typo/grammar cleanup part 9

* grammar cleanup v10

* grammar editing v10

* grammar updates v11

* Grammar updates v11

* Lucky #13 (grammar updates)

* grammar updates v14

* grammar updates v15
This commit is contained in:
Jon Sands
2018-05-25 09:59:31 +02:00
committed by Olivier Lambert
parent 8b06049bf8
commit 0c0fed2484
4 changed files with 28 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/cloudinit.md
+12 -12
View File
@@ -1,20 +1,20 @@
# CloudInit
> CloudInit support is available from 4.11 release
> CloudInit support is available in the 4.11 release and higher
Cloud-init is a program "that handles early initialization of a cloud instance"[^n]. In other words, you can, on a "cloud-init"-ready template VM, pass a lot of data at first boot:
Cloud-init is a program "that handles the early initialization of a cloud instance"[^n]. In other words, you can, on a "cloud-init"-ready template VM, pass a lot of data at first boot:
* setting hostname
* setting the hostname
* add ssh keys
* grow automatically the file system
* automatically grow the file system
* create users
* and a lot more!
This tool is pretty standard and used everywhere. A lot of existing cloud templates are using it.
So it means customizing very easily your VM when you create it from a compatible template. It brings you closer to the "instance" principle, like in Amazon cloud or OpenStack.
So it means very easily customizing your VM when you create it from a compatible template. It brings you closer to the "instance" principle, like in Amazon cloud or OpenStack.
## Requirement
## Requirements
You only need to use a template of a VM with CloudInit installed inside it. [Check this blog post to learn how to install CloudInit](https://xen-orchestra.com/blog/centos-cloud-template-for-xenserver/).
@@ -24,7 +24,7 @@ First, select your compatible template (CloudInit ready) and name it:
![](https://xen-orchestra.com/blog/content/images/2015/12/template_choice.png)
Then, activate the config drive and put your SSH key. Or you can also use a custom CloudInit configuration:
Then, activate the config drive and insert your SSH key. Or you can also use a custom CloudInit configuration:
![](https://xen-orchestra.com/blog/content/images/2016/02/CloudInit.png)
@@ -38,24 +38,24 @@ Finally, create the VM:
![](https://xen-orchestra.com/blog/content/images/2015/12/recap.png)
Now start the VM and SSH on its IP:
Now start the VM and SSH to its IP:
* **the system got the right VM hostname** (from VM name)
* you don't have to use a password to access it (thanks to your SSH key):
* **the system has the right VM hostname** (from VM name)
* you don't need to use a password to access it (thanks to your SSH key):
```
$ ssh centos@192.168.100.226
[centos@tmp-app1 ~]$
```
The default `cloud-init` configuration could allow you to be to be a sudoer directly:
The default `cloud-init` configuration can allow you to be to be a sudoer directly:
```
[centos@tmp-app1 ~]$ sudo -s
[root@tmp-app1 centos]#
```
Check the root file system size: indeed, **it was automatically grown** to what you need:
Check the root file system size: indeed, **it was automatically increased** to what you need:
```
[centos@tmp-app1 ~]$ df -h
docs/health.md
+1 -1
View File
@@ -1,6 +1,6 @@
# Health
This view will help you to find any bottleneck or to compare the metrics of your infrastructure.
This view will help you find any bottlenecks and compare the metrics of your infrastructure.
### Heatmap
docs/self_service.md
+10 -10
View File
@@ -1,10 +1,10 @@
# Self Service
The self-service feature is the possibility for users to create new VMs. That's different from delegating existing resources to them, and it leads to a lot of side-effects.
The self-service feature allows users to create new VMs. This is different from delegating existing resources (VM's) to them, and it leads to a lot of possibilities.
## Set of resources
To create a new set of resources, go inside the "Self Service" section in the main menu:
To create a new set of resources to delegate, go to the "Self Service" section in the main menu:
![](./assets/selfservice_menu.png)
@@ -12,19 +12,19 @@ To create a new set of resources, go inside the "Self Service" section in the ma
> Only an admin can create a set of resources
To allow people creating VMs as they want, we need to give them a *part* of your XenServer resources (disk space, CPUs, RAM). You can call this "general quotas" if you like. But you need first to decide which resources will be used.
To allow people to create VMs as they want, we need to give them a *part* of your XenServer resources (disk space, CPUs, RAM). You can call this "general quotas" if you like. But you first need to decide which resources will be used.
In this example below, we'll create a set called **"sandbox"** with:
* "devs" group could access this set (all users in the group)
* "devs" is the group that can use this set (all users in the group)
* "Lab Pool" is the pool where they can play
* "Debian 8 Cloud Ready" is the only template they could use
* "Debian 8 Cloud Ready" is the only template they can use
* "SSD NFS" is the only SR where they can create VMs
* "Pool-wide network with eth0" is the only available network for them
![](./assets/selfserviceset.png)
As you can see, only compatible hosts are shown and could be used for this resource set (here, hosts in another pools aren't). This way, you can be sure to have resource free for other task than self-service.
As you can see, only compatible hosts are shown and can be used for this resource set (hosts in another pool aren't shown). This way, you can be sure to have resources free for tasks other than self-service.
> Don't forget to add an ISO SR to allow your users to install VMs with CD if necessary
@@ -44,11 +44,11 @@ When you click on create, you can see the resource set and remove or edit it:
## Usage (user side)
As soon a user is inside a resource set, it displays a new button in its main view: "new".
As soon as a user is granted a resource set, it displays a new button in their main view: "new".
![](./assets/selfservice_new_vm.png)
Now, the user can create a VM with only the resources given in the set:
Now, the user can create a VM with only the resources granted in the set:
![](./assets/selfservice_create_vm.png)
@@ -58,7 +58,7 @@ And the recap before creation:
If the "Create" button is disabled, it means the user requested more resources than available.
Finally, if a user is inside many sets, they can be switched in the top right of the screen.
Finally, if a user has been granted access to multiple resource sets, they can be switched in the top right of the screen.
## Toward the Cloud
@@ -69,6 +69,6 @@ Self-service is a major step in the Cloud. Combine it with our [Cloudinit compat
* create a set and put Cloud templates inside
* delegate this set to a group of users
Now, your authorized users can create VMs with their SSH keys, grow template disks if needed. Everything inside a "sandbox" (the set) you defined earlier!
Now, your authorized users can create VMs with their SSH keys, grow template disks if needed, etc. Everything is inside a "sandbox" (the resource set) you defined earlier!
![](https://pbs.twimg.com/media/CYMt2cJUkAAWCPg.png)
docs/visualizations.md
+5 -5
View File
@@ -1,17 +1,17 @@
# Visualizations
Visualizations help you to understand your own XenServer infrastructure, to correlate event and detect bottlenecks.
Visualizations can help you to understand your XenServer infrastructure, as well as correlate events and detect bottlenecks.
### Dashboard
The dashboard is a view gathering information on all your connected pools/hosts.
The dashboard view gathers information on all your connected pools/hosts.
[![](./assets/visualizationdashboard.png)](https://xen-orchestra.com/blog/xen-orchestra-4-4/#dashboard).
> You can also update all your hosts (install missing patches) from this place.
> You can also update all your hosts (install missing patches) from this page.
### Parralel Coordinates
### Parallel Coordinates
A Parallel Coordinates visualization helps a lot to detect proportions in a hierarchical environment. In a XenServer environment, it's especially useful if you seek information in a large amount of data.
A Parallel Coordinates visualization helps to detect proportions in a hierarchical environment. In a XenServer environment, it's especially useful if you want to see useful information from a large amount of data.
[![](./assets/parralelcoordinates.png)](https://xen-orchestra.com/blog/xen-orchestra-4-4/#sunburstvisualizationforvdiandramusage).