<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
p
{mso-style-priority:99;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">A new CLI command called host-fs has been introduced to enable resizing of filesystems on a specific host. Changes were also made to the controllerfs API.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><a href="https://bugs.launchpad.net/starlingx/+bug/1830142">https://bugs.launchpad.net/starlingx/+bug/1830142</a><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b><span style="font-size:14.0pt">Previously<o:p></o:p></span></b></p>
<p class="MsoNormal">Previously we allowed resizing of our filesystems through the controllerfs API, which only applied to controller hosts. The controllerfs API modified the following filesystems;
<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none">- <b>drbd replicated</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> database<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> docker-distribution<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> etcd<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> extension<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> glance<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"><o:p> </o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none">- <b>non replicated</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> backup<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> docker
<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none"> scratch<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b><span style="font-size:14.0pt">New host-fs API<o:p></o:p></span></b></p>
<p class="MsoNormal" style="text-autospace:none">A new host-fs API has been created to allow a filesystem to be resized on any specific host. The non drbd filesystems from controllerfs (backup, docker and scratch) have been moved to the new host-fs API. Also
a new filesystem called "kublet" has been created on all hosts with a default size of 10G.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal" style="text-autospace:none">The new API has the following CLI commands
<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none">system host-fs-list <hostname or id><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none">system host-fs-modify <hostname or id> <fs_name=size> [<fs_name=size> ...]<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in;text-autospace:none">system host-host-show <hostname or id> <fs name or uuid> <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">system host-fs-list controller-1</span><span style="font-size:8.0pt;font-family:"Calibri",sans-serif;color:black"><o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| UUID | FS Name | Size in GiB | Logical Volume |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| a4d83571-a555-4ba5-999f-af709206ae35 | backup | 40 | backup-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| d57652a1-af17-47b8-b941-9ebfeee4a56f | docker | 30 | docker-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| a84374c6-8917-4db5-bd34-2a8d244f2bf6 | kubelet | 10 | kubelet-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| 2c026d6f-5c03-4135-abca-c0047aa7f5a6 | scratch | 8 | scratch-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black"> <o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">system host-fs-list compute-1<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| UUID | FS Name | Size in GiB | Logical Volume |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| 32e8b0b2-8a26-4c87-ae2e-71477b276740 | docker | 30 | docker-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| 223671f7-aed0-4c6e-b1d2-1327aae74439 | kubelet | 10 | kubelet-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| 36b96d05-febb-411b-a290-abdc5a2be0ff | scratch | 4 | scratch-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black"> <o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">system host-fs-show controller-1 a4d83571-a555-4ba5-999f-af709206ae35<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+----------------+--------------------------------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| Property | Value |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+----------------+--------------------------------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| uuid | a4d83571-a555-4ba5-999f-af709206ae35 |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| name | backup |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| size | 40 |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| logical_volume | backup-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| created_at | 2019-08-08T03:05:25.341669+00:00 |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| updated_at | None |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+----------------+--------------------------------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black"> <o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">system host-fs-modify controller-1 docker=31 kubelet=11<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| UUID | FS Name | Size in GiB | Logical Volume |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| a4d83571-a555-4ba5-999f-af709206ae35 | backup | 40 | backup-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| d57652a1-af17-47b8-b941-9ebfeee4a56f | docker | 31 | docker-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| a84374c6-8917-4db5-bd34-2a8d244f2bf6 | kubelet | 11 | kubelet-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">| 2c026d6f-5c03-4135-abca-c0047aa7f5a6 | scratch | 8 | scratch-lv |<o:p></o:p></span></p>
<p style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:0in;margin-left:.5in;margin-bottom:.0001pt">
<span style="font-size:8.0pt;font-family:"Courier New";color:black">+--------------------------------------+---------+-------------+----------------+<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal" style="text-autospace:none"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal" style="text-autospace:none"><b>Filesystem Supported Hosts Folder Logical Volume Default Size</b>
<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">backup controller /opt/backups backup-lv 40G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">scratch all hosts /scratch scratch-lv varies depending on system, configured in kickstart<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">docker all hosts /var/lib/docker docker-lv 30G (new fs to worker and storage hosts)<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">kublet all hosts /var/lib/kublet kublet-lv 10G (new fs to all hosts)<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none"><o:p> </o:p></p>
<p class="MsoNormal" style="text-autospace:none"><o:p> </o:p></p>
<p class="MsoNormal" style="text-autospace:none"><b><span style="font-size:14.0pt">Changes to controllerfs API<o:p></o:p></span></b></p>
<p class="MsoNormal" style="text-autospace:none">The existing “platform” filesystem is now resizable and added to controllerfs. The “glance” filesystem is now merged into platform. Below are the new filesystems resizable by controllerfs. The backup, docker
and scratch filesystems are now resizable under host-fs.<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none"><span style="font-family:"Courier New""><o:p> </o:p></span></p>
<p class="MsoNormal" style="text-autospace:none"><b>Filesystem Folder Logical Volume Default Size</b>
<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">database /var/lib/postgresql pgsql-lv 40G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">docker-distribution /var/lib/docker-distribution dockerdistribution-lv 16G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">etcd /opt/etcd etcd-lv 5G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none">extension /opt/extension extension-lv 1G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none"><s>glance /opt/cgcs cgcs-lv 20g (removed and merged with platform)<o:p></o:p></s></p>
<p class="MsoNormal" style="text-autospace:none">platform /opt/platform platform-lv 10G<o:p></o:p></p>
<p class="MsoNormal" style="text-autospace:none"><s>backup /opt/backups backup-lv managed by host-fs<o:p></o:p></s></p>
<p class="MsoNormal" style="text-autospace:none"><s>scratch /scratch scratch-lv managed by host-fs<o:p></o:p></s></p>
<p class="MsoNormal" style="text-autospace:none"><s>docker /var/lib/docker docker-lv managed by host-fs<o:p></o:p></s></p>
<p class="MsoNormal" style="text-autospace:none"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks,<o:p></o:p></p>
<p class="MsoNormal">Kristine <o:p></o:p></p>
</div>
</body>
</html>