Use the viocli create command to create backups, scheduled backups, certificate signing requests (CSRs), and Swift clusters and nodes.

The viocli create command supports a variety of actions to perform different tasks. The following parameters apply to all actions.

Parameter Mandatory or Optional Description

-f config-file or --file config-file

Optional

Runs the command using a specified configuration file.

-i or --interactive

Optional

Opens the configuration template in a text editor so that you can enter the required information interactively. After entering the information, save and quit the text editor to run the command.

-o or --out

Optional

Runs the command without prompting for confirmation.

-v or --verbose

Optional

Displays output in verbose mode.

To display the parameters for the command, run viocli create -h or viocli create --help. You can also use the -h or --help option to display parameters for any action. For example, viocli create backup -h shows parameters for the backup action.

Use viocli create to perform the following actions.

viocli create backup {-f config-file | -i | -o} --content-vcenter <vcenter-name> [-t timeout] [-v]

Creates a backup of your OpenStack deployment. The following additional parameters apply to the backup action.

Parameter Mandatory or Optional Description

-t timeout or --timeout timeout

Optional

Specifies the time in seconds for which viocli will display the progress of the backup operation.

If you do not include this parameter, the default value of 1800 seconds will be used.

For more information, see Back Up Your Deployment.

 

viocli create backupschedule {-f config-file | -i | -o} --content-vcenter <vcenter-name> [-t timeout] [-v]

Creates a scheduled backup of your OpenStack deployment. For more information, see Scheduled Backup.

 

viocli create csr -c country-code -t state-name -l city-name -o org-name -u org-unit [-s service-name] [-d output-dir] [-f config-file | -i | -o] [-v]

Creates a certificate signing request to send to a certificate authority. The following additional parameters apply to the csr action.

Parameter Mandatory or Optional Description

-c country-code or --countries country-code

Mandatory

Two-letter ISO country code in which the organization applying for the certificate is located.

-t state-name or --states state-name

Mandatory

Full name of the state or province.

-l city-name or --localities city-name

Mandatory

Name of the town or city.

-n org-name or --org-names org-name

Mandatory

Legal name of the organization.

-u org-unit or --org-units org-unit

Mandatory

Name of the department or organizational unit.

-s service-name or --services service-name

Optional

Name of one or more VMware Integrated OpenStack services for which to generate the CSR. Separate multiple names with commas (,).

If you do not include this parameter, a CSR is generated for every VMware Integrated OpenStack service.

-d output-dir or --output output-dir

Optional

Directory to which CSRs are saved.

If you do not include this parameter, CSRs are saved to the ./csr directory.

 

viocli create swift {-f config-file | -i | -o} [-v]

Creates a Swift cluster. For more information, see Add the Swift Cluster.

 

viocli create tenant-vdc --compute compute-node --name vdc-name --project-id project-uuid [--cpu-reserve cpu-min] [--cpu-limit cpu-max] [--mem-reserve memory-min] [--mem-limit memory-max] [-f config-file | -i | -o] [-v]

Creates a tenant virtual data center (VDC) with the specified settings. The following additional parameters apply to the tenant-vdc action.

Parameter Mandatory or Optional Description

--compute compute-node

Mandatory

Compute node on which to create the tenant VDC.

You can find the names of compute nodes by running the openstack compute service list command.

--name vdc-name

Mandatory

Name of the tenant VDC.

--project-id project-uuid

Mandatory

UUID of the project under which to create the tenant VDC.

--cpu-reserve cpu-min

Optional

CPU cycles in megahertz to reserve for the VDC.

If you do not enter a value, 0 is used by default.

The provided value should be >=0 as value=0 indicates “no resource reserved”.

--cpu-limit cpu-max

Optional

Maximum limit for CPU usage on the VDC (in megahertz).

If you do not enter a value, CPU usage is not limited.

The provided value should >=0 or -1. -1 indicates no limit set on that resource.

--mem-reserve memory-min

Optional

Memory in megabytes to reserve for the VDC.

If you do not enter a value, 0 is used by default.

The provided value should be >=0 as value=0 indicates “no resource reserved”.

--mem-limit memory-max

Optional

Maximum limit for memory consumption on the VDC (in megabytes).

If you do not enter a value, memory consumption is not limited.

The provided value should >=0 or -1. -1 indicates no limit set on that resource.

viocli create vcenter --vc_hostname <hostname> --vc_password <password> --vc_username <username>

Creates a new vCenter for backup, restoration, or other requests. The following additional parameters apply to the vcenter action.

Parameter Mandatory or Optional Description

-n hostname or --vc_hostname hostname

Mandatory

vCenter hostname or IP address of new object.

-p password or --vc_password password

Mandatory

vCenter password required to create the new object.

-u username or --vc_username username

Mandatory

vCenter username required to create the new object.