Skip to content

Commit 1597b76

Browse files
psafontpsafont
committed
Add 'squeezed/' from commit '1c23bfe2d8284384ad66fa0dedb1583b570369b8'
git-subtree-dir: squeezed git-subtree-mainline: 837d1ce git-subtree-split: 1c23bfe
2 parents 837d1ce + 1c23bfe commit 1597b76

38 files changed

+4661
-0
lines changed

‎squeezed/.gitarchive-info

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
Changeset: $Format:%H$
2+
Commit date: $Format:%cD$

‎squeezed/.gitattributes

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.gitarchive-info export-subst

‎squeezed/.gitignore

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
_build/
2+
.merlin
3+
*.install

‎squeezed/.ocamlformat

+9
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
profile=ocamlformat
2+
version=0.14.1
3+
indicate-multiline-delimiters=closing-on-separate-line
4+
if-then-else=fit-or-vertical
5+
dock-collection-brackets=true
6+
break-struct=natural
7+
break-separators=before
8+
break-infix=fit-or-vertical
9+
break-infix-before-func=false

‎squeezed/.travis.yml

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
language: c
2+
service: docker
3+
install:
4+
- wget https://raw.githubusercontent.com/ocaml/ocaml-ci-scripts/master/.travis-docker.sh
5+
- wget https://raw.githubusercontent.com/xapi-project/xs-opam/master/tools/xs-opam-ci.env
6+
- source xs-opam-ci.env
7+
script: bash -ex .travis-docker.sh
8+
env:
9+
global:
10+
- PINS="xapi-squeezed:."
11+
jobs:
12+
- PACKAGE="xapi-squeezed"

‎squeezed/ChangeLog

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
0.12.1 (22-Jul-2016):
2+
* Bugfixes
3+
* Update to stdext-2.0.0
4+
5+
0.12.0 (14-Aug-2015):
6+
* Remove dependency on Re_str
7+
* Fix FD leak while reading /sysfs
8+
9+
0.11.0 (7-Apr-2015):
10+
* CA-155888: do not clean memory reservation in transfer
11+
* Add lots of documentation
12+
13+
0.10.7 (9-Oct-2014):
14+
* Create a fast-path when there is plenty of memory
15+
* Use a more robust method for discovering domain 0 memory
16+
17+
0.10.6 (30-May-2014):
18+
* Update to stdext 0.11.0
19+
20+
0.10.4 (24-Sep-2013):
21+
* Use new xcp-idl Syslog interface
22+
23+
0.10.2 (10-Sep-2013):
24+
* Update to use the xenstore 1.2.3 interface
25+
26+
0.10.0 (2-Sep-2013):
27+
* Allow managing of domain 0 (enabled via the config file
28+
option 'manage-domain-zero=true'). This is useful if you
29+
want domain 0 to own all memory by default, and only
30+
give it up for starting VMs -- a common developer configuration.
31+
32+
0.9.0 (3-Jun-2013):
33+
* first public release
34+

‎squeezed/INSTALL

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
The simplest way to install is via opam:
2+
3+
opam init
4+
opam remote add xen-org git://github.com/xen-org/opam-repo-dev
5+
opam install squeezed
6+
7+
To build by hand first install dependencies:
8+
9+
* OCaml
10+
* findlib
11+
* stdext
12+
* syslog
13+
* re
14+
* xapi-idl

‎squeezed/LICENSE

+521
Large diffs are not rendered by default.

‎squeezed/MAINTAINERS

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
How to submit changes to this project
2+
=====================================
3+
4+
Please submit changes as pull requests to the repository on github.
5+
Please ensure that all changes have descriptive commit comments and
6+
include a Signed-off-by: line.
7+
8+
Maintainers list
9+
----------------
10+
11+
* David Scott <[email protected]>
12+

‎squeezed/Makefile

+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
.PHONY: release build install uninstall clean test doc format
2+
3+
release:
4+
dune build @install --profile=release
5+
6+
build:
7+
dune build @install
8+
9+
install:
10+
install -D -m 0755 ./_build/default/src/squeezed.exe $(DESTDIR)/squeezed
11+
12+
uninstall:
13+
rm $(DESTDIR)/squeezed
14+
15+
clean:
16+
dune clean
17+
18+
test:
19+
dune runtest --profile=release
20+
21+
# requires odoc
22+
doc:
23+
dune build @doc --profile=release
24+
25+
format:
26+
dune build @fmt --auto-promote

