diff --git a/source/_static/images/add-Host.png b/source/_static/images/add-Host.png new file mode 100644 index 0000000000..85eaf5ec00 Binary files /dev/null and b/source/_static/images/add-Host.png differ diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index 7cb469fc87..35e9e58d9f 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -485,6 +485,16 @@ Basic Zone Configuration - **Password.** This is the password for the user named above (from your XenServer or KVM install). + One additional facility that is available in case of KVM is, host can also be added + using CloudStack's SSH key without having to provide host password. + + Before adding the host in CloudStack do the following, + + - Copy the SSH public key from /var/cloudstack/management/.ssh/id_rsa.pub on the management server + - Add the copied key to /root/.ssh/authorized_keys file on the host + + Select "System SSH Key" and proceed with next steps. + - **Host Tags.** (Optional) Any labels that you use to categorize hosts for ease of maintenance. For example, you can set this to the cloud's HA tag (set in the ha.tag global configuration @@ -1001,8 +1011,8 @@ KVM Host Additional Requirements cloudstack ALL=NOPASSWD: /usr/bin/cloudstack-setup-agent defaults:cloudstack !requiretty -Adding a XenServer or KVM Host -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Adding a XenServer Host +^^^^^^^^^^^^^^^^^^^^^^^ #. If you have not already done so, install the hypervisor software on the host. You will need to know which version of the hypervisor @@ -1030,8 +1040,7 @@ Adding a XenServer or KVM Host - Username. Usually root. - - Password. This is the password for the user from your XenServer or - KVM install). + - Password. This is the password for the user from your XenServer install). - Host Tags (Optional). Any labels that you use to categorize hosts for ease of maintenance. For example, you can set to the cloud's @@ -1046,6 +1055,23 @@ Adding a XenServer or KVM Host #. Repeat for additional hosts. +Adding a KVM Host +^^^^^^^^^^^^^^^^^ + +The steps to add a KVM host are same as adding a XenServer Host as mentioned in +the above section. +One additional facility that is available in case of KVM is, host can also be added +using CloudStack's SSH key without having to provide host password. + +Before adding the host in CloudStack do the following, + + - Copy the SSH public key from /var/cloudstack/management/.ssh/id_rsa.pub on the management server + - Add the copied key to /root/.ssh/authorized_keys file on the host + +While adding the host from CloudStack UI, select "System SSH Key" as shown below + + |add-Host.png: Adding a KVM Host| + .. _adding-a-host-vsphere: Adding a Host (vSphere) @@ -1700,4 +1726,5 @@ zone denied.routes Routes that .. |provisioning-overview.png: Conceptual overview of a basic deployment| image:: /_static/images/provisioning-overview.png .. |vsphereclient.png: vSphere client| image:: /_static/images/vsphere-client.png .. |addcluster.png: add a cluster| image:: /_static/images/add-cluster.png +.. |add-Host.png: Adding a KVM Host| image:: /_static/images/add-Host.png .. |ConsoleButton.png: button to launch a console| image:: /_static/images/console-icon.png