<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>