ACRONIS Cyber Infrastructure 4.0 User guide

Acronis Cyber Infrastructure

4.0

Revision: 12/17/2020

ADMINISTRATOR COMMAND LINE

GUIDE

Table of contents

1 Introduction 13

1.1 Providing credentials 13

1.2 Managing tasks 14

2 Managing the storage cluster 15

2.1 Managing tokens 15

2.1.1 vinfra node token show 15

2.1.2 vinfra node token create 15

2.1.3 vinfra node token validate 15

2.2 Managing networks 16

2.2.1 vinfra cluster network create 16

2.2.2 vinfra cluster network list 16

2.2.3 vinfra cluster network show 17

2.2.4 vinfra cluster network set 18

2.2.5 vinfra cluster network set-bulk 19

2.2.6 vinfra cluster network migration start 20

2.2.7 vinfra cluster network migration show 21

2.2.8 vinfra cluster network migration apply 22

2.2.9 vinfra cluster network migration retry 22

2.2.10 vinfra cluster network migration revert 23

2.2.11 vinfra cluster network migration resume 23

2.2.12 vinfra cluster network reconfiguration show 24

2.2.13 vinfra cluster network conversion precheck 24

2.2.14 vinfra cluster network conversion start 25

2.2.15 vinfra cluster network conversion status 26

2.2.16 vinfra cluster network delete 27

2.3 Managing traffic types 27

2.3.1 vinfra cluster traffic-type create 27

2.3.2 vinfra cluster traffic-type list 28

2.3.3 vinfra cluster traffic-type show 28

2.3.4 vinfra cluster traffic-type set 29

2.3.5 vinfra cluster traffic-type assignment start 30

2.3.6 vinfra cluster traffic-type assignment show 30

2.3.7 vinfra cluster traffic-type assignment apply 31

2.3.8 vinfra cluster traffic-type assignment retry 31

2.3.9 vinfra cluster traffic-type assignment revert 32

2 © Acronis International GmbH, 2003-2020

2.3.10 vinfra cluster traffic-type delete 32

2.4 Managing storage nodes 33

2.4.1 vinfra node join 33

2.4.2 vinfra node list 34

2.4.3 vinfra node show 34

2.4.4 vinfra node maintenance precheck 35

2.4.5 vinfra node maintenance start 36

2.4.6 vinfra node maintenance status 37

2.4.7 vinfra node maintenance stop 38

2.4.8 vinfra node release 39

2.4.9 vinfra node forget 39

2.5 Managing failure domains 40

2.5.1 vinfra failure domain list 40

2.5.2 vinfra failure domain rename 41

2.6 Managing node location 42

2.6.1 vinfra location list 42

2.6.2 vinfra location create 42

2.6.3 vinfra location rename 43

2.6.4 vinfra location show 43

2.6.5 vinfra location move 44

2.6.6 vinfra location delete 44

2.7 Managing node network interfaces 45

2.7.1 vinfra node iface list 45

2.7.2 vinfra node iface show 45

2.7.3 vinfra node iface up 47

2.7.4 vinfra node iface down 48

2.7.5 vinfra node iface set 49

2.7.6 vinfra node iface create-bond 52

2.7.7 vinfra node iface create-vlan 54

2.7.8 vinfra node iface delete 57

2.8 Managing node disks 58

2.8.1 vinfra node disk list 58

2.8.2 vinfra node disk show 58

2.8.3 vinfra node disk assign 59

2.8.4 vinfra node disk release 61

2.8.5 vinfra node disk blink on 62

2.8.6 vinfra node disk blink off 62

3 © Acronis International GmbH, 2003-2020

2.8.7 vinfra node iscsi target add 62

2.8.8 vinfra node iscsi target delete 64

2.9 Creating and deleting the storage cluster 64

2.9.1 vinfra cluster create 64

2.9.2 vinfra cluster delete 66

2.10 Showing storage cluster overview and details 66

2.10.1 vinfra cluster overview 66

2.10.2 vinfra cluster show 67

3 Managing the compute cluster 69

3.1 Creating and deleting the compute cluster 69

3.1.1 vinfra service compute create 69

3.1.2 vinfra service compute delete 72

