Previous page

Next page

Locate page in Contents

Print this page

General Options

The table below lists the general options you can use with prlctl set.

Name

Description

--onboot <yes|no>

Set to “yes” to have Virtuozzo automatically start this Container on next system startup.

Note: If "yes" is specified as the value of this parameter in the 0.conf file, all server system management parameters are set on the server boot to the values indicated in this file.

--offline_management <yes|no>

Enabling/disabling the direct managing of the Container through a common Internet browser by means of Parallels Power Panel and the Plesk control panel (as defined by the OFFLINE_SERVICE parameter in the global or Container configuration file).

--offline_service <service_name>

Defines whether the Container can be managed by means of Parallels Power Panel or Plesk or both. Valid only if the OFFLINE_MANAGEMENT parameter is set to "yes". The names of the available services can be taken from the file names (excluding the .conf extension) in the /etc/vzredirect.d directory on the server.

--userpasswd <user:password>

This setting creates a new user with the specified password in the Container, or changes the password of an already existing user. This command modifies not the Container configuration file, but the /etc/passwd and /etc/shadow files inside the Container. In case the Container root is not mounted, it is automatically mounted to apply the changes and then unmounted.

--crypted

Used with --userpasswd. Indicates that the specified password is already a hash.

--noatime <yes|no>

Sets the noatime flag (do not update inode access times) on the Container file system. The default is yes for a Class 1 Container, and no otherwise.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--devnodes <device:r|w|rw|none>

Lets the Container access the specified devices in the specified mode - read-only, write-only, or read-write - or denies any access.

For example: --devnodes hda1:rw

The device must be present in the Container /dev directory, otherwise, a new device is automatically created.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--netdev_add <name>

Moves the specified network device from the server to the Container.

For example: --netdev_add eth0.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--netdev_del <name>

Moves the specified network device from the given Container to the server.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--capability <name:on|off>

Specifies capabilities inside the Container. Setting the following capabilities is allowed: AUDIT_WRITE, CHOWN, DAC_OVERRIDE, DAC_READ_SEARCH, FOWNER, FS_MASK, FSETID, IPC_LOCK, IPC_OWNER, KILL, LEASE, LINUX_IMMUTABLE, MKNOD, NET_ADMIN, NET_BIND_SERVICE, NET_BROADCAST, NET_RAW, SETGID, SETFCAP, SETPCAP, SETUID, SYS_ADMIN, SYS_BOOT, SYS_CHROOT, SYS_MODULE, SYS_NICE, SYS_PACCT, SYS_PTRACE, SYS_RAWIO, SYS_RESOURCE, SYS_TIME, SYS_TTY_CONFIG, VE_ADMIN.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--features <name:on|off>

Enables/disables the support for the following functionality inside the Container:

  • nfs: mounting NFS shares
  • ipip: creating IPIP tunnels
  • sit: using the Simple Internet Transition (SIT) mechanisms
  • ppp: using the PPP protocol
  • ipgre: creating IP-GRE tunnels
  • bridge: using bridges to connect virtual Ethernet devices
  • nfsd: running an NFS-kernel-space server

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--root <path>

This setting does NOT move the root mount point of your Container to a new path. It simply overrides the VE_ROOT parameter in the Container configuration file.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--private <path>

This setting does NOT move the private area of your Container to a new path. It simply overrides the VE_PRIVATE parameter in the Container configuration file. You should use this option only if you have manually moved the Container private area to a new place and want to update the Container configuration file.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--setmode <restart|ignore>

This option tells the utility either to restart or not restart the Container after applying any parameters requiring that the Container be rebooted for them to take effect.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--disabled <yes|no>

If set to yes, disables the Container making it impossible to start the Container once it was stopped. The disabled Container can be started by passing the --force option to prlctl set.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--name <name>

An arbitrary name assigned to the Container. This name can be used, along with the Container ID, to refer to the Container while performing certain Container-related operations on the server.

Names must contain the A-Z, a-z, 0-9, \, -, _ symbols only. Names with white spaces must be enclosed in quotation marks.

--description <desc>

Custom Container description.

Descriptions must contain the A -z, 0-9 symbols only. Descriptions with white spaces must be enclosed in quotation marks.

--bindmount_add [src:]<dst>[,nosuid,noexec,nodev]

Mounts a source directory (src) located on the server to a destination directory (dst) inside the Container. If the source directory is not specified, mounts the directory to the /vz/root/CT_ID directory.

Additional options that can be used with --bindmount_add are the following:

  • noexec. Do not allow execution of any binaries on the mounted directory.
  • nodev. Do not interpret character or block special devices on the mounted directory.
  • nosuid. Do not allow set-user-identifier or set-group-identifier bits to take effect.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--bindmount_del <dst|all>

Removes the mount point created by using the --bindmount_add option from the Container.

Note: Currently, this option may not be supported by the prlctl utility. Use vzctl instead.

--vnc-mode <auto|manual|off>

Enables or disables access to the Container via the VNC protocol.

--vnc-port <port>

Sets the VNC port number for the Container. Used with --vnc-mode manual.

--vnc-passwd <passwd> | --vnc-nopasswd

Sets the VNC password for the Container or specifies that no password is needed for VNC connections.

Either of these options is mandatory for any VNC setup.

--autocompact <on|off>

Enables or disables compaction for all disks in the Container.

Note: For details on how to enable or disable compaction for a specific disk in the Container, see Hard Disk Drive Management Options.