Acronis Cyber
Infrastructure 3.0
Administrator’s Command Line Guide
November 20, 2019
Copyright Statement
Copyright ©Acronis International GmbH, 2002-2019. All rights reserved.
”Acronis” and ”Acronis Secure Zone” are registered trademarks of Acronis International GmbH.
”Acronis Compute with Confidence”, ”Acronis Startup Recovery Manager”, ”Acronis Instant Restore”, and the Acronis logo are trademarks of Acronis
International GmbH.
Linux is a registered trademark of Linus Torvalds.
VMware and VMware Ready are trademarks and/or registered trademarks of VMware, Inc. in the United States and/or other jurisdictions.
Windows and MS-DOS are registered trademarks of Microsoft Corporation.
All other trademarks and copyrights referred to are the property of their respective owners.
Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder.
Distribution of this work or derivative work in any standard (paper) book form for commercial purposes is prohibited unless prior permission is
obtained from the copyright holder.
DOCUMENTATION IS PROVIDED ”AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT
SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Third party code may be provided with the Software and/or Service. The license terms for such third-parties are detailed in the license.txt file located in
the root installation directory. You can always find the latest up-to-date list of the third party code and the associated license terms used with the
Software and/or Service at http://kb.acronis.com/content/7696 .
Acronis patented technologies
Technologies, used in this product, are covered and protected by one or more U.S. Patent Numbers: 7,047,380; 7,246,211; 7,275,139; 7,281,104;
7,318,135; 7,353,355; 7,366,859; 7,383,327; 7,475,282; 7,603,533; 7,636,824; 7,650,473; 7,721,138; 7,779,221; 7,831,789; 7,836,053; 7,886,120; 7,895,403;
7,934,064; 7,937,612; 7,941,510; 7,949,635; 7,953,948; 7,979,690; 8,005,797; 8,051,044; 8,069,320; 8,073,815; 8,074,035; 8,074,276; 8,145,607; 8,180,984;
8,225,133; 8,261,035; 8,296,264; 8,312,259; 8,347,137; 8,484,427; 8,645,748; 8,732,121; 8,850,060; 8,856,927; 8,996,830; 9,213,697; 9,400,886; 9,424,678;
9,436,558; 9,471,441; 9,501,234; and patent pending applications.
Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 Providing Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Managing Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Managing Storage Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.1 Managing Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.1.1 vinfra node token show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.1.2 vinfra node token create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.1.3 vinfra node token validate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 Managing Traffic Types and Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2.1 vinfra cluster traffic-type create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2.2 vinfra cluster traffic-type list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2.3 vinfra cluster traffic-type show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.4 vinfra cluster traffic-type set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.5 vinfra cluster traffic-type delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2.6 vinfra cluster network create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2.7 vinfra cluster network list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2.8 vinfra cluster network show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2.9 vinfra cluster network set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.2.10 vinfra cluster network set-bulk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2.11 vinfra cluster network delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3 Managing Storage Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.1 vinfra node join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.2 vinfra node list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.3 vinfra node show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.4 vinfra node release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.5 vinfra node forget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
i
2.4 Managing Node Network Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4.1 vinfra node iface list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4.2 vinfra node iface show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4.3 vinfra node iface up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.4.4 vinfra node iface down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.4.5 vinfra node iface set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4.6 vinfra node iface create-bond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.4.7 vinfra node iface create-vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.4.8 vinfra node iface delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.5 Managing Node Disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.5.1 vinfra node disk list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.5.2 vinfra node disk show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
2.5.3 vinfra node disk assign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.5.4 vinfra node disk release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
2.5.5 vinfra node disk blink on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2.5.6 vinfra node disk blink off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.5.7 vinfra node iscsi target add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.5.8 vinfra node iscsi target delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.6 Creating and Deleting the Storage Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.6.1 vinfra cluster create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.6.2 vinfra cluster delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2.7 Showing Storage Cluster Overview and Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2.7.1 vinfra cluster overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2.7.2 vinfra cluster show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3. Managing Compute Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.1 Creating and Deleting the Compute Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.1.1 vinfra service compute create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.1.2 vinfra service compute delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.2 Showing Compute Cluster Details and Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.2.1 vinfra service compute show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.2.2 vinfra service compute stat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
3.3 Changing Compute Cluster Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
3.4 Managing Compute Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.4.1 vinfra service compute node add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.4.2 vinfra service compute node list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
ii
3.4.3 vinfra service compute node show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
3.4.4 vinfra service compute node fence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.4.5 vinfra service compute node unfence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.4.6 vinfra service compute node release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.5 Managing Virtual Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.5.1 vinfra service compute network create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.5.2 vinfra service compute network list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.5.3 vinfra service compute network show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.5.4 vinfra service compute network set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.5.5 vinfra service compute network delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
3.6 Managing Virtual Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
3.6.1 vinfra service compute router create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
3.6.2 vinfra service compute router list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
3.6.3 vinfra service compute router show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.6.4 vinfra service compute router set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.6.5 vinfra service compute router iface add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
3.6.6 vinfra service compute router iface list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
3.6.7 vinfra service compute router iface remove . . . . . . . . . . . . . . . . . . . . . . . . . . 61
3.6.8 vinfra service compute router delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
3.7 Managing Floating IP Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
3.7.1 vinfra service compute floatingip create . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
3.7.2 vinfra service compute floatingip list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
3.7.3 vinfra service compute floatingip show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
3.7.4 vinfra service compute floatingip set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
3.7.5 vinfra service compute floatingip delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
3.8 Managing Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
3.8.1 vinfra service compute image create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
3.8.2 vinfra service compute image list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
3.8.3 vinfra service compute image show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
3.8.4 vinfra service compute image set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
3.8.5 vinfra service compute image save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
3.8.6 vinfra service compute image delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
3.9 Managing Flavors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
3.9.1 vinfra service compute flavor create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
3.9.2 vinfra service compute flavor list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
iii
3.9.3 vinfra service compute flavor show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
3.9.4 vinfra service compute flavor delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3.10 Managing Storage Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3.10.1 vinfra cluster storage-policy create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3.10.2 vinfra cluster storage-policy list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
3.10.3 vinfra cluster storage-policy show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
3.10.4 vinfra cluster storage-policy set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
3.10.5 vinfra cluster storage-policy delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
3.11 Managing Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
3.11.1 vinfra service compute volume create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
3.11.2 vinfra service compute volume list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
3.11.3 vinfra service compute volume show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
3.11.4 vinfra service compute volume set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3.11.5 vinfra service compute volume extend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
3.11.6 vinfra service compute volume delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.12 Managing Volume Snapshots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.12.1 vinfra service compute volume snapshot create . . . . . . . . . . . . . . . . . . . . . . . . 81
3.12.2 vinfra service compute volume snapshot list . . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.12.3 vinfra service compute volume snapshot show . . . . . . . . . . . . . . . . . . . . . . . . 82
3.12.4 vinfra service compute volume snapshot set . . . . . . . . . . . . . . . . . . . . . . . . . . 83
3.12.5 vinfra service compute volume snapshot upload-to-image . . . . . . . . . . . . . . . . . 84
3.12.6 vinfra service compute volume snapshot revert . . . . . . . . . . . . . . . . . . . . . . . . 84
3.12.7 vinfra service compute volume snapshot reset-state . . . . . . . . . . . . . . . . . . . . . 85
3.12.8 vinfra service compute volume snapshot delete . . . . . . . . . . . . . . . . . . . . . . . . 86
3.13 Managing Compute SSH Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3.13.1 vinfra service compute key create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3.13.2 vinfra service compute key list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
3.13.3 vinfra service compute key show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
3.13.4 vinfra service compute key delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3.14 Managing Virtual Machines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3.14.1 vinfra service compute server create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3.14.2 vinfra service compute server list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
3.14.3 vinfra service compute server show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
3.14.4 vinfra service compute server stat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
3.14.5 vinfra service compute server set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
iv
3.14.6 vinfra service compute server iface attach . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
3.14.7 vinfra service compute server iface list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
3.14.8 vinfra service compute server iface detach . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
3.14.9 vinfra service compute server volume attach . . . . . . . . . . . . . . . . . . . . . . . . . 96
3.14.10 vinfra service compute server volume list . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
3.14.11 vinfra service compute server volume show . . . . . . . . . . . . . . . . . . . . . . . . . . 97
3.14.12 vinfra service compute server volume detach . . . . . . . . . . . . . . . . . . . . . . . . . 97
3.14.13 vinfra service compute server log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.14.14 vinfra service compute server migrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.14.15 vinfra service compute server resize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
3.14.16 vinfra service compute server start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
3.14.17 vinfra service compute server pause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
3.14.18 vinfra service compute server unpause . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
3.14.19 vinfra service compute server suspend . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
3.14.20 vinfra service compute server resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
3.14.21 vinfra service compute server reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
3.14.22 vinfra service compute server reset-state . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
3.14.23 vinfra service compute server stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
3.14.24 vinfra service compute server shelve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.14.25 vinfra service compute server unshelve . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
3.14.26 vinfra service compute server evacuate . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
3.14.27 vinfra service compute server delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
4. Managing General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
4.1 Managing Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
4.1.1 vinfra cluster license load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
4.1.2 vinfra cluster license show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
4.2 Managing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
4.2.1 vinfra domain create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
4.2.2 vinfra domain list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
4.2.3 vinfra domain show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
4.2.4 vinfra domain set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108
4.2.5 vinfra domain delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
4.3 Managing Domain Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
4.3.1 vinfra domain user create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
4.3.2 vinfra domain user list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
v
4.3.3 vinfra domain user show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
4.3.4 vinfra domain user set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
4.3.5 vinfra domain user delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
4.4 Managing Domain Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
4.4.1 vinfra domain project create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
4.4.2 vinfra domain project list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
4.4.3 vinfra domain project show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
4.4.4 vinfra domain project set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
4.4.5 vinfra domain project user list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
4.4.6 vinfra domain project user remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
4.4.7 vinfra domain project delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
4.5 Managing SSH Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
4.5.1 vinfra cluster sshkey add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
4.5.2 vinfra cluster sshkey list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
4.5.3 vinfra cluster sshkey delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.6 Managing External DNS Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
4.6.1 vinfra cluster settings dns show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
4.6.2 vinfra cluster settings dns set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
4.7 Configuring Management Node High Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
4.7.1 vinfra cluster ha create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
4.7.2 vinfra cluster ha update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
4.7.3 vinfra cluster ha show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
4.7.4 vinfra cluster ha delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
4.8 Managing Storage Tier Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.8.1 vinfra cluster settings encryption show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.8.2 vinfra cluster settings encryption set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
4.9 Managing Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
4.9.1 vinfra cluster alert list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
4.9.2 vinfra cluster alert show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.9.3 vinfra cluster alert delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
4.10 Managing Audit Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
4.10.1 vinfra cluster auditlog list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
4.10.2 vinfra cluster auditlog show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
4.11 Sending Problem Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
5. Monitoring Storage Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
vi
5.1 Monitoring General Storage Cluster Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
5.2 Monitoring Metadata Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
5.3 Monitoring Chunk Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
5.3.1 Understanding Disk Space Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140
5.3.1.1 Understanding Allocatable Disk Space . . . . . . . . . . . . . . . . . . . . . . .142
5.3.1.2 Viewing Space Occupied by Data Chunks . . . . . . . . . . . . . . . . . . . . . .143
5.3.2 Exploring Chunk States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
5.4 Monitoring Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
5.5 Monitoring Physical Disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
5.6 Monitoring Event Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
5.7 Monitoring Replication Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
6. Accessing Storage Clusters via iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
6.1 iSCSI Workflow Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
6.1.1 Managing Legacy iSCSI Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
6.2 Configuring CLI Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
6.3 Managing Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157
6.3.1 Creating Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
6.3.2 Starting and Stopping Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
6.3.3 Listing Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
6.3.4 Printing Details of Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
6.3.5 Deleting Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
6.4 Managing iSCSI Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
6.4.1 Creating iSCSI Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
6.4.2 Listing and Printing Details of iSCSI Volumes . . . . . . . . . . . . . . . . . . . . . . . . . .161
6.4.3 Attaching iSCSI Volumes to Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . .161
6.4.4 Viewing and Setting iSCSI Volume Parameters . . . . . . . . . . . . . . . . . . . . . . . . .162
6.4.5 Increasing iSCSI Volume Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
6.4.6 Setting iSCSI Volume Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
6.4.7 Detaching iSCSI Volumes from Target Groups . . . . . . . . . . . . . . . . . . . . . . . . .162
6.4.8 Deleting iSCSI Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
6.5 Managing Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
6.5.1 Adding Nodes to Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
6.5.2 Setting Node Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
6.5.3 Deleting Nodes from Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
6.6 Managing Targets and Portals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
vii
6.6.1 Creating Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
6.6.2 Adding and Removing Target Portals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
6.6.3 Deleting Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
6.7 Managing CHAP Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
6.7.1 Creating and Listing CHAP Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
6.7.2 Changing CHAP Account Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
6.7.3 Assigning CHAP Accounts to Target Groups . . . . . . . . . . . . . . . . . . . . . . . . . .167
6.7.4 Deleting CHAP Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
6.8 Managing LUN Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
6.8.1 Creating LUN Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
6.8.2 Listing LUN Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
6.8.3 Changing LUN View Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
6.8.4 Deleting LUN Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
7. Advanced Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
7.1 Updating Kernel with ReadyKernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
7.1.1 Installing ReadyKernel Patches Automatically . . . . . . . . . . . . . . . . . . . . . . . . .171
7.1.2 Managing ReadyKernel Patches Manually . . . . . . . . . . . . . . . . . . . . . . . . . . .171
7.1.2.1 Downloading, Installing, and Loading ReadyKernel Patches . . . . . . . . . . .171
7.1.2.2 Loading and Unloading ReadyKernel Patches . . . . . . . . . . . . . . . . . . .171
7.1.2.3 Installing and Removing ReadyKernel Patches for Specific Kernels . . . . . . . 172
7.1.2.4 Downgrading ReadyKernel Patches . . . . . . . . . . . . . . . . . . . . . . . . .172
7.1.2.5 Disabling Loading of ReadyKernel Patches on Boot . . . . . . . . . . . . . . . .173
7.1.2.6 Managing ReadyKernel Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
7.2 Managing Guest Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
7.2.1 Installing Guest Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
7.2.1.1 Installing Guest Tools in New VMs . . . . . . . . . . . . . . . . . . . . . . . . . .174
7.2.1.2 Installing Guest Tools in Existing VMs . . . . . . . . . . . . . . . . . . . . . . . .175
7.2.2 Uninstalling Guest Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
7.2.2.1 Uninstalling Guest Tools from Linux VMs . . . . . . . . . . . . . . . . . . . . . .177
7.2.2.2 Uninstalling Guest Tools from Windows VMs . . . . . . . . . . . . . . . . . . . 177
7.3 Running Commands in Virtual Machines without Network Connectivity . . . . . . . . . . . . . . . 178
7.3.1 Running Commands in Linux Virtual Machines . . . . . . . . . . . . . . . . . . . . . . . .178
7.3.2 Running Commands in Windows Virtual Machines . . . . . . . . . . . . . . . . . . . . . .179
7.4 Setting Virtual Machines CPU Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
7.5 Creating Linux Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
viii
7.6 Creating SSH-Enabled Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
7.6.1 Creating SSH-Enabled Linux Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
7.6.2 Creating SSH-Enabled Windows Templates . . . . . . . . . . . . . . . . . . . . . . . . . . .182
7.7 Securing OpenStack API Traffic with SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
7.8 Enabling Metering for Compute Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
7.9 Configuring Memory Policy for Storage Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
7.9.1 vinfra memory-policy vstorage-services per-cluster change . . . . . . . . . . . . . . . . .191
7.9.2 vinfra memory-policy vstorage-services per-cluster show . . . . . . . . . . . . . . . . . .192
7.9.3 vinfra memory-policy vstorage-services per-cluster reset . . . . . . . . . . . . . . . . . .192
7.9.4 vinfra memory-policy vstorage-services per-node change . . . . . . . . . . . . . . . . . .193
7.9.5 vinfra memory-policy vstorage-services per-node show . . . . . . . . . . . . . . . . . . . 194
7.9.6 vinfra memory-policy vstorage-services per-node reset . . . . . . . . . . . . . . . . . . .195
ix
CHAPTER 1
Introduction
This guide describes the syntax and parameters of the vinfra command-line tool that can be used to manage
Acronis Cyber Infrastructure from console and automate such management tasks.
Note: While the following chapters provide information on specific operations that you can perform with
vinfra , you can also run vinfra help to get a list of all supported commands and their descriptions. For help
on a specific command, either run vinfra help <command> or vinfra <command> --help .
In addition, this guide describes how to use the command line to perform operations unsupported by vinfra
as of now.
Note that the following operations should not be done from the command line:
• setting custom paths for Acronis Cyber Infrastructure services, in particular:
•
creating S3 clusters only in /mnt/vstorage/vols/s3
•
creating iSCSI targets only in /mnt/vstorage/vols/iscsi
• mounting clusters or change cluster mount options
• configuring firewall with firewall-cmd
• renaming network connections
• managing MDS/CS
• managing partitions, LVMs, or software RAID
• modifying files in /mnt/vstorage/vols and /mnt/vstorage/webcp/backup directories
1
Chapter 1. Introduction
• setting encoding or replication of cluster root
1.1 Providing Credentials
The vinfra CLI tool requires the following information:
• IP address or hostname of the management node (set to backend-api.svc.vstoragedomain by default).
• Username (admin by default).
• Password (created during installation of Acronis Cyber Infrastructure).
This information can be supplied via the --vinfra-portal , --vinfra-username , and --vinfra-password
command-line parameters with each command. Alternatively, you can supply it by setting the environment
variables VINFRA_PORTAL , VINFRA_USERNAME , and VINFRA_PASSWORD (e.g., in your ~/.bash_profile ). In this case,
you will be able to run the CLI tool without the aforementioned command-line parameters.
As you typically run vinfra from the management node as admin, the only variable you usually need to set is
the password. For example:
# export VINFRA_PASSWORD=12345
If you installed vinfra on a remote machine and/or run it as a different user, you will need to set
VINFRA_PORTAL and/or VINFRA_USERNAME on that machine in addition to VINFRA_PASSWORD.
1.2 Managing Tasks
The vinfra CLI tool executes some commands immediately, while for other commands (that may take some
time to complete) it creates system tasks that are queued. Examples of actions performed via tasks are
creating the storage or compute cluster and adding nodes to it.
To keep track of tasks being performed by vinfra , use the vinfra task list and vinfra task show
commands. For example:
# vinfra task list
+--------------------------------------+---------+-----------------------------------------+
| task_id | state | name |
+--------------------------------------+---------+-----------------------------------------+
| 8fc27e7a-ba73-471d-9134-e351e1137cf4 | success | backend.tasks.cluster.CreateNewCluster |
| e61377db-9df4-4282-99aa-6a4ae73a7f96 | success | backend.tasks.disks.ApplyDiskRoleTask |
| a005b748-cb85-40f8-a09d-291a8599bb9c | success | backend.tasks.node.AddNodeInClusterTask |
2
Chapter 1. Introduction
+--------------------------------------+---------+-----------------------------------------+
# vinfra task show 8fc27e7a-ba73-471d-9134-e351e1137cf4
+---------+----------------------------------------+
| Field | Value |
+---------+----------------------------------------+
| args | - stor1 |
| | - 7ffa9540-5a20-41d1-b203-e3f349d62565 |
| | - null |
| | - null |
| kwargs | {} |
| name | backend.tasks.cluster.CreateNewCluster |
| result | cluster_id: 1 |
| state | success |
| task_id | 8fc27e7a-ba73-471d-9134-e351e1137cf4 |
+---------+----------------------------------------+
3
CHAPTER 2
Managing Storage Cluster
2.1 Managing Tokens
2.1.1 vinfra node token show
Display the backend token:
usage: vinfra node token show
Example:
# vinfra node token show
+-------+---------------+
| Field | Value |
+-------+---------------+
| host | 10.37.130.101 |
| token | dc56d4d2 |
| ttl | 86398 |
+-------+---------------+
This command shows the details of the current token.
2.1.2 vinfra node token create
Create the backend token:
usage: vinfra node token create [--ttl <ttl>]
--ttl <ttl>
Token TTL, in seconds
4
Chapter 2. Managing Storage Cluster
Example:
# vinfra node token create --ttl 86400
+-------+---------------+
| Field | Value |
+-------+---------------+
| host | 10.37.130.101 |
| token | dc56d4d2 |
| ttl | 86398 |
+-------+---------------+
This command creates a new token with the time to live (TTL) of 86400 seconds.
2.1.3 vinfra node token validate
Validate the backend token:
usage: vinfra node token validate <token>
<token>
Token value
Example:
# vinfra node token validate dc56d4d2
+--------+-------+
| Field | Value |
+--------+-------+
| status | valid |
+--------+-------+
This command validates the token dc56d4d2.
2.2 Managing Traffic Types and Networks
2.2.1 vinfra cluster traffic-type create
Create a new traffic type:
usage: vinfra cluster traffic-type create --port <port> <traffic-type-name>
--port <port>
Traffic type port
5
<traffic-type-name>
Traffic type name
Example:
# vinfra cluster traffic-type create "MyTrafficType" --port 6900
+-----------+-----------------+
| Field | Value |
+-----------+-----------------+
| exclusive | False |
| name | MyTrafficType |
| port | 6900 |
| type | custom |
+-----------+-----------------+
This command creates a custom traffic type MyTrafficType on port 6900.
2.2.2 vinfra cluster traffic-type list
Chapter 2. Managing Storage Cluster
List available traffic types:
usage: vinfra cluster traffic-type list
Example:
# vinfra cluster traffic-type list
+---------------------+------------+-----------+------+
| name | type | exclusive | port |
+---------------------+------------+-----------+------+
| Storage | predefined | True | |
| Internal management | predefined | True | |
| OSTOR private | predefined | True | |
| S3 public | predefined | False | |
| iSCSI | predefined | False | |
| NFS | predefined | False | |
| ABGW private | predefined | True | |
| ABGW public | predefined | False | |
| Admin panel | predefined | False | |
| SSH | predefined | False | |
| VM public | predefined | False | |
| VM private | predefined | True | |
| Compute API | predefined | True | |
| MyTrafficType | custom | False | 6900 |
+---------------------+------------+-----------+------+
This command lists all traffic types in Acronis Cyber Infrastructure.
6
2.2.3 vinfra cluster traffic-type show
Show details of a traffic type:
usage: vinfra cluster traffic-type show <traffic-type>
<traffic-type>
Traffic type name
Example:
# vinfra cluster traffic-type show Storage
+-----------+------------+
| Field | Value |
+-----------+------------+
| exclusive | True |
| name | Storage |
| port | |
| type | predefined |
+-----------+------------+
Chapter 2. Managing Storage Cluster
This command shows the details of the traffic type Storage .
2.2.4 vinfra cluster traffic-type set
Modify traffic type parameters:
usage: vinfra cluster traffic-type set [--name <name>] [--port <port>] <traffic-type>
--name <name>
A new name for the traffic type
--port <port>
A new port for the traffic type
<traffic-type>
Traffic type name
Example:
# vinfra cluster traffic-type set "MyTrafficType" \
--name "MyOtherTrafficType" --port 6901
+-----------+--------------------+
| Field | Value |
+-----------+--------------------+
| exclusive | False |
7
Chapter 2. Managing Storage Cluster
| name | MyOtherTrafficType |
| port | 6901 |
| type | custom |
+-----------+--------------------+
This command renames the traffic type MyTrafficType to MyOtherTrafficType and changes its port to 6901.
2.2.5 vinfra cluster traffic-type delete
Delete a traffic type:
usage: vinfra cluster traffic-type delete <traffic-type>
<traffic-type>
Traffic type name
Example:
# vinfra cluster traffic-type delete "MyOtherTrafficType"
Operation successful
This command deletes the custom traffic type MyOtherTrafficType.
2.2.6 vinfra cluster network create
Create a new network:
usage: vinfra cluster network create [--traffic-types <traffic-types>] <network-name>
--traffic-types <traffic-types>
A comma-separated list of traffic type IDs or names
<network-name>
Network name
Example:
# vinfra cluster network create MyNet --traffic-types ssh
+-------+--------------------------------------+
| Field | Value |
+-------+--------------------------------------+
| id | 03d5eeb3-1833-4626-885d-dd066635f5de |
| name | MyNet |
| roles | - SSH |
| type | Custom |
8
Chapter 2. Managing Storage Cluster
+-------+--------------------------------------+
This command creates a custom network MyNet and assigns the traffic type SSH to it.
2.2.7 vinfra cluster network list
List available networks:
usage: vinfra cluster network list
Example:
# vinfra cluster network list
+--------------------------------------+---------+-----------------------+
| id | name | roles |
+--------------------------------------+---------+-----------------------+
| 358bdc39-cd8b-4565-8ebf-e7c12dcd1cf7 | Public | - ABGW public |
| | | - iSCSI |
| | | - NFS |
| | | - S3 public |
| | | - SSH |
| | | - Admin Panel |
| 6095a997-e5f1-493d-a750-41ddf277153b | Private | - ABGW private |
| | | - Internal Management |
| | | - OSTOR private |
| | | - SSH |
| | | - Storage |
+--------------------------------------+---------+-----------------------+
This command lists all networks in Acronis Cyber Infrastructure.
2.2.8 vinfra cluster network show
Show details of a network:
usage: vinfra cluster network show <network>
<network>
Network ID or name
Example:
# vinfra cluster network show MyNet
+-------+--------------------------------------+
| Field | Value |
+-------+--------------------------------------+
9
| id | 03d5eeb3-1833-4626-885d-dd066635f5de |
| name | MyNet |
| roles | - SSH |
| type | Custom |
+-------+--------------------------------------+
This command shows the details of the custom network MyNet.
2.2.9 vinfra cluster network set
Modify network parameters:
usage: vinfra cluster network set [--name <network-name>]
[--traffic-types <traffic-types> |
--add-traffic-types <traffic-types> |
--del-traffic-types <traffic-types>]
<network>
Chapter 2. Managing Storage Cluster
--name <network-name>
Network name
--traffic-types <traffic-types>
A comma-separated list of traffic type names (overwrites network’s current traffic types)
--add-traffic-types <traffic-types>
A comma-separated list of traffic type names (adds the specified traffic types to the network)
--del-traffic-types <traffic-types>
A comma-separated list of traffic type names (removes the specified traffic types from the network)
<network>
Network ID or name
Example:
# vinfra cluster network set MyNet --name MyOtherNet --add-traffic-types iscsi,nfs
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| task_id | b29f6f66-37d7-47de-b02e-9f4087ad932b |
+---------+--------------------------------------+
This command creates a task to rename the network MyNet to MyOtherNet and assign to it the traffic types
iSCSI and NFS.
Task outcome:
10
Chapter 2. Managing Storage Cluster
# vinfra task show b29f6f66-37d7-47de-b02e-9f4087ad932b
+---------+-------------------------------------------------------------+
| Field | Value |
+---------+-------------------------------------------------------------+
| args | - 03d5eeb3-1833-4626-885d-dd066635f5de |
| kwargs | name: MyOtherNet
| | roles: |
| | - ssh |
| | - iscsi |
| | - nfs |
| name | backend.presentation.network.roles.tasks.RolesSetChangeTask |
| result | id: 03d5eeb3-1833-4626-885d-dd066635f5de
| | name: MyOtherNet |
| | roles: |
| | - iSCSI |
| | - NFS |
| | - SSH |
|
| state | success |
| task_id | b29f6f66-37d7-47de-b02e-9f4087ad932b |
+---------+-------------------------------------------------------------+
| type: Custom
|
|
|
2.2.10 vinfra cluster network set-bulk
Modify traffic types of multiple networks:
usage: vinfra cluster network set-bulk --network <network>:<traffic-types>
--network <network>:<traffic-types>
Network configuration in the format:
• <network> : network ID or name.
• <traffic-types> : a comma-separated list of traffic type names (this option can be used multiple
times).
Example:
# vinfra cluster network set-bulk --network MyNet1:snmp --network MyNet2:ssh,snmp
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| task_id | c774f55d-c45b-42cd-ac9e-16fc196e9283 |
+---------+--------------------------------------+
This command creates a task to change the traffic type set of the network MyNet1 to SNMP and that of MyNet2 to
SSH and SNMP.
11
Chapter 2. Managing Storage Cluster
Task outcome:
# vinfra task show c774f55d-c45b-42cd-ac9e-16fc196e9283
+---------+-----------------------------------------------------------------+
| Field | Value |
+---------+-----------------------------------------------------------------+
| details | |
| name | backend.presentation.network.roles.tasks.RolesSetBulkChangeTask |
| result | - id: adf49487-9deb-4180-bb0c-08a906257981 |
| | name: MyNet1 |
| | roles: |
| | - SNMP |
| | type: Custom |
| | - id: 3f6ff4a3-31bc-440b-a36f-d755c80d5932 |
| | name: MyNet2 |
| | roles: |
| | - SNMP |
| | - SSH |
| | type: Custom |
| state | success |
| task_id | c774f55d-c45b-42cd-ac9e-16fc196e9283 |
+---------+-----------------------------------------------------------------+
2.2.11 vinfra cluster network delete
Delete a network:
usage: vinfra cluster network delete <network>
<network>
Network ID or name
Example:
# vinfra cluster network delete MyOtherNet
Operation successful
This command deletes the network MyOtherNet.
2.3 Managing Storage Nodes
2.3.1 vinfra node join
Join a node to the storage cluster:
12
Chapter 2. Managing Storage Cluster
usage: vinfra node join [--disk <disk>:<role>[:<key=value,...>]] <node>
--disk <disk>:<role> [:<key=value,...>]
Disk configuration in the format:
• <disk> : disk device ID or name
• <role> : disk role (cs , mds , journal , mds-journal , mds-system , cs-system , system )
• comma-separated key=value pairs with keys (optional):
•
tier: disk tier (0, 1, 2 or 3)
•
journal-tier: journal (cache) disk tier (0, 1, 2 or 3)
•
journal-type: journal (cache) disk type (no_cache, inner_cache or external_cache)
•
journal-disk: journal (cache) disk ID or device name
•
journal-size: journal (cache) disk size, in bytes
•
bind-address : bind IP address for the metadata service
E.g., sda:cs:tier=0,journal-type=inner_cache . This option can be used multiple times.
<node>
Node ID or hostname
Example:
# vinfra node join f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4 \
--disk sda:mds-system \
--disk sdb:cs \
--disk sdc:cs
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| task_id | a2713068-9544-4ea1-8ec8-69a068cf86f2 |
+---------+--------------------------------------+
This command creates a task to add the node with the ID f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4 to the
storage cluster and assigns roles to disks: mds-system to sda , cs to sdb and sdc .
Task outcome:
# vinfra task show a2713068-9544-4ea1-8ec8-69a068cf86f2
+---------+--------------------------------------------+
| Field | Value |
+---------+--------------------------------------------+
13
| args | - f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4 |
| | - 1 |
| kwargs | disks: |
| | - id: 85F32403-94A9-465A-9E6C-C1A2B41294FC |
| | role: mds-system |
| | service_params: {} |
| | - id: FE0B5876-E054-489B-B0FD-72429BEFD46A |
| | role: cs |
| | service_params: {} |
| | - id: D3BEF4BB-AA3B-4DB6-9376-BC7CDA636700 |
| | role: cs |
| | service_params: {} |
| name | backend.tasks.node.AddNodeInClusterTask |
| result | {} |
| state | success |
| task_id | a2713068-9544-4ea1-8ec8-69a068cf86f2 |
+---------+--------------------------------------------+
2.3.2 vinfra node list
Chapter 2. Managing Storage Cluster
List storage nodes:
usage: vinfra node list
Example:
# vinfra node list
+--------------------------+---------------+------------+-----------+-------------+----------+
| id | host | is_primary | is_online | is_assigned | is_in_ha |
+--------------------------+---------------+------------+-----------+-------------+----------+
| 09bb6b84-70a5-41ae-b342- | node001.<...> | True | True | True | False |
| 23e5fc7cc126 | | | | | |
| 187edb11-38c5-487b-bd7f- | node002.<...> | False | True | True | False |
| 57b0fa4b733c | | | | | |
| e6255aed-d6e7-41b2-ba90- | node003.<...> | False | True | True | False |
| 86164c1cd9a6
+--------------------------+---------------+------------+-----------+-------------+----------+
This command lists all nodes registered in Acronis Cyber Infrastructure (both unassigned and used in the
storage cluster).
|
|
|
|
|
|
14
2.3.3 vinfra node show
Show storage node details:
usage: vinfra node show <node>
<node>
Node ID or hostname
Example:
# vinfra node show 4f96acf5-3bc8-4094-bcb6-4d1953be7b55
+---------------+--------------------------------------+
| Field | Value |
+---------------+--------------------------------------+
| cpu_cores | 2 |
| host | stor-1.example.com.vstoragedomain. |
| id | 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 |
| ipaddr | stor-1.example.com.vstoragedomain. |
| is_assigned | False |
| is_in_ha | False |
| is_installing | False |
| is_online | True |
| is_primary | True |
| is_virt | True |
| mem_total | 8201310208 |
| roles | management: |
| | is_primary: true |
| tasks | |
+---------------+--------------------------------------+
Chapter 2. Managing Storage Cluster
This command shows the details of the node with the ID 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 .
2.3.4 vinfra node release
Release a node from the storage cluster. Start data migration from the node as well as cluster replication and
rebalancing to meet the configured redundancy level:
usage: vinfra node release [--force] <node>
--force
Release node without data migration
<node>
Node ID or hostname
15
Chapter 2. Managing Storage Cluster
Example:
# vinfra node release f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| task_id | c2a653a2-8991-4b3a-8bdf-5c0872aa75b3 |
+---------+--------------------------------------+
This command creates a task to release the node with the ID f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4 from the
storage cluster with migration of data to maintain the set redundancy mode.
Task outcome:
# vinfra task show c2a653a2-8991-4b3a-8bdf-5c0872aa75b3
+---------+----------------------------------------+
| Field | Value |
+---------+----------------------------------------+
| args | - f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4 |
| | - false |
| kwargs | {} |
| name | backend.tasks.node.ReleaseNodeTask |
| state | success |
| task_id | c2a653a2-8991-4b3a-8bdf-5c0872aa75b3 |
+---------+----------------------------------------+
2.3.5 vinfra node forget
Remove a node from the storage cluster:
usage: vinfra node forget <node>
<node>
Node ID or hostname
Example:
# vinfra node forget fd1e46de-6e17-4571-bf6b-1ac34ec1c225
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| task_id | 0eac3b74-e8f5-4974-9efe-a9070187d83c |
+---------+--------------------------------------+
This command creates a task to unregister the node with the ID fd1e46de-6e17-4571-bf6b-1ac34ec1c225 from
Acronis Cyber Infrastructure.
Task outcome:
16
Chapter 2. Managing Storage Cluster
# vinfra task show 0eac3b74-e8f5-4974-9efe-a9070187d83c
+---------+----------------------------------------+
| Field | Value |
+---------+----------------------------------------+
| args | - fd1e46de-6e17-4571-bf6b-1ac34ec1c225 |
| kwargs | {}
| name | backend.tasks.node.DeleteNodeTask |
| state | success |
| task_id | 0eac3b74-e8f5-4974-9efe-a9070187d83c |
+---------+----------------------------------------+
|
2.4 Managing Node Network Interfaces
2.4.1 vinfra node iface list
List node network interfaces:
usage: vinfra node iface list [-a | --node <node>]
-a, --all
List all network interfaces on all nodes
--node <node>
Node ID or hostname to list network interfaces on (default: node001.vstoragedomain )
Example:
This command shows network interfaces of the node with the ID 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 .
# vinfra node iface list --node 4f96acf5-3bc8-4094-bcb6-4d1953be7b55
+------+--------------------------------------+--------------------+-------+---------+
| name | node_id | ipv4 | state | network |
+------+--------------------------------------+--------------------+-------+---------+
| eth0 | 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 | - 10.94.29.218/16 | up | Public |
| eth1 | 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 | - 10.37.130.101/24 | up | Private |
+------+--------------------------------------+--------------------+-------+---------+
2.4.2 vinfra node iface show
Show details of a network interface:
usage: vinfra node iface show [--node <node>] <iface>
17
Chapter 2. Managing Storage Cluster
--node <node>
Node ID or hostname (default: node001.vstoragedomain)
<iface>
Network interface name
Example:
# vinfra node iface show eth0 --node 4f96acf5-3bc8-4094-bcb6-4d1953be7b55
+-----------------------+--------------------------------------+
| Field | Value |
+-----------------------+--------------------------------------+
| contained_in | |
| dhcp4 | 10.94.29.218 |
| dhcp4_enabled | True |
| dhcp6 | fe80::21c:42ff:fe2a:4fdf |
| dhcp6_enabled | True |
| dns4 | - 127.0.0.1 |
| dns6 | [] |
| duplex | |
| gw4 | 10.94.0.1 |
| gw6 | |
| ignore_auto_dns_v4 | False |
| ignore_auto_dns_v6 | False |
| ignore_auto_routes_v4 | False |
| ignore_auto_routes_v6 | False |
| ipv4 | - 10.94.29.218/16 |
| ipv6 | - fe80::21c:42ff:fe2a:4fdf/64 |
| mac_addr | 00:1c:42:2a:4f:df |
| mtu | 1500 |
| multicast | True |
| name | eth0 |
| node_id | 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 |
| plugged | True |
| roles_set | 237e58dd-6c10-49c1-be7f-7ddf7de2efd1 |
| rx_bytes | 1844502614 |
| rx_dropped | 0 |
| rx_errors | 0 |
| rx_overruns | 0 |
| rx_packets | 11543284 |
| speeds | current: null |
| | max: null |
| state | up |
| tx_bytes | 28477979 |
| tx_dropped | 0 |
| tx_errors | 0 |
| tx_overruns | 0 |
| tx_packets | 107649 |
| type | iface |
+-----------------------+--------------------------------------+
This command shows the details of the network interface eth0 located on the node with the ID
18
Chapter 2. Managing Storage Cluster
4f96acf5-3bc8-4094-bcb6-4d1953be7b55 .
2.4.3 vinfra node iface up
Bring a network interface up:
usage: vinfra node iface up [--node <node>] <iface>
--node <node>
Node ID or hostname (default: node001.vstoragedomain)
<iface>
Network interface name
Example:
# vinfra node iface up eth2 --node 4f96acf5-3bc8-4094-bcb6-4d1953be7b55
+-----------------------+--------------------------------------+
| Field | Value |
+-----------------------+--------------------------------------+
| contained_in | |
| dhcp4 | 10.37.130.138 |
| dhcp4_enabled | True |
| dhcp6 | fe80::21c:42ff:fef8:5b90 |
| dhcp6_enabled | True |
| dns4 | - 127.0.0.1 |
| dns6 | [] |
| duplex | |
| gw4 | 10.94.0.1 |
| gw6 | |
| ignore_auto_dns_v4 | False |
| ignore_auto_dns_v6 | False |
| ignore_auto_routes_v4 | False |
| ignore_auto_routes_v6 | False |
| ipv4 | - 10.37.130.138/24 |
| ipv6 | - fe80::21c:42ff:fef8:5b90/64 |
| mac_addr | 00:1c:42:f8:5b:90 |
| mtu | 1500 |
| multicast | True |
| name | eth2 |
| node_id | 4f96acf5-3bc8-4094-bcb6-4d1953be7b55 |
| plugged | True |
| roles_set | |
| rx_bytes | 97632 |
| rx_dropped | 0 |
| rx_errors | 0 |
| rx_overruns | 0 |
| rx_packets | 1258 |
19