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 Parallels Cloud Server 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 Panels 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 .