Initial setup

When you log in to VMmanager for the first time, the initial configuration form will open. It will help you to:

• create a cluster. A cluster is a set of servers from the same location. Such servers (cluster nodes) allow transferring data between them quickly. You can create virtual machines (VM) on these cluster nodes, as well as store disks, disk images, and operating system templates on them. Learn more in Clusters;
• add the first node (a server) to the cluster. Learn more in the article Server requirements for the cluster;
• add a network to assign IP addresses to virtual machines. Learn more in Networks.

For initial setup:

1. Specify Cluster general settings:

   1. Select the Virtualization technology — KVM or LXD.

      Note

      LXD virtualization technology is available only on a cluster with "Switching" or IP-fabric setup type and ZFS file storage. For more information on the technology, see the LXD article.

   2. Select the Time zone that will be used for cluster nodes and VMs by default.
   3. If required, specify the DNS servers for VM. VMs in the cluster will use these servers to resolve domain names.
   4. For cluster nodes to use proxy settings, enable the Use proxy to access the Internet option.
   5. Click Next.
2. Specify the Storage configuration rules on nodes. Read more in the article Storage types:
   1. Images and backups directory. Default value is /image.
      
   2. OS directory. Default value is /share.
      

   3. To edit the default storage settings, press .To add a storage, click and specify its settings :
      

       File storage settings

      1. Select Local.
      2. Enter a storage Name.
      3. Select a type — File storage.
      4. Specify the Path for VM directory. Default value is /vm.
      5. Click Save.
       LVM settings

      1. Select Local.
      2. Enter a storage Name.
      3. Select a type — LVM.
      4. Specify the Volume group name. Default value is lvm0.
      5. Click Save.
       Ceph settings

      Read more about Ceph settings in the article Pre-configuring Ceph.

      1. Select Network.
      2. Enter a storage Name.
      3. Enter the monitor’s Server IP address in Ceph cluster.
      4. Specify the Port for incoming ssh-connections.
      5. Enter the Root password to connect to the server, or press I want to use public SSH-key to create the ssh-key.
      6. Click Connect.
      7. Specify the Storage settings. Read more in the article Creating an RBD storage:

         1. Select the RBD pool for VM storage or create a new pool.

         2. Select the User to manage the pool or create a new user.

         3. Quantity of PG/PGP.

      8. Click Save.
       ZFS settings

      Note

      There can be only one storage in an LXD cluster.

      1. Enter a storage Name.
      2. Specify the ZFS pool name. Default value is zfs0.
      3. Click Save.

      Click main to use the added storage as primary.

      

      Storage configuration interface

   4. Click Next .

3. Specify Network configuration. Learn more about configuration types in the article Cluster network configurations.

    Switching

   Switching — a pool is allocated for the cluster, combining blocks of IP addresses from physical networks;

   1. Enable the Second network interface option to create a cluster with the main and additional network interface. This will allow you to create several network cards in the VM. Learn more in the article Main and additional network .

   2. Specify settings to Create an IP pool:
      
      1. Enter the Network in the format <network address>/<network mask prefix>. E.g., "172.0.0.0/24".
      2. Enter the Gateway for the network.

      3. Enter the list of IP addresses for new VM that can be used for the pool. You can enter separate addresses ("1.1.1.1"), a mask ("1.1.1.1/24"), or an IP range ("1.1.1.1-1.1.1.5").

         Note

         If you have enabled the Second network interface option, specify the Configuration of the main network and the Configuration of the additional network separately. If you plan to use one network for allocating public IP addresses and another for private ones, we recommend using the main network for public IP addresses, and an additional one for private ones.

   3. Нажмите Next.
    Routing

   Routing — a cluster node is assigned subnet of IP addresses. Virtual machines on this node are allocated only the IP addresses from the specified subnet. This subnet routing type does not allow migrating virtual machines to other cluster nodes. Choose this type, if your cluster is located in the data center Hetzner or OVH.

   Note

   If you create a cluster in the data center OVH when preparing the server perform the steps described in the article Server requirements for the cluster.

   Click Next.

    IP-fabric

   IP-fabric — a pool is allocated for the cluster, combining blocks of IP addresses from physical networks. Routing between the nodes of the cluster is carried out via the iBGP protocol.

   Note

   Before creating an "IP-fabric" cluster, add the cluster settings to the Route Reflector equipment configuration: IP addresses of nodes and numbers of BGP autonomous systems.

   1. Specify Gateway for IPv4 sessions.

      Note

      VMmanager will assign IP addresses of the gateway to all virtual interfaces on the cluster node and use this data only to route the VM inside the node. You can specify any address that will not conflict with those used in the cluster node.

   2. To configure the IPv4 network, enable the Enable BGP-sessions for IPv4 option and specify the session settings:
      1. Autonomous system BGP number.
      2. BGP community for IPv4.
      3. Neighbor IPv4 address and Autonomous System number for Route Reflector equipment.
      4. Specify an arbitrary Note.
      5. To specify settings for more equipment, click Add more sessions for IPv4.
   3. To configure the IPv6 network, enable the Enable BGP-sessions for IPv6 option and specify the session settings:
      1. Autonomous system BGP number.
      2. BGP community for IPv6.
      3. Neighbor IPv6 address and Autonomous System number for Route Reflector equipment.
      4. Specify an arbitrary Note.

      5. To specify settings for more equipment, click Add more sessions for IPv6.

         Note

         For an IPv4 network to work in a cluster, add at least one neighbor with an IPv4 address; for an IPv6 network, add at least one neighbor with an IPv6 address.

   4. Specify settings to Create an IP pool:
      
      1. Enter the Network in the format <network address>/<network mask prefix>. E.g., "172.0.0.0/24".
      2. Enter the Gateway for the network.

      3. Enter the list of IP addresses for new VM. You can enter separate addresses ("1.1.1.1"), a mask ("1.1.1.1/24"), or an IP range ("1.1.1.1-1.1.1.5").

   5. Click Next.
4. Specify settings for the first cluster Node:
   
   1. Node IP address.
   2. Port for SSH connections.
   3. Enter the server Root password or add a public SSH-key of the server with VMmanager. To do so, click on I want to use a public ssh-key, copy the key, and add it into the file /root/.ssh/authorized_keys on the server.
   4. For clusters with "Routing" configuration type enter the list of IP addresses for new VM. You can enter separate addresses ("1.1.1.1"), a mask ("1.1.1.1/24"), or an IP range ("1.1.1.1-1.1.1.5"). Enter IPv6 addresses in the x:x:x:x:x:x:x:x/64 format.
5. Click Apply.

You can create and manage virtual machines after this step. Read more in the article Virtual machines .

Related topics

• Account setup
• Connecting the SSL certificate
• Client service
• Server requirements for the cluster
• Storage types
• Cluster network configurations