.. _Installing Virtuozzo with GUI Management:

Installing Virtuozzo with GUI Management
----------------------------------------

To install Virtuozzo with GUI management in graphics mode, choose **Install Virtuozzo 7 with GUI management** on the welcome screen. After the installation program loads, you will see the **Installation Summary** screen. On this screen, you need to specify a number of parameters required to install Virtuozzo.

.. image:: ../../../images/vzinstall1_0.png
   :align: center
   :class: align-center

.. include:: installing-virtuozzo-with-cli.rst
   :start-line: 11
   :end-line: 88

.. _Installing Virtuozzo Automator Components:

Installing Virtuozzo Automator Components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To install Virtuozzo Automator along with Virtuozzo, you need to choose the respective component to install on the **VIRTUOZZO AUTOMATOR** screen.

.. image:: ../../../images/vzinstall27.png
   :align: center
   :class: align-center

The following options are available:

- **Management Panel and Compute**. Install the management panel and agent components of Virtuozzo Automator. The former is installed into a container on the node and allows you to manage registered nodes and virtual environments on them. The latter is installed on the node itself and lets the node be registered in the management panel.

- **Compute**. Install the agent on the node so the node can be registered in the management panel.

.. important:: Only one VA Management Node is needed, so choose **Management Panel and Compute** only for the first node in your Virtuozzo Automator infrastructure. For the second and other nodes choose **Compute**. The detailed instructions are provided in the following subsections.

.. _Installing Management Panel and Compute on the First Server:

Installing Management Panel and Compute on the First Server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On the first server in your Virtuozzo Automator infrastructure, you will need to install both the management panel and compute components.

Do the following on the **VIRTUOZZO AUTOMATOR** screen:

#. Choose **Management Panel and Compute**.

   .. image:: ../../../images/vzinstall28.png
      :align: center
      :class: align-center

#. Specify an **IP address** and, optionally, a **Hostname**. 

   Virtuozzo will create a container with the specified IP and install the management panel in it. The management panel will be available at the specified IP address (or hostname) on default port 4648.

#. Click **Done** and proceed to configure Virtuozzo Storage as described in :ref:`Installing Virtuozzo Storage Components`.

.. _Installing Compute on the Second and Other Servers:

Installing Compute on the Second and Other Servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On the second and other servers in your Virtuozzo Automator infrastructure, you will need to install the compute component only.

Do the following on the **VIRTUOZZO AUTOMATOR** screen:

#. Choose **Compute**.

   .. image:: ../../../images/vzinstall29.png
      :align: center
      :class: align-center

#. To register the node in the management panel, specify the following:

   #. in the **Management node** field, the IP address or hostname of the container with the management panel;

   #. in the **Password** field, the password of the management panel administrator.

   .. note:: Alternatively, you can register the node in Virtuozzo Automator `manually <http://docs.virtuozzo.com/virtuozzo_automator_7_administrators_guide/managing-physical-servers/registering-physical-server-in-virtuozzo-automator.html>`__ later.

#. Click **Done** and proceed to configure Virtuozzo Storage as described in :ref:`Installing Virtuozzo Storage Components`.

.. _Installing Virtuozzo Storage Components:

Installing Virtuozzo Storage Components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To install Virtuozzo Storage along with Virtuozzo, you need to choose the respective component to install on the **VIRTUOZZO STORAGE** screen.

.. image:: ../../../images/vzinstall24.png
   :align: center
   :class: align-center

The following options are available:

- **Management Panel and Storage**. Install the Virtuozzo Storage management panel and prepare the node for data storage. The management panel is installed into a container on the node. Storage nodes run data storage services as well as store and provide access to user data.

- **Storage**. Prepare the node for data storage. Storage nodes run data storage services as well as store and provide access to user data.

- **No Virtuozzo Storage**. Install Virtuozzo on local hard drives. If you select this option, click **Done**, and proceed to set the installation destination as described in :ref:`Choosing Installation Destination`.

.. important:: Only one management panel is needed, so choose **Management Panel and Storage** only for the first node in your Virtuozzo Storage infrastructure. For the second and other nodes choose **Storage**. The detailed instructions are provided in the following subsections.

.. _Installing Management Panel and Storage on the First Server:

Installing Management Panel and Storage on the First Server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On the first server in your Virtuozzo Storage infrastructure, you will need to install both the management panel and storage components. This node will also become a storage node. It will be added to the Virtuozzo Storage infrastructure and registered in the management panel during installation.

Do the following on the **VIRTUOZZO STORAGE** screen:

#. Choose **Management Panel and Storage**.

   .. image:: ../../../images/vzinstall25.png
      :align: center
      :class: align-center

#. Specify an **IP address** and, optionally, a **Hostname**. 

   Virtuozzo will create a new container with the specified IP and install the Virtuozzo Storage management panel in it. The management panel will be available at the specified IP address (or hostname) on default port 8888.

#. Click **Done** and proceed to set installation destination as described in :ref:`Choosing Installation Destination`.

.. _Installing Storage on the Second and Other Servers:

Installing Storage on the Second and Other Servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

On the second and other servers in your Virtuozzo Storage infrastructure, you will need to install the **Storage** component only. Storage nodes will be added to the Virtuozzo Storage infrastructure and registered in the management panel during installation.

For security reasons, you will need to provide a token that can only be obtained from the management panel you have installed on the first server. A single token can be used to install the storage component on multiple servers in parallel.

To obtain a token:

#. Log in to the Virtuozzo Storage management panel with the password created while deploying the first server. To do this, on any computer with network access to the container with the management panel, open a web browser and visit the container's IP address or hostname on port 8888.