3.2 Showing compute cluster details and overview 72

3.2.1 vinfra service compute show 72

3.2.2 vinfra service compute stat 74

3.3 Changing compute cluster parameters 75

3.4 Managing compute nodes 78

3.4.1 vinfra service compute node add 78

3.4.2 vinfra service compute node list 79

3.4.3 vinfra service compute node show 79

3.4.4 vinfra service compute node fence 80

3.4.5 vinfra service compute node unfence 80

3.4.6 vinfra service compute node release 81

3.5 Managing virtual machines 82

3.5.1 vinfra service compute server create 82

3.5.2 vinfra service compute server list 84

3.5.3 vinfra service compute server show 85

3.5.4 vinfra service compute server stat 86

3.5.5 vinfra service compute server set 87

3.5.6 vinfra service compute server iface attach 88

3.5.7 vinfra service compute server iface list 89

3.5.8 vinfra service compute server iface detach 89

3.5.9 vinfra service compute server volume attach 90

3.5.10 vinfra service compute server volume list 90

3.5.11 vinfra service compute server volume show 91

3.5.12 vinfra service compute server volume detach 91

3.5.13 vinfra service compute server log 92

4 © Acronis International GmbH, 2003-2020

3.5.14 vinfra service compute server migrate 92

3.5.15 vinfra service compute server resize 93

3.5.16 vinfra service compute server start 94

3.5.17 vinfra service compute server pause 95

3.5.18 vinfra service compute server unpause 96

3.5.19 vinfra service compute server suspend 97

3.5.20 vinfra service compute server resume 98

3.5.21 vinfra service compute server reboot 99

3.5.22 vinfra service compute server reset-state 100

3.5.23 vinfra service compute server stop 101

3.5.24 vinfra service compute server cancel-stop 103

3.5.25 vinfra service compute server shelve 103

3.5.26 vinfra service compute server unshelve 104

3.5.27 vinfra service compute server evacuate 105

3.5.28 vinfra service compute server delete 106

3.5.29 vinfra service compute server rescue 106

3.5.30 vinfra service compute server unrescue 108

3.6 Managing images 109

3.6.1 vinfra service compute image create 109

3.6.2 vinfra service compute image list 110

3.6.3 vinfra service compute image show 111

3.6.4 vinfra service compute image set 112

3.6.5 vinfra service compute image save 113

3.6.6 vinfra service compute image delete 114

3.7 Managing placements 114

3.7.1 vinfra service compute placement create 114

3.7.2 vinfra service compute placement assign 115

3.7.3 vinfra service compute placement delete-assign 116

3.7.4 vinfra service compute placement list 117

3.7.5 vinfra service compute placement show 117

3.7.6 vinfra service compute placement update 117

3.7.7 vinfra service compute placement delete 118

3.8 Managing flavors 118

3.8.1 vinfra service compute flavor create 118

3.8.2 vinfra service compute flavor list 119

3.8.3 vinfra service compute flavor show 120

3.8.4 vinfra service compute flavor delete 120

5 © Acronis International GmbH, 2003-2020

3.9 Managing compute SSH keys 120

3.9.1 vinfra service compute key create 120

3.9.2 vinfra service compute key list 121

3.9.3 vinfra service compute key show 122

3.9.4 vinfra service compute key delete 122

3.10 Managing compute networks 122

3.10.1 vinfra service compute network create 122

3.10.2 vinfra service compute network list 126

3.10.3 vinfra service compute network show 127

3.10.4 vinfra service compute network set 128

3.10.5 vinfra service compute network delete 129

3.11 Managing virtual routers 130

3.11.1 vinfra service compute router create 130

3.11.2 vinfra service compute router list 131

3.11.3 vinfra service compute router show 132

3.11.4 vinfra service compute router set 132

3.11.5 vinfra service compute router iface add 134

3.11.6 vinfra service compute router iface list 134

3.11.7 vinfra service compute router iface remove 135

3.11.8 vinfra service compute router delete 135

3.12 Managing floating IP addresses 136

3.12.1 vinfra service compute floatingip create 136

3.12.2 vinfra service compute floatingip list 137

3.12.3 vinfra service compute floatingip show 137

3.12.4 vinfra service compute floatingip set 138

