Host naming

This section describes the host naming pattern that you specify on the Properties page of the template creation wizard.

Each time a new host is created, a name for it is generated automatically based on the pattern that you specify in the Host name field. The complete name format is as follows:

<prefix>%ID:N:S%<ending>

where:

  • <prefix> is an alphanumeric string that must begin with a letter (not a digit).

  • %ID:N:S% is a numeric pattern used to automatically generate a unique host ID. See the Numeric pattern subsection below.

  • <ending> is a free-form alphanumeric string.

Numeric pattern

The numeric pattern in the VM name has the following format:

%ID:N:S%

The elements in the pattern above are:

  • ID — Must be included as is.

  • N — The number of digits to use, including leading zeros. Use "0" if you don't want to insert leading zeros.

  • S — The starting number. This element is optional. If you don't include it, the number will start with 1.

Examples:

  • %ID:3% — This pattern will generate 3 digit numbers with leading zeros, such as "001", "002", "003"...."998", "999".

  • %ID:3:200% — This example will generate 3 digit numbers starting from 200, such as "200", "201", "202"..."998", "999".

  • VDI-R1-%ID:3:100% — This is a complete name with an alphanumeric prefix and a numeric pattern. The resulting names will look like the following: "VDI-R1-100", "VDI-R1-101", etc.

When crating a name pattern, follow the rules listed below. If any of these rules are not observed, you will see an error message and will have to correct it:

  • The name must start with a letter. A digit is not allowed as the first character.

  • The alphanumeric part of a name can contain letters, digits, and a hyphen. No other characters are allowed.

  • The total length of the name must not exceed 15 characters.

  • The name can include just one numerical pattern (%ID:N:S%), which must be placed at the end or in the middle of the name.

The pattern that you specify is also validated against the value of the Maximum hosts field. If the pattern doesn't cover the maximum number of hosts, you will get an error and will have to correct it.

Reusing VM numbers in a name

When you delete a host, the number that was assigned to it becomes unused. The next host that is created will be given this number, so there are no gaps in numbering.

© 2024 Parallels International GmbH. All rights reserved.