‎squeezed/README.md

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
squeezed: a xen host memory ballooning daemon
2+
---------------------------------------------
3+
4+
Squeezed uses [ballooning](http://static.usenix.org/events/osdi02/tech/full_papers/waldspurger/waldspurger_html/node6.html)
5+
to move memory between running VMs. It is able to:
6+
7+
1. avoid wasting host memory: unused memory can be gifted to VMs
8+
2. share memory according to a configured policy, so some VMs will use more than others
9+
3. "squeeze" existing VMs to make room to start new VMs.
10+
11+
Squeezed is an optional component of the [xapi toolstack](http://wiki.xen.org/wiki/Choice_of_Toolstacks).
12+
13+
building the development version
14+
--------------------------------
15+
16+
First follow the [xenopsd build instructions](http://wiki.xen.org/wiki/Building_Xenopsd): this will ensure your environment is working correctly.
17+
18+
To build squeezed:
19+
20+
git clone git://github.com/xapi-project/squeezed
21+
cd squeezed
22+
./configure
23+
make
24+
25+
There is also a version [packaged in opam](https://opam.ocaml.org/packages/xapi-squeezed/xapi-squeezed.0.10.7/).
26+
27+
documentation
28+
-------------
29+
30+
- [Architecture](doc/architecture/README.md): a high-level overview of Squeezed.
31+
- [Design](doc/design/README.md): discover the low-level details, formats, protocols,
32+
concurrency etc.

‎squeezed/doc/Makefile

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
default:
2+
pdflatex main.tex
3+
pdflatex main.tex
4+

‎squeezed/doc/README.md

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
Squeezed: the developer handbook
2+
===============================
3+
4+
Squeezed is the [xapi-project](http://github.com/xapi-project) host
5+
memory manager (aka balloon driver driver). Squeezed uses ballooning
6+
to move memory between running VMs, to avoid wasting host memory.
7+
8+
Principles
9+
----------
10+
11+
1. avoid wasting host memory: unused memory should be put to use by returning
12+
it to VMs
13+
2. memory should be shared in proportion to the configured policy
14+
3. operate entirely at the level of domains (not VMs), and be independent of
15+
Xen toolstack
16+
17+
Contents
18+
--------
19+
- [Architecture](architecture/README.md): a high-level overview of Squeezed.
20+
- [Design](design/README.md): discover the low-level details, formats, protocols,
21+
concurrency etc.

‎squeezed/doc/architecture/README.md

+36
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
Squeezed architecture
2+
=====================
3+
4+
Squeezed is responsible for managing the memory on a single host. Squeezed
5+
"balances" memory between VMs according to a policy written to Xenstore.
6+
7+
The following diagram shows the internals of Squeezed:
8+
9+
![Internals of squeezed](http://xapi-project.github.io/squeezed/doc/architecture/squeezed.png)
10+
11+
At the center of squeezed is an abstract model of a Xen host. The model includes
12+
- the amount of already-used host memory (used by fixed overheads such as Xen
13+
and the crash kernel)
14+
- per-domain memory policy specifically ```dynamic-min``` and ```dynamic-max``` which
15+
together describe a range, within which the domain's actual used memory should remain
16+
- per-domain calibration data which allows us to compute the necessary balloon target
17+
value to achive a particular memory usage value.
18+
19+
Squeezed is a single-threaded program which receives commands from
20+
[Xenopsd](https://github.com/xapi-project/xenopsd) over a Unix domain socket.
21+
When Xenopsd wishes to start a new VM, squeezed will be asked to create a "reservation".
22+
Note this is different to the Xen notion of a reservation. A squeezed reservation consists
23+
of an amount of memory squeezed will guarantee to keep free labelled with an id.
24+
When Xenopsd later creates the domain to notionally use the reservation, the reservation
25+
is "transferred" to the domain before the domain is built.
26+
27+
Squeezed will also wake up every 30s and attempt to rebalance the memory on a host. This
28+
is useful to correct imbalances caused by balloon drivers temporarily failing to reach
29+
their targets. Note that ballooning is fundamentally a co-operative process, so squeezed
30+
must handle cases where the domains refuse to obey commands.
31+
32+
The "output" of squeezed is a list of "actions" which include:
33+
- set domain x's ```memory/target``` to a new value
34+
- set the ```maxmem``` of a domain to a new value (as a hard limit beyond which the domain
35+
cannot allocate)
36+

0 commit comments

Comments
 (0)