3.12.5 vinfra service compute floatingip delete 139

3.13 Managing load balancers 139

3.13.1 vinfra service compute load-balancer create 139

3.13.2 vinfra service compute load-balancer list 141

3.13.3 vinfra service compute load-balancer show 141

3.13.4 vinfra service compute load-balancer stats 142

3.13.5 vinfra service compute load-balancer set 143

3.13.6 vinfra service compute load-balancer pool create 144

3.13.7 vinfra service compute load-balancer pool list 146

3.13.8 vinfra service compute load-balancer pool show 147

3.13.9 vinfra service compute load-balancer pool set 148

3.13.10 vinfra service compute load-balancer pool delete 150

6 © Acronis International GmbH, 2003-2020

3.13.11 vinfra service compute load-balancer failover 151

3.13.12 vinfra service compute load-balancer delete 151

3.14 Managing volumes 151

3.14.1 vinfra service compute volume create 151

3.14.2 vinfra service compute volume list 153

3.14.3 vinfra service compute volume show 154

3.14.4 vinfra service compute volume set 155

3.14.5 vinfra service compute volume extend 156

3.14.6 vinfra service compute volume delete 156

3.15 Managing volume snapshots 157

3.15.1 vinfra service compute volume snapshot create 157

3.15.2 vinfra service compute volume snapshot list 157

3.15.3 vinfra service compute volume snapshot show 158

3.15.4 vinfra service compute volume snapshot set 158

3.15.5 vinfra service compute volume snapshot upload-to-image 159

3.15.6 vinfra service compute volume snapshot revert 160

3.15.7 vinfra service compute volume snapshot reset-state 161

3.15.8 vinfra service compute volume snapshot delete 161

3.16 Managing storage policies 162

3.16.1 vinfra service compute storage-policy create 162

3.16.2 vinfra service compute storage-policy list 163

3.16.3 vinfra service compute storage-policy show 163

3.16.4 vinfra service compute storage-policy set 164

3.16.5 vinfra service compute storage-policy delete 165

3.17 Managing Kubernetes clusters 166

3.17.1 vinfra service compute k8saas create 166

3.17.2 vinfra service compute k8saas list 168

3.17.3 vinfra service compute k8saas config 168

3.17.4 vinfra service compute k8saas show 169

3.17.5 vinfra service compute k8saas set 169

3.17.6 vinfra service compute k8saas delete 170

3.18 Managing compute quotas 171

3.18.1 vinfra service compute quotas show 171

3.18.2 vinfra service compute quotas update 172

4 Managing the backup cluster 174

4.1 Creating, showing, and deleting the backup cluster 174

4.1.1 vinfra service backup cluster create 174

7 © Acronis International GmbH, 2003-2020

4.1.2 vinfra service backup cluster show 179

4.1.3 vinfra service backup cluster release 180

4.2 Managing backup nodes 181

4.2.1 vinfra service backup node add 181

4.2.2 vinfra service backup node list 181

4.2.3 vinfra service backup node release 182

4.3 Updating backup cluster certificates 183

4.4 Changing storage parameters 184

4.4.1 vinfra service backup storage-params show 184

4.4.2 vinfra service backup storage-params change 184

4.5 Changing volume parameters 187

4.5.1 vinfra service backup volume-params show 187

4.5.2 vinfra service backup volume-params change 188

4.6 Managing backup cluster geo-replication 189

4.6.1 vinfra service backup geo-replication show 189

4.6.2 vinfra service backup geo-replication master setup 190

4.6.3 vinfra service backup geo-replication master download-configs 191

4.6.4 vinfra service backup geo-replication slave setup 191

4.6.5 vinfra service backup geo-replication master establish 192

4.6.6 vinfra service backup geo-replication slave update-certificates 192

4.6.7 vinfra service backup geo-replication master disable 193

4.6.8 vinfra service backup geo-replication slave promote-to-master 194

4.6.9 vinfra service backup geo-replication slave cancel 194

4.6.10 vinfra service backup geo-replication master cancel 195

5 Managing general settings 196

5.1 Managing licenses 196

5.1.1 vinfra cluster license load 196

5.1.2 vinfra cluster license show 196

