List VM configurations
Command
List all your VM configurationsVM configurations - A template configuration (a container template) consisting of a base image, a snapshot image, and the number of CPU cores to be used. To become a VM that you can run in the cloud, a VM configuration needs to be deployed to a node (a host).. Orka provides detailed information about the VM configuration.
orka vm configs
OR
orka vm configs -f <USER>
Output
Options
You can pass the following option with orka vm configs in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| List the VM configuration with the specified name. The specified name must be an exact match for the VM configuration you're looking for. |
|
List VMs and VM configurations
List your VMs and VM configurations. If you are running this command in administrative mode, you can list the VMs and VM configurations of a specified user or for all users.
Command
orka vm list
OR
orka vm list -f <USER>
OR
orka vm list -f all
OR (request JSON output)
orka vm list --json
Output
Options
You can pass the following options with orka vm list in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| (Administrative-only) Set to Set to the email address of an Orka user to list their VMs and VM configurations. |
|
| Returns the output of the command in |
Create VM configuration
Command
Create a VM configurationVM configuration - A template configuration (a container template) consisting of a base image, a snapshot image, and the number of CPU cores to be used. To become a VM that you can run in the cloud, a VM configuration needs to be deployed to a node (a host). from which you can deploy virtual machines.
orka vm create-config
OR (create basic config)
orka vm create-config -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -y
OR (create config with attached ISO)
orka vm create-config -v <NAME> -b <EMPTY_BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -i <ISO> -y
OR (create config with attached additional storage)
orka vm create-config -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -d <ADDITIONAL_STORAGE> -y
OR (create config with disabled VNC)
orka vm create-config -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> --vnc no -y
OR (create config with enabled IO boost)
orka vm create-config -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> --io-boost yes -y
Output
VM name limitations
The name you specify under
VM Namemust meet the following requirements:
- Doesn't exceed 38 characters.
- Contains only lowercase Latin alphanumeric characters (0-9, a-z) and dashes (-).
- Begins and ends with an alphanumeric character.
Options
You can pass the following options with orka vm create-config in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| A name for the VM configuration. All VMs deployed from this configuration will have this name. |
The string must consist of lowercase Latin alphanumeric characters or the dash ( |
| `-b- | The base imagebase image - An existing disk image file stored in Orka and used exclusively for the creation of VM configurations. The actual storage for newly created VM configurations is based on a base image specified by the user. Base images remain unchanged over time and can be used again and again for the creation of VMs. that you want to use for the VM. |
|
|
| The number of CPU cores for the VM. |
|
|
| The number of vCPU cores for the VM. Must equal the number or half the number of CPU cores specified. When the number of CPU is 3, must be 3. |
|
|
| Attaches the specified ISO. You must provide the name of the ISO. |
|
|
| Attaches the specified storage. You must provide the image name. |
|
| Enables or disables VNC access when running |
| |
| Enables or disables IO performance boost for your VMs. |
| |
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Create VM
Command
Create a VM configuration and deploy a VM from it. This command is shorthand for orka vm create-config && orka vm deploy.
orka vm create
OR (create and deploy basic VM)
orka vm create -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -y
OR (create and deploy VM on a specified node)
orka vm create -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -n <NODE> -y
OR (create and deploy VM with attached ISO)
orka vm create -v <NAME> -b <EMPTY_BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -i <ISO> -y
OR (create and deploy VM with attached additional storage)
orka vm create -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> -d <ADDITIONAL_STORAGE> -y
OR (create and deploy VM with disabled VNC)
orka vm create -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> --vnc no -y
OR (create and deploy VM with enabled IO boost)
orka vm create -v <NAME> -b <BASE_IMAGE> -c <CPU_COUNT> -C <vCPU_COUNT> --io-boost yes -y
Output
Options
You can pass the following options with orka vm create in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| A name for the VM configuration. All VMs deployed from this configuration will have this name. |
The string must consist of lowercase Latin alphanumeric characters or the dash ( |
|
| The base imagebase image - An existing disk image file stored in Orka and used exclusively for the creation of VM configurations. The actual storage for newly created VM configurations is based on a base image specified by the user. Base images remain unchanged over time and can be used again and again for the creation of VMs. that you want to use for the VM. |
|
|
| The number of CPU cores for the VM. |
|
|
| The number of vCPU cores for the VM. Must equal the number or half the number of CPU cores specified. When the number of CPU is 3, must be 3. |
|
|
| The node on which to deploy the VM. The specified node must have sufficient free computational resource to accommodate the VM. To let Orka choose a node, leave blank. |
|
|
| Attaches the specified ISO. You must provide the name of the ISO. |
|
|
| Attaches the specified storage. You must provide the image name. |
|
| Enables or disables VNC access (and port mapping) for the VM configuration. You can override the setting when running |
| |
| Enables or disables IO performance boost for your VMs. |
| |
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Deploy VM
Command
Deploy a new virtual machine from the specified VM configurationVM configuration - A template configuration (a container template) consisting of a base image, a snapshot image, and the number of CPU cores to be used. To become a VM that you can run in the cloud, a VM configuration needs to be deployed to a node (a host)..
orka vm deploy
OR
orka vm deploy -v <NAME> -y
OR (deploy on a specified node)
orka vm deploy -v <NAME> -n <NODE> -y
OR (deploy a scaled VM)
orka vm deploy -v <NAME> -r <NUMBER_OF_REPLICAS> -y
OR (deploy with additional ports)
orka vm deploy -v <NAME> -p <NODE_PORT>:<VM_PORT> -y
OR (deploy with attached ISO)
orka vm deploy -v <NAME> -i <ISO> -y
OR (deploy with additional storage)
orka vm deploy -v <NAME> -d <ADDITIONAL_STORAGE> -y
OR (deploy with disabled VNC)
orka vm deploy -v <NAME> --vnc no -y
Output
Options
You can pass the following options with orka vm deploy in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The name of the VM configuration that you want to deploy. |
|
|
| The node on which to deploy the VM. The specified node must have sufficient free computational resource to accommodate the VM. To let Orka choose a node, leave blank. |
|
|
| The scale at which to deploy the VM configuration. If not specified, defaults to All replicas share the same ID. Some operations are not available for scaled VMs ( |
|
|
| Attaches the specified ISO. You must provide the name of the ISO. |
|
|
| Attaches the specified storage. You must provide the image name. |
|
| Enables or disables VNC access (and port mapping) for the VM configuration. You can override the VNC setting of the VM configuration. |
| |
|
| (Only available in direct mode) Opens an additional port on the VM. You need to map a port on the node (host) to a port on the VM (guest). Use the following format: |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Scale a deployed VM
Command
Change the scale at which a VM is deployed. By default, VMs are deployed non-scaled (one VM at a time with a unique ID). When you increase the scale, Orka deploys replicas of the same VM and they share one ID.
Limitations
When you are working with scaled VMs, the following limitations are in place:
- Some operations are not available for scaled VMs (
orka image save,orka image commit,orka vm clone,orka vm migrate).- If you specify a node during deployment, scaling is limited to the resources of that node and will not create new replicas on other nodes.
- All replicas share the same ID.
- To view detailed information about each replica, run
orka vm status -v <NAME> -y.- When you scale down, you have no control over which replicas will be destroyed and which ones will be preserved. This might result in loss of data.
- When you scale up, newly deployed replicas use the base image of the original VM config. Changes from any other running replicas are not applied to the new replicas.
- You can delete replicas only by ID. This operation deletes all replicas with the specified ID.
orka vm scale
OR
orka vm scale -v <VM_ID> -r <NUMBER_OF_REPLICAS> -y
Output
Options
You can pass the following options with orka vm scale in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The ID of the VM machine. |
|
|
| The number of replicas to which you want to change the scale. Must be a positive integer. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Check the status of a VM
Command
Get deployment status and system information for the specified VM. If you are running this command in administrative mode, you can get the status for another user's VM.
orka vm status
OR
orka vm status -v <NAME> -y
OR
orka vm status -v <VM_ID> -y
Output
Options
You can pass the following options with orka vm status in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The name of the VM. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Attach non-bootable disk
Command
Attach a non-bootable disk to the specified VM. The disk must be listed by the orka image list command.
orka vm attach-disk
OR
orka vm attach-disk -v <VM_ID> -i <IMAGE> -y
OR (if attaching a second or a third image to this VM)
orka vm attach-disk -v <VM_ID> -m <MOUNT_POINT> -i <IMAGE> -y
Output
Options
You can pass the following options with orka vm attach-disk in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The ID of the VM to which you want to attach the disk. |
|
|
| The mount point to which you want to attach the disk. Valid values are in the |
|
|
| The name of the disk image that you want to attach. The image must be listed by the |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
List VM disks
Command
List the disks attached to the specified VM. You must specify the VM by ID.
orka vm list-disks
OR
orka vm list-disks -v <VM_ID> -y
Output
Options
You can pass the following option with orka vm list-disks in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The ID of the VM for which you want to list attached disks. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Migrate VM
Command
Move a VM to another node. This operation changes the IP of the VM and might change its assigned ports.
orka vm migrate
OR
orka vm migrate -v <VM_ID> -n <CURRENT_NODE> --to-node <TARGET_NODE> -y
Output
Options
You can pass the following options with orka vm migrate in direct mode:
Option | Description | Sample value | |
|---|---|---|---|
|
| The ID of the VM that you want to migrate. |
|
|
| The name of the source node that hosts the VM. |
|
|
| The name of the destination node to which you want to move the VM. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Clone VM
Command
Create a copy of the specified VM. The copy receives a new ID and might receive a new IP and new ports, based on the target node.
orka vm clone
OR
orka vm clone -v <VM_ID> -n <CURRENT_NODE> --to-node <TARGET_NODE> -y
Output
Options
You can pass the following options with orka vm clone in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The ID of the VM that you want to clone. |
|
|
| The name of the node that hosts the VM. |
|
|
| The name of the target node where you want to place the clone. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Stop, start, suspend, or resume a VM
Commands
Stop, start, suspend, or resume the specified VM. You can specify a VM by name and node, or by ID.
orka vm [stop / start / suspend / resume]
OR
orka vm [stop / start / suspend / resume] -v <NAME> -n <NODE> -y
OR
orka vm [stop / start / suspend / resume] -v <VM_ID> -y
Options
You can pass the following options with orka vm stop, orka vm start, orka vm suspend and orka vm resume in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The name or the ID of the VM. When you specify a VM by name, you need to provide a node as well. |
|
|
| The node on which the VM resides. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Revert VM
Command
Revert VM to the latest state of its base image. This operation restarts the VM. You can specify a VM by name, name and node, or by ID.
orka vm revert
OR
orka vm revert -v <NAME> -n <NODE> -y
OR
orka vm revert -v <VM_ID> -y
Output
Options
You can pass the following options with orka vm revert in direct mode:
Option | Shorthand option | Description | Example |
|---|---|---|---|
|
| The name or the ID of the VM. When you specify a VM by name and there are multiple VMs with that name, you need to provide a node as well. |
|
|
| The node on which the VM resides. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Save VM State
Command
Save the state (disk and memory) of the specified deployed VM. The VM should be running. The VM state is associated with the respective VM configuration. Every VM you deploy from the VM configuration after this operation, will use the saved VM state to boot.
orka vm save-state
Output
Delete VM State
Command
Delete the saved state (disk and memory) of the specified VM configuration. Every VM you deploy from the VM configuration after this operation, will use the base image to boot.
orka vm delete-state
Output
Delete VM
Command
Remove the specified deployed VM(s) but retain the respective VM configuration. You will be able to continue deploying VMs from the VM configuration.
orka vm delete
OR (delete all VMs with the specified name)
orka vm delete -v <NAME> -y
OR (delete all VMs with the specified name from the specified node)
orka vm delete -v <NAME> -n <NODE> -y
OR (delete all VMs with the specified ID)
orka vm delete -v <VM_ID> -y
Is your VM instance in an ERROR state?
Always delete VMs in an
ERRORstate by ID.
Output
Options
You can pass the following options with orka vm delete in direct mode:
Option | Shorthand option | Description | Sample value |
|---|---|---|---|
|
| The name or ID of the VM that you want to delete. |
|
|
| The node from which you want to delete the specified VM. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Purge VM
Command
Delete all deployed VMs with the specified name and the respective VM configuration. You will not be able to continue deploying VMs from the VM configuration.
orka vm purge
OR
orka vm purge -v <NAME> -y
Output
Options
You can pass the following options with orka vm purge in direct mode:
Option | Shorthand | Description | Sample value |
|---|---|---|---|
|
| The name of the VMs and their respective VM configuration. |
|
|
| Bypasses the interactive prompt and executes the command with the specified parameters. |
Updated 4 months ago