#. In the management panel, click **ADD NODE** to open a screen with the token (you can generate a new one if needed; generating a new token invalidates the old one).

   .. image:: ../../../images/stor_image12.png
      :align: center
      :class: align-center

Having obtained the token, do the following on the **VIRTUOZZO STORAGE** screen:

#. Choose **Storage**.

   .. image:: ../../../images/vzinstall26.png
      :align: center
      :class: align-center

#. Register the node in the Virtuozzo Storage management panel. To do this, specify the following:

   #. in the **Management node** field, the IP address or hostname of the container with the management panel;

   #. in the **Token** field, the acquired token.

   .. note:: Alternatively, you can register the node in the management panel manually later by logging in to the node via SSH and running ``/usr/libexec/vstorage-ui-agent/bin/register-storage-node.sh -m <MP_addr> -t <token>`` in the node's console, where ``<MP_addr>`` is the IP address of the management panel container and ``<token>`` is the token obtained in the management panel.

#. Click **Done** and proceed to set installation destination as described in :ref:`Choosing Installation Destination`.

.. _Choosing Installation Destination:

Choosing Installation Destination
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Having chosen the storage type, open the **INSTALLATION DESTINATION** screen. If you have multiple disks, select which one will be system. Other disks will be used according to the chosen storage type.

.. warning:: All disks recognized by the installation program will be cleaned from partitions once you click **Begin Installation**.

Click **Done** and proceed to finish the installation.

.. _Finishing Installation:

Finishing Installation
~~~~~~~~~~~~~~~~~~~~~~

Having configured everything necessary on the **INSTALLATION SUMMARY** screen, click **Begin Installation**.

.. image:: ../../../images/vzinstall16.png
   :align: center
   :class: align-center

While Virtuozzo is installing, click **ROOT PASSWORD** to create a password for the root account. Installation will not finish until the password is created.

.. image:: ../../../images/vzinstall17.png
   :align: center
   :class: align-center

While Virtuozzo is installing, you can also activate a Virtuozzo license and disable the automatic updating of Virtuozzo ReadyKernel patches if required.

.. _Activating License:

Activating License
^^^^^^^^^^^^^^^^^^

To activate a Virtuozzo license, click **LICENSE KEY**, enter a key, and click **Done**.

.. image:: ../../../images/vzinstall32.png
   :align: center
   :class: align-center

If you do not have a license, you can get one by clicking "Try Virtuozzo Today" at https://virtuozzo.com/.

Alternatively, you can activate a license with the ``vzlicload`` command after the installation is complete. For more details, see the `Virtuozzo 7 User's Guide <http://docs.virtuozzo.com/virtuozzo_7_users_guide/learning-virtuozzo-basics/understanding-licensing.html>`__.

.. note:: If the license is not activated, containers and virtual machines will be deactivated (suspended without possibility to resume) after a grace period. All the newly created containers and virtual machines will run 5 minutes. Containers with Virtuozzo Storage and Virtuozzo Automator management panels (if installed) will run 24 hours.

.. _Configuring ReadyKernel:

Configuring ReadyKernel
^^^^^^^^^^^^^^^^^^^^^^^

With automatic updating enabled by default, ReadyKernel will check for new patches daily at 12:00 server time. If a patch is available, ReadyKernel will download, install, and load it for the current kernel. For more details, see the `Virtuozzo 7 User's Guide <http://docs.virtuozzo.com/virtuozzo_7_users_guide/keeping-your-system-up-to-date/updating-virtuozzo-kernel-with-readykernel.html>`__.

While Virtuozzo is installing, you can disable the automatic updating of Virtuozzo ReadyKernel patches if required. To do this, click **READYKERNEL**, uncheck **ReadyKernel automatic update**, and click **Done**.

.. image:: ../../../images/vzinstall33.png
   :align: center
   :class: align-center

.. _Completing Installation:

Completing Installation
^^^^^^^^^^^^^^^^^^^^^^^

Once the installation is complete, click **Reboot** to restart the server.

.. image:: ../../../images/vzinstall18.png
   :align: center
   :class: align-center

.. note:: If you are installing Virtuozzo from a USB drive, remove the drive before restarting the server.

After restart, you can continue building your Virtuozzo infrastructure as described in :ref:`Building Virtuozzo Infrastructure`.

.. _Building Virtuozzo Infrastructure:

Building Virtuozzo Infrastructure
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Your next steps will depend on which Virtuozzo Storage and Virtuozzo Automator components you have already installed and which you still need to install.

- If you installed Virtuozzo Storage and Virtuozzo Automator management panels on the first server, proceed to install storage and compute components, respectively, on the second and other servers.

- If you installed storage and compute components on a server and need to install it on more servers, repeat the performed installation steps. When on the **VIRTUOZZO STORAGE** or **VIRTUOZZO AUTOMATOR** screen, follow the instructions in :ref:`Installing Storage on the Second and Other Servers` or :ref:`Installing Compute on the Second and Other Servers`.

- If you installed storage and compute components on the last server, do the following: 

  - Log in to the Virtuozzo Storage management panel and make sure that all storage nodes are present in the **UNASSIGNED** list on the **NODES** screen.
  - Log in to the Virtuozzo Automator management panel and make sure that all compute nodes are present on the **Infrastructure** > **Hardware Nodes** tab.

With everything ready, you can start managing your infrastructure as described in the `Virtuozzo Storage Administrator's Guide <http://docs.virtuozzo.com/virtuozzo_storage_administrators_guide/index.html>`__ and `Virtuozzo Automator Administrator's Guide <http://docs.virtuozzo.com/virtuozzo_automator_7_administrators_guide/index.html>`__.