5.2 Managing updates 197

5.2.1 vinfra software-updates check-for-updates 197

5.2.2 vinfra software-updates eligibility-check 197

5.2.3 vinfra software-updates download 199

5.2.4 vinfra software-updates start 199

5.2.5 vinfra software-updates pause 200

5.2.6 vinfra software-updates resume 201

5.2.7 vinfra software-updates cancel 201

5.2.8 vinfra software-updates status 202

8 © Acronis International GmbH, 2003-2020

5.3 Managing domains 203

5.3.1 vinfra domain create 203

5.3.2 vinfra domain list 203

5.3.3 vinfra domain show 204

5.3.4 vinfra domain set 204

5.3.5 vinfra domain delete 205

5.4 Managing domain users 205

5.4.1 vinfra domain user list-available-roles 205

5.4.2 vinfra domain user create 206

5.4.3 vinfra domain user list 208

5.4.4 vinfra domain user show 209

5.4.5 vinfra domain user set 209

5.4.6 vinfra domain user delete 211

5.5 Managing domain projects 211

5.5.1 vinfra domain project create 211

5.5.2 vinfra domain project list 212

5.5.3 vinfra domain project show 213

5.5.4 vinfra domain project set 214

5.5.5 vinfra domain project user list 215

5.5.6 vinfra domain project user remove 215

5.5.7 vinfra domain project delete 216

5.6 Managing SSH keys 216

5.6.1 vinfra cluster sshkey add 216

5.6.2 vinfra cluster sshkey list 217

5.6.3 vinfra cluster sshkey delete 217

5.7 Managing external DNS servers 218

5.7.1 vinfra cluster settings dns show 218

5.7.2 vinfra cluster settings dns set 218

5.8 Configuring management node high availability 219

5.8.1 vinfra cluster ha create 219

5.8.2 vinfra cluster ha update 221

5.8.3 vinfra cluster ha show 222

5.8.4 vinfra cluster ha delete 223

5.9 Managing cluster backups 223

5.9.1 vinfra cluster backup create 223

5.9.2 vinfra cluster backup show 224

5.10 Managing storage tier encryption 224

9 © Acronis International GmbH, 2003-2020

5.10.1 vinfra cluster settings encryption show 224

5.10.2 vinfra cluster settings encryption set 225

5.11 Managing automatic storage disk configuration 225

5.11.1 vinfra cluster settings automatic-disk-replacement show 225

5.11.2 vinfra cluster settings automatic-disk-replacement set 226

5.12 Managing alerts 227

5.12.1 vinfra cluster alert list 227

5.12.2 vinfra cluster alert show 227

5.12.3 vinfra cluster alert delete 228

5.13 Managing audit log 229

5.13.1 vinfra cluster auditlog list 229

5.13.2 vinfra cluster auditlog show 229

5.14 Managing cluster password 230

5.14.1 vinfra cluster password show 230

5.14.2 vinfra cluster password reset 230

5.15 Sending problem reports 231

6 Monitoring the storage cluster 233

6.1 Monitoring general storage cluster parameters 233

6.2 Monitoring metadata servers 235

6.3 Monitoring chunk servers 236

6.3.1 Understanding disk space usage 238

6.3.2 Exploring chunk states 241

6.4 Monitoring clients 242

6.5 Monitoring physical disks 244

6.6 Monitoring event logs 245

6.7 Monitoring replication parameters 248

7 Accessing storage clusters via iSCSI 250

7.1 iSCSI workflow overview 251

7.1.1 Managing legacy iSCSI targets 251

7.2 Configuring CLI tool 252

7.3 Managing target groups 252

7.3.1 Creating target groups 252

7.3.2 Starting and stopping target groups 254

7.3.3 Listing target groups 254

7.3.4 Printing details of target groups 255

7.3.5 Managing persistent reservations of target groups 255

7.3.6 Deleting target groups 256

10 © Acronis International GmbH, 2003-2020

7.4 Managing iSCSI volumes 256

7.4.1 Creating iSCSI volumes 256

7.4.2 Listing and printing details of iSCSI volumes 256

7.4.3 Attaching iSCSI volumes to target groups 257

7.4.4 Setting the Active/Optimized path for iSCSI volumes 257

