Add Host

ZStack allows you to add hosts via the following two methods:

Manual add
Use template

Manual Add

On the Host page, click Add Host. On the displayed Add Host page, select Manual Add, and then set the following parameters:

Name: Enter a name for the host.
Description: Optional. Enter a description for the host.
Cluster: Select the cluster where the host belongs.
Add IP/IP range: Select either an IP address or an IP range to add the host. You can add up to 500 hosts at a time.
You can either specify an IP address or an IP range for a host.
- To specify IP for a host, set the following parameters:
  - Host IP: Enter an IP address for the host.
  - Scan host IOMMU setting: Select this checkbox if you need to use the physical GPU passthrough feature or the vGPU feature.
    Note:
    
    If you scan hosts by using an IOMMU device, the physical GPU passthrough feature or the vGPU feature will be supported.
    
    If not selected, CPUs on a host will disable IOMMU. This checkbox is not selected by default.
    
    If selected, CPUs on a host enable IOMMU, and all available GPU devices on the host will be traversed. Make sure that the BIOS mode on the host has enabled Intel VT-d or AMD IOMMU.
    
    If you enable IOMMU for the first time, reboot the host to verify that IOMMU configurations on the CPUs take effect.
  - Disable Intel EPT support: Disable or enable the Intel EPT support feature.
    Note:
    
    This checkbox is not selected by default, indicating that the Intel EPT support is enabled.
    
    If CPU models on your servers are too old, you will fail to create VM instances, or cannot open the console UIs of the VM instances. You can select this checkbox to disable the Intel EPT support feature.
    
    You can change the enabled state or the disabled state of the Intel EPT support feature on the host details page.
    
    This feature is only applied to Intel CPU.
  - SSH Port: Set an SSH port for the host. Default port: 22.
  - User Name: Use either the default user name (root) or enter a regular user name for the host.
  - Password: Enter the corresponding user password for the host.
  - Add More Host: Click the plus sign + button to continue adding more hosts. The same user name and password will be used by default when you add more hosts. If the user name and the password are inconsistent, customize a user name and a password as needed.
  As shown in Add Host with IP Address.
  Figure 1. Add Host with IP Address
- To specify IP range, set the following parameters:
  - Start IP: Enter a start IP address of the host IP range that you preconfigured.
  - End IP: Enter an end IP address of the host IP range that you preconfigured.
  - Scan host IOMMU setting: Select this checkbox if you need to use the physical GPU passthrough feature or the vGPU feature.
    Note:
    
    If you scan hosts by using an IOMMU device, the physical GPU passthrough feature or the vGPU feature will be supported.
    
    If not selected, CPUs on a host will disable IOMMU. This checkbox is not selected by default.
    
    If selected, CPUs on a host enable IOMMU, and all available GPU devices on the host will be traversed. Make sure that the BIOS mode on the host has enabled Intel VT-d or AMD IOMMU.
    
    If you enable IOMMU for the first time, reboot the host to verify that IOMMU configurations on the CPUs take effect.
  - Disable Intel EPT support: Disable or enable the Intel EPT support feature.
    Note:
    
    This checkbox is not selected by default, indicating that the Intel EPT support is enabled.
    
    If CPU models on your servers are too old, you will fail to create VM instances, or cannot open the console UIs of the VM instances. You can select this checkbox to disable the Intel EPT support feature.
    
    You can change the enabled state or the disabled state of the Intel EPT support feature on the host details page.
    
    This feature is only applied to Intel CPU.
  - SSH Port: Set uniformly an SSH port for the hosts that you add in bulk. Default port: 22
  - User Name: Use the default user name or enter uniformly a user name for the hosts that you add in bulk.
  - Password: Set uniformly a password for the hosts that you add in bulk.
  As shown in Add Host with IP Range.
  Figure 2. Add Host with IP Range
Note:
In production environments, we recommend that you separate management networks from public networks to ensure your cloud security to the greatest extend. In addition, make sure that the management networks have enough network bandwidths.

You can add a host and configure its IP address by selecting Manual Add, as shown in Add Host with Manual Add Method.

Figure 3. Add Host with Manual Add Method

Use Template

You can add a host by selecting Use Template, as shown in Add Host by Using Template.

Procedure:

Download a configuration template file.
Click Download Template to download the configuration template file with the CSV format, as shown in Configuration Template File.
Figure 5. Configuration Template File
Enter the configuration information for the host according to the required format.
The configuration template includes the table title and a column of examples. When you edit the configuration template, delete or overwrite these examples.
To edit the configuration template, set the following parameters:
- Name: Enter a name for the host. If null, the system will allocate a name (HOST- host IP address) to the host by default.
- Description: Optional. Enter a description for the host.
- Cluster: Enter the UUID of the cluster where the host belongs.
- Host IP: Enter an IP address or an IP range for the host.
  If you enter multiple IP ranges for the host, use commas to separate the ranges. ^ means that the IP range is not included. For example,
```
127.0.0.1-127.0.0.10,^127.0.0.2-127.0.0.3
```
- Scan host IOMMU setting: Select whether to enable the scan host IOMMU setting. To enable this feature, enter YES, Yes, yes, Y, or y. To disable this feature, enter NO, No, no, N, or n. If you do not enter anything, this feature will be disabled by default.
  Note:
  - If you scan hosts by using an IOMMU device, the GPU passthrough feature will be supported.
  - If disabled, IOMMU will be disabled for CPU cores on the host.
  - If enabled, IOMMU will be enabled for CPU cores on the host and all available GPU devices on the host will be traversed. Make sure that the BIOS mode on the host has enabled Intel VT-d or AMD IOMMU.
  - If you enable IOMMU for the first time, reboot the host to verify that IOMMU configurations on the CPUs take effect.
- Disable Intel EPT support: Disable or enable the Intel EPT support. If you enter NO, No, no, N, or n, or if null, the Intel EPT support will be enabled. If you enter YES, Yes, yes, Y, or y, the Intel EPT support will be disabled.
  Note:
  - If CPU models on your servers are too old, you will fail to create VM instances, or cannot open the console UIs of the VM instances. You can select this checkbox to disable the Intel EPT support feature.
  - You can change the enabled state or the disabled state of the Intel EPT support feature on the host details page.
  - This feature is only applied to Intel CPU.
- SSH Port: Set an SSH port for the host. Default port: 22.
- User Name: Enter a user name for the host.
- Password: Enter the corresponding user password for the host.
Upload the configuration template file directly to the cloud through a browser after you complete editing the configuration template file, as shown in Add Host with Template.
Figure 6. Add Host with Template
Check the syntax for the configuration template file.
Click SynTax Check to check whether the syntax of the configuration template file is correct.
- If the syntax is incorrect, an error page will be displayed. After you modify the configuration template file, upload it again.
- If the syntax is correct, click OK. Then, the cloud will add the host according to the configuration template file.