7.4.5 Viewing iSCSI volume ALUA information 257

7.4.6 Viewing and setting iSCSI volume parameters 258

7.4.7 Increasing iSCSI volume size 258

7.4.8 Setting iSCSI volume limits 258

7.4.9 Detaching iSCSI volumes from target groups 259

7.4.10 Deleting iSCSI volumes 259

7.5 Managing nodes in target groups 259

7.5.1 Adding nodes to target groups 259

7.5.2 Listing nodes in target groups 260

7.5.3 Enabling and disabling nodes in target groups 260

7.5.4 Deleting nodes from target groups 261

7.6 Managing targets and portals 261

7.6.1 Creating targets 261

7.6.2 Adding and removing target portals 262

7.6.3 Deleting targets 262

7.7 Managing CHAP accounts 262

7.7.1 Creating and listing CHAP accounts 262

7.7.2 Changing CHAP account details 263

7.7.3 Assigning CHAP accounts to target groups 263

7.7.4 Deleting CHAP accounts 263

7.8 Managing LUN views 263

7.8.1 Creating LUN views 264

7.8.2 Listing LUN views 264

7.8.3 Changing LUN view details 264

7.8.4 Deleting LUN views 264

8 Advanced tasks 266

8.1 Updating kernel with ReadyKernel 266

8.1.1 Installing ReadyKernel patches automatically 266

8.1.2 Managing ReadyKernel patches manually 267

8.1.3 Managing ReadyKernel logs 268

8.2 Managing guest tools 268

8.2.1 Installing guest tools 268

11 © Acronis International GmbH, 2003-2020

8.2.2 Uninstalling guest tools 271

8.3 Running commands in virtual machines without network connectivity 273

8.3.1 Running commands in Linux virtual machines 273

8.3.2 Running commands in Windows virtual machines 274

8.4 Setting virtual machine CPU model 274

8.5 Creating Linux templates 275

8.6 Connecting to OpenStack command-line interface 276

8.7 Setting a DNS name for the compute API 278

8.8 Securing OpenStack API traffic with SSL 279

8.9 Using metering for compute resources 280

8.9.1 Enabling the metering service 282

8.9.2 Using Gnocchi command-line tool 282

8.9.3 Viewing resource usage per project 284

8.10 Configuring memory policy for the storage services 284

8.10.1 vinfra memory-policy vstorage-services per-cluster change 285

8.10.2 vinfra memory-policy vstorage-services per-cluster show 286

8.10.3 vinfra memory-policy vstorage-services per-cluster reset 287

8.10.4 vinfra memory-policy vstorage-services per-node change 287

8.10.5 vinfra memory-policy vstorage-services per-node show 288

8.10.6 vinfra memory-policy vstorage-services per-node reset 289

8.11 Migrating virtual machines from VMware vCenter 290

8.11.1 Deploying the appliance virtual machine 291

8.11.2 Setting up authentication in the appliance virtual machine 291

8.11.3 Migrating virtual machines to Acronis Cyber Infrastructure online 292

8.11.4 Migrating virtual machines to Acronis Cyber Infrastructure offline 294

8.12 Changing the default load balancer flavor 294

8.13 Changing parameters in OpenStack configuration files 295

8.14 Configuring retention policy for Prometheus metrics 297

8.15 Exiting the rescue mode for Windows virtual machines 298

8.16 Assigning users to multiple domains 299

8.17 Using network QoS policies 300

8.17.1 QoS policy rules 301

8.17.2 Assigning QoS policies 302

8.17.3 Modifying QoS policy rules 304

8.17.4 Unassigning QoS policies 304

8.18 Viewing cluster logs 305

12 © Acronis International GmbH, 2003-2020

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:

l Setting custom paths for Acronis Cyber Infrastructure services, in particular:



o

Creating S3 clusters only in /mnt/vstorage/vols/s3



o

Creating iSCSI targets only in /mnt/vstorage/vols/iscsi

l Mounting clusters or change cluster mount options

l Configuring firewall with firewall-cmd

l Renaming network connections

l Managing metadata and storage services

l Managing partitions, LVMs, or software RAID

l Modifying files in /mnt/vstorage/vols and /mnt/vstorage/webcp/backup directories

l Setting encoding or replication of cluster root

1.1 Providing credentials

The vinfra CLI tool requires the following information:

l IP address or hostname of the management node (set to backend-api.svc.vstoragedomain by

default).

l Username (admin by default).

l 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 (for example, 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

13 © Acronis International GmbH, 2003-2020

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-<...> | success | backend.tasks.cluster.CreateNewCluster |

| e61377db-<...> | success | backend.tasks.disks.ApplyDiskRoleTask |

| a005b748-<...> | success | backend.tasks.node.AddNodeInClusterTask |

+----------------+---------+-----------------------------------------+

# vinfra task show 8fc27e7a-ba73-471d-9134-e351e1137cf4

+---------+----------------------------------------+

| Field | Value |

+---------+----------------------------------------+

| args | - stor1 |

| | - 7ffa9540-5a20-41d1-b203-e3f349d62565 |

| | - null |

| kwargs | {} |

| name | backend.tasks.cluster.CreateNewCluster |

| result | cluster_id: 1 |

| state | success |

| task_id | 8fc27e7a-ba73-471d-9134-e351e1137cf4 |

+---------+----------------------------------------+

14 © Acronis International GmbH, 2003-2020

2 Managing the 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

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:

15 © Acronis International GmbH, 2003-2020

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 networks

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

+-------+--------------------------------------+

This command creates a custom network MyNet and assigns the traffic type SSH to it.

2.2.2 vinfra cluster network list

List available networks:

16 © Acronis International GmbH, 2003-2020

usage: vinfra cluster network list [--long]

--long

Enable access and listing of all fields of objects.

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.3 vinfra cluster network show

Show details of a network:

usage: vinfra cluster network show <network>

Network ID or name

Example:

# vinfra cluster network show MyNet

+-------+--------------------------------------+

| Field | Value |

+-------+--------------------------------------+

| id | 03d5eeb3-1833-4626-885d-dd066635f5de |

| name | MyNet |

| roles | - SSH |

| type | Custom |

+-------+--------------------------------------+

This command shows the details of the custom network MyNet.

17 © Acronis International GmbH, 2003-2020

2.2.4 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>]

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

# vinfra task show b29f6f66-37d7-47de-b02e-9f4087ad932b

+---------+-------------------------------------------------------------+

| Field | Value |

+---------+-------------------------------------------------------------+

| args | - 03d5eeb3-1833-4626-885d-dd066635f5de |

| kwargs | name: MyOtherNet |

| | roles: |

| | - ssh |

18 © Acronis International GmbH, 2003-2020

| | - iscsi |

| | - nfs |

| name | backend.presentation.network.roles.tasks.RolesSetChangeTask |

| result | id: 03d5eeb3-1833-4626-885d-dd066635f5de |

| | name: MyOtherNet |

| | roles: |

| | - iSCSI |

| | - NFS |

| | - SSH |

| | type: Custom |

| state | success |

| task_id | b29f6f66-37d7-47de-b02e-9f4087ad932b |

+---------+-------------------------------------------------------------+

2.2.5 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:

l <network>: network ID or name.

l <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.

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 |

19 © Acronis International GmbH, 2003-2020

| | 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.6 vinfra cluster network migration start

Start network migration:

usage: vinfra cluster network migration start <network> [--subnet <subnet>]

[--netmask <netmask>]

[--gateway <gateway>] [--shutdown]

[--node <node> <address>]

--network <network>

Network ID or name

--subnet <subnet>

New network subnet

--netmask <netmask>

New network mask

--gateway <gateway>

New network gateway

--shutdown

Prepare the cluster to be shut down manually for relocation

--node <node> <address>

New node address in the format:

l <node>: node ID or hostname

l <address>: IPv4 address

This option can be used multiple times.

Example:

# vinfra cluster network migration start --network "Private" \

--subnet 192.168.128.0 --netmask 255.255.255.0 --node node001 192.168.128.11 \

--node node002 192.168.128.12 --node node003 192.168.128.13

Page is loading ...

ACRONIS Cyber Infrastructure 4.0 User guide

ACRONIS Cyber Infrastructure 4.0 User guide

Related papers

Other documents